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- : An integer
ispecifying the draw buffer associated with the constantgl.DRAW_BUFFERi, see WebGL draw buffer constants.
- : An integer
srcRGB- : A WebGL_API/Types specifying a multiplier for the red, green and blue (RGB) source blending factors. Accepts the same enums as the
srcRGBparameter in WebGLRenderingContext.blendFuncSeparate().
- : A WebGL_API/Types specifying a multiplier for the red, green and blue (RGB) source blending factors. Accepts the same enums as the
dstRGB- : A WebGL_API/Types specifying a multiplier for the red, green and blue (RGB) destination blending factors. Accepts the same enums as the
dstRGBparameter in WebGLRenderingContext.blendFuncSeparate().
- : A WebGL_API/Types specifying a multiplier for the red, green and blue (RGB) destination blending factors. Accepts the same enums as the
srcAlpha- : A WebGL_API/Types specifying a multiplier for the alpha source blending factor. Accepts the same enums as the
srcAlphaparameter in WebGLRenderingContext.blendFuncSeparate().
- : A WebGL_API/Types specifying a multiplier for the alpha source blending factor. Accepts the same enums as the
dstAlpha- : A WebGL_API/Types specifying a multiplier for the alpha destination blending factor. Accepts the same enums as the
srcAlphaparameter in WebGLRenderingContext.blendFuncSeparate().
- : A WebGL_API/Types specifying a multiplier for the alpha destination blending factor. Accepts the same enums as the
Return value
None (undefined).
Exceptions
- If
bufis not a valid value, agl.INVALID_VALUEerror is thrown. - If
srcRGB,dstRGB,srcAlphaordstAlphaare not one of the possible values, agl.INVALID_ENUMerror 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_ENUMerror 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。离线整理了版式、链接和媒体显示。
