Funzione D3DXColorLerp

Nota

La libreria di utilità D3DX è deprecata. È consigliabile usare invece DirectXMath .

Usa l'interpolazione lineare per creare un valore di colore.

Sintassi

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

Parametri

pOut [in, out]

Tipo: D3DXCOLOR*

Puntatore a una struttura D3DXCOLOR che è il risultato dell'operazione.

pC1 [in]

Tipo: const D3DXCOLOR*

Puntatore a una struttura D3DXCOLOR di origine.

pC2 [in]

Tipo: const D3DXCOLOR*

Puntatore a una struttura D3DXCOLOR di origine.

s [in]

Tipo: FLOAT

Parametro che interpola in modo lineare tra i colori, pC1 e pC2, trattandoli entrambi come vettori 4D. Non esistono limiti sul valore di s.

Valore restituito

Tipo: D3DXCOLOR*

Questa funzione restituisce un puntatore a una struttura D3DXCOLOR che è il risultato dell'interpolazione lineare.

Commenti

Il valore restituito per questa funzione è lo stesso valore restituito nel parametro pOut. In questo modo, la funzione D3DXColorLerp può essere usata come parametro per un'altra funzione.

Questa funzione interpola i componenti rosso, verde, blu e alfa di una struttura D3DXCOLOR tra due colori, come illustrato nell'esempio seguente.


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

Se si esegue l'interpolazione lineare tra i colori A e B e s è 0, il colore risultante è A. Se s è 1, il colore risultante è colore B.

Requisiti

Requisito Valore
Intestazione
D3dx9math.h
Libreria
D3dx9.lib

Vedi anche

Funzioni matematiche

D3DXColorModulate

D3DXColorNegative

D3DXColorScale