Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::LightEnable

デバイス内のライティング パラメータ セットを有効または無効にする。

HRESULT LightEnable(
  DWORD LightIndex,
  BOOL bEnable
);

パラメータ

LightIndex
[in] このメソッドの対象となるライティング パラメータ セットのゼロから始まるインデックス。
bEnable
[in] ライティング パラメータ セットが有効または無効のいずれであるかを示す値。このパラメータに TRUE を設定すると、指定されたインデックスのパラメータのライトが有効になり、FALSE を設定すると無効になる。

戻り値

成功した場合は、D3D_OK を返す。

失敗した場合は、D3DERR_INVALIDCALL を返す。

注意

デバイス内で割り当てられているライト プロパティ セットの範囲外の値を LightIndex に設定すると、LightEnable メソッドは D3DLIGHT8 構造体で表される光源を以下のプロパティで作成し、有効なステートを bEnable で指定された値に設定する。

メンバ デフォルト
Type D3DLIGHT_DIRECTIONAL
Diffuse (R:1, G:1, B:1, A:0)
Specular (R:0, G:0, B:0, A:0)
Ambient (R:0, G:0, B:0, A:0)
Position (0, 0, 0)
Direction (0, 0, 1)
Range 0
Falloff 0
Attenuation0 0
Attenuation1 0
Attenuation2 0
Theta 0
Phi 0

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。

参照

IDirect3DDevice8::GetLightIDirect3DDevice8::GetLightEnableIDirect3DDevice8::SetLight