大网数据广告活动
Web 标准与前端开发

OES_draw_buffers_indexed: blendFuncSeparateiOES() method

· 52CE 我爱测

The `blendFuncSeparateiOES()` method of the OES_draw_buffers_indexed WebGL extension defines which function is used when blending pixels for RGB and alpha components separately for a particular draw buffer.

WebGL

The blendFuncSeparateiOES() method of the OES_draw_buffers_indexed WebGL extension defines which function is used when blending pixels for RGB and alpha components separately for a particular draw buffer.

See OES_draw_buffers_indexed.blendFunciOES() for setting RGB and alpha together and WebGLRenderingContext.blendFuncSeparate() for the WebGL 1 version of this method.

Syntax

blendFuncSeparateiOES(buf, srcRGB, dstRGB, srcAlpha, dstAlpha)

Parameters

  • buf
  • srcRGB
    • : A WebGL_API/Types specifying a multiplier for the red, green and blue (RGB) source blending factors. Accepts the same enums as the srcRGB parameter in WebGLRenderingContext.blendFuncSeparate().
  • dstRGB
    • : A WebGL_API/Types specifying a multiplier for the red, green and blue (RGB) destination blending factors. Accepts the same enums as the dstRGB parameter in WebGLRenderingContext.blendFuncSeparate().
  • srcAlpha
    • : A WebGL_API/Types specifying a multiplier for the alpha source blending factor. Accepts the same enums as the srcAlpha parameter in WebGLRenderingContext.blendFuncSeparate().
  • dstAlpha
    • : A WebGL_API/Types specifying a multiplier for the alpha destination blending factor. Accepts the same enums as the srcAlpha parameter in WebGLRenderingContext.blendFuncSeparate().

Return value

None (undefined).

Exceptions

  • If buf is not a valid value, a gl.INVALID_VALUE error is thrown.
  • If srcRGB, dstRGB, srcAlpha or dstAlpha are not one of the possible values, a gl.INVALID_ENUM error is thrown.
  • The same blending limitations as for WebGLRenderingContext.blendFuncSeparate() apply: If a constant color and a constant alpha value are used together as source and destination factors, a gl.INVALID_ENUM error is thrown.

Examples

Setting and getting blend functions

The following sets the blend functions for the draw buffers gl.DRAW_BUFFER0 (call where buf is 0) and gl.DRAW_BUFFER1 (call where buf is 1).

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

ext.blendFuncSeparateiOES(0, gl.ONE, gl.ONE, gl.ZERO, gl.ZERO);
ext.blendFuncSeparateiOES(
  1,
  gl.SRC_ALPHA,
  gl.ONE_MINUS_SRC_ALPHA,
  gl.ZERO,
  gl.ZERO,
);

To get the blend functions for the gl.DRAW_BUFFER0 and gl.DRAW_BUFFER1 draw buffers, query the BLEND_SRC_RGB, BLEND_SRC_ALPHA, BLEND_DST_RGB, and BLEND_DST_ALPHA constants using WebGL2RenderingContext.getIndexedParameter():

// For gl.DRAW_BUFFER0
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);

// For gl.DRAW_BUFFER0
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);

Specifications

Browser compatibility

See also

  • OES_draw_buffers_indexed.blendFunciOES()
  • WebGLRenderingContext.blendFuncSeparate()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。