WebGL2RenderingContext: invalidateFramebuffer() 方法

Baseline 已廣泛支援

此功能已成熟,並可在多種裝置和瀏覽器版本上執行。自 2021 年 9 月起,所有瀏覽器均已支援此功能。

注意:此功能在 Web Workers 中可用。

WebGL2RenderingContext.invalidateFramebuffer() 方法是 WebGL 2 API 的一部分,用於使幀緩衝區中的附件內容失效。

語法

js
invalidateFramebuffer(target, attachments)

引數

目標

一個 GLenum,指定繫結點(目標)。可能的值

gl.FRAMEBUFFER

用於渲染影像的顏色、Alpha、深度和模板緩衝區的集合緩衝區資料儲存。

gl.DRAW_FRAMEBUFFER

相當於 gl.FRAMEBUFFER

gl.READ_FRAMEBUFFER

用作讀取操作的源。

attachments

一個 Array,包含 GLenum 型別的值,用於指定要使其失效的附件點。可能的值包括:

gl.COLOR_ATTACHMENT{0-15}

使幀緩衝區的一個顏色緩衝區失效。

gl.DEPTH_ATTACHMENT

使幀緩衝區的深度緩衝區失效。

gl.STENCIL_ATTACHMENT

使幀緩衝區的模板緩衝區失效。

gl.DEPTH_STENCIL_ATTACHMENT

使幀緩衝區的深度緩衝區和模板緩衝區都失效。

返回值

無(undefined)。

示例

js
gl.invalidateFramebuffer(gl.READ_FRAMEBUFFER, [
  gl.COLOR_ATTACHMENT0,
  gl.COLOR_ATTACHMENT1,
]);

規範

規範
WebGL 2.0 規範
# 3.7.4

瀏覽器相容性

另見