glBlendEquationSeparate

The blend equations determines how a new pixel (the ''source'' color) is combined with a pixel already in the framebuffer (the ''destination'' color). This function specifies one blend equation for the RGB-color components and one blend equation for the alpha component.

The blend equations use the source and destination blend factors specified by either glBlendFunc or glBlendFuncSeparate . See glBlendFunc or glBlendFuncSeparate for a description of the various blend factors.

In the equations that follow, source and destination color components are referred to as $\left({\mathit{R}}_{\mathit{s}},{\mathit{G}}_{\mathit{s}},{\mathit{B}}_{\mathit{s}},{\mathit{A}}_{\mathit{s}}\right)$ and $\left({\mathit{R}}_{\mathit{d}},{\mathit{G}}_{\mathit{d}},{\mathit{B}}_{\mathit{d}},{\mathit{A}}_{\mathit{d}}\right)$ , respectively. The result color is referred to as $\left({\mathit{R}}_{\mathit{r}},{\mathit{G}}_{\mathit{r}},{\mathit{B}}_{\mathit{r}},{\mathit{A}}_{\mathit{r}}\right)$ . The source and destination blend factors are denoted $\left({\mathit{s}}_{\mathit{R}},{\mathit{s}}_{\mathit{G}},{\mathit{s}}_{\mathit{B}},{\mathit{s}}_{\mathit{A}}\right)$ and $\left({\mathit{d}}_{\mathit{R}},{\mathit{d}}_{\mathit{G}},{\mathit{d}}_{\mathit{B}},{\mathit{d}}_{\mathit{A}}\right)$ , respectively. For these equations all color components are understood to have values in the range $\left[0,1\right]$ .

Mode	RGB Components	Alpha Component
GL_FUNC_ADD	$\mathit{Rr}={\mathit{R}}_{\mathit{s}}{\mathit{s}}_{\mathit{R}}+{\mathit{R}}_{\mathit{d}}{\mathit{d}}_{\mathit{R}}$ $\mathit{Gr}={\mathit{G}}_{\mathit{s}}{\mathit{s}}_{\mathit{G}}+{\mathit{G}}_{\mathit{d}}{\mathit{d}}_{\mathit{G}}$ $\mathit{Br}={\mathit{B}}_{\mathit{s}}{\mathit{s}}_{\mathit{B}}+{\mathit{B}}_{\mathit{d}}{\mathit{d}}_{\mathit{B}}$	$\mathit{Ar}={\mathit{A}}_{\mathit{s}}{\mathit{s}}_{\mathit{A}}+{\mathit{A}}_{\mathit{d}}{\mathit{d}}_{\mathit{A}}$
GL_FUNC_SUBTRACT	$\mathit{Rr}={\mathit{R}}_{\mathit{s}}{\mathit{s}}_{\mathit{R}}-{\mathit{R}}_{\mathit{d}}{\mathit{d}}_{\mathit{R}}$ $\mathit{Gr}={\mathit{G}}_{\mathit{s}}{\mathit{s}}_{\mathit{G}}-{\mathit{G}}_{\mathit{d}}{\mathit{d}}_{\mathit{G}}$ $\mathit{Br}={\mathit{B}}_{\mathit{s}}{\mathit{s}}_{\mathit{B}}-{\mathit{B}}_{\mathit{d}}{\mathit{d}}_{\mathit{B}}$	$\mathit{Ar}={\mathit{A}}_{\mathit{s}}{\mathit{s}}_{\mathit{A}}-{\mathit{A}}_{\mathit{d}}{\mathit{d}}_{\mathit{A}}$
GL_FUNC_REVERSE_SUBTRACT	$\mathit{Rr}={\mathit{R}}_{\mathit{d}}{\mathit{d}}_{\mathit{R}}-{\mathit{R}}_{\mathit{s}}{\mathit{s}}_{\mathit{R}}$ $\mathit{Gr}={\mathit{G}}_{\mathit{d}}{\mathit{d}}_{\mathit{G}}-{\mathit{G}}_{\mathit{s}}{\mathit{s}}_{\mathit{G}}$ $\mathit{Br}={\mathit{B}}_{\mathit{d}}{\mathit{d}}_{\mathit{B}}-{\mathit{B}}_{\mathit{s}}{\mathit{s}}_{\mathit{B}}$	$\mathit{Ar}={\mathit{A}}_{\mathit{d}}{\mathit{d}}_{\mathit{A}}-{\mathit{A}}_{\mathit{s}}{\mathit{s}}_{\mathit{A}}$
GL_MIN	$\mathit{Rr}=\mathit{min}\left({\mathit{R}}_{\mathit{s}},{\mathit{R}}_{\mathit{d}}\right)$ $\mathit{Gr}=\mathit{min}\left({\mathit{G}}_{\mathit{s}},{\mathit{G}}_{\mathit{d}}\right)$ $\mathit{Br}=\mathit{min}\left({\mathit{B}}_{\mathit{s}},{\mathit{B}}_{\mathit{d}}\right)$	$\mathit{Ar}=\mathit{min}\left({\mathit{A}}_{\mathit{s}},{\mathit{A}}_{\mathit{d}}\right)$
GL_MAX	$\mathit{Rr}=\mathit{max}\left({\mathit{R}}_{\mathit{s}},{\mathit{R}}_{\mathit{d}}\right)$ $\mathit{Gr}=\mathit{max}\left({\mathit{G}}_{\mathit{s}},{\mathit{G}}_{\mathit{d}}\right)$ $\mathit{Br}=\mathit{max}\left({\mathit{B}}_{\mathit{s}},{\mathit{B}}_{\mathit{d}}\right)$	$\mathit{Ar}=\mathit{max}\left({\mathit{A}}_{\mathit{s}},{\mathit{A}}_{\mathit{d}}\right)$

The results of these equations are clamped to the range $\left[0,1\right]$ .

The GL_MIN and GL_MAX equations are useful for applications that analyze image data (image thresholding against a constant color, for example). The GL_FUNC_ADD equation is useful for antialiasing and transparency, among other things.

Initially, both the RGB blend equation and the alpha blend equation are set to GL_FUNC_ADD .

glBlendEquationSeparate is available only if the GL version is 2.0 or greater.

The GL_MIN , and GL_MAX equations do not use the source or destination factors, only the source and destination colors.

GL_INVALID_ENUM is generated if either modeRGB or modeAlpha is not one of GL_FUNC_ADD , GL_FUNC_SUBTRACT , GL_FUNC_REVERSE_SUBTRACT , GL_MAX , or GL_MIN .

GL_INVALID_OPERATION is generated if glBlendEquationSeparate is executed between the execution of glBegin and the corresponding execution of glEnd .

glGet with an argument of GL_BLEND_EQUATION_RGB

glGet with an argument of GL_BLEND_EQUATION_ALPHA

glGetString , glBlendColor , glBlendFunc , glBlendFuncSeparate

Copyright 2006 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/ .