Função glReadBuffer

A função glReadBuffer seleciona uma fonte de buffer de cores para pixels.

Sintaxe

void WINAPI glReadBuffer(
   GLenum mode
);

Parâmetros

mode

Um buffer de cores. Os valores aceitos são GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT e GL_AUX i, em que estou entre 0 e GL_AUX_BUFFERS 1.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Nome	Significado
GL_INVALID_ENUM	mode não foi um dos doze (ou mais) valores aceitos.
GL_INVALID_OPERATION	o modo especificou um buffer que não existe.
GL_INVALID_OPERATION	A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glReadBuffer especifica um buffer de cores como a origem para os comandos glReadPixels e glCopyPixels subsequentes. O parâmetro mode aceita um dos doze ou mais valores predefinidos. (GL_AUX0 por meio de GL_AUX3 são sempre definidos.) Em um sistema totalmente configurado, GL_FRONT, GL_LEFT e GL_FRONT_LEFT nomeie o buffer front-left, GL_FRONT_RIGHT e GL_RIGHT nomeie o buffer front-right e GL_BACK_LEFT e GL_BACK nomeie o buffer de back-left.

As configurações com buffer duplo nãostereo têm apenas um front-left e um buffer de back-left. As configurações de buffer único têm um front-left e um buffer frontal-direito, se estéreo, e apenas um buffer front-left se não forstereo. É um erro especificar um buffer inexistente para glReadBuffer.

Por padrão, o modo é GL_FRONT em configurações de buffer único e GL_BACK em configurações com buffer duplo.

A função a seguir recupera informações relacionadas ao glReadBuffer:

glGet com GL_READ_BUFFER de argumento

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels