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 |
|---|---|
|
la modalità non è stata accettata. |
|
Nessuno dei buffer indicati dalla modalità esiste. |
|
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 |
|
| Libreria |
|
| DLL |
|