Sprite QML Type

スプライトのアニメーションを指定します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• duration : int
• durationVariation : int
• frameCount : int
• frameDuration : int
• frameDurationVariation : int
• frameHeight : int
• frameRate : real
• frameRateVariation : real
• frameSync : bool
• frameWidth : int
• frameX : int
• frameY : int
• name : string
• randomStart : bool
• reverse : bool
• source : url
• to : QVariantMap

詳細な説明

スプライトは、SpriteSequence によってアニメーション化およびレンダリングされる1つ以上のフレームの系列を定義します。スプライトは、画像ファイルの中央に配置されていても、複数の行に分割されていてもかまいません。ただし、ファイルの左端からファイルの次の行へと折り返される、連続した行を形成している必要があります。

詳細については、「スプライトアニメーションの概要」を参照してください。

プロパティのドキュメント

duration : int

アニメーションの再生時間。0 未満の値は無効です。

frameRate が有効な場合、フレームの再生時間の計算にこれを使用します。有効でない場合で、frameDuration が有効な場合は、frameDuration を使用します。それ以外の場合は、durationが使用されます。

durationVariation : int

アニメーションの再生時間は、この値の範囲内で変動する可能性があります。変動によって、アニメーションの再生時間が0未満になることはありません。

durationVariationは、フレームの再生時間を計算する際にdurationが使用されている場合にのみ有効になります。

デフォルト値は 0 です。

frameCount : int

このスプライトのフレーム数。

frameDuration : int

アニメーションの各フレームの持続時間（ミリ秒単位）。0未満の値は無効です。

frameRate が有効な場合、フレームの持続時間の計算には が使用されます。 が無効で、かつframeDurationが有効な場合は、frameDurationが使用されます。それ以外の場合は、durationが使用されます。

frameDurationVariation : int

アニメーションの1フレームの持続時間は、この値の範囲内で変動する可能性があります。変動によって、アニメーションの長さが0未満になることはありません。

frameDurationVariationは、フレームの再生時間がframeDuration を使用して計算される場合にのみ有効になります。

デフォルト値は 0 です。

frameHeight : int

このスプライトにおける1フレームの高さ。

frameRate : real

アニメーションで表示する1秒あたりのフレーム数。0未満の値は無効です。

frameRateが有効な値である場合、フレームの持続時間の計算にそれが使用されます。そうでない場合、frameDuration が有効な値であれば、frameDuration が使用されます。それ以外の場合は、durationが使用されます。

frameRateVariation : real

アニメーション間のフレームレートは、この値の範囲内で変動する可能性があります。この変動によって、アニメーションの長さが0未満になることはありません。

frameRateVariationは、フレームの持続時間を計算するためにframeRate が使用されている場合にのみ有効になります。

デフォルト値は 0 です。

frameSync : bool

true に設定すると、アニメーションの持続時間はなくなります。その代わり、画面にフレームがレンダリングされるたびに、アニメーションが 1 フレームずつ進みます。これにより、経過時間ではなく描画レートに合わせてアニメーションが同期されます。

frameSync が true に設定されている場合、duration、frameRate 、およびframeDuration のすべての設定が上書きされます。

デフォルトは false です。

frameWidth : int

このスプライトにおける1フレームの幅。

frameX : int

スプライトの最初のフレームの画像ファイルにおけるX座標。

frameY : int

スプライトの最初のフレームの画像ファイルにおけるY座標。

name : string

他のスプライトの「to」プロパティで使用するための、このスプライトの名前。

randomStart : bool

true に設定すると、アニメーションは最初の再生時に、再生時間のランダムな分だけスキップして開始されます。これにより、アニメーションが開始されたときに、すべてのアニメーションが同時に始まったように見えるのを防ぐことができます。

この動作は、最初に再生されるアニメーションにのみ影響します。別のアニメーションへの遷移や、同じアニメーションの再再生では、この動作は発生しません。

デフォルトは false です。

reverse : bool

trueの場合、アニメーションは逆再生されます。

デフォルトは false です。

source : url

アニメーションの画像ソース。

frameHeight およびframeWidth が指定されていない場合、正方形のフレームが1つの長い行に並んでいるものとみなされます。それ以外の場合は、複数の連続した行または長方形のフレームとみなされ、1つの行が尽きると次の行が使用されます。

frameX およびframeY が指定された場合、その x/y 座標を左上隅として、そのフレームの行が使用されます。

to : QVariantMap

その他のスプライトと、それらへの重み付き遷移の一覧。例えば、{"a":1, "b":2, "c":0} のように指定すると、このスプライトの表示が終了した際、3分の1の確率でスプライト「a」へ、3分の2の確率でスプライト「b」へと遷移することを意味します。 遷移はランダムに選択されるため、これらの割合は正確には一致しません。リストに "c":0 が含まれている場合、どのスプライトもランダムに "c" へ遷移することはありませんが、スプライトのゴールが設定されていれば、それは有効なパスとなります。

リストが指定されていない場合、またはリスト内の重みの合計がゼロの場合、スプライトは完了後に自身を繰り返し再生します。