Класс QAbstractOpenGLFunctions

Класс QAbstractOpenGLFunctions является базовым классом семейства классов, которые предоставляют доступ ко всем функциям OpenGL для каждой версии и профиля. Подробнее...

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

Публичные функции

Защищённые функции

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

Класс QAbstractOpenGLFunctions является базовым классом семейства классов, которые предоставляют доступ ко всем функциям OpenGL для каждой версии и профиля.

Реализации OpenGL на разных платформах могут связываться с переменным количеством функций OpenGL в зависимости от OpenGL ABI на данной платформе. Например, в Microsoft Windows к моменту компиляции могут быть связаны только функции до OpenGL 1.1. Все остальные функции должны быть разрешены во время выполнения. Традиционным решением этой проблемы было использование либо QOpenGLContext::getProcAddress(), либо QOpenGLFunctions. Первый метод утомителен и подвержен ошибкам, и означает непосредственную работу с указателями на функции. Второй метод экспонирует только те функции, которые общие для OpenGL ES 2 и настольного OpenGL. Однако существует много новой функциональности OpenGL, которая полезна при написании реальных приложений OpenGL.

Qt теперь предоставляет семейство классов, все из которых наследуются от QAbstractOpenGLFunctions, которые экспонируют каждую основную функцию OpenGL с помощью соответствующей функции-члена. Существует класс для каждой допустимой комбинации версии и профиля OpenGL. Каждый класс следует соглашению об именовании:

QOpenGLFunctions_<MAJOR VERSION>_<MINOR VERSION>[_PROFILE]

Для версий OpenGL с 1.0 по 3.0 профилей нет, что приводит к классам:

• 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

где каждый класс наследуется от QAbstractOpenGLFunctions.

В версии OpenGL 3.1 были удалены многие устаревшие функции, что привело к более простому и универсальному API.

С OpenGL 3.2 было введено понятие профилей. В настоящее время определены два профиля OpenGL: Core и Compatibility.

Профиль Core не включает какие-либо функции, которые были удалены в OpenGL 3.1. Профиль Compatibility содержит все функции в профиле Core той же версии плюс все функции, которые были удалены в OpenGL 3.1. Таким образом, классы профиля Compatibility позволяют использовать более новые возможности OpenGL, а также позволяют использовать ваш устаревший код OpenGL. Для нового кода OpenGL следует предпочитать профиль Core.

Обратите внимание, что некоторые поставщики, в частности Apple, не реализуют профиль Compatibility. Поэтому, если вы хотите нацелиться на новые возможности OpenGL на macOS, вы должны убедиться, что запросили контекст профиля Core с помощью QSurfaceFormat::setProfile().

Qt предоставляет классы для всех версий и комбинаций профилей Core и Compatibility. Классы для версий OpenGL с 3.1 по 4.3:

• 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

где каждый класс наследуется от QAbstractOpenGLFunctions.

Указатель на объект класса, соответствующего используемой версии и профилю OpenGL, можно получить из QOpenGLContext::versionFunctions(). Если он получен таким образом, обратите внимание, что QOpenGLContext сохраняет владение объектом. Это делается для того, чтобы создать только один экземпляр.

Перед вызовом любой из экспонированных функций OpenGL необходимо убедиться, что объект разрешил указатели функций на функции OpenGL. Это необходимо сделать только один раз на экземпляр с помощью initializeOpenGLFunctions(). После инициализации объект можно использовать для вызова любой функции OpenGL для соответствующей версии и профиля. Обратите внимание, что initializeOpenGLFunctions() может завершиться неудачей в некоторых случаях, поэтому проверьте возвращаемое значение. Ситуации, в которых инициализация может завершиться неудачей, — это если у вас есть объект функций для версии или профиля, который содержит функции, которые не являются частью используемого контекста для разрешения указателей на функции.

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

См. также QOpenGLContext::versionFunctions().

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

[protected] QAbstractOpenGLFunctions::QAbstractOpenGLFunctions()

Конструирует объект QAbstractOpenGLFunctions.

[virtual] QAbstractOpenGLFunctions::~QAbstractOpenGLFunctions()

Уничтожает объект QAbstractOpenGLFunctions.