En esta página

Gráficos 2D en Qt

Los gráficos bidimensionales constituyen el núcleo de las capacidades de la interfaz de usuario de Qt. Esta página ofrece una visión general de las herramientas y las API que tienes a tu disposición para renderizar tus propios gráficos 2D. También pretende aclarar la diferencia entre las API que realizan tareas similares.

Se trata de una visión general de alto nivel, centrada en las formas directas de renderizar primitivas gráficas como círculos, rectángulos, formas complejas e imágenes. Para obtener una visión de bajo nivel del funcionamiento interno de los gráficos de Qt, consulta la documentación de visión general de gráficos.

Qt también incluye capacidades de renderizado 3D de alta gama con su propio conjunto de API y herramientas. La siguiente descripción general se centrará en los gráficos bidimensionales, por lo que no se tratarán aquí los componentes 3D deQt Quick ni los relacionados.

Qt Quick

Qt Quick dispone de herramientas para renderizar gráficos 2D acelerados por hardware y animados. Sirve de base para los componentes de interfaz de usuario avanzados de Qt Quick Controls.

El módulo Qt Quick proporciona primitivas esenciales como « rectangles », « text » e imágenes. Estas suelen constituir la base de una interfaz de usuario bidimensional.

Las interfaces de usuario en Qt Quick pueden transformarse y animarse con una baja sobrecarga de rendimiento, y esta promesa constituye la esencia del módulo. La API es declarativa, lo que permite a Qt optimizar el almacenamiento y el renderizado de los gráficos, así como la gestión de las actualizaciones de las animaciones.

Qt Quick Formas

Además de las primitivas básicas, Qt Quick dispone de API para renderizar formas más complejas. Se puede acceder a ellas importando el Qt Quick Shapes módulo en tu código.

Qt Quick Las formas te permiten construir « paths » arbitrarias a partir de operaciones de trazado como « move-to », « line-to », « cubic-to » y « arc-to ».

Cada trazado puede tener un trazo definido mediante un amplio conjunto de opciones. Además, puede rellenarse con un color sólido, un degradado, una imagen o incluso otro elemento de « Qt Quick ».

GhostScript Tiger renderizado con trazados de <span translate=Qt Quick Shapes" src="images/tiger.png" title="GhostScript Tiger renderizado con trazados de Qt Quick Shapes"/>

El ejemplo «Qt Quick Shapes » muestra cómo se puede renderizar el clásico tigre de GhostScript utilizando trazados construidos con « Qt Quick Shapes».

Renderizador de curvas

Por defecto, « Qt Quick Shapes» utiliza el multimuestreo para el suavizado. Además, las curvas se aplanan en segmentos de línea cortos, lo que puede hacerse visible al ampliar la forma. Al establecer la propiedad « preferredRendererType » del elemento « Shape » en « Shape.CurveRenderer », se utilizará internamente un renderizador diferente. Este renderizador de curvas resuelve las curvas en la propia GPU y aplica el suavizado sin MSAA.

Esto supone un pequeño coste adicional en el rendimiento la primera vez que se representa la forma. Sin embargo, a partir de entonces, la forma se puede escalar y transformar con fluidez sin coste adicional.

Otras operaciones

Además de las operaciones básicas para construir una ruta, Qt Quick Shapes también incluye algunos componentes prácticos y potentes.

  • El componente « PathQuad » se puede utilizar para añadir una curva cuadrática a la ruta.
  • El componente « PathRectangle » se puede utilizar para construir un rectángulo, opcionalmente con esquinas redondeadas.
  • El componente « PathSvg » se puede utilizar para construir una ruta utilizando la sintaxis de rutas de SVG. (Nota: este componente solo proporciona una forma compacta de describir una ruta; no es compatible con toda la sintaxis de SVG).
  • El componente « PathText » se puede utilizar para añadir contornos de una fuente a la ruta. Esto se suma al componente « Text » de Qt Quick. Se puede utilizar para efectos avanzados, por ejemplo, rellenos degradados y operaciones con rutas, como restar el texto de otra forma.

Imágenes rasterizadas

Las imágenes rasterizadas (o mapas de píxeles) se pueden mostrar en Qt Quick utilizando el componente «Image ». De forma predeterminada, se admiten varios formatos de imagen a través del Qt GUI módulo (PNG, JPEG, BMP y GIF). Además, el Qt Image Formats módulo dispone de complementos para cargar otros formatos de imagen. Siempre que tu aplicación pueda acceder al complemento correspondiente a un formato determinado, este se podrá cargar mediante el componente Imagen.

