WebGL2RenderingContext: invalidateSubFramebuffer() 方法

Baseline 已廣泛支援

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

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

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

語法

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

引數

目標

一個 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

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

x

一個 GLint,指定要使其失效的畫素矩形的左側起始位置。

y

一個 GLint,指定要使其失效的畫素矩形底部起始位置。

width

一個 GLsizei,指定要使其失效的畫素矩形的寬度。

height

一個 GLsizei,指定要使其失效的畫素矩形的高度。

返回值

無(undefined)。

示例

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

規範

規範
WebGL 2.0 規範
# 3.7.4

瀏覽器相容性

另見