このページでは

SpriteSequence3D QML Type

Sprite パーティクルの画像シーケンス機能を提供します。詳細...

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