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 Juli 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.
Der Scherrahmen, Dithering und Puffer-Schreibmasken können die clear() Methode beeinflussen. Zum Beispiel, wenn das Beschreiben des Puffers durch colorMask(), depthMask() oder stencilMask() deaktiviert ist, hat clear() keine Auswirkung auf den entsprechenden Puffer.
Syntax
clear(mask)
Parameter
mask-
Ein
GLbitfieldBit-oder-Maske, die angibt, welche Puffer gelöscht werden sollen. 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 |
Browser-Kompatibilität
Loading…