Partilhar via


Função D3DXColorLerp

Observação

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

Usa interpolação linear para criar um valor de cor.

Sintaxe

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

Parâmetros

pOut [in, out]

Tipo: D3DXCOLOR*

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

pC1 [in]

Tipo: const D3DXCOLOR*

Ponteiro para uma estrutura D3DXCOLOR de origem.

pC2 [in]

Tipo: const D3DXCOLOR*

Ponteiro para uma estrutura D3DXCOLOR de origem.

s [in]

Tipo: FLOAT

Parâmetro que interpola linearmente entre as cores, pC1 e pC2, tratando ambas como vetores 4D. Não há limites para o valor de s.

Valor retornado

Tipo: D3DXCOLOR*

Essa função retorna um ponteiro para uma estrutura D3DXCOLOR que é o resultado da interpolação linear.

Comentários

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

Essa função interpola os componentes vermelho, verde, azul e alfa de uma estrutura D3DXCOLOR entre duas cores, conforme mostrado no exemplo a seguir.


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

Se você estiver interpolando linearmente entre as cores A e B e s for 0, a cor resultante será A. Se s for 1, a cor resultante será a cor B.

Requisitos

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

Confira também

Funções Matemáticas

D3DXColorModulate

D3DXColorNegative

D3DXColorScale