WebGLRenderingContext: Methode clear()
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: Dieses Feature ist verfügbar in Web Workers.
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.
Der Scherenkasten, das Dithering und die Puffer-Schreibmasken können die clear()
Methode beeinflussen.
Syntax
clear(mask)
Parameter
mask
-
Ein bitweises OR-Masken
GLbitfield
, das angibt, welche Puffer geleert werden sollen. Mögliche Werte sind:gl.COLOR_BUFFER_BIT
gl.DEPTH_BUFFER_BIT
gl.STENCIL_BUFFER_BIT
Rückgabewert
Keiner (undefined
).
Ausnahmen
Wenn mask nicht einer der aufgelisteten 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 COLOR_CLEAR_VALUE
,
DEPTH_CLEAR_VALUE
und STENCIL_CLEAR_VALUE
Konstanten 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 |
Browser-Kompatibilität
BCD tables only load in the browser