Функция glGetString

Статья
06/13/2023

Функция glGetString возвращает строку, описывающую текущее подключение OpenGL.

Синтаксис

const GLubyte* WINAPI glGetString(
   GLenum name
);

Параметры

name

Одна из следующих символических констант.

Значение	Значение
GL_VENDOR	Возвращает компанию, ответственную за реализацию OpenGL. Это имя не меняется от выпуска к выпуску.
GL_RENDERER	Возвращает имя отрисовщика. Обычно это имя зависит от конкретной конфигурации аппаратной платформы. Он не меняется от выпуска к выпуску.
GL_VERSION	Возвращает номер версии или выпуска.
GL_EXTENSIONS	Возвращает разделенный пробелами список поддерживаемых расширений для OpenGL.

Коды ошибок

Следующие коды ошибок могут быть получены функцией glGetError .

Имя	Значение
GL_INVALID_ENUM	name не является допустимым значением.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Так как OpenGL не включает запросы для характеристик производительности реализации, ожидается, что некоторые приложения будут написаны для распознавания известных платформ и изменят их использование OpenGL на основе известных характеристик производительности этих платформ. Строки, GL_VENDOR и GL_RENDERER вместе, однозначно указывают платформу и не изменяются от выпуска к выпуску. Они должны использоваться в качестве таковых алгоритмами распознавания платформы.

Формат и содержимое строки, возвращаемой glGetString , зависят от реализации, за исключением следующего:

Имена расширений не будут содержать пробелы и будут разделены пробелами в строке GL_EXTENSIONS.
Строка GL_VERSION начинается с номера версии. Номер версии использует одну из следующих форм:

major_number. minor_number

major_number. minor_number. release_number
Сведения о поставщике могут следовать за номером версии. Его формат зависит от реализации, но пробел всегда отделяет номер версии и сведения о поставщике.
Все строки заканчиваются значением NULL.

Если возникает ошибка, функция glGetString возвращает ноль.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Gl.h
Библиотека	Opengl32.lib
DLL	Opengl32.dll

См. также раздел

glBegin
glEnd

Поделиться через