이 페이지에서

SpriteSequence3D QML Type

스프라이트 파티클에 대한 이미지 시퀀스 기능을 제공합니다. 더 보기...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

QtObject

속성

상세 설명

SpriteSequence3D 요소는 여러 프레임으로 구성된 애니메이션 이미지를 지원합니다. 프레임은 이미지 내에서 가로로 정렬되어야 하며, 첫 번째 프레임은 왼쪽에, 마지막 프레임은 오른쪽에 위치해야 합니다.

SpriteParticle3D 를 애니메이션 시퀀스로 만들려면 해당 요소의 ` spriteSequence ` 속성을 설정하십시오.

속성 설명

AnimationDirection : enumeration

시퀀스의 애니메이션 재생 방향을 정의합니다.

상수설명
SpriteSequence3D.Normal첫 번째 프레임에서 마지막 프레임까지 애니메이션을 재생합니다. 마지막 프레임에 도달하면 첫 번째 프레임으로 다시 돌아갑니다.
SpriteSequence3D.Reverse마지막 프레임에서 첫 번째 프레임으로 애니메이션을 재생합니다. 첫 번째 프레임에 도달하면 마지막 프레임으로 되돌아갑니다.
SpriteSequence3D.Alternate첫 번째 프레임부터 마지막 프레임까지 애니메이션을 재생합니다. 마지막 프레임이나 첫 번째 프레임에 도달하면 애니메이션 방향을 전환합니다. 이렇게 하면 첫 번째 프레임과 마지막 프레임이 일치하지 않더라도 시퀀스 애니메이션이 부드럽게 재생됩니다.
SpriteSequence3D.AlternateReverse마지막 프레임에서 첫 번째 프레임까지 애니메이션을 재생합니다. 마지막 프레임이나 첫 번째 프레임에 도달하면 애니메이션 방향을 전환합니다. 이를 통해 첫 번째 프레임과 마지막 프레임이 일치하지 않더라도 시퀀스 애니메이션이 부드럽게 재생됩니다.
SpriteSequence3D.SingleFrame프레임을 애니메이션 처리하지 않습니다. ` randomStart `가 false인 경우, ` frameIndex ` 프레임이 렌더링됩니다. ` randomStart `가 true인 경우, 각 파티클은 무작위 프레임을 렌더링합니다.

animationDirection : AnimationDirection

이 속성은 시퀀스의 애니메이션 방향을 정의합니다.

기본값은 ` SpriteSequence3D.Normal`입니다.

randomStart도 참조하십시오 .

duration : int

이 속성은 스프라이트 시퀀스가 애니메이션되는 데 걸리는 시간을 밀리초 단위로 정의합니다. 예를 들어, 지속 시간(duration)이 400 이고 프레임 수( frameCount )가 8인 경우, 각 프레임은 50밀리초 동안 표시됩니다. 값이 -1인 경우, 파티클의 수명(lifeSpan)이 지속 시간으로 사용됩니다.

기본값은 -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

이 속성은 애니메이션을 더 부드럽게 보이도록 프레임 간에 스프라이트를 보간(블렌딩)할지 여부를 정의합니다.

기본값은 ' true'입니다.

frameCount도 참조하십시오 .

randomStart : bool

이 속성은 애니메이션이 0 와 frameCount - 1 사이의 임의의 프레임에서 시작해야 하는지 여부를 정의합니다. 이를 통해 애니메이션이 시작될 때 모든 애니메이션이 마치 동시에 시작된 것처럼 보이지 않게 할 수 있습니다.

기본값은 false 입니다.

animationDirection도 참조하십시오 .

© 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.