funzione glReadBuffer

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

Sintassi

void WINAPI glReadBuffer(
   GLenum mode
);

Parametri

mode

Buffer di colore. 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
la modalità non era uno dei dodici (o più) valori accettati.
GL_INVALID_OPERATION
modalità specificata da 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. (GL_AUX0 tramite GL_AUX3 vengono sempre definiti. 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 front-right e GL_BACK_LEFT e GL_BACK denominare il buffer back-left.

Le configurazioni double-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 nonstereo. 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 buffer doppio.

La funzione seguente recupera 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