SpriteSequence3D QML Type
스프라이트 파티클에 이미지 시퀀스 기능을 제공합니다. 더 보기...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: |
속성
- AnimationDirection : enumeration
- animationDirection : AnimationDirection
- duration : int
- durationVariation : int
- frameCount : int
- frameIndex : int
- interpolate : bool
- randomStart : bool
상세 설명
SpriteSequence3D 요소는 여러 프레임이 있는 애니메이션 이미지를 지원합니다. 프레임은 이미지에서 가로로 정렬되어야 하며 첫 번째 프레임은 왼쪽에, 마지막 프레임은 오른쪽에 있어야 합니다.
SpriteParticle3D 를 애니메이션 시퀀스로 만들려면 spriteSequence 속성을 설정합니다.
속성 문서
AnimationDirection : enumeration |
시퀀스의 애니메이션 재생 방향을 정의합니다.
| Constant | 설명 |
|---|---|
SpriteSequence3D.Normal | 첫 번째 프레임부터 마지막 프레임까지 애니메이션을 재생합니다. 마지막 프레임에 도달하면 첫 번째 프레임으로 돌아갑니다. |
SpriteSequence3D.Reverse | 마지막 프레임에서 첫 번째 프레임으로 애니메이션을 재생합니다. 첫 번째 프레임에 도달하면 마지막 프레임으로 다시 이동합니다. |
SpriteSequence3D.Alternate | 첫 번째 프레임에서 마지막 프레임으로 애니메이션을 적용합니다. 마지막 또는 첫 번째 프레임에 도달하면 애니메이션 방향을 전환합니다. 이렇게 하면 첫 번째 프레임과 마지막 프레임이 일치하지 않더라도 시퀀스 애니메이션이 부드러워집니다. |
SpriteSequence3D.AlternateReverse | 마지막 프레임에서 첫 번째 프레임으로 애니메이션을 적용합니다. 마지막 프레임 또는 첫 번째 프레임에 도달하면 애니메이션 방향을 전환합니다. 이렇게 하면 첫 번째 프레임과 마지막 프레임이 일치하지 않더라도 시퀀스 애니메이션이 부드러워집니다. |
SpriteSequence3D.SingleFrame | 프레임에 애니메이션을 적용하지 않습니다. randomStart 이 거짓이면 frameIndex 프레임이 렌더링됩니다. randomStart 이 참이면 각 파티클이 임의의 프레임을 렌더링합니다. |
animationDirection : AnimationDirection |
duration : int |
이 속성은 스프라이트 시퀀스가 애니메이션되는 데 걸리는 시간을 밀리초 단위로 정의합니다. 예를 들어 지속 시간이 400 이고 frameCount 이 8이면 각 프레임이 50밀리초 동안 표시됩니다. 값이 -1이면 파티클 수명이 지속 시간으로 사용됩니다.
기본값은 -1 입니다.
durationVariation : int |
이 프로퍼티는 밀리초 단위로 지속 시간 변화를 정의합니다. 애니메이션의 실제 지속 시간은 duration - durationVariation 과 duration + durationVariation 사이입니다.
기본값은 0 (변동 없음)입니다.
frameCount : int |
이 프로퍼티는 sprite 에서 이미지 프레임의 양을 정의합니다. 파티클은 duration 동안 이 프레임을 통해 애니메이션을 진행합니다. 프레임은 동일한 이미지 파일에 가로로 배치되어야 합니다. 512x64 예를 들어 스프라이트는 frameCount 의 8 이미지가 될 수 있습니다. 이렇게 하면 각 파티클 프레임 크기가 64x64 픽셀이 됩니다.
기본값은 1 입니다.
참고: 이미지에 스프라이트 프레임이 하나만 있는 경우 spriteSequence 속성을 전혀 정의하지 마세요.
interpolate 를참조하세요 .
frameIndex : int |
이 속성은 프레임의 초기 인덱스를 정의합니다. 이 인덱스는 애니메이션이 시작되는 프레임 사이의 위치입니다. 예를 들어 frameIndex 가 5이고 animationDirection 가 Normal 인 경우 첫 번째 렌더링된 프레임은 5입니다. animationDirection 가 Reverse 인 경우 첫 번째 렌더링된 프레임은 4입니다.
frameIndex의 값은 0에서 frameCount - 1 사이여야 합니다. animationDirection 가 SingleFrame 이고 randomStart 가 false 인 경우 모든 파티클은 frameIndex 로 스프라이트를 렌더링합니다.
기본값은 0 입니다.
randomStart 와 animationDirection도 참조하십시오 .
interpolate : bool |
randomStart : bool |
이 속성은 애니메이션을 0 와 frameCount - 1 사이의 임의 프레임에서 시작할지 여부를 정의합니다. 이렇게 하면 애니메이션이 시작될 때 애니메이션이 모두 방금 시작된 것처럼 보이지 않게 할 수 있습니다.
기본값은 false 입니다.
animationDirection도 참조하세요 .
© 2025 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.
