VectorImage QML Type
Charge un fichier d'image vectorielle et l'affiche dans une scène Qt Quick. Plus d'informations...
| Import Statement: | import QtQuick.VectorImage |
| Since: | Qt 6.8 |
| Inherits: |
Propriétés
- 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
Description détaillée
VectorImage peut être utilisé pour charger un fichier d'image vectorielle et l'afficher en tant qu'élément dans une scène Qt Quick.
Il prend actuellement en charge le format de fichier SVG. En outre, la prise en charge de Lottie peut être activée en définissant la propriété assumeTrustedSource à true et en incluant le plugin à partir du module Qt Lottie Animation et en incluant le plugin dans le module
Remarque : cette approche complète celle qui consiste à charger le fichier d'image vectorielle par l'intermédiaire d'un élément Image: Image crée une version matricielle de l'image à la taille demandée. VectorImage construit une scène Qt Quick qui représente l'image. Cela signifie que l'élément résultant peut être mis à l'échelle et tourné sans perte de qualité, et qu'il consommera généralement moins de mémoire que la version matricielle.
Documentation sur les propriétés
animations group
Ces propriétés peuvent être utilisées pour contrôler les animations dans l'image, si elle en contient.
La propriété paused peut être définie sur true (vrai) pour mettre temporairement toutes les animations en pause. Lorsque la propriété est réinitialisée à false, les animations reprennent là où elles étaient. Par défaut, la valeur de cette propriété est false.
La propriété loops définit le nombre de répétitions des animations dans le document. Par défaut, cette propriété est égale à 1. Toute animation définie pour tourner en boucle indéfiniment dans l'image source ne sera pas affectée par cette propriété. Pour que toutes les animations du document se répètent indéfiniment, la propriété loops peut être définie sur Animation.Infinite.
Ces propriétés ont été introduites dans Qt 6.10.
assumeTrustedSource : bool [since 6.10]
En définissant cette valeur à true lors du chargement de fichiers source fiables, on étend la prise en charge de certaines fonctionnalités qui pourraient être dangereuses dans un environnement non contrôlé. Pour SVG en particulier, cela correspond à AssumeTrustedSource option.
Lorsque cette valeur est fixée à true, VectorImage essaiera également de charger l'image à l'aide du plugin de format Lottie si celui-ci est disponible. Voir Qt Lottie Animation pour plus d'informations.
Par défaut, cette propriété est false.
Cette propriété a été introduite dans Qt 6.10.
Voir aussi svgtoqml et lottietoqml.
asynchronousShapes : bool [since 6.11]
Cette propriété contrôle la propriété {QtQuick.Shapes::Shape::asynchronous}{asynchrone} des éléments Shape dans la scène Quick que VectorImage construit pour représenter l'image.
En définissant cette propriété sur true, la partie CPU du traitement du rendu des formes sera déchargée sur des threads de travail distincts. Cela peut améliorer l'utilisation de l'unité centrale et la réactivité de l'interface utilisateur.
Par défaut, la valeur de cette propriété est false.
Cette propriété a été introduite dans Qt 6.11.
fillMode : enumeration
Cette propriété définit ce qui se passe si la largeur et la hauteur du site VectorImage diffèrent de la taille implicite de son contenu.
| Constante | Description |
|---|---|
VectorImage.NoResize | Le contenu est toujours rendu à la taille fournie par l'entrée. |
VectorImage.Stretch | Le contenu est mis à l'échelle pour correspondre à la largeur et à la hauteur de VectorImage(par défaut). |
VectorImage.PreserveAspectFit | Le contenu est mis à l'échelle pour tenir dans les limites de VectorImage, tout en préservant le rapport d'aspect. Le rectangle de délimitation réel du contenu sera parfois plus petit que l'élément VectorImage. |
VectorImage.PreserveAspectCrop | Le contenu est mis à l'échelle pour remplir l'élément VectorImage, tout en préservant le rapport hauteur/largeur. Les limites réelles du contenu seront parfois plus grandes que l'élément VectorImage. |
preferredRendererType : enumeration
Demande l'utilisation d'un backend spécifique pour le rendu des formes dans le site VectorImage.
| Constante | Description |
|---|---|
VectorImage.GeometryRenderer | Équivalent à Shape.GeometryRenderer. Ce moteur aplatit les courbes et triangule le résultat. Il donnera des résultats aliasés à moins que le multi-échantillonnage ne soit activé, et l'aplatissement des courbes peut être visible lorsque l'élément est mis à l'échelle. |
VectorImage.CurveRenderer | Équivalent à Shape.CurveRenderer. Avec ce backend, les courbes sont rendues sur le GPU et l'anticrénelage est intégré. Cela donne généralement de meilleurs résultats visuels, mais au prix d'un surcoût en termes de performances. |
La valeur par défaut est VectorImage.GeometryRenderer.
source : url
Cette propriété contient l'URL du fichier d'image vectorielle à charger.
VectorImage prend actuellement en charge le format de fichier SVG. En outre, la prise en charge de Lottie peut être activée en définissant la propriété assumeTrustedSource à true et en incluant le plugin dans le module Qt Lottie Animation module.
© 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.
