Back to Qt.io
Contact Us Blog Download Qt

AnimatedImage QML Type

一連の画像として保存されたアニメーションを再生します。もっと詳しく...

Import Statement: import QtQuick
Inherits:

Image

プロパティ

詳細説明

AnimatedImage型は、Image 型の機能を拡張し、GIFファイルに保存されているような、一連のフレームを含む画像として保存されているアニメーションを再生する方法を提供します。

アニメーションの現在のフレームと合計の長さに関する情報は、currentFrame とframeCount プロパティを使用して取得できます。playing とpaused プロパティの値を変更することで、アニメーションを開始、一時停止、停止することができます。

サポートされているフォーマットの全リストは、QMovie::supportedFormats() で確認できます。

使用例

次のQMLは、アニメーション画像を表示し、その状態に関する情報（現在のフレームや総フレーム数など）を取得する方法を示しています。結果は、アニメーション画像とその下に表示される単純な進捗インジケータです。

注意：アニメーション画像がキャッシュされる場合、アニメーションのすべてのフレームがキャッシュされます。

長いアニメーションや大きなアニメーションを再生していて、メモリを節約したい場合は、cacheをfalseに設定してください。

画像データがシーケンシャルデバイス（ソケットなど）から来る場合、AnimatedImageはcacheがtrueに設定されている場合のみループすることができます。


import QtQuick

Rectangle {
    width: animation.width; height: animation.height + 8

    AnimatedImage { id: animation; source: "animation.gif" }

    Rectangle {
        property int frames: animation.frameCount

        width: 4; height: 8
        x: (animation.width - width) * animation.currentFrame / frames
        y: animation.height
        color: "red"
    }
}

BorderImage およびImageも参照してください 。

プロパティ ドキュメント

currentFrame : int

frameCount : int [read-only]

currentFrame は現在表示されているフレームです。このプロパティの変化を監視することで、画像と同時に他のアイテムをアニメーションさせることができます。

frameCount はアニメーションのフレーム数です。いくつかのアニメーションフォーマットでは、 は不明で、値はゼロです。frameCount


paused : bool

このプロパティは、アニメーション画像を一時停止するかどうかを保持します。

デフォルトでは、このプロパティは false です。アニメーションを一時停止したい場合は、このプロパティを true に設定します。


playing : bool

このプロパティは、アニメーション画像が再生中かどうかを保持します。

デフォルトでは、このプロパティはtrueです。つまり、アニメーションはすぐに再生を開始します。

注意：このプロパティは、AnimatedImage の実際の再生状態の変更に影響されます。アニメーション以外の画像が使用されている場合、次の画像をアニメーション化するには、playing を手動でtrue に設定する必要があります。

AnimatedImage {
    onStatusChanged: playing = (status == AnimatedImage.Ready)
}

source : url

このプロパティは、ソース画像を参照するURLを保持する。

AnimatedImage このプロパティは、Qt がサポートする URL スキームからロードされた、Qt がサポートするすべての画像フォーマットを扱うことができます。ただし、 とは互換性がありません。QQuickImageProvider


sourceSize : size

このプロパティは、フルフレームイメージのスケーリングされた幅と高さを保持します。

このプロパティは、width とheight プロパティとは異なり、画像の描画をスケーリングします。このプロパティは、キャッシュされるフレームの最大ピクセル数を設定し、大きなアニメーションが必要以上のメモリを使用しないようにします。

元のサイズがsourceSize より大きい場合、画像は縮小されます。

このプロパティをundefined に設定することで、画像の自然なサイズを復元できます。

注意： このプロパティを動的に変更すると、画像ソースがディスクキャッシュにない場合、ネットワークからであっても再読み込みされる可能性があります。

Image::sourceSizeも参照してください 。


speed : real [since QtQuick 2.11]

このプロパティは、アニメーションの速度を保持します。

速度は、元のアニメーション画像の速度に対するパーセンテージで測定されます。デフォルトの速度は 1.0（元の速度）です。

このプロパティは、QtQuick 2.11 で導入されました。


©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。