AnimatedImage QML Type
一連の画像として保存されたアニメーションを再生します。もっと詳しく...
| Import Statement: | import QtQuick |
| Inherits: |
プロパティ
- currentFrame : int
- frameCount : int
- paused : bool
- playing : bool
- source : url
- sourceSize : size
- speed : real
(since QtQuick 2.11)
詳細な説明
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 は現在表示されているフレームです。このプロパティの変化を監視することで、画像と同時に他のアイテムをアニメーションさせることができます。
frameCount はアニメーションのフレーム数です。いくつかのアニメーションフォーマットでは、 は不明であり、値は 0 です。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 |
このプロパティは、アニメーションの速度を保持します。
速度は、元のアニメーション画像の速度に対するパーセンテージで測定されます。デフォルトの速度は 1.0（元の速度）です。
このプロパティは QtQuick 2.11 で導入されました。
© 2025 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.
