funzione glDrawBuffer

La funzione glDrawBuffer specifica i buffer di colore da disegnare.

Sintassi

void WINAPI glDrawBuffer(
   GLenum mode
);

Parametri

mode

Specifica fino a quattro buffer di colore da disegnare con le costanti simboliche accettabili seguenti.

Valore	Significato
GL_NONE	Non vengono scritti buffer di colore.
GL_FRONT_LEFT	Viene scritto solo il buffer di colore anteriore sinistro.
GL_FRONT_RIGHT	Viene scritto solo il buffer di colore anteriore destro.
GL_BACK_LEFT	Viene scritto solo il buffer di colore indietro sinistro.
GL_BACK_RIGHT	Viene scritto solo il buffer di colore indietro destro.
GL_FRONT	Vengono scritti solo i buffer di colore front-left e front-right. Se non è presente alcun buffer di colore front-right, viene scritto solo il buffer a sinistra anteriore.
GL_BACK	Vengono scritti solo i buffer di colore indietro e indietro destro. Se non è presente alcun buffer di colore indietro a destra, viene scritto solo il buffer colore indietro sinistro.
GL_LEFT	Vengono scritti solo i buffer di colore front-left e indietro. Se non è presente alcun buffer di colore indietro sinistro, viene scritto solo il buffer colore front-left.
GL_RIGHT	Vengono scritti solo i buffer di colore front-destra e indietro. Se non è presente alcun buffer di colore indietro, viene scritto solo il buffer colore front-right.
GL_FRONT_AND_BACK	Vengono scritti tutti i buffer di colore front-end e indietro (front-left, front-right, back-left, back-right). Se non sono presenti buffer di colore indietro, vengono scritti solo i buffer di colore front-left e front-right. Se non sono presenti buffer di colore destro, vengono scritti solo i buffer di colore front-left e back-left. Se non sono presenti buffer di colore destro o indietro, viene scritto solo il buffer colore front-left.
GL_AUXi	Solo il buffer di colore ausiliario io è scritto; i è compreso tra 0 e GL_AUX_BUFFERS - 1. (GL_AUX_BUFFERS non è il limite superiore; usare glGet per eseguire query sul numero di buffer ausiliari disponibili.

Il valore predefinito è GL_FRONT per contesti con buffer singolo e GL_BACK per contesti con buffer doppio.

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 è stata accettata.
GL_INVALID_OPERATION	Nessuno dei buffer indicati dalla modalità esiste.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

Quando i colori vengono scritti nella cornicebuffer, vengono scritti nei buffer di colore specificati da glDrawBuffer.

Se viene selezionato più buffer di colori per il disegno, le operazioni di fusione o logica vengono calcolate e applicate in modo indipendente per ogni buffer di colore e possono produrre risultati diversi in ogni buffer.

I contesti monoscopici includono solo buffer sinistro e contesti stereoscopici includono buffer sinistro e destro. Analogamente, i contesti con buffer singolo includono solo buffer front e contesti con buffer doppio includono buffer front-and back. Il contesto viene selezionato all'inizializzazione OpenGL.

È sempre il caso che GL_AUX i = GL_AUX0 + i.

Le funzioni seguenti recuperano informazioni correlate alla funzione glDrawBuffer :

glGet con argomento GL_DRAW_BUFFER

glGet con argomento GL_AUX_BUFFERS

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

glBlendFunc

glColorMask

glEnd

glGet

glIndexMask

glLogicOp

glReadBuffer