WebGLRenderingContext.blendFunc() - Web API 接口参考编辑

WebGL API 的WebGLRenderingContext.blendFunc() 方法定义了一个用于混合像素算法的函数.

语法

void gl.blendFunc(sfactor, dfactor);

None.

下列常数可用于 sfactor 和dfactor.

混合颜色的公式可以这样描述: color(RGBA) = (sourceColor * sfactor) + (destinationColor * dfactor). RBGA 值在 0 到1 之间.

Constant	Factor	Description
`gl.ZERO`	0,0,0,0	所有颜色乘0.
`gl.ONE`	1,1,1,1	所有颜色乘1.
`gl.SRC_COLOR`	R_S, G_S, B_S, A_S	将所有颜色乘上源颜色.
`gl.ONE_MINUS_SRC_COLOR`	1-R_S, 1-G_S, 1-B_S, 1-A_S	每个源颜色所有颜色乘1 .
`gl.DST_COLOR`	R_D, G_D, B_D, A_D	将所有颜色与目标颜色相乘.
`gl.ONE_MINUS_DST_COLOR`	1-R_D, 1-G_D, 1-B_D, 1-A_D	将所有颜色乘以1减去每个目标颜色.
`gl.SRC_ALPHA`	A_S, A_S, A_S, A_S	将所有颜色乘以源alpha值.
`gl.ONE_MINUS_SRC_ALPHA`	1-A_S, 1-A_S, 1-A_S, 1-A_S	将所有颜色乘以1 减去源alpha值.
`gl.DST_ALPHA`	A_D, A_D, A_D, A_D	将所有颜色与目标alpha值相乘.
`gl.ONE_MINUS_DST_ALPHA`	1-A_D, 1-A_D, 1-A_D, 1-A_D	将所有颜色乘以1减去目标alpha值.
`gl.CONSTANT_COLOR`	R_C, G_C, B_C, A_C	将所有颜色乘以一个常数颜色.
`gl.ONE_MINUS_CONSTANT_COLOR`	1-R_C, 1-G_C, 1-B_C, 1-A_C	所有颜色乘以1减去一个常数颜色.
`gl.CONSTANT_ALPHA`	A_C, A_C, A_C, A_C	将所有颜色乘以一个常数.
`gl.ONE_MINUS_CONSTANT_ALPHA`	1-A_C, 1-A_C, 1-A_C, 1-A_C	所有颜色乘以1减去一个常数.
`gl.SRC_ALPHA_SATURATE`	min(A_S, 1 - A_D), min(A_S, 1 - A_D), min(A_S, 1 - A_D), 1	将RGB颜色乘以源alpha值或1减去目标alpha值中的较小值。alpha值乘以1.

使用混合函数, 您首先必须使用参数 gl.BLEND来激活WebGLRenderingContext.enable() 的混合.

gl.enable(gl.BLEND);
gl.blendFunc(gl.SRC_COLOR, gl.DST_COLOR);

要获得当前的混合函数, 查询BLEND_SRC_RGB, BLEND_SRC_ALPHA, BLEND_DST_RGB, 和BLEND_DST_ALPHA 常量中返回混合函数常量.

gl.enable(gl.BLEND);
gl.blendFunc(gl.SRC_COLOR, gl.DST_COLOR);
gl.getParameter(gl.BLEND_SRC_RGB) == gl.SRC_COLOR;
// true

Specification	Status	Comment
WebGL 1.0 blendFunc	Recommendation	Initial definition. In WebGL, constant color and constant alpha cannot be used together as source and destination factors in the blend function. See section 6.13. of the specification.
OpenGL ES 2.0 glBlendFunc	Standard	Man page of the OpenGL API.