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: Dieses Feature ist verfügbar in Web Workers.

Die WebGL2RenderingContext.invalidateFramebuffer()-Methode des WebGL 2 API ungültigt die Inhalte von Anhängen in einem Framebuffer.

Syntax

js
invalidateFramebuffer(target, attachments)

Parameter

target

Ein GLenum, der den Bindungspunkt (Ziel) angibt. Mögliche Werte:

gl.FRAMEBUFFER

Sammlung von Pufferspeicherdaten von Farb-, Alpha-, Tiefen- und Stencil-Puffern, die zum Rendern 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 ungültig gemacht werden sollen. Mögliche Werte:

gl.COLOR_ATTACHMENT{0-15}

Macht einen der Farbpuffer des Framebuffers ungültig.

gl.DEPTH_ATTACHMENT

Macht den Tiefenpuffer des Framebuffers ungültig.

gl.STENCIL_ATTACHMENT

Macht den Stencil-Puffer des Framebuffers ungültig.

gl.DEPTH_STENCIL_ATTACHMENT

Macht sowohl den Tiefen- als auch den Stencil-Puffer des Framebuffers ungültig.

Rückgabewert

Keine (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

BCD tables only load in the browser

Siehe auch