Imágenes vectoriales

Una limitación de las imágenes ráster es que no se pueden escalar ni transformar de ningún otro modo sin que se produzca cierta pérdida de calidad. Para las imágenes que se vayan a mostrar en diferentes tamaños o con transformaciones, suele ser preferible utilizar un formato de imagen vectorial.

El componente « VectorImage » se puede utilizar para incluir gráficos vectoriales escalables directamente en tu aplicación de Qt Quick. Actualmente es compatible con el formato SVG de forma predeterminada. Al implementar un complemento con tu aplicación, también se puede hacer que sea compatible con el formato Lottie.

El componente « VectorImage » analiza el documento y crea en memoria una escena de « Qt Quick » que representa su contenido, utilizando formas de « Qt Quick » y otras primitivas. Por lo tanto, se comportará igual que si la imagen vectorial se hubiera creado mediante « Qt Quick ».

Las imágenes vectoriales también pueden convertirse a QML con antelación, utilizando las herramientas svgtoqml y lottietoqml. Esto crea la misma representación de la imagen vectorial utilizando componentes de Qt Quick. Sin embargo, en lugar de crear la representación en memoria, se guarda en un archivo. La pregeneración del archivo QML permite precompilarlo como parte de los recursos de la aplicación, lo que ahorrará algo de tiempo a la hora de cargarlo.

Ejemplo de previsión meteorológica con símbolos meteorológicos, mapas e iconos derivados de SVG

El ejemplo de previsión meteorológica muestra cómo se puede utilizar svgtoqml en una aplicación. Los símbolos meteorológicos, los mapas y los iconos son archivos SVG que se han convertido a QML y se han cargado como elementos en la escena de la aplicación.

Del mismo modo, la herramienta lottietoqml puede utilizarse para convertir animaciones Lottie a QML.

Imágenes vectoriales prerasterizadas

En el caso de las imágenes vectoriales que solo se muestran en un único tamaño, resulta más eficiente rasterizarlas previamente en mapas de píxeles (pixmaps) y mostrarlas mediante Image. A menudo, estas imágenes se almacenan como SVG en los recursos de origen de la aplicación y luego se convierten a PNG (por ejemplo) en tamaños predefinidos. Esto suele realizarse como parte del proceso de compilación y empaquetado de la aplicación.

Renderizar una imagen es más rápido que renderizar formas complejas, por lo que, para imágenes estáticas, este es el enfoque óptimo. Sin embargo, para algunas aplicaciones no resulta conveniente realizar esta conversión en el momento de la compilación. Si la aplicación está destinada a muchos formatos diferentes, por ejemplo, la lista de tamaños predefinidos para abarcarlos todos puede ser muy larga y difícil de predecir. Dado que cada imagen prerenderizada ocupa espacio adicional en la implementación de la aplicación, este enfoque también conlleva un coste.

Por ello, Qt también admite la rasterización de archivos SVG a un tamaño específico cuando se carga la imagen. Esto se puede hacer simplemente cargando el archivo a través del componente Image habitual. La propiedad sourceSize se puede utilizar para controlar el tamaño rasterizado de la imagen.

Cargar el SVG a través de `Image` difiere de hacerlo a través de ` VectorImage ` en los siguientes aspectos:

  • Con Image, la imagen se rasteriza en la CPU antes de cargarse como textura. Por lo tanto, supone un coste de carga adicional que depende del tamaño de destino de la imagen rasterizada. Sin embargo, la representación posterior de la misma imagen será tan rápida como si la imagen se hubiera rasterizado previamente y se hubiera cargado como un mapa de píxeles.
  • Además, la imagen rasterizada puede consumir más memoria, dependiendo de la complejidad de la imagen vectorial y del tamaño de los datos rasterizados.
  • El escalado o la transformación de la imagen presentan los mismos inconvenientes que si se hubiera cargado como un mapa de píxeles.
  • Si la imagen contiene animaciones, Image solo mostrará el primer fotograma.

Por lo tanto, como regla general, será mejor utilizar imágenes vectoriales prerasterizadas cuando la imagen no esté animada y su tamaño se mantenga constante durante todo el tiempo de ejecución de la aplicación. El hecho de que las imágenes se rastericen en tiempo de compilación mediante una herramienta de terceros o en tiempo de ejecución cuando Qt carga la imagen supone un equilibrio entre el tiempo de carga y la comodidad o el tamaño de la implementación.

