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) - asynchronousShapes : bool
(since 6.11) - 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.
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 baut eine Qt Quick Szene auf, 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 Eigenschaft
animations group
Diese Eigenschaften können verwendet werden, um Animationen im Bild zu steuern, sofern es welche enthält.
Die Eigenschaft paused kann auf true gesetzt werden, um alle Animationen vorübergehend zu unterbrechen. 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 Eigenschaften wurden in Qt 6.10 eingeführt.
assumeTrustedSource : bool [since 6.10]
Wenn dies beim Laden von vertrauenswürdigen Quelldateien auf true gesetzt wird, wird die Unterstützung für einige Funktionen erweitert, 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. 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.
asynchronousShapes : bool [since 6.11]
Diese Eigenschaft steuert die {QtQuick.Shapes::Shape::asynchronous}{asynchronous} Eigenschaft der Shape Elemente in der Quick-Szene, die VectorImage zur Darstellung des Bildes aufbaut.
Wenn Sie diese Eigenschaft auf true setzen, wird der CPU-Teil der Rendering-Verarbeitung der Formen auf separate Worker-Threads ausgelagert. Dies kann die CPU-Auslastung und die Reaktionsfähigkeit der Benutzeroberfläche verbessern.
Standardmäßig ist diese Eigenschaft auf false eingestellt.
Diese Eigenschaft wurde in Qt 6.11 eingeführt.
fillMode : enumeration
Diese Eigenschaft legt fest, 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 die Darstellung von Formen in 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. |
Die Voreinstellung ist VectorImage.GeometryRenderer.
source : url
Diese Eigenschaft enthält die URL der zu ladenden Vektorgrafikdatei.
VectorImage unterstützt derzeit das Dateiformat SVG. Darüber hinaus kann die Unterstützung von Lottie aktiviert werden, indem die Eigenschaft assumeTrustedSource auf true gesetzt und das Plugin aus dem Qt Lottie Animation Modul.
© 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.
