XMColorAdjustSaturation-Funktion (directxmath.h)

Artikel
08/23/2023

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

Weitere Informationen

Farbfunktionen der DirectXMath-Bibliothek

Freigeben über