WebGL2RenderingContext.drawBuffers()

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.

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

WebGL 2 API的 WebGL2RenderingContext.drawBuffers() 方法定义了将写入零散数据（fragment colors）的绘制缓存 (draw buffer)。绘制缓存设置了上一次绑定帧缓存状态，如果没有帧缓存可用的话，则用绘制缓存。

语法

void gl.drawBuffers(buffers);

参数

buffers

一个 GLenum的Array 对碎片颜色的说明将被写入缓冲区。可能的值有：

  • gl.NONE: 碎片着色器的输出没有被写入到任何颜色缓存中。
  • gl.BACK: 碎片着色器的输出被写入到返回的颜色缓存中。
  • gl.COLOR_ATTACHMENT{0-15}: 碎片着色器的输出被写入当前帧缓存的第 n 个颜色缓存中。Fragment shader output is written in the nth color attachment of the current framebuffer.

返回值

没有。

报错信息

  • 如果 buffers 包含了不止一个合法值， gl.INVALID_ENUM错误会被抛出

示例

js
gl.drawBuffers([gl.NONE, gl.COLOR_ATTACHMENT1]);

规范

Specification
WebGL 2.0 Specification
# 3.7.11

浏览器兼容性

BCD tables only load in the browser

详见