Fonction D3DXColorScale

Notes

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

Met à l’échelle une valeur de couleur.

Syntaxe

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

Paramètres

pOut [in, out]

Type : D3DXCOLOR*

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

pC [in]

Type : const D3DXCOLOR*

Pointeur vers une structure D3DXCOLOR source.

s [in]

Type : FLOAT

Facteur d’échelle. Il met à l’échelle la couleur, en la traitant comme un vecteur 4D. Il n’existe aucune limite sur la valeur de s. Si s est 1, la couleur résultante est la couleur d’origine.

Valeur retournée

Type : D3DXCOLOR*

Cette fonction retourne un pointeur vers une structure D3DXCOLOR qui est la valeur de couleur mise à l’échelle.

Notes

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

Cette fonction calcule la valeur de couleur mise à l’échelle en multipliant les composants de couleur de la structure D3DXCOLOR par le facteur d’échelle spécifié, comme illustré dans l’exemple suivant.

pOut->r = pC->r * s;

Spécifications

Condition requise	Valeur
En-tête	D3dx9math.h
Bibliothèque	D3dx9.lib

Voir aussi

Fonctions mathématiques

D3DXColorLerp

D3DXColorModulate

D3DXColorNegative