Entity 범주

설명

이 범주에는 엔티티 시스템과 관련된 API 요소들이 포함됩니다.

관련 샘플 코드

Appkit: /component_manager.lua

네임스페이스

stingray.EntityManager 엔티티 생성 및 삭제를 위한 관리자입니다.

오브젝트

stingray.ActorComponent 키를 통해 액세스하는 임의 값을 저장할 수 있는 구성요소입니다.

stingray.AnimationBlenderComponent 엔티티에 대한 애니메이션 혼합을 처리하는 구성요소입니다.

stingray.AnimationStateMachineComponent 엔티티에 대한 애니메이션 상태 시스템을 처리하는 구성요소입니다.

stingray.DataComponent 키를 통해 액세스하는 임의 값을 저장할 수 있는 구성요소입니다.

stingray.DebugNameComponent 엔티티에 대한 디버그 이름을 저장하는 구성요소입니다.

stingray.Entity 엔티티를 나타내는 불투명 오브젝트입니다.

stingray.FlowComponent 엔티티에 흐름을 추가하는 구성요소입니다.

stingray.MeshComponent 키를 통해 액세스하는 임의 값을 저장할 수 있는 구성요소입니다.

stingray.RenderDataComponent 키를 통해 액세스하는 임의 값을 저장할 수 있는 구성요소입니다.

stingray.SceneGraphComponent 엔티티에 장면 그래프(노드 계층)를 할당하는 구성요소입니다.

stingray.ScriptComponent 엔티티에 스크립팅 지원을 추가하는 구성요소입니다.

stingray.TagComponent 엔티티에 대한 태그를 처리하는 구성요소입니다.

stingray.TransformComponent 엔티티를 표준에 배치시키는 구성요소입니다.

stingray.UnitComponent 유닛을 엔티티에 연결하는 구성요소입니다.

함수

add_instance_to_tags ( self, instance, tags ) 나중에 태그로 인스턴스를 효율적으로 쿼리하는 데 사용할 수 있는 다수의 태그로 인스턴스에 태그를 지정합니다.

매개변수

self :	stingray.DataComponent	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오.
instance :	integer	구성요소 인스턴스입니다.
tags :	string*	구성요소 인스턴스에 추가할 태그를 나타내는 변동되는 문자열입니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

반환하는 항목

이 함수는 아무 값도 반환하지 않습니다.

기타 관련 참조 항목

Entity

entities_with_script ( self, script_name ) : stingray.Entity[] 지정된 스크립트 이름에 연결된 모든 엔티티를 반환합니다.

매개변수

self :	stingray.ScriptComponent	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오.
script_name :	string	스크립트 이름입니다.

반환하는 항목

stingray.Entity[]

스크립트 이름에 연결된 엔티티의 어레이입니다. [] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다.

기타 관련 참조 항목

Entity

instance_ids_with_script ( self, entity, script_name, result_table ) : any(stingray.Entity, integer)[], integerinstance_ids_with_script ( self, script_name, result_table ) : any(stingray.Entity, integer)[], integer 지정된 스크립트 이름에 연결된 모든 스크립트 구성요소 인스턴스를 반환합니다.

매개변수

self :	stingray.ScriptComponent	이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오.
entity :	stingray.Entity	스크립트 구성요소를 쿼리하는 선택적 엔티티입니다.
script_name :	string	스크립트 이름입니다.
result_table :	table?	선택적 결과 테이블입니다. ? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.

반환하는 항목

any(stingray.Entity, integer)[]	엔티티 및 구성요소 인스턴스 id의 인터리브된 쌍입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. [] 표기는 이 유형이 어레이임을 나타냅니다. 어레이는 구성원의 키가 순차적인 정수이며, 각 요소의 값이 표시된 유형의 인스턴스인 테이블입니다.
integer	결과 수가 테이블에 기록됩니다.

사용 예제:

-- We can pass a cached table for better performance or we can omit the parameter and have it allocated for us.
local components, num_components = script_component:instances_with_script("myscript_name", self._query_cache)
local arg1 = -- some argument
local arg2 = -- some argument
script_component:call_function(components, "some_function", arg1, arg2)

local entity = -- some entity
local arg1 = -- some argument
local arg2 = -- some argument
local components = script_component:instances_with_script(entity, "myscript_name", self._query_cache)
script_component:call_function(components, "some_function", arg1, arg2)

기타 관련 참조 항목

Entity