Función D3DXColorScale

Nota

La biblioteca de utilidades D3DX está en desuso. Se recomienda usar DirectXMath en su lugar.

Escala un valor de color.

Sintaxis

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

Parámetros

pOut [in, out]

Tipo: D3DXCOLOR*

Puntero a una estructura D3DXCOLOR que es el resultado de la operación.

pC [in]

Tipo: const D3DXCOLOR*

Puntero a una estructura D3DXCOLOR de origen.

s [in]

Tipo: FLOAT

Factor de escala. Escala el color, tratandolo como un vector 4D. No hay límites en el valor de s. Si s es 1, el color resultante es el color original.

Valor devuelto

Tipo: D3DXCOLOR*

Esta función devuelve un puntero a una estructura D3DXCOLOR que es el valor de color escalado.

Comentarios

El valor devuelto de esta función es el mismo valor devuelto en el parámetro pOut. De este modo, la función D3DXColorScale se puede usar como parámetro para otra función.

Esta función calcula el valor de color escalado multiplicando los componentes de color de la estructura D3DXCOLOR por el factor de escala especificado, como se muestra en el ejemplo siguiente.

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

Requisitos

Requisito	Value
Encabezado	D3dx9math.h
Biblioteca	D3dx9.lib

Consulte también

Funciones matemáticas

D3DXColorLerp

D3DXColorModulate

D3DXColorNegative