funzione glReadBuffer

La funzione glReadBuffer seleziona un'origine del buffer dei colori per pixel.

Sintassi

void WINAPI glReadBuffer(
   GLenum mode
);

Parametri

mode

Buffer dei colori. I valori accettati sono GL_FRONT_LEFT, GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT e GL_AUX i, dove i è compreso tra 0 e GL_AUX_BUFFERS 1.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome	Significato
GL_INVALID_ENUM	mode non era uno dei dodici (o più) valori accettati.
GL_INVALID_OPERATION	mode ha specificato un buffer che non esiste.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La funzione glReadBuffer specifica un buffer di colore come origine per i comandi glReadPixels e glCopyPixels successivi. Il parametro mode accetta uno dei dodici o più valori predefiniti. Le GL_AUX0 tramite GL_AUX3 sono sempre definite. In un sistema completamente configurato, GL_FRONT, GL_LEFT e GL_FRONT_LEFT tutti i nomi del buffer front-left, GL_FRONT_RIGHT e GL_RIGHT denominare il buffer anteriore destro e GL_BACK_LEFT e GL_BACK denominare il buffer indietro sinistro.

Le configurazioni con doppio buffer nonstereo hanno solo un buffer front-left e un buffer back-left. Le configurazioni con buffer singolo hanno un buffer front-left e un buffer front-right se stereo e solo un buffer front-left se non èstereo. Si tratta di un errore per specificare un buffer inesistente in glReadBuffer.

Per impostazione predefinita, la modalità è GL_FRONT in configurazioni con buffer singolo e GL_BACK in configurazioni con doppio buffer.

La funzione seguente recupera le informazioni correlate a glReadBuffer:

glGet con argomento GL_READ_BUFFER

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels