En esta página

svgtoqml

svgtoqml es una herramienta de línea de comandos incluida con Qt que convierte un documento SVG en un archivo QML. Este archivo QML puede utilizarse posteriormente como componente en aplicaciones de Qt Quick ». El ejemplo de previsión meteorológica incluye varios archivos QML que se han generado utilizando esta herramienta.

Descripción general

svgtoqml convierte un archivo SVG en un archivo QML que utiliza primitivas de Qt Quick. Dado que Qt Quick admite gráficos vectoriales escalables, el elemento resultante se podrá transformar con fluidez en la medida de lo posible. Como punto de partida, la herramienta admite la mayoría de las características estáticas del perfil SVG Tiny 1.2. Se admiten ciertas características adicionales, que se determinan caso por caso. No se admiten las características interactivas ni las animaciones.

Uso

El uso básico de svgtoqml consiste en proporcionar un archivo de entrada y un archivo de salida: svgtoqml input.svg output.qml. Esto leerá el archivo input.svg y lo convertirá en la escena Qt Quick correspondiente en output.qml, que luego podrá utilizarse como parte de una aplicación Qt Quick.

Además, admite las siguientes opciones:

OpciónDescripción
--no-assume-trusted-sourceIndica que el archivo de entrada no es de confianza y que deben activarse comprobaciones y restricciones adicionales. Por defecto, el archivo SVG se analizará con la opción AssumeTrustedSource option. Al pasar este argumento, se desactivará dicha opción.
--copyright-statement <string>Añade <cadena> como comentario al principio del archivo generado.
-c, --curve-rendererActiva el motor de renderizado de curvas para Qt Quick Shapes. Esto permite obtener formas suaves y suavizadas en la escena sin necesidad de multimuestreo, aunque con un coste adicional.
-a, --asynchronous-shapesActiva el modo {QtQuick.Shapes::Shape::asynchronous}{asynchronous} en todos los elementos Shape de la escena generada. Esto puede mejorar la utilización de la CPU y la capacidad de respuesta.
-p, --optimize-pathsHabilita la optimización de las rutas antes de guardarlas en el archivo QML, lo que podría acelerar su carga y renderizado posteriores.
--outline-stroke-modeTraza el contorno (perfil) de la forma rellena en lugar de la ruta original.
-t, --type-name <string>En lugar de Shape, la salida utilizará el nombre de tipo <string>. Esto permite utilizar un elemento personalizado para anular el comportamiento predeterminado de los elementos Shape.
-v, --viewMostrar una vista previa del elemento « Qt Quick » tal y como se generará.

La herramienta se puede invocar automáticamente desde la compilación utilizando la función de CMake qt_target_qml_from_svg().

Comparación con otras opciones

Existen varias opciones para incluir contenido SVG en Qt Quick. A continuación se ofrece una visión general del papel que desempeña svgtoqml en este contexto.

Comparación con Qt SVG

Qt SVG es un módulo que proporciona un analizador sintáctico y un renderizador de software para archivos SVG. Además, incluye un complemento de carga de imágenes, de modo que los archivos SVG pueden cargarse directamente mediante el elemento Image en Qt Quick. A continuación, el SVG se rasterizará y se almacenará en caché con un tamaño especificado, y volver a dibujarlo resultará bastante económico. Sin embargo, ampliar la imagen sin que se vea pixelada implicará volver a cargarla con un tamaño diferente, lo que a su vez puede resultar costoso.

svgtoqml (y el componente ` VectorImage `) son formas alternativas de renderizar el mismo contenido. Una vez cargado en ` Qt Quick`, las transformaciones se pueden modificar conservando los datos geométricos necesarios para renderizar la escena en la memoria de la GPU. De este modo, la imagen vectorial se puede volver a dibujar a diferentes escalas con muy poca sobrecarga.

Sin embargo, si el tamaño de la imagen no va a cambiar durante el tiempo de ejecución de la aplicación, resultará más eficiente cargar el SVG como un « Image ». En este caso, si el SVG siempre se representa en un pequeño subconjunto de los tamaños posibles, plantéate pre-rasterizarlo a un formato de imagen que sea más eficiente de cargar, como PNG.

Comparación con VectorImage

El componente « VectorImage » ofrece la misma funcionalidad básica que « svgtoqml », pero en lugar de pregenerar la escena « Qt Quick » como un archivo QML, crea la escena en tiempo de ejecución. Esto permite cargar archivos SVG que no se proporcionan en el momento de la compilación y, por lo tanto, ofrece mayor flexibilidad. La pregeneración de las escenas con svgtoqml permite optimizar la escena antes de que se cargue. Por lo tanto, para los archivos que están disponibles en el momento de la compilación, svgtoqml es la opción recomendada.

Comparación con PathSvg

El componente « PathSvg » forma parte del Qt Quick Shapes módulo. Ofrece una forma de definir trazados con la sintaxis utilizada por SVG, en la que los puntos de control de un trazado se especifican como una cadena de caracteres. No admite la carga de archivos SVG, por lo que no es una alternativa directa a svgtoqml. Si un SVG complejo contiene una forma específica que necesita la aplicación, copiar esta descripción de trazado en PathSvg puede resultar más cómodo que generar el archivo completo.

© 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.