Функция glReadBuffer

Статья
06/13/2023

Функция glReadBuffer выбирает источник буфера цвета для пикселей.

Синтаксис

void WINAPI glReadBuffer(
   GLenum mode
);

Параметры

mode: Буфер цвета. Допустимые значения: GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT и GL_AUX i, где значение i находится в диапазоне от 0 до GL_AUX_BUFFERS 1.

Возвращаемое значение

Эта функция не возвращает значение.

Коды ошибок

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

Имя	Значение
GL_INVALID_ENUM	Mode не является одним из двенадцати (или более) принятых значений.
GL_INVALID_OPERATION	mode указывает буфер, который не существует.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Функция glReadBuffer указывает буфер цвета в качестве источника для последующих команд glReadPixels и glCopyPixels . Параметр mode принимает одно из двенадцати или более предопределенных значений. (GL_AUX0 через GL_AUX3 всегда определяются.) В полностью настроенной системе GL_FRONT, GL_LEFT и GL_FRONT_LEFT укажите имя левого переднего буфера, GL_FRONT_RIGHT и GL_RIGHT имя правого переднего буфера, а GL_BACK_LEFT и GL_BACK имя левого буфера.

Нестерео с двойной буферией конфигурации имеют только передний левый и задний левый буфер. Конфигурации с одним буфером имеют буфер переднего левого и переднего правого буфера, если стерео, и только передний левый буфер, если нестерео. Указание несуществующего буфера для glReadBuffer является ошибкой.

По умолчанию режим GL_FRONT в конфигурациях с одной буферизацией, а GL_BACK в конфигурациях с двойной буферизацией.

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

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

Требования

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

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

glBegin
glCopyPixels
glDrawBuffer
glEnd
glReadPixels