デバイス内の照明パラメーターのセットを有効または無効にします。
構文
HRESULT LightEnable(
[in] DWORD Index,
[in] BOOL Enable
);
パラメーター
[in] Index
種類: DWORD
このメソッドのターゲットである照明パラメーターのセットの 0 から始まるインデックス。
[in] Enable
種類: BOOL
照明パラメーターのセットが有効または無効になっているかどうかを示す値。 このパラメーターを TRUE に設定すると、指定したインデックスでパラメーターを使用した照明が有効になります。無効にするには FALSE を 設定します。
戻り値
種類: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合は、戻り値をD3DERR_INVALIDCALLできます。
解説
LightIndex の値がデバイス内で割り当てられたライト プロパティ セットの範囲外にある場合、 IDirect3DDevice9::LightEnable メソッドは、次のプロパティを持つ D3DLIGHT9 構造体で表される光源を作成し、その有効な状態を bEnable で指定された値に設定します。
| メンバー | Default |
|---|---|
| Type | 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) |
| 位置 | (0, 0, 0) |
| Direction | (0, 0, 1) |
| Range | 0 |
| フォールオフ | 0 |
| 減衰0 | 0 |
| 減衰1 | 0 |
| 減衰2 | 0 |
| シータ | 0 |
| ファイ | 0 |
要件
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9.h (D3D9.h を含む) |
| Library | D3D9.lib |