Функция glRenderMode

Статья
06/13/2023

Функция glRenderMode задает режим растеризации.

Синтаксис

GLint WINAPI glRenderMode(
   GLenum mode
);

Параметры

mode

Режим растеризации. Принимаются следующие три значения. Значение по умолчанию — GL_RENDER.

Значение	Значение
GL_RENDER	Режим отрисовки. Примитивы растеризуются, создавая пиксельные фрагменты, которые записываются в framebuffer. Это обычный режим, а также режим по умолчанию.
GL_SELECT	Режим выбора. Фрагменты пикселей не создаются, а содержимое framebuffer не изменяется. Вместо этого запись имен примитивов, которые были бы нарисованы, если бы режим отрисовки был GL_RENDER, возвращается в буфере выбора, который необходимо создать (см . glSelectBuffer) перед вводом режима выбора.
GL_FEEDBACK	Режим обратной связи. Фрагменты пикселей не создаются, а содержимое framebuffer не изменяется. Вместо этого координаты и атрибуты вершин, которые были бы нарисованы, если бы режим отрисовки был GL_RENDER, возвращаются в буфере обратной связи, который необходимо создать (см. glFeedbackBuffer) перед вводом режима обратной связи.

Коды ошибок

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

Имя	Значение
GL_INVALID_ENUM	mode не является одним из трех допустимых значений.
GL_INVALID_OPERATION	Функция была вызвана с аргументом GL_SELECT до вызова glSelectBuffer по крайней мере один раз.
GL_INVALID_OPERATION	Функция была вызвана с аргументом GL_FEEDBACK до вызова glBeedbackBuffer по крайней мере один раз.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Возвращаемое значение функции glRenderMode определяется режимом отрисовки во время вызова glRenderMode , а не режимом . Для трех режимов отрисовки возвращаются следующие значения.

Значение	Значение
GL_RENDER	Ноль.
GL_SELECT	Количество записей попаданий, переданных в буфер выбора.
GL_FEEDBACK	Количество значений (не вершин), переданных в буфер обратной связи.

Дополнительные сведения об операциях выбора и обратной связи см. в разделе glSelectBuffer и glFeedbackBuffer .

При возникновении ошибки glRenderMode возвращает ноль независимо от текущего режима отрисовки.

Следующая функция извлекает сведения, связанные с glRenderMode:

glGet с аргументом GL_RENDER_MODE

Требования

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

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

glBegin
glEnd
glFeedbackBuffer
glInitNames
glLoadName
glPassThrough
glPushName
glSelectBuffer

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