WebGL2RenderingContext: clearBuffer[fiuv]() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die WebGL2RenderingContext.clearBuffer[fiuv]() Methoden des WebGL 2 APIs löschen Puffer aus dem aktuell gebundenen Framebuffer.

Syntax

js
clearBufferfv(buffer, drawbuffer, values)
clearBufferfv(buffer, drawbuffer, values, srcOffset)

clearBufferiv(buffer, drawbuffer, values)
clearBufferiv(buffer, drawbuffer, values, srcOffset)

clearBufferuiv(buffer, drawbuffer, values)
clearBufferuiv(buffer, drawbuffer, values, srcOffset)

clearBufferfi(buffer, drawbuffer, depth, stencil)

Parameter

buffer

Ein GLenum, der den zu löschenden Puffer angibt. Mögliche Werte sind:

  • gl.COLOR: Farb-Puffer.
  • gl.DEPTH: Tiefen-Puffer.
  • gl.STENCIL: Schablonen-Puffer.
  • gl.DEPTH_STENCIL: löscht Tiefen- und Schablonen-Puffer (wird mit clearBufferfi verwendet).
drawBuffer

Ein GLint, der den zu löschenden Zeichnungspuffer angibt.

values

Ein Array von GLint, GLuint oder GLfloat Werten oder ein Int32Array, Uint32Array oder Float32Array, das die Werte angibt, auf die gelöscht werden soll.

depth

Ein GLfloat, der den Wert angibt, auf den ein Tiefen-Render-Puffer gelöscht werden soll.

stencil

Ein GLint, der den Wert angibt, auf den der Schablonen-Render-Puffer gelöscht werden soll.

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.clearBufferiv(gl.COLOR, 0, new Int32Array([r, g, b, a]));
gl.clearBufferuiv(gl.COLOR, 0, new Uint32Array([r, g, b, a]));
gl.clearBufferfv(gl.COLOR, 0, new Float32Array([r, g, b, a]));
gl.clearBufferfv(gl.COLOR, 0, [0.0, 0.0, 0.0, 0.0]);
gl.clearBufferfi(gl.DEPTH_STENCIL, 0, 1.0, 0);

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.11

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch