Функция glReadBuffer

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

Синтаксис

void WINAPI glReadBuffer(
   GLenum mode
);

Параметры

режим

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

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

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

Коды ошибок

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

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

Замечания

Функция glReadBuffer указывает цветной буфер в качестве источника для последующих команд glReadPixels и glCopyPixels . Параметр режима принимает одно из двенадцати или более предопределенных значений. (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