IDirect3DDevice9::LightEnable 方法 (d3d9helper.h)

啟用或停用裝置內的一組光源參數。

語法

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

參數

[in] Index

類型: DWORD

以零起始的光源參數集索引,這些參數是這個方法的目標。

[in] Enable

類型: BOOL

值,指出是否啟用或停用一組光源參數。 將此參數設定為 TRUE ,以啟用指定索引處參數的光源,或 將此參數設為 FALSE 以停用。

傳回值

類型: HRESULT

如果方法成功,傳回值會D3D_OK。 如果方法失敗,則可以D3DERR_INVALIDCALL傳回值。

備註

如果 LightIndex 的值超出裝置內指派的光線屬性集範圍, 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
0

規格需求

需求
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9

IDirect3DDevice9::GetLight

IDirect3DDevice9::GetLightEnable

IDirect3DDevice9::SetLight