Funzione XMColorAdjustSaturation (directxmath.h)

  • Articolo

Regola il valore di saturazione di un colore.

Sintassi

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

Parametri

[in] C

XMVECTOR che descrive il colore. Ognuno dei componenti di C deve essere compreso nell'intervallo da 0,0f a 1,0f.

[in] Saturation

Valore di saturazione. Questo parametro esegue l'interpolazione lineare tra il colore convertito in scala grigia e il colore originale , C. Se saturazione è 0,0f, la funzione restituisce il colore in scala grigia. Se saturazione è 1,0f, la funzione restituisce il colore originale.

Valore restituito

Restituisce un XMVECTOR che descrive il colore risultante dalla regolazione della saturazione.

Commenti

Lo pseudocodice seguente illustra l'operazione della funzione .

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;

Requisiti della piattaforma

Microsoft Visual Studio 2010 o Microsoft Visual Studio 2012 con Windows SDK per Windows 8. Supportato per le app desktop Win32, le app di Windows Store e Windows Phone 8 app.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione directxmath.h

Vedi anche

Funzioni colore della libreria DirectXMath