VectorImage QML Type
ベクター画像ファイルを読み込み、Qt Quick シーンに表示します。もっと見る
| Import Statement: | import QtQuick.VectorImage |
| Since: | Qt 6.8 |
| Inherits: |
プロパティ
- animations
(since 6.10)- animations.loops : int
(since 6.10) - animations.paused : bool
(since 6.10)
- animations.loops : int
- assumeTrustedSource : bool
(since 6.10) - asynchronousShapes : bool
(since 6.11) - fillMode : enumeration
- preferredRendererType : enumeration
- source : url
詳細説明
VectorImage は、ベクター画像ファイルを読み込んで、Qt Quick シーン内のアイテムとして表示するために使用できます。
現在、SVG ファイル フォーマットをサポートしています。さらに、assumeTrustedSource プロパティを true に設定し、プラグインを Qt Lottie Animationモジュールからプラグインをインクルードします。
注: これは、Image 要素を通してベクター画像ファイルをロードするアプローチを補完します:Image は、要求されたサイズで画像のラスターバージョンを作成します。VectorImageは、画像を表すQt Quick シーンを構築します。これは、結果として得られるアイテムが、品質を失うことなく拡大縮小や回転が可能であり、一般的にラスタライズされたバージョンよりも少ないメモリを消費することを意味します。
プロパティの説明
animations group
これらのプロパティは、画像にアニメーションが含まれている場合、そのアニメーションを制御するために使用できます。
paused プロパティを true に設定すると、すべてのアニメーションを一時的に停止できます。こ のプ ロ パテ ィ をfalse に再設定す る と 、 ア ニ メ ーシ ョ ンは元に戻 り ます。デフォルトでは、このプロパティはfalse です。
loops プロパティは、ドキュメント内のアニメーションが繰り返される回数を定義します。ソース画像で無期限にループするように設定されているアニメーションは、このプロパティの影響を受けません。ドキュメント内のすべてのアニメーションを無期限に繰り返すようにするには、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も参照してください 。
asynchronousShapes : bool [since 6.11]
このプロパティは、QtQuick.Shapes::Shape::asynchronous}{asynchronous} プロパティを制御し、VectorImage がイメージを表現するために構築するクイックシーンのShape アイテムを制御します。
このプロパティをtrue に設定すると、シェイプのレンダリング処理の CPU 部分が別々のワーカースレッドにオフロードされます。これにより、CPU使用率とユーザーインターフェイスの応答性が向上します。
デフォルトでは、このプロパティはfalse です。
このプロパティは Qt 6.11 で導入されました。
fillMode : enumeration
このプロパティは、VectorImage の幅と高さが、そのコンテンツの暗黙のサイズと異なる場合に何が起こるかを定義します。
| 定数 | 説明 |
|---|---|
VectorImage.NoResize | コンテンツは入力によって提供されたサイズのままレンダリングされる。 |
VectorImage.Stretch | コンテンツは、VectorImage の幅と高さに合うように拡大縮小されます(これはデフォルトです)。 |
VectorImage.PreserveAspectFit | アスペクト比を維持したまま、コンテンツはVectorImage の境界内に収まるように拡大縮小されます。内容物の実際の外接矩形は、VectorImage 項目 よ り も 小 さ く な る こ と があ り ます。 |
VectorImage.PreserveAspectCrop | 内容は、 縦横比を保ちつつ、VectorImage 項目いっぱいに収ま る よ う 縮小 さ れます。内容の実際の境界は、VectorImage 項目 よ り も 大き く な る こ と があ り ます。 |
preferredRendererType : enumeration
VectorImage の図形のレンダリングに使用する特定のバックエンドを要求します。
| 定数 | 説明 |
|---|---|
VectorImage.GeometryRenderer | Shape.GeometryRenderer に相当します。このバックエンドは、曲線を平坦化し、結果を三角形化します。マルチサンプリングが有効でない限り、エイリアスされた結果が得られ、アイテムが拡大縮小されると、曲線の平坦化が表示されることがあります。 |
VectorImage.CurveRenderer | Shape.CurveRendererに相当します。このバックエンドでは、曲線はGPUでレンダリングされ、アンチエイリアスが組み込まれます。通常、より良いビジュアル結果が得られますが、パフォーマンスには余分なコストがかかります。 |
デフォルトはVectorImage.GeometryRenderer です。
source : url
このプロパティは、ロードするベクター画像ファイルの URL を保持する。
VectorImage 現在、SVG ファイル形式をサポートしています。さらに、assumeTrustedSource プロパティを true に設定し、プラグインを Qt Lottie Animationモジュールからプラグインをインクルードします。
© 2026 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.