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 |
|
| Bibliothèque |
|