ActorComponent - stingray.ActorComponent 오브젝트 참조 - Stingray Lua API 참조
설명
키를 통해 액세스하는 임의 값을 저장할 수 있는 구성요소입니다.
생성자 및 액세서 
기타 관련 참조 항목
관련 도움말 항목
함수
 |
create ( self, entity, id ) : integer 지정된 구성요소 ID를 사용하여 엔티티의 구성요소 인스턴스를 만듭니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 엔티티입니다. | |
id : | any(integer, string) | 구성요소 ID입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
integer |
구성요소 인스턴스입니다. |
| |
create_capsule ( self, entity, id, pose, radius, height, actor_template, shape_template, material_template ) : integer캡슐 모양으로 액터를 생성합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 액터를 소유하게 될 엔티티입니다. | |
id : | any(integer, string) | 액터 구성요소 인스턴스 ID입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
pose : | 엔티티를 기준으로 한 액터의 포즈입니다. | |
radius : | number | 캡슐의 반지름입니다. |
height : | number | 캡슐의 높이입니다. |
actor_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 액터 템플릿입니다. |
shape_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 모양 템플릿입니다. |
material_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 재질 템플릿입니다. |
integer |
새로 생성된 액터 구성요소 인스턴스입니다. |
캡슐의 방향은 변환의 y축을 따라 지정됩니다. 다른 회전을 원하는 경우 해당 결과에 도달하도록 pose 매트릭스를 회전시킵니다.
| |
create_plane ( self, entity, id, pose, normal, actor_template, shape_template, material_template ) : integer평면 모양으로 액터를 생성합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 액터를 소유하게 될 엔티티입니다. | |
id : | any(integer, string) | 액터 구성요소 인스턴스 ID입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
pose : | 엔티티를 기준으로 한 액터의 포즈입니다. | |
normal : | 평면의 법선입니다. | |
actor_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 액터 템플릿입니다. |
shape_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 모양 템플릿입니다. |
material_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 재질 템플릿입니다. |
integer |
새로 생성된 액터 구성요소 인스턴스입니다. |
평면 모양은 지정된 위치와 법선으로 이루어진 무한 평면입니다.
| |
create_sphere ( self, entity, id, pose, radius, actor_template, shape_template, material_template ) : integer구 모양으로 액터를 생성합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 액터를 소유하게 될 엔티티입니다. | |
id : | any(integer, string) | 액터 구성요소 인스턴스 ID입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
pose : | 엔티티를 기준으로 한 액터의 포즈입니다. | |
radius : | number | 구의 반지름입니다. |
actor_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 액터 템플릿입니다. |
shape_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 모양 템플릿입니다. |
material_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 재질 템플릿입니다. |
integer |
새로 생성된 액터 구성요소 인스턴스입니다. |
| |
create_sphere ( self, entity, id, pose, radius, actor_template, shape_template, material_template ) : integer상자 모양으로 액터를 생성합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 액터를 소유하게 될 엔티티입니다. | |
id : | any(integer, string) | 액터 구성요소 인스턴스 ID입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
pose : | 엔티티를 기준으로 한 액터의 포즈입니다. | |
radius : | 상자의 "반지름"(x, y 및 z축상의 절반 범위)입니다. | |
actor_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 액터 템플릿입니다. |
shape_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 모양 템플릿입니다. |
material_template : | string | 이 액터에 사용하기 위해 .physics_properties 파일에서 가져온 재질 템플릿입니다. |
integer |
새로 생성된 액터 구성요소 인스턴스입니다. |
| |
destroy ( self, instance )엔티티의 특정 구성요소 인스턴스를 삭제합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
instance : | integer | 삭제할 구성요소 인스턴스입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
| |
destroy_all ( self, entity )엔티티의 모든 구성요소 인스턴스를 삭제합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 모든 구성요소 인스턴스를 삭제할 엔티티입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
| |
get_property ( self, instance, key ) : any*특성 키의 값을 가져옵니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
instance : | integer | 구성요소 인스턴스입니다. |
key : | any(string, string[]) | 값을 가져오려는 특성의 키입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
any* |
키의 값입니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다. |
키는 도트로 구분되는 문자열("fog.color.red") 또는 문자열의 어레이({"fog", "color", "red"})일 수 있습니다. 둘 모두 서로 바꿔서 쓸 수 있습니다.
값은 특성 시스템에서 지원하는 값, 즉 nil, 부울, 숫자, 문자열 또는 부동 소수점 어레이 중 하나가 됩니다.
부동 소수점 어레이는 다중 반환값으로 반환됩니다. 테이블 또는 Vector3로 반환되길 원한다면 래퍼를 사용하십시오.
키가 존재하지 않으면 nil이 반환됩니다.
| |
get_property_by_id ( self, entity, id, key ) : any*지정된 ID와 일치하는 구성요소 인스턴스의 특성 값을 가져옵니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 엔티티입니다. | |
id : | integer | 구성요소 인스턴스 ID입니다. |
key : | any(string, string[]) | 값을 가져오려는 특성의 키입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
any* |
키의 값입니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다. |
키는 도트로 구분되는 문자열("fog.color.red") 또는 문자열의 어레이({"fog", "color", "red"})일 수 있습니다. 둘 모두 서로 바꿔서 쓸 수 있습니다.
값은 특성 시스템에서 지원하는 값, 즉 nil, 부울, 숫자, 문자열 또는 부동 소수점 어레이 중 하나가 됩니다.
부동 소수점 어레이는 다중 반환값으로 반환됩니다. 테이블 또는 Vector3로 반환되길 원한다면 래퍼를 사용하십시오.
키가 존재하지 않으면 nil이 반환됩니다.
이 함수를 호출하면 지정된 구성요소 ID부터 구성요소 인스턴스까지 추가 조회가 수행됩니다. 여러 특성을 가져올 때 먼저 구성요소 ID로 구성요소 인스턴스를 조회한 다음 get_property를 호출하는 것이 좋습니다.
| |
instances ( self, entity ) : integer*지정된 엔티티의 모든 구성요소 인스턴스를 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 엔티티입니다. |
integer* |
모든 엔티티 구성요소 인스턴스입니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다. |
인스턴스는 스택으로 반환됩니다.
| |
instance_ids ( self, entity ) : integer*엔티티의 모든 구성요소의 ID를 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 엔티티입니다. |
integer* |
모든 엔티티 인스턴스 ID입니다. * 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다. |
ID는 스택으로 반환됩니다.
| |
lookup ( self, entity, id ) : integer지정한 ID에 대한 구성요소 인스턴스를 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 엔티티입니다. | |
id : | integer | 구성요소 인스턴스 ID입니다. |
integer |
구성요소 인스턴스입니다. |
| |
set_parent ( self, entities, parent_indices )각 엔티티에 대한 parent_indices를 조회하고 상위를 지정된 상위 인덱스로 설정합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entities : | table | 상위/하위 관계를 설정할 엔티티의 목록입니다. |
parent_indices : | table | 상위 인덱스의 엔티티 목록과 동일한 길이의 목록입니다. 상위가 없는 엔티티의 인덱스로 false를 사용합니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
이 함수는 모든 구성요소를 추가 및 구성한 다음 spawned 전에 호출해야 합니다.
| |
set_property ( self, instance, key, value )특성 키의 값을 설정합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
instance : | integer | 구성요소 인스턴스입니다. |
key : | any(string, string[]) | 값을 설정하려는 특성의 키입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
value : | any | 키에 대해 설정할 값입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
키는 도트로 구분되는 문자열("fog.color.red") 또는 문자열의 어레이({"fog", "color", "red"})일 수 있습니다. 둘 모두 서로 바꿔서 쓸 수 있습니다.
값은 특성 시스템에서 지원하는 값, 즉 nil, 부울, 숫자, 문자열 또는 부동 소수점 어레이 중 어느 값이든 될 수 있습니다.
3~ 4개의 부동 소수점 어레이 대신 Vector 3 또는 Quaternion을 사용해도 됩니다.
값을 nil로 설정하여 특성을 지울 수도 있습니다.
| |
set_property_by_id ( self, entity, id, key, value ) : integer특성 값을 설정하고 지정된 ID와 일치하는 구성요소 인스턴스를 반환합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entity : | 엔티티입니다. | |
id : | integer | 구성요소 인스턴스 ID입니다. |
key : | any(string, string[]) | 값을 설정하려는 특성의 키입니다. any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다. |
value : | any | 키에 대해 설정할 값입니다. |
integer |
구성요소 인스턴스입니다. |
키는 도트로 구분되는 문자열("fog.color.red") 또는 문자열의 어레이({"fog", "color", "red"})일 수 있습니다. 둘 모두 서로 바꿔서 쓸 수 있습니다.
값은 특성 시스템에서 지원하는 값, 즉 nil, 부울, 숫자, 문자열 또는 부동 소수점 어레이 중 어느 값이든 될 수 있습니다.
3~ 4개의 부동 소수점 어레이 대신 Vector 3 또는 Quaternion을 사용해도 됩니다.
값을 nil로 설정하여 특성을 지울 수도 있습니다.
이 함수를 호출하면 지정된 구성요소 ID부터 구성요소 인스턴스까지 추가 조회가 수행됩니다. 여러 특성을 설정할 경우 먼저 구성요소 ID로 구성요소 인스턴스를 조회한 다음 set_property를 호출하는 것이 좋습니다.
| |
spawned ( self, entities )각 엔티티에서 이 구성요소 유형에 대해 spawned를 호출합니다.
|
self : | 이 함수가 작동하는 오브젝트 인스턴스를 지정합니다. 콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 Stingray 도움말 항목 또는 Lua 설명서의 이 페이지를 참조하십시오. | |
entities : | table | 호출할 엔티티 목록입니다. |
| 이 함수는 아무 값도 반환하지 않습니다. |
표준에 대한 해당 소개를 완료하려면 엔티티와 해당 구성요소를 생성 및 구성한 다음 호출해야 합니다.