<div class="refentry" id="glBlendFuncSeparate">

<div class="titlepage"></div>

<div class="refnamediv">

<h2>Name</h2>

<p>glBlendFuncSeparate — specify pixel arithmetic for RGB and alpha components separately</p>

</div>

<div class="refsynopsisdiv">

<h2>C Specification</h2>

<div class="funcsynopsis">

<table style="border: 0; cellspacing: 0; cellpadding: 0;" class="funcprototype-table">

<tr>

<td>

<code class="funcdef">void <strong class="fsfunc">glBlendFuncSeparate</strong>(</code>

</td>

<td>GLenum <var class="pdparam">srcRGB</var>, </td>

</tr>

<tr>

<td> </td>

<td>GLenum <var class="pdparam">dstRGB</var>, </td>

</tr>

<tr>

<td> </td>

<td>GLenum <var class="pdparam">srcAlpha</var>, </td>

</tr>

<tr>

<td> </td>

<td>GLenum <var class="pdparam">dstAlpha</var><code>)</code>;</td>

</tr>

</table>

<div class="funcprototype-spacer"> </div>

<table style="border: 0; cellspacing: 0; cellpadding: 0;" class="funcprototype-table">

<tr>

<td>

<code class="funcdef">void <strong class="fsfunc">glBlendFuncSeparatei</strong>(</code>

</td>

<td>GLuint <var class="pdparam">buf</var>, </td>

</tr>

<tr>

<td> </td>

<td>GLenum <var class="pdparam">srcRGB</var>, </td>

</tr>

<tr>

<td> </td>

<td>GLenum <var class="pdparam">dstRGB</var>, </td>

</tr>

<tr>

<td> </td>

<td>GLenum <var class="pdparam">srcAlpha</var>, </td>

</tr>

<tr>

<td> </td>

<td>GLenum <var class="pdparam">dstAlpha</var><code>)</code>;</td>

</tr>

</table>

<div class="funcprototype-spacer"> </div>

</div>

</div>

<div class="refsect1" id="parameters">

<h2>Parameters</h2>

<div class="variablelist">

<dl class="variablelist">

<dt>

<span class="term">

<em class="parameter">

<code>buf</code>

</em>

</span>

</dt>

<dd>

<p>

For <code class="function">glBlendFuncSeparatei</code>, specifies the index of the draw

buffer for which to set the blend functions.

</p>

</dd>

<dt>

<span class="term">

<em class="parameter">

<code>srcRGB</code>

</em>

</span>

</dt>

<dd>

<p>

Specifies how the red, green, and blue blending factors are computed.

The initial value is <code class="constant">GL_ONE</code>.

</p>

</dd>

<dt>

<span class="term">

<em class="parameter">

<code>dstRGB</code>

</em>

</span>

</dt>

<dd>

<p>

Specifies how the red, green, and blue destination blending factors are

computed.

The initial value is <code class="constant">GL_ZERO</code>.

</p>

</dd>

<dt>

<span class="term">

<em class="parameter">

<code>srcAlpha</code>

</em>

</span>

</dt>

<dd>

<p>

Specified how the alpha source blending factor is computed.

The initial value is <code class="constant">GL_ONE</code>.

</p>

</dd>

<dt>

<span class="term">

<em class="parameter">

<code>dstAlpha</code>

</em>

</span>

</dt>

<dd>

<p>

Specified how the alpha destination blending factor is computed.

The initial value is <code class="constant">GL_ZERO</code>.

</p>

</dd>

</dl>

</div>

</div>

<div class="refsect1" id="description">

<h2>Description</h2>

<p>

Pixels can be drawn using a function that blends

the incoming (source) RGBA values with the RGBA values

that are already in the frame buffer (the destination values).

Blending is initially disabled.

Use <a class="citerefentry" href="glEnable"><span class="citerefentry"><span class="refentrytitle">glEnable</span></span></a> and <a class="citerefentry" href="glDisable"><span class="citerefentry"><span class="refentrytitle">glDisable</span></span></a> with argument <code class="constant">GL_BLEND</code>

to enable and disable blending.

</p>

<p>

<code class="function">glBlendFuncSeparate</code> defines the operation of blending for all draw buffers when it is enabled.

