Back to Qt.io
Contact Us Blog Download Qt
このページでは

C

AnimatedSprite QML Type

スプライトのアニメーションを描画します。もっと詳しく...

Import Statement: import QtQuick
Since: Qt Quick Ultralite 2.3
Inherits:

Item

プロパティ

信号

方法

詳細説明

AnimatedSpriteは、1つの画像ファイルに複数のフレームとして提供されるアニメーションをレンダリングし、制御する。固定速度で再生することも、手動で進めて制御することもできる。

次のスプライト・シートを考えてみよう：

これは4つのフレームに分割することができます：

次のコードを使って、それぞれのフレームを1フレームあたり500ミリ秒の速度で再生します：

コード結果
 
import QtQuick 2.15

AnimatedSprite {
    source: "loading.png"
    frameWidth: 64
    frameHeight: 64
    frameCount: 4
    frameDuration: 500
}

プロパティ説明

currentFrame : int

アニメーションが一時停止しているときに、現在のフレームを手動で進めるには、このプロパティを設定します。advance() メソッドを呼び出すこともできます。


frameCount : int

AnimatedSprite のフレーム数を示します。


frameDuration : int

アニメーションの各フレームの継続時間をミリ秒単位で表します。正の値のみが有効です。

アニメーションがアクティブな状態でこのプロパティを変更すると、アニメーションが再開されます。


frameHeight : int

AnimatedSprite の 1 フレームの高さを設定します。


frameWidth : int

AnimatedSprite で1フレームの幅を設定します。


loops : int

アニメーションをこの回数再生すると、アニメーションは自動的に停止します。正の値のみ有効です。

アニメーションを無限に再生するには、AnimatedSprite.Infinite に設定します。

デフォルトはAnimatedSprite.Infinite 。


paused : bool [since Qt Quick Ultralite 2.5]

アニメーションを一時停止するかどうかを示します。

アニメーションが一時停止しているときは、現在のフレームを手動で進めることができます。

デフォルトはfalse

このプロパティはQt Quick Ultralite 2.5 で導入されました。


running : bool

アニメーションが再生されているかどうかを示します。

デフォルトはtrue


source : string

アニメーションのイメージソース。

ImageFiles.MCU.resourceAnimatedSpriteFrameWidthと ImageFiles.MCU.resourceAnimatedSpriteFrameHeightで画像ソースのフレームサイズを指定することで、画像をフレームシーケンスに分割し、それらの間で共通部分を共有することによるリソースの最適化が可能になります。

リソースの管理」も参照してください 。


シグナルの説明

finished()

このシグナルは、スプライト・アニメーションが完了したときに発せられる。

running プロパティがfalse に設定されている場合、またはloops プロパティがAnimatedSprite.Infinite に設定されている場合は、このシグナルは発行されません。

注意： 対応するハンドラはonFinished です。


メソッドの説明

advance()

スプライトアニメーションを1フレーム進めます。


[since Qt Quick Ultralite 2.5] pause()

スプライトのアニメーションを一時停止します。paused がtrue の場合は何もしません。

このメソッドはQt Quick Ultralite 2.5で導入されました。


restart()

スプライトアニメーションを再開します。


[since Qt Quick Ultralite 2.5] resume()

paused がtrue の場合、スプライトのアニメーションを再開します。そうでない場合は何もしません。

このメソッドはQt Quick Ultralite 2.5 で導入された。


start()

スプライトアニメーションを開始します。アニメーションがすでに実行されている場合、このメソッドを呼び出しても効果はありません。


stop()

スプライト・アニメーションを停止します。アニメーションが実行されていない場合、このメソッドを呼び出しても効果はありません。


特定の Qt ライセンスの下で利用可能です。
詳細はこちら。