funzione glClear

La funzione glClear cancella i buffer per impostare i valori predefiniti.

Sintassi

void WINAPI glClear(
   GLbitfield mask
);

Parametri

Maschera

Operatori OR bit per bit delle maschere che indicano che i buffer devono essere cancellati. Le quattro maschere sono le seguenti.

Valore Significato
GL_COLOR_BUFFER_BIT
I buffer attualmente abilitati per la scrittura dei colori.
GL_DEPTH_BUFFER_BIT
Buffer di profondità.
GL_ACCUM_BUFFER_BIT
Buffer di accumulo.
GL_STENCIL_BUFFER_BIT
Buffer stencil.

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_VALUE
Qualsiasi bit diverso dai quattro bit definiti è stato impostato in maschera.
GL_INVALID_OPERATION
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La funzione glClear imposta l'area bitplane della finestra sui valori precedentemente selezionati da glClearColor, glClearIndex, glClearDepth, glClearStencil e glClearAccum. È possibile cancellare più buffer di colore contemporaneamente selezionando più buffer alla volta usando glDrawBuffer.

Il test di proprietà pixel, il test di scissor, il dithering e i mascherati di scrittura del buffer influiscono sull'operazione di glClear. La casella scissor delimita l'area cancellata. La funzione glClear ignora la funzione alfa, la funzione blend, l'operazione logica, lo stenciling, il mapping delle trame e il buffer z.

La funzione glClear accetta un singolo argomento (maschera) che è l'OR bit per bit di diversi valori che indicano quale buffer deve essere cancellato.

Il valore a cui ogni buffer viene cancellato dipende dall'impostazione del valore chiaro per tale buffer.

Se un buffer non è presente, una chiamata glClear indirizzata a tale buffer non ha alcun effetto.

Le funzioni seguenti recuperano informazioni correlate a glClear:

glGet con argomento GL_ACCUM_CLEAR_VALUE

glGet con argomento GL_DEPTH_CLEAR_VALUE

glGet con argomento GL_INDEX_CLEAR_VALUE

glGet con argomento GL_COLOR_CLEAR_VALUE

glGet con argomento GL_STENCIL_CLEAR_VALUE

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

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor