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 ライブラリのカラー関数