Класс QOpenGLVertexArrayObject

Класс QOpenGLVertexArrayObject оборачивает объект массива вершин OpenGL. Подробнее...

Этот класс был представлен в Qt 5.1.

• Список всех членов, включая унаследованные

Типы публичного доступа

Открытые функции

Подробное описание

Объект массива вершин (VAO) — это контейнерный объект OpenGL, который инкапсулирует состояние, необходимое для задания данных атрибутов вершин для конвейера OpenGL. Другими словами, VAO запоминает состояние объектов буферов (см. QOpenGLBuffer) и их связанного состояния (например, делителей атрибутов вершин). Это позволяет очень просто и эффективно переключаться между состояниями буферов OpenGL для отображения различных «объектов» в сцене. Класс QOpenGLVertexArrayObject является тонким оболочкой вокруг VAO OpenGL.

Для настольных систем VAO поддерживаются как основная функция в OpenGL 3.0 или более поздних версиях и в GL_ARB_vertex_array_object для более ранних версий. В OpenGL ES 2 VAO предоставляются с помощью необязательного расширения GL_OES_vertex_array_object. Вы можете проверить версию OpenGL с помощью QOpenGLContext::surfaceFormat() и проверить наличие расширений с помощью QOpenGLContext::hasExtension().

Как и другие классы Qt OpenGL, QOpenGLVertexArrayObject имеет функцию create() для создания базового объекта OpenGL. Это позволяет разработчику убедиться, что в момент использования имеется допустимый текущий контекст OpenGL.

После успешного создания VAO типичная схема использования выглядит следующим образом:

• В функции инициализации сцены, для каждого визуального объекта:
  • Привязать VAO
  • Установить состояние данных вершин для этого визуального объекта (вершины, нормали, координаты текстуры и т. д.)
  • Отвязать ( release()) VAO
• В функции отрисовки, для каждого визуального объекта:
  • Привязать VAO (и программу шейдера, если нужно)
  • Вызвать функцию glDraw*()
  • Отвязать ( release()) VAO

Привязка VAO в функции отрисовки приводит к восстановлению всех состояний данных вершин, настроенных на фазе инициализации. Таким образом, мы можем настроить большое количество состояний при настройке VAO и эффективно переключаться между наборами состояний объектов, которые нужно отрисовать. Использование VAO также позволяет драйверу OpenGL амортизировать проверки валидности данных вершин.

Примечание: Объекты массива вершин, как и все другие контейнерные объекты OpenGL, специфичны для контекста, для которого они были созданы, и не могут быть объединены в группе контекста.

См. также QOpenGLVertexArrayObject::Binder и QOpenGLBuffer.

Документация по функциям-членам

QOpenGLVertexArrayObject::QOpenGLVertexArrayObject(QObject *parent = nullptr)

Создаёт QOpenGLVertexArrayObject с заданным parent. Необходимо вызвать create() с допустимым контекстом OpenGL перед использованием.

[virtual] QOpenGLVertexArrayObject::~QOpenGLVertexArrayObject()

Уничтожает QOpenGLVertexArrayObject и базовый ресурс OpenGL.

void QOpenGLVertexArrayObject::bind()

Привязывает этот объект массива вершин к точке привязки OpenGL. С этого момента и до вызова release() или привязки другого объекта массива вершин любые изменения, внесённые в состояние данных вершин, сохраняются в этом объекте массива вершин.

Если затем привязывается другой объект массива вершин, то позже вы можете восстановить набор состояний, связанных с этим объектом, вызвав bind() для этого объекта ещё раз. Это позволяет эффективно изменять состояния данных вершин в функциях отрисовки.

bool QOpenGLVertexArrayObject::create()

Создаёт базовый объект массива вершин OpenGL. Для успешного выполнения этой функции должен быть текущий допустимый контекст OpenGL, поддерживающий объекты массивов вершин.

Возвращает true , если объект массива вершин OpenGL был успешно создан.

Когда возвращаемое значение является false, поддержка объектов массивов вершин недоступна. Это не ошибка: на системах с OpenGL 2.x или OpenGL ES 2.0 объекты массивов вершин могут не поддерживаться. В этом случае приложение может продолжить выполнение, но должно быть готово работать и без VAO. Это означает, что вместо простого вызова bind() необходимо проверять значение isCreated() и инициализировать массивы вершин традиционным способом, когда объекты массивов вершин отсутствуют.

См. также isCreated().

void QOpenGLVertexArrayObject::destroy()

Уничтожает базовый объект массива вершин OpenGL. Для успешного выполнения этой функции должен быть текущий допустимый контекст OpenGL, поддерживающий объекты массивов вершин.

bool QOpenGLVertexArrayObject::isCreated() const

Возвращает true , если базовый объект массива вершин OpenGL был создан. Если это возвращает true и связанный контекст OpenGL текущий, то вы можете вызвать bind() для этого объекта.

GLuint QOpenGLVertexArrayObject::objectId() const

Возвращает идентификатор базового объекта массива вершин OpenGL.

void QOpenGLVertexArrayObject::release()

Отвязывает этот объект массива вершин, привязывая по умолчанию объект массива вершин (id = 0).