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

C

AnimatedSpriteDirectory QML Type

ディレクトリに保存されたスプライトアニメーションを描画します。詳細...

Import Statement: import QtQuickUltralite.Extras 2.12
Since: Qt Quick Ultralite 2.4
Inherits:

Item

プロパティ

信号

方法

詳細説明

AnimatedSpriteDirectory 型はスプライト・アニメーション用の画像を取得すること以外はAnimatedSprite と同じ動作をします。sourcePath 、一連の画像を持つディレクトリパスが必要です。これらの画像はスプライト・アニメーションのフレームであり、AnimatedSpriteDirectory はAnimatedSprite と同様に各画像を再生します。

アニメーション・フレームの順序は、ImageFilesノードの画像のリスト順序に従います。これらの画像ファイルにImageFiles.MCU.resourceAnimatedSpriteタグを付け、Qt Quick Ultralite Toolsがスプライト・アニメーション・フレームの候補として識別できるようにします。また、これらの画像にタグを付けることで、ディレクトリ名を識別し、各画像を正しくレンダリングすることができます。

QMLQMLプロジェクトでの画像宣言
 
import QtQuickUltralite.Extras

AnimatedSpriteDirectory {
    sourcePath: "loading"
}
    ImageFiles {
        files: [
            "loading/01.png",
            "loading/02.png",
            "loading/03.png",
            "loading/04.png"
        ]
        MCU.resourceAnimatedSprite: true
    }

AnimatedSprite とは異なり、AnimatedSpriteDirectory はframeCount 、frameWidth 、frameHeight プロパティを持ちません。これらの値は、指定されたディレクトリ内の画像から取得します。ディレクトリ内の画像の数をframeCount 、画像の幅と高さをそれぞれframeWidth とframeHeight とします。

注意： すべてのイメージの幅と高さが同じでなければ、リソースコンパイラ（qulrccツール）は生のイメージデータを生成できません。

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

プロパティ ドキュメント

currentFrame : int

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


frameDuration : int

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

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


loops : int

アニメーションの再生回数を指定します。正の値のみ有効です。

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

デフォルトはAnimatedSpriteDirectory.Infinite です。


paused : bool

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

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

デフォルトはfalse


running : bool

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

デフォルトはtrue 。


sourcePath : string

スプライトアニメーションの画像があるディレクトリへのパス。ImageFilesノードのImageFiles.MCU.resourceAnimatedSpriteプロパティをtrue に設定することで、パス内の画像にタグを付けます。

注意： 画像にタグ付けしない場合、指定されたsourcePath は無効です。


シグナルの説明

finished()

このシグナルは、スプライト・アニメーションが完了したことを示す。

running プロパティをfalse に設定した場合、またはloops プロパティをAnimatedSpriteDirectory.Infinite に設定した場合は、このシグナルは出力されません。

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


メソッドの説明

advance()

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


pause()

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


restart()

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


resume()

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


start()

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


stop()

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


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