En esta página

Cambios en Qt OpenGL

Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco sea más eficiente y fácil de usar.

Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables con el fin de mejorar Qt como marco de trabajo.

En este tema resumimos dichos cambios Qt OpenGLy ofrecemos orientación para gestionarlos.

Clases obsoletas eliminadas

El Qt OpenGL módulo quedó obsoleto durante el ciclo de vida de Qt 5, y las clases que contenía se han eliminado en Qt 6.

Esto se refiere específicamente a las clases con el prefijo « QGL ».

Clases de QOpenGL migradas

En Qt 5, se añadió a Qt GUI un conjunto de clases sustitutivas para el soporte de OpenGL. El objetivo era dar soporte a OpenGL como la API gráfica multiplataforma que servía de base para los gráficos en Qt.

En Qt 6, estas se han migrado al Qt OpenGL módulo. Siguen siendo utilizables y cuentan con soporte completo para las aplicaciones que dependen directamente de OpenGL. Sin embargo, ya no se consideran fundamentales, ya que Qt se ha ampliado para admitir otras API gráficas en su base, como Direct3D, Metal y Vulkan.

El código de las aplicaciones existentes seguirá funcionando en su mayor parte, pero ahora debería incluir Qt OpenGL en los archivos del proyecto, así como incluir los encabezados si anteriormente se incluían de forma indirecta a través de Qt GUI.

Nota: Una excepción destacada es ` QOpenGLContext`, que sigue residiendo en Qt GUI.

La clase QOpenGLWidgets

Otra excepción es la clase QOpenGLWidget. Esta se ha trasladado a un nuevo módulo denominado Qt OpenGL Widgets y debe incluirse desde allí.

Selección del motor OpenGL para RHI

Además de ajustar los archivos del proyecto e incluir los encabezados, la aplicación también debe configurar manualmente el backend de renderizado en OpenGL para poder utilizar esta funcionalidad al trabajar con Qt Quick. Por defecto, Qt utilizará la API gráfica más adecuada para la plataforma de destino. Consulta la documentación sobre renderizado de RHI para obtener más detalles.

Eliminación de ANGLE

En Windows, ANGLE, un traductor de terceros de OpenGL ES a Direct 3D, ya no se incluye en Qt 6. Esto significa que Qt::AA_UseOpenGLES y la variable de entorno QT_OPENGL=angle ya no tienen ningún efecto. En las compilaciones dinámicas de OpenGL no hay una recarga automática a ANGLE en caso de que OpenGL propiamente dicho no se inicialice. Para las aplicaciones basadas en QWindow o QWidget que utilizan OpenGL directamente, por ejemplo a través de QOpenGLWidget, esto significa que OpenGL propiamente dicho es la única opción en tiempo de ejecución. Sin embargo, sigue estando disponible el uso de una implementación de OpenGL puramente de software, como Mesa llvmpipe, que se incluye con los paquetes Qt precompilados.

Para las aplicaciones 3D de Qt Quick y Qt Quick, Qt 6 introduce compatibilidad con Direct 3D 11, Vulkan y Metal, además de OpenGL. En Windows, Qt 6 utiliza Direct 3D de forma predeterminada, por lo que el efecto de la eliminación de ANGLE se ve atenuado por la incorporación de compatibilidad con otras API gráficas.

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