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
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
vonGLenum
, 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