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, onde estou entre 0 e GL_AUX_BUFFERS 1.

Retornar valor

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

Códigos do Erro

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

Nome Significado
GL_INVALID_ENUM
o modo não era 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 de modo 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 back-left.

As configurações com buffer duplo nãostereo têm apenas um front-left e um buffer back-left. As configurações de buffer único têm um buffer front-left e front-right, 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 de 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