XMColorAdjustSaturation 函式 (directxmath.h)

  • 發行項

調整色彩的飽和度值。

語法

XMVECTOR XM_CALLCONV XMColorAdjustSaturation(
  [in] FXMVECTOR C,
  [in] float     Saturation
) noexcept;

參數

[in] C

描述色彩的 XMVECTOR。 C 的每個元件都應該在 0.0f 到 1.0f 的範圍內。

[in] Saturation

飽和度值。 此參數會在轉換成灰階的色彩與原始色彩 C 之間以線性方式插補。如果 飽和度 為 0.0f，函式會傳回灰階色彩。 如果 飽和度 為 1.0f，函式會傳回原始色彩。

傳回值

傳回 XMVECTOR ，描述飽和度調整所產生的色彩。

備註

下列虛擬程式代碼示範函式的作業。

XMVector colorOut;

// Approximate values for each component's contribution to luminance.
// Based upon the NTSC standard described in ITU-R Recommendation BT.709.
float Luminance = 0.2125f * C.x + 0.7154f * C.y + 0.0721f * C.z;

colorOut.x = (C.x - Luminance) * Saturation + Luminance;
colorOut.y = (C.y - Luminance) * Saturation + Luminance;
colorOut.z = (C.z - Luminance) * Saturation + Luminance;
colorOut.w = C.w;

return colorOut;

平臺需求

Microsoft Visual Studio 2010 或 Microsoft Visual Studio 2012 搭配 Windows SDK for Windows 8。 支援 Win32 傳統型應用程式、Windows 市集應用程式和 Windows Phone 8 個應用程式。

規格需求

需求 值
目標平台 Windows
標頭 directxmath.h

另請參閱

DirectXMath 連結庫色彩函式