WebGL2RenderingContext: invalidateSubFramebuffer() 方法

基线 广泛可用

此功能已成熟,可在许多设备和浏览器版本上运行。它自 2021 年 9 月.

报告反馈

语法

WebGL2RenderingContext.invalidateSubFramebuffer() 方法是 WebGL 2 API 的一部分,它会使帧缓冲区中附件内容的某些部分失效。
invalidateSubFramebuffer(target, attachments, x, y, width, height)

参数

target

一个 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).

示例

WebGL2RenderingContext.invalidateSubFramebuffer() 方法是 WebGL 2 API 的一部分,它会使帧缓冲区中附件内容的某些部分失效。
gl.invalidateSubFramebuffer(
  gl.READ_FRAMEBUFFER,
  [gl.COLOR_ATTACHMENT0, gl.COLOR_ATTACHMENT1],
  0,
  0,
  256,
  256,
);

规范

规范
WebGL 2.0 规范
# 3.7.4

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参见