SpriteSequence3D QML 类型

为 Sprite 粒子提供图像序列特性。更多信息...

属性

SpriteSequence3D 元素提供对多帧动画图片的支持。帧应该在图像中水平对齐，第一帧在左侧，最后一帧在右侧。

要使 SpriteParticle3D 成为动画序列，设置其 spriteSequence 属性。

AnimationDirection : 枚举

定义了序列的动画播放方向。

常量	描述
`SpriteSequence3D.Normal`	从第一帧到最后一帧进行动画。当达到最后一帧时，跳回到第一帧。
`SpriteSequence3D.Reverse`	从最后一帧到第一帧进行动画。当达到第一帧时，跳回到最后一帧。
`SpriteSequence3D.Alternate`	从第一帧到最后一帧进行动画。当达到最后一帧或第一帧时，切换动画方向。这使得即使在第一帧和最后一帧不匹配的情况下，序列动画也非常平滑。
`SpriteSequence3D.AlternateReverse`	从最后一帧到第一帧进行动画。当达到最后一帧或第一帧时，切换动画方向。这使得即使在第一帧和最后一帧不匹配的情况下，序列动画也非常平滑。
`SpriteSequence3D.SingleFrame`	不要动画化帧。当 randomStart 设置为 false 时，渲染 frameIndex 帧。当 randomStart 设置为 true 时，每个粒子渲染随机帧。

animationDirection : AnimationDirection

此属性定义序列的动画方向。

默认值是 SpriteSequence3D.Normal。

另请参阅randomStart。

duration : int

此属性定义精灵序列动画的持续时间（毫秒）。例如，如果持续时间设置为 400，且 frameCount 是 8，则每个帧将显示 50 毫秒。当值为 -1 时，使用粒子生命周期作为持续时间。

默认值是 -1。

durationVariation : int

此属性定义持续时间的变化（毫秒）。动画的实际持续时间在 duration - durationVariation 和 duration + durationVariation 之间。

默认值是 0（无变化）。

frameCount : int

此属性定义精灵中的图像帧数量。粒子在 duration 期间通过这些帧进行动画。帧应水平排列在同一图像文件中。例如，如果 sprite 是一个 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。

interpolate : bool

此属性定义是否在帧之间插值（混合）精灵，以使动画看起来更平滑。

默认值是 true。

另请参阅frameCount。

randomStart : bool

此属性定义动画是否应从0到frameCount（帧数）之间的随机帧开始。这允许动画在开始时不显得所有动画都是同时启动的。

默认值为false。

另请参阅动画方向。