C

AnimatedSpriteDirectory QML Type

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

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

継承されたメンバを含む全メンバのリスト

プロパティ

currentFrame : int
frameDuration : int
loops : int
paused : bool
running : bool
sourcePath : string

信号

void finished()

方法

void advance()
void pause()
void restart()
void resume()
void start()
void stop()

詳細説明

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

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

QML QMLプロジェクトでの画像宣言

QML	QMLプロジェクトでの画像宣言
`import QtQuickUltralite.Extras AnimatedSpriteDirectory { sourcePath: "loading" }`	`ImageFiles { files: [ "loading/01.png", "loading/02.png", "loading/03.png", "loading/04.png" ] MCU.resourceAnimatedSprite: true }`

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 は無効です。

シグナル・ドキュメント

void finished()

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

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

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

メソッドのドキュメント

void advance()

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

void pause()

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

void restart()

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

void resume()

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

void start()

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

void stop()

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

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