컴포넌트

컴포넌트는 게임 오브젝트에 특정 표현 및/또는 기능을 부여하는 데 사용됩니다. 컴포넌트는 게임 오브젝트 안에 포함되어야 하며, 해당 컴포넌트를 포함하는 게임 오브젝트의 위치, 회전, 스케일의 영향을 받습니다.

많은 컴포넌트에는 조작할 수 있는 타입별 프로퍼티가 있으며, 런타임에서 컴포넌트와 상호작용할 수 있는 컴포넌트 타입별 함수도 제공됩니다.

-- can "body" 스프라이트 비활성화
msg.post("can#body", "disable")

-- 1초 뒤에 "bean"에서 "hoohoo" 사운드 재생
sound.play("bean#hoohoo", { delay = 1, gain = 0.5 } )

컴포넌트는 게임 오브젝트 안에 내장(in-place)으로 추가하거나, 컴포넌트 파일에 대한 참조로 게임 오브젝트에 추가할 수 있습니다.

Outline 뷰에서 게임 오브젝트를 Right-click하고 Add Component(내장으로 추가) 또는 Add Component File(파일 참조로 추가)을 선택합니다.

대부분의 경우 컴포넌트를 내장으로 생성하는 것이 가장 적합하지만, 다음 컴포넌트 타입은 게임 오브젝트에 참조로 추가하기 전에 별도의 리소스 파일로 생성해야 합니다.

• Script
• GUI
• Particle FX
• Tile Map

컴포넌트 타입

Defold는 다음 컴포넌트 타입을 지원합니다:

• 컬렉션 팩토리 - 컬렉션을 스폰합니다
• 컬렉션 프록시 - 컬렉션을 로드하고 언로드합니다
• 충돌 오브젝트 - 2D 및 3D 물리
• Camera - 게임 월드의 뷰포트와 투영을 변경합니다
• Factory - 게임 오브젝트를 스폰합니다
• GUI - 그래픽 유저 인터페이스를 렌더링합니다
• Label - 텍스트 조각을 렌더링합니다
• Mesh 3D mesh를 표시합니다(런타임 생성 및 조작 포함)
• Model 3D 모델을 표시합니다(선택적 애니메이션 포함)
• Particle FX - 파티클을 스폰합니다
• Script - 게임 로직을 추가합니다
• Sound - 사운드나 음악을 재생합니다
• Sprite - 2D 이미지를 표시합니다(선택적 플립북 애니메이션 포함)
• Tilemap - 타일 그리드를 표시합니다

익스텐션을 통해 추가 컴포넌트를 더할 수 있습니다:

• Rive 모델 - Rive 애니메이션을 렌더링합니다
• Spine 모델 - Spine 애니메이션을 렌더링합니다

컴포넌트 활성화 및 비활성화

게임 오브젝트의 컴포넌트는 게임 오브젝트가 생성될 때 활성화됩니다. 컴포넌트를 비활성화하려면 해당 컴포넌트로 disable 메세지를 보냅니다:

-- 이 스크립트와 같은 게임 오브젝트에 있는 id 'weapon' 컴포넌트를 비활성화합니다
msg.post("#weapon", "disable")

-- 'enemy' 게임 오브젝트에 있는 id 'shield' 컴포넌트를 비활성화합니다
msg.post("enemy#shield", "disable")

-- 현재 게임 오브젝트의 모든 컴포넌트를 비활성화합니다
msg.post(".", "disable")

-- 'enemy' 게임 오브젝트의 모든 컴포넌트를 비활성화합니다
msg.post("enemy", "disable")

컴포넌트를 다시 활성화하려면 해당 컴포넌트로 enable 메세지를 보낼 수 있습니다:

-- id 'weapon' 컴포넌트를 활성화합니다
msg.post("#weapon", "enable")

컴포넌트 프로퍼티

Defold의 모든 컴포넌트 타입은 서로 다른 프로퍼티를 가집니다. 에디터의 Properties 창은 Outline 창에서 현재 선택한 컴포넌트의 프로퍼티를 표시합니다. 사용할 수 있는 컴포넌트 프로퍼티에 대해 더 알아보려면 각 컴포넌트 타입의 매뉴얼을 참고하세요.

컴포넌트 위치, 회전 및 스케일

시각적 컴포넌트는 일반적으로 위치와 회전 프로퍼티를 가지며, 대부분 스케일 프로퍼티도 가집니다. 이러한 프로퍼티는 에디터에서 변경할 수 있지만, 거의 모든 경우 런타임에는 변경할 수 없습니다(런타임에 변경할 수 있는 유일한 예외는 스프라이트 및 라벨 컴포넌트의 스케일입니다).

