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 |
シーケンスのアニメーション再生方向を定義します。
定数 | 説明 |
---|---|
SpriteSequence3D.Normal | 最初のフレームから最後のフレームまでアニメートする。最後のフレームに達すると、最初のフレームにジャンプして戻ります。 |
SpriteSequence3D.Reverse | 最後のフレームから最初のフレームにアニメートする。最初のフレームに達すると、最後のフレームにジャンプバックする。 |
SpriteSequence3D.Alternate | 最初のフレームから最後のフレームまでアニメートする。最後のフレームまたは最初のフレームに到達したら、アニメーションの方向を切り替えます。これにより、最初のフレームと最後のフレームが一致しない場合でも、シーケンス・アニメーションが滑らかになります。 |
SpriteSequence3D.AlternateReverse | 最後のフレームから最初のフレームにアニメートします。最後のフレームまたは最初のフレームに到達したら、アニメーションの方向を切り替えます。これにより、最初と最後のフレームが一致していなくても、シーケンス・アニメーションは滑らかになります。 |
SpriteSequence3D.SingleFrame | フレームをアニメーションさせない。randomStart が false の場合、frameIndex フレームがレンダリングされます。randomStart が true の場合、各パーティクルはランダムなフレームをレンダリングします。 |
animationDirection : AnimationDirection |
duration : int |
このプロパティは、スプライトシーケンスがアニメーションするまでの時間をミリ秒単位で定義します。例えば、duration が400
で、frameCount が 8 の場合、各フレームは 50 ミリ秒表示されます。値が-1の場合、パーティクルのライフスパンが持続時間として使用されます。
デフォルト値は-1
です。
durationVariation : int |
このプロパティは、持続時間の変化をミリ秒単位で定義します。アニメーションの実際の継続時間はduration
-durationVariation
とduration
+durationVariation
の間です。
デフォルト値は0
(変動なし)です。
frameCount : int |
このプロパティは画像フレームの量をsprite で定義します。パーティクルはduration の間、これらのフレームを通してアニメーションします。フレームは、同じ画像ファイルに水平にレイアウトする必要があります。例えば、スプライトは 512x64
のイメージで、8
のframeCount
があります。 この場合、各パーティクルのフレームサイズは64x64
ピクセルになります。
デフォルト値は1
です。
注意: 画像にスプライトフレームが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も参照してください 。
©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。