WebGL2RenderingContext: invalidateFramebuffer() 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: Diese Funktion ist in Web Workers verfügbar.

Die WebGL2RenderingContext.invalidateFramebuffer()-Methode der WebGL 2 API invalidiert den Inhalt von Anhängen in einem Framebuffer.

Syntax

js
invalidateFramebuffer(target, attachments)

Parameter

target

Ein GLenum, das den Bindepunkt (Ziel) angibt. Mögliche Werte:

gl.FRAMEBUFFER

Sammlung von Pufferdaten für Farbtiefe, Alpha, und Stencil-Puffern, die zur Erstellung eines Bildes verwendet werden.

gl.DRAW_FRAMEBUFFER

Entspricht gl.FRAMEBUFFER.

gl.READ_FRAMEBUFFER

Wird als Quelle für Leseoperationen verwendet.

attachments

Ein Array von GLenum, das die Anhangspunkte angibt, die invalidiert werden sollen. Mögliche Werte:

gl.COLOR_ATTACHMENT{0-15}

Invalidiert einen der Farbpuffer des Framebuffers.

gl.DEPTH_ATTACHMENT

Invalidiert den Tiefenpuffer des Framebuffers.

gl.STENCIL_ATTACHMENT

Invalidiert den Stencil-Puffer des Framebuffers.

gl.DEPTH_STENCIL_ATTACHMENT

Invalidiert sowohl den Tiefen- als auch den Stencil-Puffer des Framebuffers.

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.invalidateFramebuffer(gl.READ_FRAMEBUFFER, [
  gl.COLOR_ATTACHMENT0,
  gl.COLOR_ATTACHMENT1,
]);

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.4

Browser-Kompatibilität

Siehe auch