WebGLRenderingContext: clear()-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die WebGLRenderingContext.clear()-Methode der WebGL API löscht Puffer auf voreingestellte Werte.
Die voreingestellten Werte können durch clearColor(), clearDepth() oder clearStencil() festgelegt werden.
Das Scherrechteck, das Dithering und die Puffer-Schreibmasken können die clear()-Methode beeinflussen.
Syntax
clear(mask)
Parameter
mask-
Ein
GLbitfieldBitweises ODER-Maske, die die zu löschenden Puffer angibt. Mögliche Werte sind:gl.COLOR_BUFFER_BITgl.DEPTH_BUFFER_BITgl.STENCIL_BUFFER_BIT
Rückgabewert
Keiner (undefined).
Ausnahmen
Wenn mask nicht einer der aufgeführten möglichen Werte ist, wird ein
gl.INVALID_ENUM-Fehler ausgelöst.
Beispiele
Die clear()-Methode akzeptiert mehrere Werte.
gl.clear(gl.DEPTH_BUFFER_BIT);
gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
Um die aktuellen Löschwerte zu erhalten, fragen Sie die Konstanten COLOR_CLEAR_VALUE,
DEPTH_CLEAR_VALUE und STENCIL_CLEAR_VALUE ab.
gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);
Spezifikationen
| Specification |
|---|
| WebGL Specification # 5.14.11 |