D3DXColorAdjustSaturation, fonction (D3DX10Math. h)

Ajuste la valeur de saturation d’une couleur.

Syntaxe

D3DXCOLOR* D3DXColorAdjustSaturation(
  _In_       D3DXCOLOR *pOut,
  _In_ const D3DXCOLOR *pC,
  _In_       FLOAT     s
);

Paramètres

moue [ dans]

Type : D3DXCOLOR*

Pointeur vers un D3DXCOLOR qui est le résultat de l’opération.

ordinateur [ dans]

Type : const D3DXCOLOR *

Pointeur vers une structure D3DXCOLOR source.

[ dans]

Type : float

Valeur de saturation. Ce paramètre interpole de manière linéaire entre la couleur convertie en nuances de gris et la couleur d’origine, pC. La valeur de s n’est pas limitée. Si s est égal à 0, la couleur retournée est la couleur de nuances de gris. Si s est 1, la couleur retournée est la couleur d’origine.

Valeur retournée

Type : D3DXCOLOR*

Cette fonction retourne un pointeur vers une structure D3DXCOLOR qui est le résultat de l’ajustement de saturation.

Remarques

Le canal alpha d’entrée est copié, sans modification, sur le canal alpha de sortie.

La valeur de retour de cette fonction est la même que celle retournée dans le paramètre moue. De cette façon, cette fonction peut être utilisée comme paramètre pour une autre fonction.

Cette fonction interpole les composants de couleur rouge, vert et bleu d’une structure D3DXCOLOR entre une couleur insaturée et une couleur, comme illustré dans l’exemple suivant.

//Approximate values for each component's contribution to luminance.
//Based upon the NTSC standard described in ITU-R Recommendation BT.709.
FLOAT grey = pC->r * 0.2125f + pC->g * 0.7154f + pC->b * 0.0721f;

pOut->r = grey + s * (pC->r - grey);

Si s est supérieur à 0 et inférieur à 1, la saturation est réduite. Si s est supérieur à 1, la saturation est augmentée.

La couleur de nuances de gris est calculée comme suit :

r = g = b = 0.2125*r + 0.7154*g + 0.0721*b;

Configuration requise

Condition requise Valeur
En-tête
D3DX10Math. h
Bibliothèque
D3DX10. lib

Voir aussi

Fonctions mathématiques