OES_draw_buffers_indexed

Baseline 已广泛支持

此功能已成熟,可跨多个设备和浏览器版本使用。自 2022 年 12 月起,所有浏览器均已提供此功能。

OES_draw_buffers_indexed 扩展是 WebGL API 的一部分,它允许在同时写入多个颜色缓冲区时使用不同的混合选项。

可以使用 WebGLRenderingContext.getExtension() 方法来访问 WebGL 扩展。有关更多信息,请参阅 WebGL 教程中的 使用扩展

注意:此扩展仅适用于 WebGL2 上下文。

实例方法

OES_draw_buffers_indexed.blendEquationiOES()

为特定的绘图缓冲区设置 RGB 和 Alpha 混合方程。

OES_draw_buffers_indexed.blendEquationSeparateiOES()

分别为特定的绘图缓冲区单独设置 RGB 和 Alpha 混合方程。

OES_draw_buffers_indexed.blendFunciOES()

定义为特定绘图缓冲区混合像素时使用的函数。

OES_draw_buffers_indexed.blendFuncSeparateiOES()

分别为 RGB 和 Alpha 分量定义为特定绘图缓冲区混合像素时使用的函数。

OES_draw_buffers_indexed.colorMaskiOES()

设置在为特定绘图缓冲区绘制或渲染时启用或禁用哪些颜色分量。

OES_draw_buffers_indexed.disableiOES()

禁用特定绘图缓冲区的混合。

OES_draw_buffers_indexed.enableiOES()

启用特定绘图缓冲区的混合。

示例

使用 OES_draw_buffers_indexed 扩展

通过调用 WebGLRenderingContext.getExtension() 来启用扩展。

js
const ext = gl.getExtension("OES_draw_buffers_indexed");

现在您可以为特定的绘图缓冲区启用混合、设置混合方程、混合函数和颜色掩码。

js
// For gl.DRAW_BUFFER0
ext.enableiOES(gl.BLEND, 0);
ext.blendEquationiOES(0, gl.FUNC_ADD);
ext.blendFunciOES(0, gl.ONE, gl.ONE);
ext.colorMaskiOES(0, 1, 0, 0, 0);

// For gl.DRAW_BUFFER1
ext.enableiOES(gl.BLEND, 1);
ext.blendEquationSeparateiOES(1, gl.FUNC_ADD, gl.FUNC_SUBTRACT);
ext.blendFuncSeparateiOES(
  1,
  gl.SRC_ALPHA,
  gl.ONE_MINUS_SRC_ALPHA,
  gl.ZERO,
  gl.ZERO,
);
ext.colorMaskiOES(1, 0, 1, 0, 0);

要检索特定绘图缓冲区的设置,请使用 WebGL2RenderingContext.getIndexedParameter()

js
// For gl.DRAW_BUFFER0
gl.getIndexedParameter(gl.BLEND_EQUATION_RGB, 0);
gl.getIndexedParameter(gl.BLEND_EQUATION_ALPHA, 0);
gl.getIndexedParameter(gl.BLEND_SRC_RGB, 0);
gl.getIndexedParameter(gl.BLEND_SRC_ALPHA, 0);
gl.getIndexedParameter(gl.BLEND_DST_RGB, 0);
gl.getIndexedParameter(gl.BLEND_DST_ALPHA, 0);
gl.getIndexedParameter(gl.COLOR_WRITEMASK, 0);

// For gl.DRAW_BUFFER1
gl.getIndexedParameter(gl.BLEND_EQUATION_RGB, 1);
gl.getIndexedParameter(gl.BLEND_EQUATION_ALPHA, 1);
gl.getIndexedParameter(gl.BLEND_SRC_RGB, 1);
gl.getIndexedParameter(gl.BLEND_SRC_ALPHA, 1);
gl.getIndexedParameter(gl.BLEND_DST_RGB, 1);
gl.getIndexedParameter(gl.BLEND_DST_ALPHA, 1);
gl.getIndexedParameter(gl.COLOR_WRITEMASK, 1);

您可以使用 WebGLRenderingContext.getParameter() 来查看有多少个绘图缓冲区可用。

js
const maxDrawBuffers = gl.getParameter(gl.MAX_DRAW_BUFFERS);

规范

规范
WebGL OES_draw_buffers_indexed 扩展规范

浏览器兼容性