Função XMColorAdjustSaturation (directxmath.h)

Ajusta o valor de saturação de uma cor.

Sintaxe

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

Parâmetros

[in] C

XMVECTOR que descreve a cor. Cada um dos componentes de C deve estar no intervalo de 0,0f a 1,0f.

[in] Saturation

Valor de saturação. Esse parâmetro interpola linearmente entre a cor convertida em escala de cinza e a cor original, C. Se saturação for 0,0f, a função retornará a cor em escala de cinza. Se saturação for 1,0f, a função retornará a cor original.

Retornar valor

Retorna um XMVECTOR que descreve a cor resultante do ajuste de saturação.

Comentários

O pseudocódigo a seguir demonstra a operação da função .

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 plataforma

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 com o SDK do Windows para Windows 8. Com suporte para aplicativos da área de trabalho Win32, aplicativos da Windows Store e aplicativos Windows Phone 8.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	directxmath.h

Confira também

Funções de cor da biblioteca DirectXMath