En esta página

Qt 3D Render C++ Classes

El módulo « Qt 3D » (Renderizado) incluye funciones para el renderizado en 2D y 3D mediante Qt 3D. Más información...

Este módulo está obsoleto desde la versión 6.8. Recomendamos encarecidamente no utilizarlo en código nuevo.

Espacios de nombres

Clases

Descripción detallada

El módulo « Qt 3D Render» proporciona un aspecto, componentes y otros tipos de apoyo necesarios para implementar el renderizado en 2D y 3D como parte del marco de trabajo Qt 3D.

Para utilizar las clases de este módulo, añade esta directiva a los archivos de C++:

#include <Qt3DRender>

Para vincular la biblioteca C++ correspondiente, añade lo siguiente a tu archivo de proyecto qmake:

QT += 3drender

Las clases, los tipos y las funciones se declaran bajo el espacio de nombres Qt3DRender.

Descripción general

El aspecto « Qt 3D Render» ofrece soporte para la configuración basada en datos, tal y como se describe en «Qt 3D Render Framegraph».

Selección de un backend de renderizado

El aspecto «Render» incluye dos backends de renderizado.

  • Backend de OpenGL (ES 2, ES 3.2, GL 2, GL 3, GL 3.2, GL 4.3)
  • Backend RHI (ES 2, GL, DirectX, Vulkan, Metal)

Si tu aplicación está dirigida exclusivamente a OpenGL y utilizas características específicas de OpenGL, quizá te convenga más utilizar el backend de OpenGL. Este es el backend de OpenGL que Qt 3D utilizó exclusivamente en la serie Qt 5.

En los casos en los que no utilices características específicas de OpenGL y desees desarrollar para diferentes plataformas en las que OpenGL pueda estar en desuso, utilizar el backend RHI es una mejor alternativa.

Para seleccionar el backend de renderizado, hay que establecer la variable de entorno QT3D_RENDERER en «opengl» o «rhi». El valor por defecto es el backend de OpenGL.

Al utilizar el backend RHI, puedes forzar aún más el uso del backend RHI interno configurando QSG_RHI_BACKEND con uno de los siguientes valores:

  • opengl -> backend RHI OpenGL
  • gl -> backend RHI OpenGL
  • gles2 -> backend OpenGL de RHI
  • metal -> backend Metal de RHI
  • vulkan -> backend Vulkan de RHI
  • d3d11 -> Backend RHI DirectX 11

Si no se especifica, RHI utilizará por defecto el backend que considere más adecuado para la plataforma.

Referencia

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