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 der WebGL 2 API ungültig erklärt Teile der Inhalte von Anhängen in einem Framebuffer.

Syntax

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

Parameter

target

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

gl.FRAMEBUFFER: Sammlung von Pufferdaten 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.

attachments

Ein Array von GLenum, das die zu invalidierenden Anhangspunkte angibt. Mögliche Werte:

gl.COLOR_ATTACHMENT{0-15}: Invalidiert einen der Farb-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.

x

Ein GLint, das den linken Ursprung des zu invalidierenden Pixelrechtecks angibt.

y

Ein GLint, das den unteren Ursprung des zu invalidierenden Pixelrechtecks angibt.

width

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

height

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

Rückgabewert

Keiner (undefined).

Beispiele

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

Spezifikationen

Specification
WebGL 2.0 Specification # 3.7.4

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

WebGL2RenderingContext.invalidateFramebuffer()