Qt Quick Requisitos gráficos 3D
API gráficas, versiones y lenguajes de sombreado compatibles
Qt Quick El 3D es compatible con todas las API gráficas y lenguajes de sombreado que admite Qt Quick en Qt 6.0. En algunos casos, especialmente con OpenGL y OpenGL ES, los requisitos de versión para Qt Quick 3D pueden ser más exigentes que para Qt Quick.
- OpenGL 3.0 o superior; se recomienda encarecidamente OpenGL 3.3 o superior
- OpenGL ES 2.0 o superior; se recomienda encarecidamente OpenGL ES 3.0 o superior
- Direct3D 11.1
- Direct3D 12
- Vulkan 1.0 o superior
- Metal 1.2 o superior
El proceso de renderizado de shaders se basa en el enfoque estándar de Qt 6: el código de shaders GLSL compatible con Vulkan se compila a SPIR-V, que a su vez se traduce a código fuente GLSL, HLSL y MSL. Consulta la documentación del módulo Qt « Shader Tools » para obtener más detalles.
Qt Quick 3D no funciona directamente con ninguna de las API gráficas mencionadas anteriormente. En su lugar, utiliza las abstracciones de la interfaz de hardware de renderizado de Qt, de forma similar a Qt Quick.
Elección de la API gráfica
Dado que Qt Quick 3D no inicializa el renderizado ni una ventana por sí mismo, sino que se basa en QQuickWindow o QQuickView o en el tipo QML Window, todo lo relacionado con la selección de la API gráfica que se aplica al grafo de escena deQt Quick se aplica también a Qt Quick 3D. Es posible controlar el comportamiento del grafo de escena configurando variables de entorno específicas, tal y como se indica a continuación:
| Variable de entorno | Valores posibles | Descripción |
|---|---|---|
QSG_RHI_BACKEND | vulkan, metal, opengl, d3d11, d3d12 | Solicita el backend RHI específico. Por defecto, la API gráfica de destino se elige en función de la plataforma, a menos que se anule mediante esta variable o las API equivalentes de C++. Los valores por defecto actuales son Direct3D 11 para Windows, Metal para macOS y OpenGL en el resto de plataformas. |
QSG_RHI_DEBUG_LAYER | 1 | Cuando sea aplicable (Vulkan, Direct3D), habilita las capas de depuración y/o validación de la implementación de la API gráfica, si están disponibles. |
QSG_INFO | 1 | Al igual que con la ruta de renderizado basada en OpenGL, al establecer esta opción se habilita la impresión de información del sistema al inicializar el grafo de escena de Qt Quick. Esto puede resultar muy útil para la resolución de problemas. |
Las aplicaciones que deseen ejecutarse siempre con una única API gráfica determinada pueden solicitarlo a través de la variable de entorno ` QSG_RHI_BACKEND `, así como mediante C++. Por ejemplo, la siguiente llamada realizada al inicio de ` main()`, antes de construir cualquier ` QQuickWindow`, fuerza el uso de Vulkan (y, de lo contrario, dará error).
QQuickWindow::setGraphicsApi(QSGRendererInterface::Vulkan);Nota: La adaptación por software de Qt Quick no es compatible con contenido 3D.
Aspectos específicos de OpenGL
Se espera que las aplicaciones 3D bien escritas en Qt Quick llamen a QQuick3D::idealSurfaceFormat() en su función main() y utilicen el QSurfaceFormat devuelto como valor por defecto:
QSurfaceFormat::setDefaultFormat(QQuick3D::idealSurfaceFormat());La llamada a esta función no tiene ningún efecto cuando se utiliza una API gráfica distinta de OpenGL, pero resulta muy beneficiosa cuando la API es OpenGL, ya que da lugar a la creación de un contexto OpenGL que se adapta mejor a las necesidades de Qt Quick 3D.
Compatibilidad con OpenGL ES 2.0
Qt Quick El 3D es compatible con OpenGL ES 2.0, pero con un conjunto de funciones considerablemente limitado. La siguiente lista contiene algunas de las funciones que no estarán disponibles o que no funcionarán correctamente:
- Iluminación basada en imágenes, sondas de luz, skybox
- Mapeado de sombras
- Oclusión ambiental en el espacio de pantalla
- Multimuestreo
- Ciertos efectos de posprocesamiento
- Materiales personalizados que utilizan sombreadores basados en características de GLSL no presentes en GLSL ES 100
- Transparencia independiente del orden
Nota: Qt Quick 3D requiere OpenGL ES 3.0 / WebGL 2 en la plataforma WebAssembly. No es compatible con OpenGL ES 2.0 / WebGL 1.
© 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.