En esta página

Qt OpenGL

Qt ofrece dos enfoques principales para el desarrollo de la interfaz de usuario: Qt Quick y Qt Widgets. Estos enfoques están pensados para dar soporte a diferentes tipos de interfaces de usuario y se basan en motores gráficos independientes que se han optimizado para cada uno de estos tipos.

En Qt es posible combinar código escrito en la API gráfica OpenGL con ambos tipos de interfaz de usuario. Esto puede resultar útil cuando la aplicación tiene su propio código dependiente de OpenGL o cuando se integra con un renderizador de terceros basado en OpenGL.

El módulo « Qt OpenGL » contiene clases de conveniencia para facilitar y agilizar este tipo de integración.

Qt OpenGL y Qt Widgets

Qt Widgets suele representarse mediante un rasterizador de software altamente optimizado y preciso, y el contenido final se reproduce en pantalla utilizando un método adecuado para la plataforma en la que se ejecuta la aplicación.

Pero también es posible combinar Qt Widgets con OpenGL. El punto de entrada principal para ello es la clase ` QOpenGLWidget `. Esta clase se puede utilizar para habilitar el renderizado con OpenGL en una parte determinada del árbol de widgets, y las clases del módulo ` Qt OpenGL ` pueden utilizarse para facilitar cualquier código OpenGL del lado de la aplicación.

Qt OpenGL y Qt Quick

Qt Quick está optimizado para el renderizado acelerado por hardware. De forma predeterminada, se compilará sobre la API gráfica de bajo nivel más adecuada para la plataforma de destino.

Por ejemplo, en Windows utilizará por defecto Direct3D, mientras que en macOS utilizará por defecto Metal. No obstante, también es posible seleccionar manualmente OpenGL como API gráfica activa en aquellas plataformas que lo admitan.

Para obtener más detalles sobre cómo habilitar OpenGL con Qt Quick, consulta la documentación del renderizador de grafos de escena.

Uso del módulo

Para utilizar la API de C++ de un módulo de Qt es necesario vincularla con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utilice el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Compilación con qmake

Para configurar el módulo para la compilación con qmake, añade el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:

QT += opengl

Ejemplos

Referencia

Evolución del módulo

La sección«Cambios en Qt OpenGL » enumera los cambios importantes en la API y la funcionalidad del módulo que se han realizado para la serie Qt 6 de Qt.

Licencias y marcas registradas

El módulo « Qt OpenGL » está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre: la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt para obtener más detalles.

OpenGL® es una marca comercial de Silicon Graphics, Inc. en Estados Unidos y otros países.

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