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の場合、パーティクルのライフスパンが持続時間として使用されます。

デフォルト値は-1 です。


durationVariation : int

このプロパティは、持続時間の変化をミリ秒単位で定義します。アニメーションの実際の継続時間はduration -durationVariationduration +durationVariation の間です。

デフォルト値は0 (変動なし)です。


frameCount : int

このプロパティは画像フレームの量をsprite で定義します。パーティクルはduration の間、これらのフレームを通してアニメーションします。フレームは、同じ画像ファイルに水平にレイアウトする必要があります。例えば、スプライトは 512x64 のイメージで、8frameCount があります。 この場合、各パーティクルのフレームサイズは64x64 ピクセルになります。

デフォルト値は1 です。

注意: 画像にスプライトフレームが1つしかない場合は、spriteSequence プロパティを定義しないでください。

interpolateも参照してください


frameIndex : int

このプロパティはフレームの初期インデックスを定義します。これは、アニメーションが開始されるフレーム間の位置です。例えば、frameIndex が 5 で、animationDirectionNormal の場合、最初のレンダリングフレームは 5 になります。animationDirectionReverse の場合、最初のレンダリングフレームは 4 になります。

frameIndex の値は、0 からframeCount -1 の間でなければなりません。animationDirectionSingleFramerandomStartfalse の場合、すべてのパーティクルはframeIndex でスプライトをレンダリングします。

デフォルト値は0 です。

randomStart およびanimationDirectionも参照してください


interpolate : bool

このプロパティは、アニメーションをより滑らかに見せるために、スプライトがフレーム間で補間(ブレンド)されるかどうかを定義します。

デフォルト値はtrue です。

frameCountも参照して ください。


randomStart : bool

このプロパティは、アニメーションを0frameCount -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.