AnimationController QML Type
애니메이션용 컨트롤러 유형입니다. 더 보기...
| Import Statement: | import Qt3D.Animation 2.12 |
| In C++: | QAnimationController |
| Status: | Technology preview |
이 타입은 기술 미리보기 단계에 있으며 변경될 수 있습니다.
속성
- activeAnimationGroup : int
- animationGroups : list<AnimationGroup>
- entity : Entity
- position : real
- positionOffset : real
- positionScale : real
- recursive : bool
방법
- int getAnimationIndex(name)
- AnimationGroup getGroup(index)
상세 설명
AnimationController 타입은 애니메이션의 선택 및 재생을 제어합니다. 이 타입을 사용하면 엔티티 트리에서 모든 애니메이션을 검색하고, 동일한 이름을 가진 애니메이션으로 애니메이션 그룹( AnimationGroups )을 생성할 수 있습니다. 사용자는 활성 애니메이션(active animation)을 설정하여 현재 애니메이션 컨트롤러로 제어되는 애니메이션 그룹을 선택할 수 있습니다. 그런 다음 제공된 위치 값에 스케일( positionScale ) 및 오프셋( positionOffset ) 값을 적용하여 조정된 후, 해당 위치가 해당 그룹으로 전달됩니다.
참고: 애니메이션 컨트롤러에는 내부 타이머가없으므로 , 사용자가 적시에 position 속성을 업데이트해야 합니다.
속성 설명서
activeAnimationGroup : int
현재 활성화된 애니메이션 그룹을 보관합니다.
animationGroups : list<AnimationGroup>
컨트롤러에 포함된 애니메이션 그룹 목록을 보관합니다.
entity : Entity
애니메이션이 수집되고 그룹화되는 엔티티를 보관합니다. 컨트롤러에 이미 애니메이션이 저장되어 있는 경우, 해당 애니메이션은 모두 삭제됩니다.
position : real
애니메이션의 현재 위치를 저장합니다. 위치가 설정되면 positionScale/positionOffset 를 통해 크기가 조정되고 오프셋이 적용된 후, 활성 애니메이션 그룹으로 전달됩니다.
positionOffset : real
애니메이션의 위치 오프셋을 저장합니다.
positionScale : real
애니메이션의 위치 스케일을 유지합니다.
recursive : bool
엔티티에서 애니메이션을 수집할 때 엔티티 트리를 재귀적으로 검색할지 여부를 지정합니다. true로 설정하면 해당 엔티티의 자식 엔티티에서도 애니메이션을 검색합니다. false로 설정하면 컨트롤러에 전달된 엔티티만 검색합니다.
메서드 문서
int getAnimationIndex(name)
name 를 사용하여 애니메이션의 인덱스를 반환합니다. 지정된 이름의 AnimationGroup 가 발견되지 않으면 -1을 반환합니다.
AnimationGroup getGroup(index)
지정된 ` index`을 가진 ` AnimationGroup `을 반환합니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.