Метод IDirect3DDevice9::LightEnable (d3d9.h)

Статья
08/23/2023

Включает или отключает набор параметров освещения на устройстве.

Синтаксис

HRESULT LightEnable(
  [in] DWORD Index,
  [in] BOOL  Enable
);

Параметры

[in] Index

Тип: DWORD

Отсчитываемый от нуля индекс набора параметров освещения, которые являются целевыми объектами этого метода.

[in] Enable

Тип: BOOL

Значение, указывающее, включен или отключен набор параметров освещения. Присвойте этому параметру значение TRUE , чтобы включить освещение с параметрами по указанному индексу, или FALSE , чтобы отключить его.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. Если метод завершается сбоем, возвращаемое значение можно D3DERR_INVALIDCALL.

Если значение lightIndex находится за пределами диапазона наборов свойств light, назначенных на устройстве, метод IDirect3DDevice9::LightEnable создает источник света, представленный структурой D3DLIGHT9 со следующими свойствами, и устанавливает для его включенного состояния значение, указанное в bEnable.

Член	По умолчанию
Тип	D3DLIGHT_DIRECTIONAL
Диффузное	(R:1, G:1, B:1, A:0)
Отражающее	(R:0, G:0, B:0, A:0)
Окружающее	(R:0, G:0, B:0, A:0)
Position	(0, 0, 0)
Направление	(0, 0, 1)
Диапазон	0
Спад	0
Затухание0	0
Затухание1	0
Затухание2	0
Тета	0
Phi	0