런타임에 컴포넌트의 위치, 회전 또는 스케일을 변경해야 한다면, 대신 해당 컴포넌트가 속한 게임 오브젝트의 위치, 회전 또는 스케일을 수정합니다. 그러면 그 게임 오브젝트의 모든 컴포넌트가 영향을 받는 부작용이 있습니다. 게임 오브젝트에 연결된 여러 컴포넌트 중 하나만 조작하고 싶다면, 해당 컴포넌트를 별도의 게임 오브젝트로 옮기고 원래 컴포넌트가 속해 있던 게임 오브젝트의 자식 게임 오브젝트로 추가하는 것을 권장합니다.

컴포넌트 그리기 순서

시각적 컴포넌트의 그리기 순서는 두 가지에 따라 달라집니다:

렌더 스크립트 predicate

각 컴포넌트에는 메터리얼이 할당되고, 각 메터리얼은 하나 이상의 태그를 가집니다. 렌더 스크립트는 다시 여러 predicate를 정의하며, 각 predicate는 하나 이상의 메터리얼 태그와 매칭됩니다. 렌더 스크립트의 update() 함수에서 렌더 스크립트 predicate가 하나씩 그려지고, 각 predicate에 정의된 태그와 매칭되는 컴포넌트가 그려집니다. 기본 렌더 스크립트는 먼저 스프라이트와 타일맵을 하나의 패스에서 그린 다음, 파티클 효과를 다른 패스에서 그리며, 둘 다 월드 공간에서 그립니다. 그런 다음 렌더 스크립트는 GUI 컴포넌트를 별도 패스에서 화면 공간에 그립니다.

컴포넌트 z 값

모든 게임 오브젝트와 컴포넌트는 vector3 오브젝트로 표현되는 위치를 사용해 3D 공간에 배치됩니다. 게임의 그래픽 컨텐츠를 2D로 볼 때 X와 Y 값은 오브젝트의 “너비”와 “높이” 축 위치를 결정하고, Z 위치는 “깊이” 축 위치를 결정합니다. Z 위치를 사용하면 겹치는 오브젝트의 가시성을 제어할 수 있습니다. Z 값이 1인 스프라이트는 Z 위치가 0인 스프라이트 앞에 나타납니다. 기본적으로 Defold는 -1에서 1 사이의 Z 값을 허용하는 좌표 시스템을 사용합니다:

렌더 predicate와 매칭되는 컴포넌트들은 함께 그려지며, 그려지는 순서는 컴포넌트의 최종 z 값에 따라 달라집니다. 컴포넌트의 최종 z 값은 컴포넌트 자체의 z 값, 컴포넌트가 속한 게임 오브젝트의 z 값, 그리고 모든 부모 게임 오브젝트의 z 값을 더한 값입니다.

예: 게임 오브젝트 A와 B가 있습니다. B는 A의 자식입니다. B에는 스프라이트 컴포넌트가 있습니다.

위 계층구조에서 B의 스프라이트 컴포넌트의 최종 z 값은 2 + 1 + 0.5 = 3.5입니다.

컴포넌트 최대 개수 최적화

game.project 설정 파일에는 동시에 존재할 수 있는 특정 리소스의 최대 개수를 지정하는 값이 많이 포함되어 있으며, 보통 로드된 컬렉션(월드라고도 함)별로 계산됩니다. Defold 엔진은 게임 실행 중 동적 할당과 메모리 단편화를 피하기 위해 이 최대값들을 사용하여 해당 수량만큼 메모리를 미리 할당합니다.

컴포넌트와 기타 리소스를 표현하는 데 사용되는 Defold 데이터 구조는 가능한 한 적은 메모리를 사용하도록 최적화되어 있지만, 실제로 필요한 것보다 더 많은 메모리를 할당하지 않도록 값을 설정할 때 여전히 주의해야 합니다.

메모리 사용량을 더 최적화하기 위해 Defold 빌드 프로세스는 게임의 컨텐츠를 분석하고, 정확한 수량을 확실히 알 수 있는 경우 최대 개수를 재정의합니다.

• 컬렉션에 팩토리 컴포넌트가 없으면 각 컴포넌트와 게임 오브젝트의 정확한 수량이 할당되며 최대 개수 값은 무시됩니다.
• 컬렉션에 팩토리 컴포넌트가 있으면 스폰된 오브젝트가 분석되고, 팩토리에서 스폰될 수 있는 컴포넌트와 게임 오브젝트에는 최대 개수가 사용됩니다.
• 컬렉션에 “Dynamic Prototype” 옵션이 활성화된 팩토리 또는 컬렉션 팩토리가 포함되어 있으면 이 컬렉션은 최대 개수 카운터를 사용합니다.