Compartilhar via


Função D3DXColorAdjustContrast (D3dx9math.h)

Observação

A biblioteca de utilitários D3DX foi preterida. Em vez disso, recomendamos que você use DirectXMath .

Ajusta o valor de contraste de uma cor.

Sintaxe

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

Parâmetros

pOut [in, out]

Tipo: D3DXCOLOR*

Ponteiro para uma estrutura D3DXCOLOR que é o resultado da operação.

pC [in]

Tipo: const D3DXCOLOR*

Ponteiro para uma estrutura D3DXCOLOR de origem.

c [in]

Tipo: FLOAT

Valor de contraste. Esse parâmetro interpola linearmente entre 50% de cinza e a cor, pC. Não há limites para o valor de c. Se esse parâmetro for zero, a cor retornada será 50% cinza. Se esse parâmetro for 1, a cor retornada será a cor original.

Valor retornado

Tipo: D3DXCOLOR*

Essa função retorna um ponteiro para uma estrutura D3DXCOLOR que é o resultado do ajuste de contraste.

Comentários

O canal alfa de entrada é copiado, não modificado, para o canal alfa de saída.

O valor retornado para essa função é o mesmo valor retornado no parâmetro pOut. Dessa forma, essa função pode ser usada como um parâmetro para outra função.

Essa função interpola os componentes de cor vermelho, verde e azul de uma estrutura D3DXCOLOR entre 50% de cinza e um valor de contraste especificado, conforme mostrado no exemplo a seguir.

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

Se c for maior que 0 e menor que 1, o contraste será reduzido. Se c for maior que 1, o contraste será aumentado.

Requisitos

Requisito Valor
parâmetro
D3dx9math.h
Biblioteca
D3dx9.lib

Confira também

Funções Matemáticas

D3DXColorAdjustSaturation