Функция D3DXColorScale

Статья
06/13/2023

Примечание

Служебная библиотека D3DX устарела. Вместо этого рекомендуется использовать DirectXMath .

Масштабирует значение цвета.

Синтаксис

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

Параметры

pOut [in, out]

Тип: D3DXCOLOR*

Указатель на структуру D3DXCOLOR , которая является результатом операции.

pC [in]

Тип: const D3DXCOLOR*

Указатель на исходную структуру D3DXCOLOR .

s [in]

Тип: FLOAT

Коэффициент масштабирования. Он масштабирует цвет, рассматривая его как 4D-вектор. Нет ограничений на значение s. Если значение s равно 1, результирующий цвет является исходным цветом.

Возвращаемое значение

Тип: D3DXCOLOR*

Эта функция возвращает указатель на структуру D3DXCOLOR , которая является масштабируемым значением цвета.

Возвращаемое значение для этой функции совпадает с значением, возвращаемым в параметре pOut. Таким образом, функцию D3DXColorScale можно использовать в качестве параметра для другой функции.

Эта функция вычисляет масштабируемое значение цвета, умножая компоненты цвета структуры D3DXCOLOR на указанный коэффициент масштабирования, как показано в следующем примере.

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

Требования

Требование	Значение
Заголовок	D3dx9math.h
Библиотека	D3dx9.lib

См. также раздел

Математические функции
D3DXColorLerp
D3DXColorModulate
D3DXColorNegative

Share via