XMColorAdjustSaturation-Funktion (directxmath.h)
Passt den Sättigungswert einer Farbe an.
Syntax
XMVECTOR XM_CALLCONV XMColorAdjustSaturation(
[in] FXMVECTOR C,
[in] float Saturation
) noexcept;
Parameter
[in] C
XMVECTOR beschreibt die Farbe. Jede der Komponenten von C sollte sich im Bereich von 0,0f bis 1,0f befinden.
[in] Saturation
Sättigungswert. Dieser Parameter interpoliert linear zwischen der in Graustufen konvertierten Farbe und der ursprünglichen Farbe C. Wenn Sättigung 0,0f ist, gibt die Funktion die Graustufenfarbe zurück. Wenn Sättigung 1,0f ist, gibt die Funktion die ursprüngliche Farbe zurück.
Rückgabewert
Gibt einen XMVECTOR zurück, der die Farbe beschreibt, die sich aus der Sättigungsanpassung ergibt.
Hinweise
Der folgende Pseudocode veranschaulicht den Vorgang der Funktion.
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;
Plattformanforderungen
Microsoft Visual Studio 2010 oder Microsoft Visual Studio 2012 mit dem Windows SDK für Windows 8. Unterstützt für Win32-Desktop-Apps, Windows Store-Apps und Windows Phone 8-Apps.Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | directxmath.h |