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 |