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 |
|---|---|
|
Alle anderen Bits als die vier definierten Bits wurden in der Maske festgelegt. |
|
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 |
|
| Bibliothek |
|
| DLL |
|