Función XMColorAdjustSaturation (directxmath.h)

  • Artículo

Ajusta el valor de saturación de un color.

Sintaxis

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

Parámetros

[in] C

XMVECTOR que describe el color. Cada uno de los componentes de C debe estar en el intervalo de 0,0f a 1,0f.

[in] Saturation

Valor de saturación. Este parámetro interpola linealmente entre el color convertido a escala gris y el color original, C. Si saturación es 0,0f, la función devuelve el color de escala gris. Si la saturación es 1.0f, la función devuelve el color original.

Valor devuelto

Devuelve un XMVECTOR que describe el color resultante del ajuste de saturación.

Comentarios

El pseudocódigo siguiente muestra la operación de la función .

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;

Requisitos de la plataforma

Microsoft Visual Studio 2010 o Microsoft Visual Studio 2012 con Windows SDK para Windows 8. Compatible con aplicaciones de escritorio Win32, aplicaciones de la Tienda Windows y Windows Phone 8 aplicaciones.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado directxmath.h

Consulte también

Funciones de color de la biblioteca DirectXMath