<code class="function">glBlendFuncSeparatei</code> defines the operation of blending for a single draw buffer

specified by <em class="parameter"><code>buf</code></em> when enabled for that draw buffer.

<em class="parameter"><code>srcRGB</code></em> specifies which method is used to scale the

source RGB-color components.

<em class="parameter"><code>dstRGB</code></em> specifies which method is used to scale the

destination RGB-color components.

Likewise, <em class="parameter"><code>srcAlpha</code></em> specifies which method is used to scale the source alpha

color component, and <em class="parameter"><code>dstAlpha</code></em> specifies which method is used to scale the

destination alpha component.

The possible methods are described in the following table.

Each method defines four scale factors,

one each for red, green, blue, and alpha.

</p>

<p>

In the table and in subsequent equations, first source, second source and destination

color components are referred to as

<math overflow="scroll">

<mfenced open="(" close=")">

<msub><mi mathvariant="italic">R</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">G</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">B</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

</mfenced>

</math>,

<math overflow="scroll">

<mfenced open="(" close=")">

<msub><mi mathvariant="italic">R</mi>

<mi mathvariant="italic">s1</mi>

</msub>

<msub><mi mathvariant="italic">G</mi>

<mi mathvariant="italic">s1</mi>

</msub>

<msub><mi mathvariant="italic">B</mi>

<mi mathvariant="italic">s1</mi>

</msub>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s1</mi>

</msub>

</mfenced>

</math>,

and

<math overflow="scroll">

<mfenced open="(" close=")">

<msub><mi mathvariant="italic">R</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">G</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">B</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

</mfenced>

</math>, respectively.

The color specified by <a class="citerefentry" href="glBlendColor"><span class="citerefentry"><span class="refentrytitle">glBlendColor</span></span></a> is referred to as

<math overflow="scroll">

<mfenced open="(" close=")">

<msub><mi mathvariant="italic">R</mi>

<mi mathvariant="italic">c</mi>

</msub>

<msub><mi mathvariant="italic">G</mi>

<mi mathvariant="italic">c</mi>

</msub>

<msub><mi mathvariant="italic">B</mi>

<mi mathvariant="italic">c</mi>

</msub>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">c</mi>

</msub>

</mfenced>

</math>.

They are understood to have integer values between 0 and

<math overflow="scroll">

<mfenced open="(" close=")">

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">R</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">G</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">B</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfenced>

</math>,

where

</p>

<p>

<math overflow="scroll">

<mrow>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">c</mi>

</msub>

<mo>=</mo>

<mrow>

<msup><mn>2</mn>

<mfenced open="" close="">

<msub><mi mathvariant="italic">m</mi>

<mi mathvariant="italic">c</mi>

</msub>

</mfenced>

</msup>

<mo>-</mo>

<mn>1</mn>

</mrow>

</mrow>

</math>

</p>

<p>

and

<math overflow="scroll">

<mfenced open="(" close=")">

<msub><mi mathvariant="italic">m</mi>

<mi mathvariant="italic">R</mi>

</msub>

<msub><mi mathvariant="italic">m</mi>

<mi mathvariant="italic">G</mi>

</msub>

<msub><mi mathvariant="italic">m</mi>

<mi mathvariant="italic">B</mi>

</msub>

<msub><mi mathvariant="italic">m</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfenced>

</math>

is the number of red,

green,

blue,

and alpha bitplanes.

</p>

<p>

Source and destination scale factors are referred to as

<math overflow="scroll">

<mfenced open="(" close=")">

<msub><mi mathvariant="italic">s</mi>

<mi mathvariant="italic">R</mi>

</msub>

<msub><mi mathvariant="italic">s</mi>

<mi mathvariant="italic">G</mi>

</msub>

<msub><mi mathvariant="italic">s</mi>

<mi mathvariant="italic">B</mi>

</msub>

<msub><mi mathvariant="italic">s</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfenced>

</math>

and

<math overflow="scroll">

<mfenced open="(" close=")">

<msub><mi mathvariant="italic">d</mi>

<mi mathvariant="italic">R</mi>

</msub>

<msub><mi mathvariant="italic">d</mi>

<mi mathvariant="italic">G</mi>

</msub>

