QAbstractOpenGLFunctions Class
La clase `QAbstractOpenGLFunctions` es la clase base de una familia de clases que exponen todas las funciones para cada versión y perfil de OpenGL. Más información...
| Encabezado: | #include <qopenglversionfunctions.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS OpenGL) target_link_libraries(mytarget PRIVATE Qt6::OpenGL) |
| qmake: | QT += opengl |
| Heredado por: | 27 tiposQOpenGLFunctions_1_0, QOpenGLFunctions_1_1, QOpenGLFunctions_1_2, QOpenGLFunctions_1_3, QOpenGLFunctions_1_4, QOpenGLFunctions_1_5, QOpenGLFunctions_2_0, QOpenGLFunctions_2_1, QOpenGLFunctions_3_0, QOpenGLFunctions_3_1, QOpenGLFunctions_3_2_Compatibility, QOpenGLFunctions_3_2_Core, QOpenGLFunctions_3_3_Compatibility, QOpenGLFunctions_3_3_Core, QOpenGLFunctions_4_0_Compatibility, QOpenGLFunctions_4_0_Core, QOpenGLFunctions_4_1_Compatibility, QOpenGLFunctions_4_1_Core, QOpenGLFunctions_4_2_Compatibility, QOpenGLFunctions_4_2_Core, QOpenGLFunctions_4_3_Compatibility, QOpenGLFunctions_4_3_Core, QOpenGLFunctions_4_4_Compatibility, QOpenGLFunctions_4_4_Core, QOpenGLFunctions_4_5_Compatibility, QOpenGLFunctions_4_5_Core, y QOpenGLFunctions_ES2 |
Funciones públicas
| QAbstractOpenGLFunctions(const QAbstractOpenGLFunctions &) | |
| virtual | ~QAbstractOpenGLFunctions() |
| QAbstractOpenGLFunctions & | operator=(const QAbstractOpenGLFunctions &) |
Funciones protegidas
Descripción detallada
Las implementaciones de OpenGL en diferentes plataformas pueden vincularse a un número variable de funciones de OpenGL en función de la ABI de OpenGL de dicha plataforma. Por ejemplo, en Microsoft Windows solo se pueden vincular en tiempo de compilación las funciones hasta las de OpenGL 1.1. El resto de funciones deben resolverse en tiempo de ejecución. La solución tradicional a este problema ha sido utilizar ` QOpenGLContext::getProcAddress()` o ` QOpenGLFunctions`. La primera es tediosa y propensa a errores, y implica manejar directamente punteros a funciones. La segunda solo expone aquellas funciones comunes a OpenGL ES 2 y a OpenGL de escritorio. Sin embargo, hay muchas funcionalidades nuevas de OpenGL que resultan útiles a la hora de escribir aplicaciones OpenGL para el mundo real.
Qt ofrece ahora una familia de clases que heredan de `QAbstractOpenGLFunctions` y que exponen todas las funciones básicas de OpenGL a través de una función miembro correspondiente. Existe una clase para cada combinación válida de versión y perfil de OpenGL. Cada clase sigue la convención de nomenclatura:
QOpenGLFunctions_<MAJOR VERSION>_<MINOR VERSION>[_PROFILE]Para las versiones de OpenGL 1.0 a 3.0 no hay perfiles, lo que da lugar a las clases:
- QOpenGLFunctions_1_0
- QOpenGLFunctions_1_1
- QOpenGLFunctions_1_2
- QOpenGLFunctions_1_3
- QOpenGLFunctions_1_4
- QOpenGLFunctions_1_5
- QOpenGLFunctions_2_0
- QOpenGLFunctions_2_1
- QOpenGLFunctions_3_0
donde cada clase hereda de `QAbstractOpenGLFunctions`.
La versión 3.1 de OpenGL eliminó muchas funciones obsoletas, lo que dio lugar a una API mucho más sencilla y genérica.
Con OpenGL 3.2 se introdujo el concepto de perfiles. Actualmente hay dos perfiles definidos para OpenGL: Core y Compatibility.
El perfil Core no incluye ninguna de las funciones que se eliminaron en OpenGL 3.1. El perfil «Compatibility» contiene todas las funciones del perfil «Core» de la misma versión, además de todas las funciones que se eliminaron en OpenGL 3.1. De este modo, las clases del perfil «Compatibility» permiten utilizar las nuevas funcionalidades de OpenGL, pero también te permiten seguir utilizando tu código OpenGL heredado. Para el código OpenGL nuevo, se debe dar preferencia al perfil «Core».
Ten en cuenta que algunos proveedores, en particular Apple, no implementan el perfil «Compatibility». Por lo tanto, si deseas utilizar las nuevas características de OpenGL en macOS, debes asegurarte de solicitar un contexto de perfil «Core» mediante QSurfaceFormat::setProfile().
Qt proporciona clases para todas las combinaciones de versiones y perfiles «Qt Core» y «Compatibility». Las clases para las versiones de OpenGL desde la 3.1 hasta la 4.3 son:
- QOpenGLFunctions_3_1
- QOpenGLFunctions_3_2_Core
- QOpenGLFunctions_3_2_Compatibility
- QOpenGLFunctions_3_3_Core
- QOpenGLFunctions_3_3_Compatibility
- QOpenGLFunctions_4_0_Core
- QOpenGLFunctions_4_0_Compatibility
- QOpenGLFunctions_4_1_Core
- QOpenGLFunctions_4_1_Compatibility
- QOpenGLFunctions_4_2_Core
- QOpenGLFunctions_4_2_Compatibility
- QOpenGLFunctions_4_3_Core
- QOpenGLFunctions_4_3_Compatibility
donde cada clase hereda de `QAbstractOpenGLFunctions`.
Se puede obtener un puntero a un objeto de la clase correspondiente a la versión y el perfil de OpenGL en uso mediante ` QOpenGLVersionFunctionsFactory::get()` (). Si se obtiene de esta forma, ten en cuenta que ` QOpenGLContext ` conserva la propiedad del objeto. Esto permite que la instancia se almacene en caché y se comparta.
Antes de llamar a cualquiera de las funciones OpenGL expuestas, debes asegurarte de que el objeto haya resuelto los punteros a las funciones OpenGL. Esto solo es necesario hacerlo una vez por instancia mediante initializeOpenGLFunctions(). Una vez inicializado, el objeto puede utilizarse para llamar a cualquier función OpenGL correspondiente a la versión y el perfil en cuestión. Ten en cuenta que `initializeOpenGLFunctions()` puede fallar en algunas circunstancias, por lo que debes comprobar el valor de retorno. La inicialización puede fallar si tienes un objeto de funciones para una versión o perfil que contenga funciones que no formen parte del contexto utilizado para resolver los punteros de función.
Si se utilizan exclusivamente objetos de funciones, se producirán errores en tiempo de compilación al intentar utilizar una función que no esté incluida en esa versión y perfil. Obviamente, esto es mucho más fácil de depurar que un comportamiento indefinido en tiempo de ejecución.
Véase también QOpenGLVersionFunctionsFactory::get().
Documentación sobre funciones de miembro
[protected] QAbstractOpenGLFunctions::QAbstractOpenGLFunctions()
Crea un objeto de tipo QAbstractOpenGLFunctions.
[delete] QAbstractOpenGLFunctions::QAbstractOpenGLFunctions(const QAbstractOpenGLFunctions &)
Crea una instancia de ` QAbstractOpenGLFunctions` mediante copia. Esta función se ha eliminado.
[virtual noexcept] QAbstractOpenGLFunctions::~QAbstractOpenGLFunctions()
Elimina un objeto de tipo « QAbstractOpenGLFunctions ».
[delete] QAbstractOpenGLFunctions &QAbstractOpenGLFunctions::operator=(const QAbstractOpenGLFunctions &)
Asigna por copia « other » a esta instancia de « QAbstractOpenGLFunctions ». Esta función se ha eliminado.
© 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.