VectorImage QML Type
Carga un archivo de imagen vectorial y lo muestra en una escena de Qt Quick. Más...
| Import Statement: | import QtQuick.VectorImage |
| Since: | Qt 6.8 |
| Inherits: |
Propiedades
- 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
Descripción detallada
VectorImage puede utilizarse para cargar un archivo de imagen vectorial y mostrarlo como un elemento en una escena de Qt Quick.
Actualmente es compatible con el formato de archivo SVG. Además, se puede habilitar la compatibilidad con Lottie estableciendo la propiedad assumeTrustedSource en true e incluyendo el complemento del módulo Qt Lottie Animation módulo.
Nota: Esto complementa el enfoque de cargar el archivo de imagen vectorial a través de un elemento Image: Image crea una versión rasterizada de la imagen al tamaño solicitado. VectorImage construye una escena Qt Quick que representa la imagen. Esto significa que el elemento resultante puede escalarse y rotarse sin perder calidad, y normalmente consumirá menos memoria que la versión rasterizada.
Documentación de propiedades
animations group
Estas propiedades se pueden utilizar para controlar las animaciones en la imagen, si contiene alguna.
La propiedad paused puede establecerse a true para pausar temporalmente todas las animaciones. Cuando la propiedad se restablezca a false, las animaciones se reanudarán donde estaban. Por defecto esta propiedad es false.
La propiedad loops define el número de veces que se repetirán las animaciones en el documento. Por defecto esta propiedad es 1. Cualquier animación que esté configurada para repetirse indefinidamente en la imagen de origen no se verá afectada por esta propiedad. Para hacer que todas las animaciones del documento se repitan indefinidamente, la propiedad loops puede establecerse a Animation.Infinite.
Estas propiedades se introdujeron en Qt 6.10.
assumeTrustedSource : bool [since 6.10]
Si se establece en true al cargar archivos fuente de confianza, se amplía la compatibilidad con algunas funciones que podrían no ser seguras en un entorno no controlado. Para SVG en particular, esto se corresponde con AssumeTrustedSource option.
Cuando se establece en true, VectorImage también intentará cargar la imagen utilizando el plugin de formato Lottie si está disponible. Consulte Qt Lottie Animation para obtener información adicional.
Por defecto esta propiedad es false.
Esta propiedad se introdujo en Qt 6.10.
Véase también svgtoqml y lottietoqml.
asynchronousShapes : bool [since 6.11]
Esta propiedad controla la propiedad {QtQuick.Shapes::Shape::asynchronous}{asíncrona} de los elementos Shape en la escena Quick que VectorImage construye para representar la imagen.
Establecer esta propiedad en true descargará la parte de la CPU del procesamiento de renderizado de las formas a hilos de trabajo separados. Esto puede mejorar la utilización de la CPU y la respuesta de la interfaz de usuario.
Por defecto esta propiedad es false.
Esta propiedad se introdujo en Qt 6.11.
fillMode : enumeration
Esta propiedad define lo que ocurre si la anchura y la altura de VectorImage difieren del tamaño implícito de su contenido.
| Constante | Descripción |
|---|---|
VectorImage.NoResize | El contenido se sigue mostrando en el tamaño proporcionado por la entrada. |
VectorImage.Stretch | El contenido se escala para ajustarse a la anchura y altura de VectorImage. (Este es el valor por defecto.) |
VectorImage.PreserveAspectFit | El contenido se escala para ajustarse a los límites de VectorImage, conservando la relación de aspecto. En ocasiones, el rectángulo de delimitación real del contenido será menor que el elemento VectorImage. |
VectorImage.PreserveAspectCrop | Los contenidos se escalan para llenar el elemento VectorImage, conservando la relación de aspecto. Los límites reales del contenido serán a veces mayores que el elemento VectorImage. |
preferredRendererType : enumeration
Solicita que se utilice un backend específico para la representación de formas en VectorImage.
| Constante | Descripción |
|---|---|
VectorImage.GeometryRenderer | Equivale a Shape.GeometryRenderer. Este backend aplana las curvas y triangula el resultado. Dará resultados con alias a menos que esté habilitado el muestreo múltiple, y el aplanamiento de curvas puede ser visible cuando se escala el elemento. |
VectorImage.CurveRenderer | Equivalente a Shape.CurveRenderer. Con este backend, las curvas se renderizan en la GPU y se incorpora anti-aliasing. Normalmente se obtienen mejores resultados visuales, pero con un coste adicional en el rendimiento. |
El valor predeterminado es VectorImage.GeometryRenderer.
source : url
Esta propiedad contiene la URL del archivo de imagen vectorial a cargar.
VectorImage actualmente soporta el formato de archivo SVG. Además, la compatibilidad con Lottie puede habilitarse estableciendo la propiedad assumeTrustedSource a true e incluyendo el plugin desde el módulo Qt Lottie Animation módulo.
© 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.
