En esta página

QOpenGLVersionFunctionsFactory Class

Permite acceder a las funciones de OpenGL para una versión y un perfil específicos. Más...

Encabezado: #include <QOpenGLVersionFunctionsFactory>
CMake: find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake: QT += opengl
Desde: Qt 6.0

Miembros públicos estáticos

QAbstractOpenGLFunctions *get(const QOpenGLVersionProfile &versionProfile = QOpenGLVersionProfile(), QOpenGLContext *context = nullptr)
TYPE *get(QOpenGLContext *context = nullptr)

Descripción detallada

Documentación de las funciones de miembro

[static] QAbstractOpenGLFunctions *QOpenGLVersionFunctionsFactory::get(const QOpenGLVersionProfile &versionProfile = QOpenGLVersionProfile(), QOpenGLContext *context = nullptr)

Devuelve un puntero a un objeto que permite acceder a todas las funciones de la clase « versionProfile » de « context ». No es necesario llamar a «QAbstractOpenGLFunctions::initializeOpenGLFunctions()» siempre que « context » esté vigente. También es posible llamar a esta función cuando el context no está activo, pero en ese caso es responsabilidad del llamante garantizar una inicialización correcta llamando posteriormente a QAbstractOpenGLFunctions::initializeOpenGLFunctions().

Normalmente se utilizaría la versión con plantilla de esta función para que el resultado se convierta automáticamente al tipo correcto.

[static] template <typename TYPE> TYPE *QOpenGLVersionFunctionsFactory::get(QOpenGLContext *context = nullptr)

Devuelve un puntero a un objeto que permite acceder a todas las funciones correspondientes a la versión y el perfil de este contexto. No es necesario llamar a QAbstractOpenGLFunctions::initializeOpenGLFunctions() siempre que context esté actualizado. También es posible llamar a esta función cuando el ` context ` no está actualizado, pero en ese caso es responsabilidad del llamante garantizar una inicialización adecuada llamando posteriormente a `QAbstractOpenGLFunctions::initializeOpenGLFunctions()`.

Normalmente se utilizaría la versión con plantilla de esta función para que el resultado se convierta automáticamente al tipo correcto.

auto funcs = QOpenGLVersionFunctionsFactory::get<QOpenGLFunctions_3_3_Core>(context);
if (!funcs) {
    qFatal("Could not obtain required OpenGL context version");
}

Es posible solicitar un objeto de funciones para una versión y un perfil distintos de aquellos para los que se creó el contexto. Para ello, utilice la versión de plantilla de esta función especificando el tipo de objeto de funciones deseado como parámetro de plantilla, o bien pasando un objeto ` QOpenGLVersionProfile ` como argumento a la función sin plantilla.

Ten en cuenta que las solicitudes de objetos de funciones de otras versiones o perfiles pueden fallar y, en tal caso, devolverán ` nullptr`. Las situaciones en las que la creación del objeto de funciones puede fallar se dan cuando la solicitud no puede satisfacerse debido a que se solicitan funciones que no se encuentran en la versión o el perfil de este contexto. Por ejemplo:

  • Solicitar un objeto de funciones del perfil básico 3.3 se realizaría correctamente.
  • Solicitar un objeto de funciones del perfil de compatibilidad 3.3 fallaría. No podríamos resolver las funciones obsoletas.
  • Solicitar un objeto de funciones del perfil básico 4.3 fallaría. No podríamos resolver las nuevas funciones básicas introducidas en las versiones 4.0-4.3.
  • La solicitud de un objeto de funciones de la versión 3.1 se realizaría con éxito. No hay nada en la versión 3.1 que no se encuentre también en el perfil básico 3.3.

Ten en cuenta que, si se crea un objeto de funciones mediante este método, el ` QOpenGLContext ` conserva la propiedad del objeto. Esto permite que el objeto se almacene en caché y se comparta.

Esta función sobrescribe QOpenGLVersionFunctionsFactory::get().

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