Função D3DXColorScale

  • Artigo

Observação

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

Dimensiona um valor de cor.

Sintaxe

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

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.

s [in]

Tipo: FLOAT

Fator de escala. Ele dimensiona a cor, tratando-a como um vetor 4D. Não há limites para o valor de s. Se s for 1, a cor resultante será a cor original.

Valor retornado

Tipo: D3DXCOLOR*

Essa função retorna um ponteiro para uma estrutura D3DXCOLOR que é o valor de cor dimensionada.

Comentários

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

Essa função calcula o valor de cor dimensionada multiplicando os componentes de cor da estrutura D3DXCOLOR pelo fator de escala especificado, conforme mostrado no exemplo a seguir.

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

Requisitos

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

Confira também

Funções Matemáticas

D3DXColorLerp

D3DXColorModulate

D3DXColorNegative