Ejemplo de imagen vectorial
Un ejemplo de Qt Quick que muestra las diferencias entre Qt SVGVectorImage y svgtoqml.

Existen varias formas diferentes de incluir gráficos vectoriales bidimensionales en tu aplicación Qt. Este ejemplo se centra en el formato SVG y en cómo se puede utilizar con Qt. Como punto de partida, Qt es compatible con las características estáticas del perfil SVG Tiny 1.2. Además, Qt SVG opcionalmente admite algunas características del perfil completo, aunque en este ejemplo no se utilizan.
El ejemplo muestra una cuadrícula de 3x3 celdas, cada una de las cuales contiene la misma imagen vectorial de un corazón. La imagen del corazón se proporciona como un archivo SVG junto con el ejemplo.
En la cuadrícula, cada fila muestra la imagen con un factor de escala diferente (1x, 2,5x y 4x, respectivamente).
Cada columna representa una forma diferente de representar los gráficos vectoriales en Qt. La columna situada más a la izquierda es un componente Image, la columna central es un componente VectorImage y la columna situada más a la derecha es una representación QML pregenerada creada con la herramienta svgtoqml.
Cada método de representación de los gráficos vectoriales tiene sus propias ventajas e inconvenientes, y se adapta a diferentes casos de uso. Para tomar una decisión informada sobre cuál utilizar, puede resultar útil comprender en detalle en qué se diferencian.
El componente Image y Qt SVG
Cuando se utiliza el elemento « Image » y se establece un archivo « SVG » como fuente, se invocará el complemento de formato de imagen en Qt SVG. El complemento analizará el archivo « SVG », lo rasterizará utilizando el rasterizador de software de QPainter y, a continuación, lo proporcionará a Qt Quick como una imagen pixmap. Esto equivale a utilizar la clase « QSvgRenderer » para dibujar la imagen.
Image {
sourceSize: Qt.size(topLevel.sourceSize, topLevel.sourceSize)
source: "heart.svg"
}Dado que la imagen vectorial se rasteriza a un tamaño específico, cualquier transformación que apliquemos a Image se aplicará a la imagen rasterizada. Esto puede dar lugar a artefactos de pixelación y curvas irregulares.
Cargar una imagen vectorial a través de Image funciona mejor si se solicita la imagen con el tamaño exacto con el que se pretende mostrarla. Cuando la imagen Image se muestra a una escala de 1x en la fila superior, tiene el mismo aspecto que las demás, pero a escalas mayores empieza a verse borrosa.
Si la imagen solo se va a mostrar con un único tamaño, esta suele ser la opción más eficiente. Existe un coste inicial por rasterizar la imagen al tamaño especificado, pero, una vez hecho esto, el coste de copiar los datos a la pantalla es muy bajo.
Sin embargo, a medida que la imagen se solicite en varios tamaños diferentes, el coste inicial aumentará, al igual que el consumo acumulado de memoria. Los zooms animados de la imagen a menudo pueden resultar demasiado costosos de ejecutar a la velocidad de fotogramas máxima en dispositivos de gama baja. Estos son los casos de uso en los que se debería considerar el uso de VectorImage y svgtoqml.
El componente VectorImage
Como alternativa a Image, Qt ofrece el componente VectorImage. Este convierte la imagen SVG en una representación gráfica vectorial en Qt Quick, y la rasterización se realiza bajo demanda, en el hardware gráfico, a medida que se representa en la pantalla.
VectorImage {
width: topLevel.sourceSize
height: topLevel.sourceSize
preferredRendererType: VectorImage.CurveRenderer
source: "heart.svg"
}Dado que la imagen no está prerasterizada, podemos aplicarle transformaciones sin perder fidelidad respecto a las formas originales. Ten en cuenta que el ejemplo utiliza el tipo de renderizador VectorImage.CurveRenderer. Se recomienda su uso en casos en los que la imagen se vaya a transformar y se necesite suavizado.
Esto significa que podemos mostrar la imagen a cualquier tamaño e incluso animar su escala, y todo el trabajo lo realizará el hardware gráfico. Sin embargo, cuando el « VectorImage » se representa en pantalla, el coste es ligeramente superior al de representar un « Image ». Esto se debe a que la rasterización de las curvas se produce cada vez que se representa el componente y no de forma anticipada.
Por lo tanto, ` VectorImage ` resulta más adecuado para gráficos vectoriales cuyo tamaño cambie con frecuencia. También puede ser adecuado cuando el tamaño de destino de la imagen es muy grande y el consumo de memoria es un factor a tener en cuenta. Al utilizar ` Image`, la imagen rasterizada completa debe almacenarse en la memoria gráfica. Por lo tanto, el consumo de memoria variará en función del tamaño de la imagen. La memoria consumida por VectorImage será la misma, independientemente del tamaño de destino al que se renderice.
La herramienta svgtoqml
El componente « VectorImage » analiza el archivo ` SVG ` y crea una escena equivalente con elementos ` Qt Quick ` en tiempo de ejecución.
Si el archivo « SVG » forma parte de los recursos de la aplicación, parte del trabajo se puede realizar con antelación utilizando la herramienta «svgtoqml ». Esta herramienta genera la misma escena que VectorImage, pero en lugar de crearla en tiempo de ejecución, genera un archivo QML que se puede incluir en el proyecto de la aplicación.
En este ejemplo, el archivo heart.svg se convierte automáticamente a Heart.qml durante la compilación.
qt_target_qml_from_svg(vectorimageexample
CURVE_RENDERER
OPTIMIZE_PATHS
FILES heart.svg
OUTPUTS Heart.qml
COPYRIGHT_STATEMENT
"Copyright © 2024 The Qt Company Ltd.\\nSPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause"
)Este componente se puede instanciar en la escena como cualquier otro elemento de Qt Quick.
Heart {
width: topLevel.sourceSize
height: topLevel.sourceSize
}Al utilizar este enfoque, no es necesario analizar el archivo « SVG » cada vez que se inicia la aplicación. Además, la herramienta « svgtoqml » puede optimizar y analizar las formas, con el fin de proporcionar al renderizador indicaciones que acelerarán aún más su procesamiento en tiempo de ejecución.
La herramienta svgtoqml debe tenerse en cuenta para los mismos casos de uso que VectorImage y debe ser la opción preferida siempre que el archivo SVG esté disponible como recurso al compilar la aplicación y no lo proporcione el usuario final de la misma.
© 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.