D3DXColorScale 函数

注意

D3DX 实用工具库已弃用。 建议改用 DirectXMath

缩放颜色值。

语法

D3DXCOLOR* D3DXColorScale(
  _Inout_       D3DXCOLOR *pOut,
  _In_    const D3DXCOLOR *pC,
  _In_          FLOAT     s
);

参数

pOut [in, out]

类型: D3DXCOLOR*

指向作为操作结果的 D3DXCOLOR 结构的指针。

pC [in]

类型: const D3DXCOLOR*

指向源 D3DXCOLOR 结构的指针。

s [in]

类型: FLOAT

比例系数。 它缩放颜色,将其视为 4D 矢量。 对 的值没有限制。 如果 为 1,则生成的颜色为原始颜色。

返回值

类型: D3DXCOLOR*

此函数返回指向 D3DXCOLOR 结构的指针,该结构是缩放的颜色值。

备注

此函数的返回值与 pOut 参数中返回的值相同。 这样, D3DXColorScale 函数就可用作另一个函数的参数。

此函数通过将 D3DXCOLOR 结构的颜色分量乘以指定的比例因子来计算缩放的颜色值,如以下示例所示。

pOut->r = pC->r * s;

要求

要求
标头
D3dx9math.h

D3dx9.lib

另请参阅

数学函数

D3DXColorLerp

D3DXColorModulate

D3DXColorNegative