Функция 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 для Windows 8. Поддерживается для классических приложений Win32, приложений Магазина Windows и приложений Windows Phone 8.

Требования

Требование Значение
Целевая платформа Windows
Header directxmath.h

См. также раздел

Функции цвета библиотеки DirectXMath