En esta página

Adaptaciones del grafo de escena

Adaptaciones del grafo de escena en Qt Quick

En Qt 5.0, Qt Quick siempre utilizaba OpenGL (OpenGL ES 2.0 u OpenGL 2.0) para analizar el grafo de escena y renderizar los resultados en un destino de renderizado.

A partir de Qt 5.8, Qt Quick también admite el renderizado por software y con OpenVG. Esto se consigue mediante adaptaciones adicionales del grafo de escena, ya sea en forma de complementos (openvg) o integradas en la biblioteca Qt Quick (software). La adaptación predeterminada sigue basándose directamente en OpenGL.

A partir de Qt 5.14, la adaptación por defecto cuenta con la opción de renderizar a través de una capa de abstracción gráfica, la Interfaz de Hardware de Renderizado de Qt (RHI), proporcionada por el Qt GUI módulo. Cuando está habilitada, no se realizan llamadas directas a OpenGL. En su lugar, el grafo de escena se renderiza utilizando las API proporcionadas por la capa de abstracción, que luego se traducen en llamadas a OpenGL, Vulkan, Metal o Direct 3D. La gestión de los shaders también se unifica escribiendo el código de los shaders una sola vez, compilándolo a SPIR-V y traduciéndolo posteriormente al lenguaje adecuado para las distintas API gráficas.

A partir de Qt 6.0, el modelo de renderizado basado en RHI es el predeterminado y no existe la opción de recurrir al uso directo de OpenGL.

Cambiar entre adaptaciones en tu aplicación

A diferencia de software, el renderizador basado en RHI no es una adaptación adicional, sino que siempre está integrado. A partir de Qt 6.0, está siempre activado. En las plataformas en las que hay varias API gráficas disponibles, el grafo de escena elige la específica para cada plataforma. Si no se desea esto, las aplicaciones pueden forzar el uso de una API gráfica concreta configurando la variable de entorno ` QSG_RHI_BACKEND ` o mediante ` QQuickWindow::setGraphicsApi()` en combinación con ` QSGRendererInterface::GraphicsApi`.

El cambio a una adaptación diferente puede realizarse de dos maneras:

  • Utilizar una variable de entorno: establecer la variable de entorno QT_QUICK_BACKEND o la variable heredada QMLSCENE_DEVICE antes de iniciar las aplicaciones.
  • Utilizar una API de C++: llamar a QQuickWindow::setSceneGraphBackend() al inicio de la función main() de la aplicación.

Se admiten los siguientes backends:

Para averiguar qué backend se está utilizando, puede habilitar el registro de información básica del grafo de escena mediante la variable de entorno « QSG_INFO » o la categoría de registro « qt.scenegraph.general ». De este modo, se mostrará cierta información en la salida de depuración durante el inicio de la aplicación.

Nota: En las compilaciones de Qt en las que tanto OpenGL como Vulkan están desactivados, la adaptación predeterminada es « software ». Sin embargo, esto no se aplica a Windows ni a macOS, ya que estas plataformas siempre tienen habilitado el soporte para Direct 3D o Metal, respectivamente.

Nota: Por lo general , las adaptaciones distintas de la predeterminada conllevan una serie de limitaciones, ya que es poco probable que ofrezcan un conjunto de características 100 % compatible con OpenGL. No obstante, estas adaptaciones pueden aportar sus propias ventajas específicas en determinados ámbitos. Para obtener más información sobre las distintas adaptaciones, consulta las secciones siguientes.

Adaptación predeterminada

Al utilizar OpenGL directamente, la adaptación predeterminada es capaz de proporcionar el conjunto completo de funciones de « Qt Quick e 2». Para obtener más detalles, consulte Adaptación predeterminada.

Adaptación por software

La adaptación por software es un renderizador alternativo para Qt Quick 2 que utiliza el motor de pintura ráster para renderizar el contenido del grafo de escena. Para obtener más detalles, consulta «Adaptación por software».

OpenVG

La adaptación OpenVG es un renderizador alternativo para Qt Quick 2 que representa el contenido del grafo de escena utilizando comandos OpenVG para proporcionar gráficos vectoriales y ráster 2D acelerados por hardware. Para obtener más detalles, consulta «Adaptación OpenVG».

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