このページでは

Sprite QML Type

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

Import Statement: import QtQuick

プロパティ

詳細説明

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

詳しくはスプライトアニメーションの概要をご覧ください。

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

duration : int

アニメーションの継続時間。0以下の値は無効です。

frameRate が有効な場合、フレームの持続時間を計算するために使用されます。そうでなく、frameDuration が有効な場合は、frameDuration が使用されます。そうでない場合は duration が使用されます。

durationVariation : int

アニメーションの長さは、この量まで変化させることができます。Variation がアニメーションの長さを 0 より短くすることはありません。

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

デフォルトは 0 です。

frameCount : int

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

frameDuration : int

アニメーションの各フレームの継続時間(ミリ秒)。0以下の値は無効です。

frameRate が有効な場合、フレームの継続時間を計算するために使用されます。そうでなく、frameDurationが有効な場合は、frameDurationが使用されます。そうでない場合は duration が使用されます。

frameDurationVariation : int

アニメーションの1フレームの長さは、この量まで変化します。Variation はアニメーションの長さを 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、frameRateframeDuration のすべてが上書きされます。

デフォルトはfalseです。

frameWidth : int

スプライト内の1フレームの幅。

frameX : int

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

frameY : int

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

name : string

このスプライトの名前で、他のスプライトのtoプロパティで使用します。

randomStart : bool

trueを指定すると、アニメーションは最初のアニメーションをランダムな時間スキップして開始します。これにより、アニメーションが始まったときに、すべてが始まったように見えなくなります。

これは最初に再生されるアニメーションにのみ影響します。別のアニメーションに移行したり、同じアニメーションが再び再生されたりしても、この効果は発生しません。

デフォルトは false です。

reverse : bool

trueを指定すると、アニメーションを逆再生する。

デフォルトはfalseです。

source : url

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

frameHeightframeWidth が指定されていない場合は、正方形のフレームが一列に並んだものとみなされます。そうでない場合は、複数の連続した行または長方形のフレームにすることができ、1つの行がなくなると次の行が使用されます。

frameXframeY が指定された場合、その x/y 座標を左上隅とする枠の行が取られる。

to : QVariantMap

例えば、{"a":1, "b":2, "c":0}のように、他のスプライトのリストとそれらへの遷移の重み付けを指定すると、このスプライトが終わったときに3分の1がスプライト "a "に遷移し、このスプライトが終わったときに3分の2がスプライト "b "に遷移することになります。トランジションはランダムに選択されるので、この比率は正確ではありません。リストに "c":0を指定すると、どのスプライトもランダムに "c "に遷移しませんが、スプライトのゴールが設定されている場合は有効なパスになります。

リストが指定されていない場合,またはリストの重みの合計が0である場合,スプライトは完了後に繰り返し実行されます.

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