D3DXColorAdjustContrast 函式 (D3dx9math.h)

注意

D3DX 公用程式程式庫已被取代。建議您改用 DirectXMath 。

調整色彩的對比值。

語法

D3DXCOLOR* D3DXColorAdjustContrast(
  _Inout_       D3DXCOLOR *pOut,
  _In_    const D3DXCOLOR *pC,
  _In_          FLOAT     c
);

pOut [in， out]

類型： D3DXCOLOR*

作業結果的 D3DXCOLOR 結構的指標。

pC [in]

類型：const D3DXCOLOR*

來源 D3DXCOLOR 結構的指標。

c [in]

類型： FLOAT

對比值。此參數會以線性方式插補 50% 灰色與色彩 pC。 c 的值沒有限制。如果此參數為零，則傳回的色彩為 50% 灰色。如果此參數為 1，則傳回的色彩為原始色彩。

此函式會傳回 D3DXCOLOR 結構的指標，這是對比調整的結果。

輸入 Alpha 色板會以未修改方式複製到輸出 Alpha 色板。

此函式的傳回值與 pOut 參數中傳回的值相同。如此一來，這個函式就可以當做另一個函式的參數使用。

此函式會插補 D3DXCOLOR 結構的紅色、綠色和藍色元件，介於 50% 灰色和指定的對比值之間，如下列範例所示。

pOut->r = 0.5f + c * (pC->r - 0.5f);

如果 c 大於 0 且小於 1，則會減少對比。如果 c 大於 1，則會增加對比。

需求	值
標頭	D3dx9math.h
程式庫	D3dx9.lib