Ejemplo de imagen vectorial que muestra un archivo SVG a varias escalas con distintos renderizadores

El ejemplo de imagen vectorial muestra un archivo SVG visualizado a diferentes escalas utilizando Image, VectorImage y un archivo QML generado con svgtoqml. Cuando se muestra a su tamaño original, el resultado es idéntico en todos los casos, y Image será ligeramente más rápido a la hora de renderizarlo. A escalas más altas, el objeto ` Image` se vuelve borroso y pixelado, mientras que los otros métodos mantienen la nitidez y se mantienen fieles a la fuente.

Gráficos vectoriales animados

Las animaciones constituyen el núcleo de la oferta de « Qt Quick ». Muchas animaciones de gráficos vectoriales pueden ejecutarse sin modificar la geometría de los elementos y, por lo tanto, se benefician en gran medida del renderizador acelerado por hardware de « Qt Quick ».

VectorImage, svgtoqml y lottietoqml admiten animaciones para un subconjunto seleccionado de propiedades.

Cuadrícula de archivos Lottie animados convertidos a QML

El ejemplo de lottietoqml muestra cómo se pueden convertir archivos Lottie animados a QML. Como se aprecia en esta captura de pantalla, varias imágenes animadas se disponen en una cuadrícula. Cada una de ellas se puede ampliar sin que se produzcan artefactos de escalado ni pérdida de fidelidad.

Efectos

La compatibilidad con efectos de posprocesamiento se incluye como una característica fundamental en Qt Quick. Cualquier elemento puede convertirse en una textura y el componente ShaderEffect puede utilizarse para aplicarle cualquier efecto.

Además de esta compatibilidad de bajo nivel con los efectos, Qt Quick también cuenta con algunos componentes de alto nivel para facilitar el proceso.

El componente « MultiEffect » permite aplicar uno o varios efectos de un conjunto predefinido de efectos comunes a un objeto.

<span translate=Qt Quick Effect Maker, herramienta visual para encadenar y crear efectos" src="images/quickeffectmaker.png" title="Qt Quick Effect Maker, herramienta visual para encadenar y crear efectos"/>

Para casos de uso más complejos, el «Effect Maker» deQt Quick ofrece una herramienta visual en la que se pueden encadenar efectos predefinidos y personalizados, y generar el código de sombreado para su uso con ShaderEffect.

QPainter

QPainter es la base de Qt Widgets. Proporciona una API imperativa para dibujar formas e imágenes complejas con suavizado de píxeles perfecto.

Las formas se pueden especificar mediante QPainterPath y el renderizador también admite directamente primitivas como texto e imágenes.

QPainter es principalmente un renderizador de software y está optimizado para actualizaciones parciales y de menor tamaño de la pantalla. Por lo tanto, se adapta bien a las interfaces tradicionales de estilo escritorio de Qt Widgets, en las que la mayor parte de la interfaz de usuario permanece estática de un fotograma a otro. Por lo tanto, renderizar escenas 2D grandes y complejas con él puede resultar costoso, por lo que podría merecer la pena considerar Qt Quick Shapes una alternativa.

Por otro lado, la calidad de renderizado es superior, por lo que en muchos casos seguirá siendo preferible. Al renderizar una imagen SVG a través de `Image`, tal y como se ha descrito anteriormente, QPainter será el renderizador subyacente.

Si el objetivo es la perfección al píxel y las actualizaciones son poco frecuentes o se limitan a regiones pequeñas, entonces QPainter es una herramienta potente. Si se convierte en un cuello de botella para el rendimiento, podrías plantearte pasar a utilizar Qt Quick y Qt Quick Shapes en su lugar.

Componentes de nivel superior

Partiendo de estas primitivas gráficas básicas, Qt también ofrece numerosos componentes especializados de alto nivel.

Qt Quick «Controls» es uno de esos módulos. Proporciona un conjunto variado y personalizable de componentes comunes de interfaz de usuario. Del mismo modo, Qt Widgets ofrece lo mismo para las aplicaciones basadas en QPainter.

Además, Qt Graphs es un módulo de visualización de datos. Ofrece numerosos componentes diferentes para visualizar conjuntos de datos y gráficos en una Qt Quick aplicación. Qt Graphs Admite gráficos tanto en 2D como en 3D.

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