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

stingray.AnimationBlenderComponent 오브젝트 참조

설명

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

함수

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

반환하는 항목

stingray.AnimationBlenderBoneMode

애니메이션 블렌더의 골격 모드입니다.

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

id :

any(integer, string)

구성요소 ID입니다.

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

integer

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

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

animation :

string

재생해야 하는 .animation 리소스의 이름입니다.

layer :

integer?

애니메이션을 재생해야 하는 레이어(기본값은 0)입니다.

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

blend_time :

number?

지정된 레이어에서 애니메이션을 혼합할 시간(기본값은 0)입니다.

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

loop :

boolean?

애니메이션의 루프 여부를 지정합니다(기본값은 true).

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

integer

재생 애니메이션의 ID입니다.

애니메이션이 지정된 blend_time 동안 지정된 레이어에서 혼합됩니다. 애니메이션이 루프되도록 지정되지 않은 경우 종료 포즈에서 멈춥니다(다른 애니메이션을 혼합하지 않은 경우).

애니메이션 상태 머신을 사용하는 경우에는 애니메이션 블렌더에서 직접 재생되는 애니메이션을 방해하게 됩니다.

애니메이션 제어에 사용할 수 있는 ID를 반환합니다.

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

반환하는 항목

stingray.Matrix4x4

애니메이션에서 가져오는 엔티티에 대한 변환 델타입니다.

AnimationBlenderRootMode.IGNORE 모드에서 실행 중인 경우 이 함수가 애니메이션 블렌더가 엔티티에 적용할 델타 변환을 반환합니다. 이 함수를 사용하여 스크립트를 통해 수동으로 애니메이션 동작을 적용하거나 이를 다른 시스템(무버 등)을 통해 전달할 수 있습니다.

매개변수

self :

stingray.AnimationBlenderComponent

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

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

instance :

integer

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

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

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

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

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

self :

stingray.AnimationBlenderComponent

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

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

instance :

integer

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

key :

any(string, string[])

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

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

any*

키의 값입니다.

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

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

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

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

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

매개변수

self :

stingray.AnimationBlenderComponent

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

콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 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.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

반환하는 항목

integer*

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

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

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

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

반환하는 항목

integer*

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

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

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

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

반환하는 항목

boolean

애니메이션이 현재 크로스 페이딩되는 중이면 true를 반환합니다.

이를 사용하여 너무 많은 크로스 페이딩 애니메이션이 서로 겹치는 상황을 방지할 수 있습니다.

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

id :

integer

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

반환하는 항목

integer

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

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

반환하는 항목

stingray.AnimationBlenderRootMode

애니메이션 블렌더의 루트 모드입니다.

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

lod :

integer

애니메이션의 새 골격 LOD 수준입니다.

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

AnimationBlenderRootMode.IGNORE 모드에서 실행 중인 경우 이 함수가 애니메이션 블렌더가 엔티티를 이동시킬 대상 포즈를 반환합니다. 이 함수를 사용하여 스크립트를 통해 수동으로 애니메이션 동작을 적용하거나 이를 다른 시스템(무버 등)을 통해 전달할 수 있습니다.

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

bone_mode :

stingray.AnimationBlenderBoneMode

애니메이션 블렌더의 새 골격 모드입니다.

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

self :

stingray.AnimationBlenderComponent

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

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

entities :

table

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

parent_indices :

table

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

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

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

매개변수

self :

stingray.AnimationBlenderComponent

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

콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 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.AnimationBlenderComponent

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

콜론 : 호출 구문을 사용하여 이 오브젝트의 인스턴스에 대해 이 함수를 호출할 수도 있습니다. 그렇게 하는 경우에는 이 매개변수를 생략해야 합니다. 자세한 내용은 이 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.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

root_mode :

stingray.AnimationBlenderRootMode

애니메이션 블렌더의 새 루트 모드입니다.

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

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

id :

integer

크로스 페이드 애니메이션의 ID입니다.

speed :

number

새로운 애니메이션 재생 속도입니다.

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

시드는 블렌더의 속도를 기준으로 설정됩니다. 값이 1이면 블렌더와 같은 시간 단계를 사용한다는 의미입니다. 값이 0이면 멈춥니다. 속도 값을 음수로 설정할 수 없습니다.

매개변수

self :

stingray.AnimationBlenderComponent

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

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

entity :

stingray.Entity

엔티티입니다.

id :

integer

크로스 페이드 애니메이션의 ID입니다.

time :

number

설정할 애니메이션의 시간입니다.

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

self :

stingray.AnimationBlenderComponent

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

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

entities :

table

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

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

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