---
title: WebGLRenderingContext.blendFunc()
slug: Web/API/WebGLRenderingContext/blendFunc
translation_of: Web/API/WebGLRenderingContext/blendFunc
---
<div>{{APIRef("WebGL")}}</div>

<p><a href="/en-US/docs/Web/API/WebGL_API">WebGL API</a> 的<strong><code>WebGLRenderingContext.blendFunc()</code></strong> 方法定义了一个用于混合像素算法的函数.</p>

<h2 id="语法">语法</h2>

<pre class="syntaxbox">void <var>gl</var>.blendFunc(<var>sfactor</var>, <var>dfactor</var>);
</pre>

<h3 id="参数">参数</h3>

<dl>
 <dt><code>sfactor</code></dt>
 <dd> {{domxref("GLenum")}} 为源混合因子指定一个乘数. 默认值是 <code>gl.ONE</code>. 有关可能的值, 查看下面.</dd>
 <dt><code>dfactor</code></dt>
 <dd> {{domxref("GLenum")}} 为源目标合因子指定一个乘数. 默认值是 <code>gl.ZERO</code>. 有关可能的值, 查看下面.</dd>
</dl>

<h3 id="返回值">返回值</h3>

<p>None.</p>

<h3 id="异常">异常</h3>

<ul>
 <li>如果 <code><em>sfactor</em> 或</code> <code><em>dfactor</em> </code>不是列出的可能值一直, 则抛出 <code>gl.INVALID_ENUM</code> 错误.</li>
 <li>如果使用恒定的颜色和恒定的alpha值作为源和目标因子, 则抛出<code>gl.INVALID_ENUM</code> 错误.</li>
</ul>

<h2 id="常量">常量</h2>

<p>下列常数可用于  <code><em>sfactor</em></code> 和<code><em>dfactor</em></code>.</p>

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

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Constant</th>
   <th scope="col">Factor</th>
   <th scope="col">Description</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><code>gl.ZERO</code></td>
   <td>0,0,0,0</td>
   <td>所有颜色乘0.</td>
  </tr>
  <tr>
   <td><code>gl.ONE</code></td>
   <td>1,1,1,1</td>
   <td>所有颜色乘1.</td>
  </tr>
  <tr>
   <td><code>gl.SRC_COLOR</code></td>
   <td>R<sub>S</sub>, G<sub>S</sub>, B<sub>S</sub>, A<sub>S</sub></td>
   <td>将所有颜色乘上源颜色.</td>
  </tr>
  <tr>
   <td><code>gl.ONE_MINUS_SRC_COLOR</code></td>
   <td>1-R<sub>S</sub>, 1-G<sub>S</sub>, 1-B<sub>S</sub>, 1-A<sub>S</sub></td>
   <td>每个源颜色所有颜色乘1 .</td>
  </tr>
  <tr>
   <td><code>gl.DST_COLOR</code></td>
   <td>R<sub>D</sub>, G<sub>D</sub>, B<sub>D</sub>, A<sub>D</sub></td>
   <td>将所有颜色与目标颜色相乘.</td>
  </tr>
  <tr>
   <td><code>gl.ONE_MINUS_DST_COLOR</code></td>
   <td>1-R<sub>D</sub>, 1-G<sub>D</sub>, 1-B<sub>D</sub>, 1-A<sub>D</sub></td>
   <td>将所有颜色乘以1减去每个目标颜色.</td>
  </tr>
  <tr>
   <td><code>gl.SRC_ALPHA</code></td>
   <td>A<sub>S</sub>, A<sub>S</sub>, A<sub>S</sub>, A<sub>S</sub></td>
   <td>将所有颜色乘以源alpha值.</td>
  </tr>
  <tr>
   <td><code>gl.ONE_MINUS_SRC_ALPHA</code></td>
   <td>1-A<sub>S</sub>, 1-A<sub>S</sub>, 1-A<sub>S</sub>, 1-A<sub>S</sub></td>
   <td>将所有颜色乘以1 减去源alpha值.</td>
  </tr>
  <tr>
   <td><code>gl.DST_ALPHA</code></td>
   <td>A<sub>D</sub>, A<sub>D</sub>, A<sub>D</sub>, A<sub>D</sub></td>
   <td>将所有颜色与目标alpha值相乘.</td>
  </tr>
  <tr>
   <td><code>gl.ONE_MINUS_DST_ALPHA</code></td>
   <td>1-A<sub>D</sub>, 1-A<sub>D</sub>, 1-A<sub>D</sub>, 1-A<sub>D</sub></td>
   <td>将所有颜色乘以1减去目标alpha值.</td>
  </tr>
  <tr>
   <td><code>gl.CONSTANT_COLOR</code></td>
   <td>R<sub>C</sub>, G<sub>C</sub>, B<sub>C</sub>, A<sub>C</sub></td>
   <td>将所有颜色乘以一个常数颜色.</td>
  </tr>
  <tr>
   <td><code>gl.ONE_MINUS_CONSTANT_COLOR</code></td>
   <td>1-R<sub>C</sub>, 1-G<sub>C</sub>, 1-B<sub>C</sub>, 1-A<sub>C</sub></td>
   <td>所有颜色乘以1减去一个常数颜色.</td>
  </tr>
  <tr>
   <td><code>gl.CONSTANT_ALPHA</code></td>
   <td>A<sub>C</sub>, A<sub>C</sub>, A<sub>C</sub>, A<sub>C</sub></td>
   <td>将所有颜色乘以一个常数.</td>
  </tr>
  <tr>
   <td><code>gl.ONE_MINUS_CONSTANT_ALPHA</code></td>
   <td>1-A<sub>C</sub>, 1-A<sub>C</sub>, 1-A<sub>C</sub>, 1-A<sub>C</sub></td>
   <td>所有颜色乘以1减去一个常数.</td>
  </tr>
  <tr>
   <td><code>gl.SRC_ALPHA_SATURATE</code></td>
   <td>
    <p>min(A<sub>S</sub>, 1 - A<sub>D</sub>), min(A<sub>S</sub>, 1 - A<sub>D</sub>), min(A<sub>S</sub>, 1 - A<sub>D</sub>), 1</p>
   </td>
   <td>将RGB颜色乘以源alpha值或1减去目标alpha值中的较小值。alpha值乘以1.</td>
  </tr>
 </tbody>
</table>

<h2 id="示例">示例</h2>

<p>使用混合函数, 您首先必须使用参数 <code>gl.BLEND</code>来激活{{domxref("WebGLRenderingContext.enable()")}} 的混合.</p>

<pre class="brush: js">gl.enable(gl.BLEND);
gl.blendFunc(gl.SRC_COLOR, gl.DST_COLOR);
</pre>

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

<pre class="brush: js">gl.enable(gl.BLEND);
gl.blendFunc(gl.SRC_COLOR, gl.DST_COLOR);
gl.getParameter(gl.BLEND_SRC_RGB) == gl.SRC_COLOR;
// true
</pre>

<h2 id="说明">说明</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('WebGL', "#5.14.3", "blendFunc")}}</td>
   <td>{{Spec2('WebGL')}}</td>
   <td>Initial definition.<br>
    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.</td>
  </tr>
  <tr>
   <td>{{SpecName('OpenGL ES 2.0', "glBlendFunc.xml", "glBlendFunc")}}</td>
   <td>{{Spec2('OpenGL ES 2.0')}}</td>
   <td>Man page of the OpenGL API.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<p>{{Compat("api.WebGLRenderingContext.blendFunc")}}</p>

<h2 id="另见">另见</h2>

<ul>
 <li>{{domxref("WebGLRenderingContext.blendColor()")}}</li>
 <li>{{domxref("WebGLRenderingContext.blendEquation()")}}</li>
</ul>