<msub><mi mathvariant="italic">d</mi>

<mi mathvariant="italic">B</mi>

</msub>

<msub><mi mathvariant="italic">d</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfenced>

</math>.

All scale factors have range

<math overflow="scroll">

<mfenced open="[" close="]">

<mn>0</mn>

<mn>1</mn>

</mfenced>

</math>.

</p>

<p>

</p>

<div class="informaltable">

<table style="border-collapse: collapse; border-top: 2px solid ; border-bottom: 2px solid ; border-left: 2px solid ; border-right: 2px solid ; ">

<colgroup>

<col style="text-align: left; "/>

<col style="text-align: left; "/>

<col style="text-align: left; "/>

</colgroup>

<thead>

<tr>

<th style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<span class="bold"><strong> Parameter </strong></span>

</th>

<th style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<span class="bold"><strong> RGB Factor </strong></span>

</th>

<th style="text-align: left; border-bottom: 2px solid ; ">

<span class="bold"><strong> Alpha Factor </strong></span>

</th>

</tr>

</thead>

<tbody>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_ZERO</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfenced open="(" close=")">

<mn>0</mn>

<mn>0</mn>

<mn>0</mn>

</mfenced>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mn>0</mn>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_ONE</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfenced open="(" close=")">

<mn>1</mn>

<mn>1</mn>

<mn>1</mn>

</mfenced>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mn>1</mn>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_SRC_COLOR</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfenced open="(" close=")">

<mfrac>

<msub><mi mathvariant="italic">R</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">R</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">G</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">G</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">B</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">B</mi>

</msub>

</mfrac>

</mfenced>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_ONE_MINUS_SRC_COLOR</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mrow>

<mfenced open="(" close=")">

<mn>1</mn>

<mn>1</mn>

<mn>1</mn>

<mn>1</mn>

</mfenced>

<mo>-</mo>

<mfenced open="(" close=")">

<mfrac>

<msub><mi mathvariant="italic">R</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">R</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">G</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">G</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">B</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">B</mi>

</msub>

</mfrac>

</mfenced>

</mrow>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mrow>

<mn>1</mn>

<mo>-</mo>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</mrow>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_DST_COLOR</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfenced open="(" close=")">

<mfrac>

<msub><mi mathvariant="italic">R</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">R</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">G</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">G</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">B</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">B</mi>

</msub>

</mfrac>

</mfenced>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_ONE_MINUS_DST_COLOR</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mrow>

<mfenced open="(" close=")">

<mn>1</mn>

<mn>1</mn>

<mn>1</mn>

</mfenced>

<mo>-</mo>

<mfenced open="(" close=")">

<mfrac>

<msub><mi mathvariant="italic">R</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">R</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">G</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">G</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">B</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">B</mi>

</msub>

</mfrac>

</mfenced>

</mrow>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mrow>

<mn>1</mn>

<mo>-</mo>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</mrow>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_SRC_ALPHA</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfenced open="(" close=")">

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</mfenced>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_ONE_MINUS_SRC_ALPHA</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mrow>

<mfenced open="(" close=")">

<mn>1</mn>

<mn>1</mn>

<mn>1</mn>

</mfenced>

<mo>-</mo>

<mfenced open="(" close=")">

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</mfenced>

</mrow>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mrow>

<mn>1</mn>

<mo>-</mo>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">s0</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</mrow>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_DST_ALPHA</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfenced open="(" close=")">

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</mfenced>

</math>

</td>

<td style="text-align: left; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

</math>

</td>

</tr>

<tr>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; "> <code class="constant">GL_ONE_MINUS_DST_ALPHA</code> </td>

<td style="text-align: left; border-right: 2px solid ; border-bottom: 2px solid ; ">

<math overflow="scroll">

<mrow>

<mfenced open="(" close=")">

<mn>1</mn>

<mn>1</mn>

<mn>1</mn>

</mfenced>

<mo>-</mo>

<mfenced open="(" close=")">

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">A</mi>

<mi mathvariant="italic">d</mi>

</msub>

<msub><mi mathvariant="italic">k</mi>

<mi mathvariant="italic">A</mi>

</msub>

</mfrac>

<mfrac>

<msub><mi mathvariant="italic">A</mi>