Класс QAbstractOpenGLFunctions

Класс 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, можно получить из QOpenGLVersionFunctionsFactory::get(). Если он получен таким способом, обратите внимание, что QOpenGLContext сохраняет владение объектом. Это делается для того, чтобы экземпляр можно было кэшировать и использовать совместно.

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

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

См. также QOpenGLVersionFunctionsFactory::get().

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

[protected] QAbstractOpenGLFunctions::QAbstractOpenGLFunctions()

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

[virtual] QAbstractOpenGLFunctions::~QAbstractOpenGLFunctions()

Деструктор объекта QAbstractOpenGLFunctions.