Condividi tramite


funzione glReadBuffer

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

Sintassi

void WINAPI glReadBuffer(
   GLenum mode
);

Parametri

modalità

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 è 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.

Osservazioni:

La funzione glReadBuffer specifica un buffer di colori 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 sono 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 assegnare al buffer il nome back-left.

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 nonstereo. Si tratta di un errore per specificare un buffer inesistente in glReadBuffer.

Per impostazione predefinita, la modalità è GL_FRONT in configurazioni a 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

Vedere anche

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels