SpriteSequence3D QML Type
Sprite パーティクルの画像シーケンス機能を提供します。詳細...
| 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
このプロパティは、シーケンスのアニメーション方向を定義します。
デフォルト値は `SpriteSequence3D.Normal` です。
「randomStart」も参照してください 。
duration : int
このプロパティは、スプライトシーケンスのアニメーション再生にかかる時間をミリ秒単位で定義します。たとえば、durationが400 で、frameCount が8の場合、各フレームは50ミリ秒間表示されます。値が-1の場合、パーティクルのlifespanがdurationとして使用されます。
デフォルト値は-1 です。
durationVariation : int
このプロパティは、持続時間の変動をミリ秒単位で定義します。アニメーションの実際の持続時間は、duration ~durationVariation およびduration ~durationVariation の範囲内となります。
デフォルト値は0 (変化なし)です。
frameCount : int
このプロパティは、sprite 内の画像フレーム数を定義します。パーティクルは、duration の間にこれらのフレームを順次表示します。フレームは、同じ画像ファイル内に水平方向に配置する必要があります。例えば、スプライトとして 512x64 の画像を使用し、frameCount を8 に設定できます。これにより、各パーティクルフレームのサイズは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」も参照してください 。
© 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.