Fonction XMColorAdjustSaturation (directxmath.h)
Ajuste la valeur de saturation d’une couleur.
Syntaxe
XMVECTOR XM_CALLCONV XMColorAdjustSaturation(
[in] FXMVECTOR C,
[in] float Saturation
) noexcept;
Paramètres
[in] C
XMVECTOR décrivant la couleur. Chacun des composants de C doit être dans la plage 0.0f à 1.0f.
[in] Saturation
Valeur de saturation. Ce paramètre interpole linéairement entre la couleur convertie en échelle de gris et la couleur d’origine, C. Si saturation est de 0,0f, la fonction retourne la couleur d’échelle de gris. Si saturation est 1.0f, la fonction retourne la couleur d’origine.
Valeur retournée
Retourne un XMVECTOR décrivant la couleur résultant de l’ajustement de saturation.
Remarques
Le pseudocode suivant illustre le fonctionnement de la fonction .
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;
Configuration requise pour la plateforme
Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 avec le SDK Windows pour Windows 8. Pris en charge pour les applications de bureau Win32, les applications du Windows Store et les applications Windows Phone 8.Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | directxmath.h |