TransformComponent - stingray.TransformComponent 오브젝트 참조 - Stingray Lua API 참조

stingray.TransformComponent 오브젝트 참조

설명

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

TransformComponent는 엔티티에 대한 장면 그래프를 생성합니다. 엔티티는 다른 엔티티, 그리고 변경된 자신의 로컬 위치에 링크될 수 있습니다. TransformComponent는 모든 엔티티의 표준 위치를 계산하는 역할을 합니다.

함수

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

parent :

stingray.Entity

하위 항목을 검색 중인 엔티티입니다.

반환하는 항목

stingray.Entity[]

상위 엔티티의 하위 항목을 반환합니다.

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

상위 엔티티에 하위 항목이 없으면 빈 테이블이 반환됩니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

엔티티입니다.

id :

any(integer, string)

구성요소 ID입니다.

any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
반환하는 항목

integer

구성요소 인스턴스입니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

instance :

integer

삭제할 구성요소 인스턴스입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

모든 구성요소 인스턴스를 삭제할 엔티티입니다.

반환하는 항목
이 함수는 아무 값도 반환하지 않습니다.
매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

instance :

integer

구성요소 인스턴스입니다.

key :

any(string, string[])

값을 가져오려는 특성의 키입니다.

any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
반환하는 항목

any*

키의 값입니다.

* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

키는 도트로 구분되는 문자열("fog.color.red") 또는 문자열의 어레이({"fog", "color", "red"})일 수 있습니다. 둘 모두 서로 바꿔서 쓸 수 있습니다.

값은 특성 시스템에서 지원하는 값, 즉 nil, 부울, 숫자, 문자열 또는 부동 소수점 어레이 중 하나가 됩니다.

부동 소수점 어레이는 다중 반환값으로 반환됩니다. 테이블 또는 Vector3로 반환되길 원한다면 래퍼를 사용하십시오.

키가 존재하지 않으면 nil이 반환됩니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

엔티티입니다.

id :

integer

구성요소 인스턴스 ID입니다.

key :

any(string, string[])

값을 가져오려는 특성의 키입니다.

any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.
반환하는 항목

any*

키의 값입니다.

* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

키는 도트로 구분되는 문자열("fog.color.red") 또는 문자열의 어레이({"fog", "color", "red"})일 수 있습니다. 둘 모두 서로 바꿔서 쓸 수 있습니다.

값은 특성 시스템에서 지원하는 값, 즉 nil, 부울, 숫자, 문자열 또는 부동 소수점 어레이 중 하나가 됩니다.

부동 소수점 어레이는 다중 반환값으로 반환됩니다. 테이블 또는 Vector3로 반환되길 원한다면 래퍼를 사용하십시오.

키가 존재하지 않으면 nil이 반환됩니다.

이 함수를 호출하면 지정된 구성요소 ID부터 구성요소 인스턴스까지 추가 조회가 수행됩니다. 여러 특성을 가져올 때 먼저 구성요소 ID로 구성요소 인스턴스를 조회한 다음 get_property를 호출하는 것이 좋습니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

엔티티입니다.

반환하는 항목

integer*

모든 엔티티 구성요소 인스턴스입니다.

* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

인스턴스는 스택으로 반환됩니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

엔티티입니다.

반환하는 항목

integer*

모든 엔티티 인스턴스 ID입니다.

* 표기는 지정된 유형의 인스턴스가 0개 이상 있을 수 있음을 나타냅니다.

ID는 스택으로 반환됩니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

포즈를 검색 중인 엔티티입니다.

반환하는 항목

stingray.Matrix4x4

엔티티의 로컬 포즈입니다.

엔티티에 상위 항목이 없는 경우 로컬 포즈는 표준 포즈와 같아집니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

위치를 검색 중인 엔티티입니다.

반환하는 항목

stingray.Vector3

엔티티의 로컬 위치입니다.

엔티티에 상위 항목이 없는 경우 로컬 위치는 표준 위치와 같아집니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

회전을 검색 중인 엔티티입니다.

반환하는 항목

stingray.Quaternion

엔티티의 로컬 회전입니다.

엔티티에 상위 항목이 없는 경우 로컬 회전은 표준 회전과 같아집니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

배율을 검색 중인 엔티티입니다.

반환하는 항목

stingray.Vector3

