Funzione D3DXColorScale

Nota

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

Ridimensiona un valore di colore.

Sintassi

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

Parametri

pOut [in, out]

Tipo: D3DXCOLOR*

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

pC [in]

Tipo: const D3DXCOLOR*

Puntatore a una struttura D3DXCOLOR di origine.

s [in]

Tipo: FLOAT

Fattore di scala. Scala il colore, trattandolo come un vettore 4D. Non esistono limiti sul valore di s. Se s è 1, il colore risultante è il colore originale.

Valore restituito

Tipo: D3DXCOLOR*

Questa funzione restituisce un puntatore a una struttura D3DXCOLOR che rappresenta il valore di colore ridimensionato.

Commenti

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

Questa funzione calcola il valore del colore ridimensionato moltiplicando i componenti di colore della struttura D3DXCOLOR dal fattore di scala specificato, come illustrato nell'esempio seguente.

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

Requisiti

Requisito Valore
Intestazione
D3dx9math.h
Libreria
D3dx9.lib

Vedi anche

Funzioni matematiche

D3DXColorLerp

D3DXColorModulate

D3DXColorNegative