D3DXColorAdjustContrast, fonction (D3DX10Math.h)

Notes

La bibliothèque utilitaire D3DX10 est déconseillée. Nous vous recommandons d’utiliser DirectXMath à la place.

Ajuste la valeur de contraste d’une couleur.

Syntaxe

D3DXCOLOR* D3DXColorAdjustContrast(
  _In_       D3DXCOLOR *pOut,
  _In_ const D3DXCOLOR *pC,
  _In_       FLOAT     c
);

Paramètres

pOut [in]

Type : D3DXCOLOR*

[in, out] Pointeur vers un D3DXCOLOR qui est le résultat de l’opération.

pC [in]

Type : const D3DXCOLOR*

Pointeur vers une structure D3DXCOLOR source.

c [in]

Type : FLOAT

Valeur de contraste. Ce paramètre interpole linéairement entre cinquante pour cent de gris et la couleur, pC. Il n’existe aucune limite sur la valeur de c. Si ce paramètre est égal à zéro, la couleur retournée est grise de cinquante pour cent. Si ce paramètre a la valeur 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 du contraste.

Notes

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

La valeur de retour pour cette fonction est la même valeur retournée dans le paramètre pOut. 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 cinquante pour cent de gris et une valeur de contraste spécifiée, comme illustré dans l’exemple suivant.

pOut->r = 0.5f + c * (pC->r - 0.5f);

Si c est supérieur à 0 et inférieur à 1, le contraste est réduit. Si c est supérieur à 1, le contraste est augmenté.

Spécifications

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

Voir aussi

Fonctions mathématiques