VectorImage QML Type
Lädt eine Vektorgrafikdatei und zeigt sie in einer Qt Quick Szene an. Mehr...
| Import Statement: | import QtQuick.VectorImage |
| Since: | Qt 6.8 |
| Inherits: |
Eigenschaften
- animations
(since 6.10)- animations.loops : int
(since 6.10) - animations.paused : bool
(since 6.10)
- animations.loops : int
- assumeTrustedSource : bool
(since 6.10) - fillMode : enumeration
- preferredRendererType : enumeration
- source : url
Detaillierte Beschreibung
VectorImage kann verwendet werden, um eine Vektorgrafikdatei zu laden und diese als Element in einer Qt Quick Szene anzuzeigen.
Es unterstützt derzeit das SVG Dateiformat. Zusätzlich kann die Unterstützung von Lottie aktiviert werden, indem die Eigenschaft assumeTrustedSource auf true gesetzt und das Plugin aus dem Qt Lottie Animation Modul. Dieses Plugin befindet sich derzeit in der technischen Vorschau.
Hinweis: Dies ergänzt den Ansatz, die Vektorbilddatei über ein Image -Element zu laden: Image erstellt eine Rasterversion des Bildes in der gewünschten Größe. VectorImage erstellt eine Qt Quick Szene, die das Bild darstellt. Das bedeutet, dass das resultierende Element ohne Qualitätsverlust skaliert und gedreht werden kann und in der Regel weniger Speicherplatz benötigt als die gerasterte Version.
Dokumentation der Eigenschaften
Diese Eigenschaften können verwendet werden, um Animationen im Bild zu steuern, wenn es welche enthält.
Die Eigenschaft paused kann auf true gesetzt werden, um alle Animationen vorübergehend anzuhalten. Wenn die Eigenschaft auf false zurückgesetzt wird, werden die Animationen dort fortgesetzt, wo sie vorher waren. Standardmäßig ist diese Eigenschaft auf false eingestellt.
Die Eigenschaft loops legt fest, wie oft die Animationen im Dokument wiederholt werden. Standardmäßig ist diese Eigenschaft 1. Alle Animationen, die im Quellbild auf Endlosschleife eingestellt sind, werden von dieser Eigenschaft nicht beeinflusst. Um alle Animationen im Dokument unbegrenzt wiederholen zu lassen, kann die Eigenschaft loops auf Animation.Infinite gesetzt werden.
Diese QML-Eigenschaft wurde in Qt 6.10 eingeführt.
assumeTrustedSource : bool |
Das Setzen dieser Eigenschaft auf true beim Laden von vertrauenswürdigen Quelldateien erweitert die Unterstützung für einige Funktionen, die in einer unkontrollierten Umgebung unsicher sein könnten. Für SVG im Besonderen entspricht dies der AssumeTrustedSource option.
Wenn dies auf true gesetzt ist, versucht VectorImage auch, das Bild mit dem Lottie-Format-Plugin zu laden, wenn dieses verfügbar ist. Dieses Plugin befindet sich derzeit in der technischen Vorschau. Siehe Qt Lottie Animation für zusätzliche Informationen.
Standardmäßig ist diese Eigenschaft auf false gesetzt.
Diese Eigenschaft wurde in Qt 6.10 eingeführt.
Siehe auch svgtoqml und lottietoqml.
fillMode : enumeration |
Diese Eigenschaft definiert, was passiert, wenn die Breite und Höhe von VectorImage von der impliziten Größe des Inhalts abweicht.
| Konstante | Beschreibung |
|---|---|
VectorImage.NoResize | Der Inhalt wird weiterhin in der von der Eingabe vorgegebenen Größe gerendert. |
VectorImage.Stretch | Der Inhalt wird so skaliert, dass er mit der Breite und Höhe von VectorImage übereinstimmt (dies ist die Standardeinstellung). |
VectorImage.PreserveAspectFit | Der Inhalt wird so skaliert, dass er in die Begrenzungslinien von VectorImage passt, wobei das Seitenverhältnis erhalten bleibt. Das tatsächliche Begrenzungsrechteck des Inhalts wird manchmal kleiner sein als das Element VectorImage. |
VectorImage.PreserveAspectCrop | Der Inhalt wird so skaliert, dass er das Element VectorImage ausfüllt, wobei das Seitenverhältnis beibehalten wird. Die tatsächlichen Begrenzungen des Inhalts sind manchmal größer als das Element VectorImage. |
preferredRendererType : enumeration |
Fordert ein bestimmtes Backend an, das für das Rendern von Formen im VectorImage verwendet werden soll.
| Konstante | Beschreibung |
|---|---|
VectorImage.GeometryRenderer | Äquivalent zu Shape.GeometryRenderer. Dieses Backend glättet Kurven und trianguliert das Ergebnis. Es liefert Aliasing-Ergebnisse, es sei denn, Multi-Sampling ist aktiviert, und die Abflachung von Kurven kann sichtbar werden, wenn das Element skaliert wird. |
VectorImage.CurveRenderer | Äquivalent zu Shape.CurveRenderer. Mit diesem Backend werden Kurven auf der GPU gerendert und Anti-Aliasing ist eingebaut. Dies führt in der Regel zu besseren visuellen Ergebnissen, allerdings auf Kosten der Leistung. |
Der Standardwert ist VectorImage.GeometryRenderer.
source : url |
Diese Eigenschaft enthält die URL der zu ladenden Vektorgrafikdatei.
VectorImage unterstützt derzeit das Dateiformat SVG. Zusätzlich kann die Unterstützung von Lottie aktiviert werden, indem die Eigenschaft assumeTrustedSource auf true gesetzt und das Plugin aus dem Qt Lottie Animation Modul. Dieses Plugin befindet sich derzeit in der technischen Vorschau.
© 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.
