glBlendFunc 函数

  • 项目

glBlendFunc 函数指定像素算术。

语法

void WINAPI glBlendFunc(
   GLenum sfactor,
   GLenum dfactor
);

参数

sfactor

指定如何计算红色、绿色、蓝色和 alpha 源混合因子。 接受九个符号常量：GL_ZERO、GL_ONE、GL_DST_COLOR、GL_ONE_MINUS_DST_COLOR、GL_SRC_ALPHA、GL_ONE_MINUS_SRC_ALPHA、GL_DST_ALPHA、GL_ONE_MINUS_DST_ALPHA和GL_SRC_ALPHA_SATURATE。

dfactor

指定如何计算红色、绿色、蓝色和 alpha 目标混合因子。 接受八个符号常量：GL_ZERO、GL_ONE、GL_SRC_COLOR、GL_ONE_MINUS_SRC_COLOR、GL_SRC_ALPHA、GL_ONE_MINUS_SRC_ALPHA、GL_DST_ALPHA和GL_ONE_MINUS_DST_ALPHA。

返回值

此函数不返回值。

错误代码

glGetError 函数可以检索以下错误代码。

名称 含义
GL_INVALID_ENUM
 sfactor 或 dfactor 不是接受的值。
GL_INVALID_OPERATION
 在对 glBegin 的调用和对 glEnd 的相应调用之间调用了函数。

备注

在 RGB 模式下，可以使用函数绘制像素，该函数将传入 (源) RGBA 值与已在帧缓冲区中的 RGBA 值混合 (目标值) 。 默认情况下，混合处于禁用状态。 将 glEnable 和 glDisable 与 GL_BLEND 参数一起使用，以启用和禁用混合。

启用后， glBlendFunc 定义混合操作。 sfactor 参数指定使用九种方法中的哪一种方法来缩放源颜色分量。 dfactor 参数指定使用八种方法中的哪一种方法来缩放目标颜色分量。 下表介绍了 11 种可能的方法。 每个方法定义四个比例系数，分别用于红色、绿色、蓝色和 alpha。

在表和后续公式中，源和目标颜色组件称为 (R？、 G？、 B？、 A？) 和 (Rd 、 Gd 、 Bd 、 Ad ) 。 据了解，它们的整数值介于零和 (kR 、 kG 、 kR 、 kA ) 之间，其中

kR = 2mR - 1

kG = 2mG - 1

kB = 2mB - 1

kA = 2mA - 1

和 (mR 、 mG 、 mB 、 mA ) 是红色、绿色、蓝色和 alpha 位平面的数目。

源和目标比例因子称为 (R、G 、B、a ) 和 (dR、dG、dB、dA ) 。 表中描述的比例因子表示 (fR 、 fG 、 fB 、 fA ) 表示源因子或目标因子。 所有比例系数的范围为 [0，1]。

参数 (fR 、 fG 、 fB 、 fA )
GL_ZERO (0,0,0,0)
GL_ONE (1，1，1，1)
GL_SRC_COLOR (R？/ kR 、 G？/ kG 、 B？/ kB 、 A？/ kA )
GL_ONE_MINUS_SRC_COLOR (1，1，1，1) - (R？/ kR 、 G？/ kG 、 B？/ kB 、 A？/ kA )
GL_DST_COLOR (Rd / kR 、 Gd / kG 、 Bd / kB 、 Ad / kA )
GL_ONE_MINUS_DST_COLOR (1，1，1，1) - (Rd / kR、Gd / kG、Bd / k B、Ad / kA )
GL_SRC_ALPHA (A？/ kA 、 A？/ kA 、 A？/ kA 、 A？/ kA )
GL_ONE_MINUS_SRC_ALPHA (1，1，1，1) - (A？/ kA 、 A？/ kA 、 A？/ kA 、 A？/ kA )
GL_DST_ALPHA (Ad / kA 、Ad / kA 、Ad / kA 、A d / kA )
GL_ONE_MINUS_DST_ALPHA (1，1，1，1) - (Ad / kA 、 Ad / kA 、 Ad / kA 、 Ad / kA )
GL_SRC_ALPHA_SATURATE (i，i，i， 1)

在表中，

i = min (A？、kA - d ) / kA

为了确定在 RGBA 模式下绘制时像素的混合 RGBA 值，系统使用以下公式：

R (d) = min ( kR ， R？ + RddR )

G (d) = min ( kG ， G？ sG + GddG )

B (d) = min ( kB， B？ sB + BddB )

(d) = min ( kA 、 A？ sA + AddA )

尽管上述公式具有明显的精度，但混合算术并没有完全指定，因为混合运算使用不精确的整数颜色值。 但是，应等于 1 的混合因子保证不会修改其乘法，而等于零的混合因子会将其乘数减为零。 因此，例如，当 sfactor 为GL_SRC_ALPHA时， dfactor 为 GL_ONE_MINUS_SRC_ALPHA，而 A？等于 kA，公式缩减为简单替换：

Rd = R？

Gd = G？

Bd = B？

Ad = A？

示例

透明度最好使用 glBlendFunc (GL_SRC_ALPHA来实现，GL_ONE_MINUS_SRC_ALPHA) 基元从最远到最接近排序。 请注意，此透明度计算不需要帧缓冲区中存在 alpha 位平面。

还可以使用 glBlendFunc (GL_SRC_ALPHA，GL_ONE_MINUS_SRC_ALPHA) 任意顺序呈现抗锯齿点和线条。

若要优化多边形抗锯齿，请使用 glBlendFunc (GL_SRC_ALPHA_SATURATE，GL_ONE) 多边形从最近到最远排序。 (有关 polygon antialiasing.) Destination alpha 位平面的信息，请参阅 glEnable 中的GL_POLYGON_SMOOTH参数，该参数必须存在才能使此混合函数正常运行，并存储累积的覆盖范围。

传入 (源) alpha 是一种材料不透明度，范围从 1.0 (KA ) （表示完全不透明度）到 0.0 (0) ，表示完全透明度。

为绘图启用多个颜色缓冲区时，每个已启用的缓冲区将单独混合，并且缓冲区的内容将用于目标颜色。 (请参阅 glDrawBuffer.)

混合仅影响 RGBA 呈现。 颜色索引呈现器会忽略它。

以下函数检索与 glBlendFunc 相关的信息：

带参数GL_BLEND_SRC的 glGet

带参数GL_BLEND_DST的 glGet

glIsEnabled with argument GL_BLEND

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Gl.h
库
Opengl32.lib
DLL
Opengl32.dll

另请参阅

glAlphaFunc

glBegin

glClear

glDisable

glDrawBuffer

glEnable

glGet

glIsEnabled

glLogicOp

glStencilFunc