En esta página

QOpenGLVertexArrayObject Class

La clase QOpenGLVertexArrayObject envuelve un objeto de matriz de vértices de OpenGL. Más información...

Encabezado: #include <QOpenGLVertexArrayObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake: QT += opengl
Heredado de: QObject

Tipos públicos

class Binder

Funciones públicas

QOpenGLVertexArrayObject(QObject *parent = nullptr)
virtual ~QOpenGLVertexArrayObject()
void bind()
bool create()
void destroy()
bool isCreated() const
GLuint objectId() const
void release()

Descripción detallada

Un objeto de matriz de vértices (VAO) es un objeto contenedor de OpenGL que encapsula el estado necesario para especificar datos de atributos por vértice al canal de procesamiento de OpenGL. Dicho de otro modo, un VAO recuerda los estados de los objetos de búfer (véase QOpenGLBuffer) y su estado asociado (por ejemplo, los divisores de atributos de vértice). Esto permite un método muy sencillo y eficiente para cambiar entre los estados de los búferes de OpenGL a la hora de renderizar diferentes «objetos» en una escena. La clase QOpenGLVertexArrayObject es una envoltura ligera alrededor de un VAO de OpenGL.

En el entorno de escritorio, los VAO son compatibles como característica principal en OpenGL 3.0 o versiones posteriores, y mediante la extensión GL_ARB_vertex_array_object para versiones anteriores. En OpenGL ES 2, los VAO se proporcionan mediante la extensión opcional GL_OES_vertex_array_object. Puedes comprobar la versión de OpenGL con QOpenGLContext::surfaceFormat() y verificar la presencia de extensiones con QOpenGLContext::hasExtension().

Al igual que con las demás clases de « Qt OpenGL », QOpenGLVertexArrayObject dispone de una función « create()» para crear el objeto OpenGL subyacente. Esto permite al desarrollador asegurarse de que existe un contexto OpenGL válido en ese momento.

Una vez creado correctamente un VAO, el patrón de uso habitual es el siguiente:

  • En la función de inicialización de la escena, para cada objeto visual:
    • Vincular el VAO
    • Establecer el estado de los datos de vértices para este objeto visual (vértices, normales, coordenadas de textura, etc.)
    • Desvincular (release())) el VAO
  • En la función de renderizado, para cada objeto visual:
    • Vincular el VAO (y el programa de sombreado si es necesario)
    • Llamar a una función glDraw*()
    • Desvincular (release()) el VAO

El hecho de vincular el VAO en la función de renderizado tiene como efecto restaurar toda la configuración del estado de los datos de vértices establecida en la fase de inicialización. De esta forma, podemos establecer una gran cantidad de estado al configurar un VAO y cambiar de manera eficiente entre los conjuntos de estado de los objetos que se van a renderizar. El uso de VAO también permite al controlador de OpenGL amortizar las comprobaciones de validación de los datos de vértices.

Nota: Los objetos de matrizde vértices (VAO), al igual que el resto de objetos contenedores de OpenGL, son específicos del contexto para el que se crearon y no pueden compartirse entre un grupo de contextos.

Véase también QOpenGLVertexArrayObject::Binder y QOpenGLBuffer.

Documentación de las funciones miembro

[explicit] QOpenGLVertexArrayObject::QOpenGLVertexArrayObject(QObject *parent = nullptr)

Crea un objeto `QOpenGLVertexArrayObject` con el ` parent` especificado. Antes de utilizarlo, debes llamar a ` create()` con un contexto OpenGL válido.

[virtual noexcept] QOpenGLVertexArrayObject::~QOpenGLVertexArrayObject()

Elimina el objeto ` QOpenGLVertexArrayObject ` y el recurso OpenGL subyacente.

void QOpenGLVertexArrayObject::bind()

Vincula este objeto de matriz de vértices al punto de enlace de OpenGL. A partir de este momento y hasta que se llame a ` release()` o se vincule otro objeto de matriz de vértices, cualquier modificación realizada en el estado de los datos de los vértices se almacena dentro de este objeto de matriz de vértices.

Si posteriormente se vincula otro objeto de matriz de vértices, se puede restaurar más tarde el conjunto de estados asociado a este objeto llamando de nuevo a bind() sobre él. Esto permite realizar cambios eficientes entre los estados de los datos de vértices en las funciones de renderizado.

bool QOpenGLVertexArrayObject::create()

Crea el objeto de matriz de vértices de OpenGL subyacente. Para que esta función se ejecute correctamente, debe haber un contexto de OpenGL válido y activo que admita objetos de matriz de vértices.

Devuelve « true » si el objeto de matriz de vértices de OpenGL se ha creado correctamente.

Cuando el valor de retorno es ` false`, no hay compatibilidad con los objetos de matriz de vértices. Esto no es un error: en sistemas con OpenGL 2.x u OpenGL ES 2.0 es posible que no se admitan los objetos de matriz de vértices. En este caso, la aplicación puede continuar con la ejecución, pero debe estar preparada para funcionar también sin objetos de matriz de vértices. Esto significa que, en lugar de limitarse a llamar a ` bind()`, debe comprobarse el valor de ` isCreated()` y las matrices de vértices deben inicializarse de la forma tradicional cuando no haya ningún objeto de matriz de vértices presente.

Véase también isCreated().

void QOpenGLVertexArrayObject::destroy()

Destruye el objeto de matriz de vértices de OpenGL subyacente. Para que esta función se ejecute correctamente, debe haber un contexto de OpenGL válido y activo que admita objetos de matriz de vértices.

bool QOpenGLVertexArrayObject::isCreated() const

Devuelve « true » si se ha creado el objeto de matriz de vértices de OpenGL subyacente. Si devuelve « true » y el contexto de OpenGL asociado es el actual, entonces se puede llamar a « bind()» con este objeto.

GLuint QOpenGLVertexArrayObject::objectId() const

Devuelve el identificador del objeto de matriz de vértices de OpenGL subyacente.

void QOpenGLVertexArrayObject::release()

Desvincula este objeto de matriz de vértices vinculando el objeto de matriz de vértices predeterminado (id = 0).

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