WebGL2RenderingContext: invalidateSubFramebuffer() 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.invalidateSubFramebuffer() Methode des WebGL 2 API invalidiert Teile des Inhalts von Anhängen in einem Framebuffer.

Syntax

invalidateSubFramebuffer(target, attachments, x, y, width, height)

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

gl.FRAMEBUFFER: Sammlung von Puffer-Datenspeichern für Farb-, Alpha-, Tiefen- und Schablonenpuffer, die zum Rendern eines Bildes verwendet werden.
gl.DRAW_FRAMEBUFFER: Entspricht gl.FRAMEBUFFER.
gl.READ_FRAMEBUFFER: Wird als Quelle für Leseoperationen verwendet.

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

gl.COLOR_ATTACHMENT{0-15}: Invalidiert einen der Farbe-Puffer des Framebuffers.
gl.DEPTH_ATTACHMENT: Invalidiert den Tiefenpuffer des Framebuffers.
gl.STENCIL_ATTACHMENT: Invalidiert den Schablonenpuffer des Framebuffers.
gl.DEPTH_STENCIL_ATTACHMENT: Invalidiert sowohl den Tiefen- als auch den Schablonenpuffer des Framebuffers.

Ein GLint, der die linke Herkunft des Pixelrechtecks angibt, das invalidiert werden soll.

Ein GLint, der die untere Herkunft des Pixelrechtecks angibt, das invalidiert werden soll.

Ein GLsizei, der die Breite des zu invalidierenden Pixelrechtecks angibt.

Ein GLsizei, der die Höhe des zu invalidierenden Pixelrechtecks angibt.

gl.invalidateSubFramebuffer(
  gl.READ_FRAMEBUFFER,
  [gl.COLOR_ATTACHMENT0, gl.COLOR_ATTACHMENT1],
  0,
  0,
  256,
  256,
);

Specification
WebGL 2.0 Specification # 3.7.4