VectorImage QML Type

ベクター画像ファイルを読み込み、Qt Quick シーンに表示します。もっと見る

Import Statement: import QtQuick.VectorImage
Since: Qt 6.8
Inherits:

Item

プロパティ

詳細説明

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

現在、SVG ファイル フォーマットをサポートしています。さらに、assumeTrustedSource プロパティを true に設定し、プラグインを Qt Lottie Animationモジュールからプラグインをインクルードすることで有効になります。このプラグインは現在、技術プレビューとされています。

注: これは、Image 要素を通してベクター画像ファイルを読み込むアプローチを補完するものです。Image は、要求されたサイズの画像のラスターバージョンを作成します。VectorImageは、画像を表すQt Quick シーンを構築します。つまり、出来上がったアイテムは、品質を失うことなく拡大縮小や回転が可能で、通常、ラスタライズされたバージョンよりも少ないメモリを消費します。

プロパティの説明

animations group

animations.loops : int [since 6.10]

animations.paused : bool [since 6.10]

これらのプロパティは、イメージにアニメーションが含まれている場合、それを制御するために使用できます。

paused プロパティを true に設定すると、すべてのアニメーションを一時的に停止することができます。このプロパティをfalse にリセットすると、アニメーションは元の状態に戻ります。デフォルトでは、このプロパティはfalse です。

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

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


assumeTrustedSource : bool [since 6.10]

この QML プロパティは、Qt 6.10 で導入されました。信頼できるソースファイルを読み込む際に、このプロパティを true に設定することで、制御されていない設定では安全でない可能性のあるいくつかの機能のサポートが拡張されます。特に SVG では、これはAssumeTrustedSource option に対応します。

これをtrueに設定すると、VectorImage 、Lottieフォーマットプラグインが利用可能であれば、それを使って画像を読み込もうとします。このプラグインは現在技術プレビューとされています。詳しくは Qt Lottie Animationを参照してください。

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

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

svgtoqmlや lottietoqmlも参照してください


fillMode : enumeration

このプロパティは、VectorImage の幅と高さが、そのコンテンツの暗黙のサイズと異なる場合に何が起こるかを定義します。

定数説明
VectorImage.NoResizeコンテンツは、入力によって提供されたサイズのままレンダリングされる。
VectorImage.Stretchコンテンツは、VectorImage の幅と高さに合うように拡大縮小されます(これはデフォルトです)。
VectorImage.PreserveAspectFitアスペクト比を維持したまま、コンテンツはVectorImage の境界内に収まるように拡大縮小されます。内容物の実際の外接矩形は、VectorImage 項目 よ り も 小 さ く な る こ と があ り ます。
VectorImage.PreserveAspectCrop内容は、 縦横比を保ちつつ、VectorImage 項目いっぱいに収ま る よ う 縮小 さ れます。コンテンツの実際の境界は、VectorImage アイテムよりも大きくなることがあります。

preferredRendererType : enumeration

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

定数説明
VectorImage.GeometryRendererShape.GeometryRendererに相当します。このバックエンドは、曲線を平坦化し、結果を三角形化します。マルチサンプリングが有効でない限り、エイリアスされた結果が得られ、アイテムが拡大縮小されると、曲線の平坦化が表示されることがあります。
VectorImage.CurveRendererShape.CurveRendererに相当します。このバックエンドでは、曲線はGPUでレンダリングされ、アンチエイリアスが組み込まれます。通常、より良いビジュアル結果が得られますが、パフォーマンスには余分なコストがかかります。

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


source : url

このプロパティは、読み込むベクター画像ファイルのURLを保持します。

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


© 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.