엔티티의 로컬 배율입니다.

엔티티에 상위 항목이 없는 경우 로컬 배율은 표준 배율과 같아집니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

엔티티입니다.

id :

integer

구성요소 인스턴스 ID입니다.

반환하는 항목

integer

구성요소 인스턴스입니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

child :

stingray.Entity

상위 항목을 살펴보려는 하위 항목입니다.

반환하는 항목

stingray.Entity?

하위 항목의 상위 항목입니다.

? 표기는 이 유형이 선택 사항임을 나타냅니다. 해당 인스턴스가 0개 또는 한 개일 수 있습니다.
매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

포즈를 변경하려는 엔티티입니다.

pose :

stingray.Matrix4x4

엔티티의 새 로컬 포즈입니다.

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

엔티티에 상위 항목이 없는 경우 로컬 포즈는 표준 포즈와 같아집니다.

로컬 포즈를 변경하면 즉시 새 포즈 배율을 반영하여 엔티티 및 모든 하위 항목의 표준 포즈가 변경됩니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

위치를 변경하려는 엔티티입니다.

position :

stingray.Vector3

엔티티의 새 로컬 위치입니다.

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

엔티티에 상위 항목이 없는 경우 로컬 위치는 표준 위치와 같아집니다.

로컬 위치를 변경하면 즉시 새 로컬 위치를 반영하여 엔티티 및 모든 하위 항목의 표준 위치가 변경됩니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

회전을 변경하려는 엔티티입니다.

rotation :

stingray.Quaternion

엔티티의 새 로컬 회전입니다.

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

엔티티에 상위 항목이 없는 경우 로컬 회전은 표준 회전과 같아집니다.

로컬 회전을 변경하면 즉시 새 로컬 회전을 반영하여 엔티티 및 모든 하위 항목의 표준 회전이 변경됩니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

배율을 변경하려는 엔티티입니다.

scale :

stingray.Vector3

엔티티의 새 로컬 배율입니다.

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

엔티티에 상위 항목이 없는 경우 로컬 배율은 표준 배율과 같아집니다.

로컬 배율을 변경하면 즉시 새 로컬 배율을 반영하여 엔티티 및 모든 하위 항목의 표준 배율이 변경됩니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entities :

table

상위/하위 관계를 설정할 엔티티의 목록입니다.

parent_indices :

table

상위 인덱스의 엔티티 목록과 동일한 길이의 목록입니다. 상위가 없는 엔티티의 인덱스로 false를 사용합니다.

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

이 함수는 모든 구성요소를 추가 및 구성한 다음 spawned 전에 호출해야 합니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

instance :

integer

구성요소 인스턴스입니다.

key :

any(string, string[])

값을 설정하려는 특성의 키입니다.

any(...) 표기는 이 항목이 괄호 내에 표시되는 어떠한 유형의 인스턴스도 될 수 있다는 의미입니다.

value :

any

키에 대해 설정할 값입니다.

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

키는 도트로 구분되는 문자열("fog.color.red") 또는 문자열의 어레이({"fog", "color", "red"})일 수 있습니다. 둘 모두 서로 바꿔서 쓸 수 있습니다.

값은 특성 시스템에서 지원하는 값, 즉 nil, 부울, 숫자, 문자열 또는 부동 소수점 어레이 중 어느 값이든 될 수 있습니다.

3~ 4개의 부동 소수점 어레이 대신 Vector 3 또는 Quaternion을 사용해도 됩니다.

값을 nil로 설정하여 특성을 지울 수도 있습니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.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를 호출하는 것이 좋습니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entities :

table

호출할 엔티티 목록입니다.

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

표준에 대한 해당 소개를 완료하려면 엔티티와 해당 구성요소를 생성 및 구성한 다음 호출해야 합니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

포즈를 검색 중인 엔티티입니다.

반환하는 항목

stingray.Matrix4x4

엔티티의 표준 포즈입니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

위치를 검색 중인 엔티티입니다.

반환하는 항목

stingray.Vector3

엔티티의 표준 위치입니다.

매개변수

self :

stingray.TransformComponent

이 함수가 작동하는 오브젝트 인스턴스를 지정합니다.

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

entity :

stingray.Entity

회전을 검색 중인 엔티티입니다.

반환하는 항목

stingray.Quaternion

엔티티의 표준 회전입니다.