Funzione D3DXColorAdjustContrast (D3dx9math.h)

Nota

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

Regola il valore di contrasto di un colore.

Sintassi

D3DXCOLOR* D3DXColorAdjustContrast(
  _Inout_       D3DXCOLOR *pOut,
  _In_    const D3DXCOLOR *pC,
  _In_          FLOAT     c
);

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.

c [in]

Tipo: FLOAT

Valore di contrasto. Questo parametro interpola in modo lineare tra il colore grigio e il colore, pC. Non esistono limiti sul valore di c. Se questo parametro è zero, il colore restituito è grigio del cinquanta%. Se questo parametro è 1, il colore restituito è il colore originale.

Valore restituito

Tipo: D3DXCOLOR*

Questa funzione restituisce un puntatore a una struttura D3DXCOLOR che è il risultato della regolazione del contrasto.

Commenti

Il canale alfa di input viene copiato, non modificato, nel canale alfa di output.

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

Questa funzione interpola i componenti di colore rosso, verde e blu di una struttura D3DXCOLOR compresa tra il cinquanta percento di grigio e un valore di contrasto specificato, come illustrato nell'esempio seguente.

pOut->r = 0.5f + c * (pC->r - 0.5f);

Se c è maggiore di 0 e minore di 1, il contrasto è diminuito. Se c è maggiore di 1, il contrasto è aumentato.

Requisiti

Requisito Valore
Intestazione
D3dx9math.h
Libreria
D3dx9.lib

Vedi anche

Funzioni matematiche

D3DXColorAdjustSaturation