Partager via


D3DXColorLerp, fonction

Notes

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

Utilise l’interpolation linéaire pour créer une valeur de couleur.

Syntaxe

D3DXCOLOR* D3DXColorLerp(
  _Inout_       D3DXCOLOR *pOut,
  _In_    const D3DXCOLOR *pC1,
  _In_    const D3DXCOLOR *pC2,
  _In_          FLOAT     s
);

Paramètres

pOut [in, out]

Type : D3DXCOLOR*

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

pC1 [in]

Type : const D3DXCOLOR*

Pointeur vers une structure D3DXCOLOR source.

pC2 [in]

Type : const D3DXCOLOR*

Pointeur vers une structure D3DXCOLOR source.

s [in]

Type : FLOAT

Paramètre qui interpole linéairement entre les couleurs, pC1 et pC2, en les traitant tous deux comme des vecteurs 4D. Il n’existe aucune limite sur la valeur de s.

Valeur retournée

Type : D3DXCOLOR*

Cette fonction retourne un pointeur vers une structure D3DXCOLOR qui est le résultat de l’interpolation linéaire.

Notes

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

Cette fonction interpole les composants rouge, vert, bleu et alpha d’une structure D3DXCOLOR entre deux couleurs, comme illustré dans l’exemple suivant.


pOut->r = pC1->r + s * (pC2->r - pC1->r);

Si vous interpolez linéairement entre les couleurs A et B, et que s a la valeur 0, la couleur résultante est A. Si s a la valeur 1, la couleur obtenue est la couleur B.

Spécifications

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

Voir aussi

Fonctions mathématiques

D3DXColorModulate

D3DXColorNegative

D3DXColorScale