Funzione XMColorAdjustSaturation (directxmath.h)
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 |