VectorImage QML Type

ベクター画像ファイルを読み込み、Qt Quick のシーンに表示します。詳細...

• 継承されたメンバーを含むすべてのメンバーの一覧

プロパティ

• animations (since 6.10)
  • animations.loops : int (since 6.10)
  • animations.paused : bool (since 6.10)
• assumeTrustedSource : bool (since 6.10)
• asynchronous : bool (since 6.12)
• asynchronousShapes : bool (since 6.11)
• fillMode : enumeration
• generatedItem : Item (since 6.12)
• preferredRendererType : enumeration
• retainWhileLoading : bool (since 6.12)
• source : url
• status : enumeration (since 6.12)

詳細な説明

VectorImage を使用すると、ベクター画像ファイルを読み込み、Qt Quick のシーン内でアイテムとして表示することができます。

現在、SVG ファイル形式に対応しています。さらに、assumeTrustedSource プロパティをtrueに設定し、 Qt Lottie Animation モジュールからプラグインを組み込むことで有効にできます。

プロパティのドキュメント

animations group

画像にアニメーションが含まれている場合、これらのプロパティを使用してアニメーションを制御することができます。

paused プロパティをtrueに設定すると、すべてのアニメーションを一時的に一時停止できます。このプロパティがfalse にリセットされると、アニメーションは中断した箇所から再開されます。デフォルトでは、このプロパティはfalse に設定されています。

loops プロパティは、ドキュメント内のアニメーションが繰り返される回数を定義します。デフォルトでは、このプロパティは1に設定されています。ソース画像で無限ループに設定されているアニメーションは、このプロパティの影響を受けません。ドキュメント内のすべてのアニメーションを無限に繰り返すには、loops プロパティをAnimation.Infinite に設定します。

これらのプロパティは Qt 6.10 で導入されました。

assumeTrustedSource : bool [since 6.10]

信頼できるソースファイルを読み込む際にこれを「true」に設定すると、制御されていない環境では安全でない可能性がある一部の機能のサポートが拡張されます。特にSVGの場合、これはAssumeTrustedSource option に対応します。

この設定が true に設定されている場合、VectorImage は、利用可能な場合は Lottie 形式のプラグインを使用して画像を読み込もうとします。詳細については Qt Lottie Animation を参照してください。

デフォルトでは、このプロパティは `false` です。

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

svgtoqmlおよびlottietoqmlも参照してください 。

asynchronous : bool [since 6.12]

このプロパティは、画像が非同期で読み込まれるかどうかを指定します。true に設定すると、画像の読み込み中も UI は反応し続けます。現在の進行状況を確認するには、status プロパティを使用できます。

デフォルトでは、このプロパティは `false` に設定されています。

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

「 asynchronousShapes 」および「status 」も参照してください 。

asynchronousShapes : bool [since 6.11]

このプロパティは、VectorImage が画像を表現するために生成するQuickシーン内のShape 項目の{QtQuick.Shapes::Shape::asynchronous}{asynchronous}プロパティを制御します。

このプロパティをtrue に設定すると、シェイプのレンダリング処理のうちCPUで実行される部分が、個別のワーカースレッドにオフロードされます。これにより、CPU使用率の向上やユーザーインターフェースの応答性の向上が期待できます。

デフォルトでは、このプロパティは `false` に設定されています。

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

「asynchronous」も参照してください 。

fillMode : enumeration

このプロパティは、VectorImage の幅と高さが、その内容物の暗黙的なサイズと異なる場合に、どのように処理されるかを定義します。

generatedItem : Item [read-only, since 6.12]

ベクター画像ファイルが読み込まれると、このプロパティには、生成されたQt Quick シーンの最上位のItemが格納されます。ファイルが読み込まれていない場合、このプロパティの値はnull となります。

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

preferredRendererType : enumeration

VectorImage で図形をレンダリングする際に使用する特定のバックエンドを指定します。

デフォルトはVectorImage.GeometryRenderer です。

retainWhileLoading : bool [since 6.12]

このプロパティは、source プロパティが変更され、読み込みが非同期で行われる場合の動作を定義します。これは、asynchronous プロパティがtrue に設定されている場合に該当します。

retainWhileLoading がfalse （デフォルト）の場合、古い画像は直ちに破棄され、新しい画像の読み込み中はコンポーネントがクリアされます。true に設定されている場合、古い画像は保持され、新しい画像の準備が整うまで表示されたままになります。

このプロパティを有効にすると、新しい画像の読み込みに時間がかかる場合に発生するちらつきを防ぐことができます。その代償として、新しい画像の読み込み中は、若干の追加メモリ使用が発生します。

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

asynchronousも参照してください 。

source : url

このプロパティには、読み込むベクター画像ファイルのURLが格納されます。

VectorImage 現在、SVG ファイル形式をサポートしています。また、assumeTrustedSource プロパティをtrueに設定し、 Qt Lottie Animation モジュールからプラグインをインクルードすることで、Lottieのサポートを有効にできます。

status : enumeration [since 6.12]

このプロパティは、ベクター画像の読み込み状況を保持します。次のいずれかの値を取ります：

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