翻译不完整。 请帮助我们翻译这篇文章！
WebGL API 的WebGLRenderingContext.blendFunc() 方法定义了一个用于混合像素算法的函数.
语法
void gl.blendFunc(sfactor, dfactor);
参数
sfactor-
GLenum为源混合因子指定一个乘数. 默认值是gl.ONE. 有关可能的值, 查看下面. dfactor-
GLenum为源目标合因子指定一个乘数. 默认值是gl.ZERO. 有关可能的值, 查看下面.
返回值
None.
异常
- 如果
sfactor 或dfactor不是列出的可能值一直, 则抛出gl.INVALID_ENUM错误. - 如果使用恒定的颜色和恒定的alpha值作为源和目标因子, 则抛出
gl.INVALID_ENUM错误.
常量
下列常数可用于 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 |
RS, GS, BS, AS | 将所有颜色乘上源颜色. |
gl.ONE_MINUS_SRC_COLOR |
1-RS, 1-GS, 1-BS, 1-AS | 每个源颜色所有颜色乘1 . |
gl.DST_COLOR |
RD, GD, BD, AD | 将所有颜色与目标颜色相乘. |
gl.ONE_MINUS_DST_COLOR |
1-RD, 1-GD, 1-BD, 1-AD | 将所有颜色乘以1减去每个目标颜色. |
gl.SRC_ALPHA |
AS, AS, AS, AS | 将所有颜色乘以源alpha值. |
gl.ONE_MINUS_SRC_ALPHA |
1-AS, 1-AS, 1-AS, 1-AS | 将所有颜色乘以1 减去源alpha值. |
gl.DST_ALPHA |
AD, AD, AD, AD | 将所有颜色与目标alpha值相乘. |
gl.ONE_MINUS_DST_ALPHA |
1-AD, 1-AD, 1-AD, 1-AD | 将所有颜色乘以1减去目标alpha值. |
gl.CONSTANT_COLOR |
RC, GC, BC, AC | 将所有颜色乘以一个常数颜色. |
gl.ONE_MINUS_CONSTANT_COLOR |
1-RC, 1-GC, 1-BC, 1-AC | 所有颜色乘以1减去一个常数颜色. |
gl.CONSTANT_ALPHA |
AC, AC, AC, AC | 将所有颜色乘以一个常数. |
gl.ONE_MINUS_CONSTANT_ALPHA |
1-AC, 1-AC, 1-AC, 1-AC | 所有颜色乘以1减去一个常数. |
gl.SRC_ALPHA_SATURATE |
min(AS, 1 - AD), min(AS, 1 - AD), min(AS, 1 - AD), 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. |
浏览器兼容性
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
blendFunc | Chrome Full support 9 | Edge Full support 12 | Firefox Full support 4 | IE Full support 11 | Opera Full support 12 | Safari Full support 5.1 | WebView Android Full support Yes | Chrome Android Full support 25 | Firefox Android Full support Yes | Opera Android Full support 12 | Safari iOS Full support 8 | Samsung Internet Android Full support 1.5 |
Legend
- Full support
- Full support