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