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

Die WebGL2RenderingContext.invalidateSubFramebuffer()-Methode der WebGL 2 API ungültig erklärt Teile der Inhalte von Anhängen in einem Framebuffer.

Syntax

js
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

js
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