glClear-Funktion

Die glClear-Funktion gibt Puffer für vordefinierte Werte frei.

Syntax

void WINAPI glClear(
   GLbitfield mask
);

Parameter

mask

Bitweise OR-Operatoren von Masken, die die zu löschenden Puffer angeben. Die vier Masken lauten wie folgt.

Wert Bedeutung
GL _ COLOR _ BUFFER _ BIT
Die Puffer, die derzeit für das Schreiben von Farben aktiviert sind.
GL _ DEPTH _ BUFFER _ BIT
Der Tiefenpuffer.
_ _ GL-PUFFERBIT _
Der Akkumulationspuffer.
_ _ GL-SCHABLONENPUFFERBIT _
Der Schablonenpuffer.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL _ UNGÜLTIGER _ WERT
Ein anderes Bit als die vier definierten Bits wurde in der Maske festgelegt.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Hinweise

Die glClear-Funktion legt den Bitebenenbereich des Fensters auf Werte fest, die zuvor von glClearColor, glClearIndex, glClearDepth, glClearStencilund glClearAccumausgewählt wurden. Sie können mehrere Farbpuffer gleichzeitig löschen, indem Sie mit glDrawBuffermehrere Puffer gleichzeitig auswählen.

Der Pixelbesitztest, der Scissor-Test, das Dithering und die Puffer-Schreibmasken wirken sich auf den Betrieb von glClear aus. Das Scissor-Feld umrandet den frei werdenden Bereich. Die glClear-Funktion ignoriert die Alphafunktion, blend-Funktion, logische Operation, Schablone, Texturzuordnung und z-Pufferung.

Die glClear-Funktion verwendet ein einzelnes Argument (mask), das das bitweise OR mehrerer Werte ist, das angibt, welcher Puffer zu löschen ist.

Der Wert, für den jeder Puffer gepuffert wird, hängt von der Einstellung des eindeutigen Werts für diesen Puffer ab.

Wenn kein Puffer vorhanden ist, hat ein glClear-Aufruf, der an diesen Puffer gerichtet ist, keine Auswirkungen.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glClear ab:

glGet mit dem Argument _ GLGEM _ CLEAR _ VALUE

glGet mit Argument GL _ DEPTH _ CLEAR _ VALUE

glGet mit Argument GL _ INDEX CLEAR _ _ VALUE

glGet mit Argument GL _ COLOR CLEAR _ _ VALUE

glGet mit Argument GL _ STENCIL _ CLEAR _ VALUE

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Siehe auch

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor