glClear-Funktion

Die glClear-Funktion löscht Puffer auf voreingestellte Werte.

Syntax

void WINAPI glClear(
   GLbitfield mask
);

Parameter

mask

Bitweise OR-Operatoren von Masken, die die zu löschenden Puffer angeben. Die vier Masken sind 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_ACCUM_BUFFER_BIT	Der Akkumulationspuffer.
GL_STENCIL_BUFFER_BIT	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_INVALID_VALUE	Alle anderen Bits als die vier definierten Bits wurden in der Maske festgelegt.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glClear-Funktion legt den Bitplanebereich des Fensters auf Werte fest, die zuvor von glClearColor, glClearIndex, glClearDepth, glClearStencil und glClearAccum ausgewählt wurden. Sie können mehrere Farbpuffer gleichzeitig löschen, indem Sie mit glDrawBuffer mehrere Puffer gleichzeitig auswählen.

Der Pixelbesitztest, der Scissor-Test, das Dithering und die Pufferschreibmasken wirken sich auf den Betrieb von glClear aus. Das Scherenfeld umgrenzt den gelöschten Bereich. Die glClear-Funktion ignoriert die Alphafunktion, die Blendfunktion, den logischen Vorgang, die Schablone, die Texturzuordnung und das Z-Puffern.

Die glClear-Funktion nimmt ein einzelnes Argument (Maske) an, bei dem es sich um das bitweise OR von mehreren Werten handelt, die angeben, welcher Puffer gelöscht werden soll.

Der Wert, für den jeder Puffer gelöscht wird, hängt von der Einstellung des clear-Werts für diesen Puffer ab.

Wenn kein Puffer vorhanden ist, hat ein an diesen Puffer gerichteter glClear-Aufruf keine Auswirkung.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glClear ab:

glGet mit Argument GL_ACCUM_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

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