IDirect3DDevice9::LightEnable

  • [アーティクル]

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

HRESULT 
LightEnable(
  DWORD LightIndex,
  BOOL bEnable
);

パラメータ

  • LightIndex
    このメソッドの対象となるライティング パラメーター セットのゼロから始まるインデックス
  • bEnable
    ライティング パラメーター セットを有効または無効のどちらにするかを示す値です。指定されたインデックスでパラメーターを使用したライティングを有効にするには、このパラメーターを TRUE に設定し、無効にするには、FALSE に設定します。

戻り値

メソッドが成功した場合は、D3D_OK を返します。失敗した場合は、D3DERR_INVALIDCALL を返します。

解説　

LightIndex の値が、デバイス内で割り当てられているライティング プロパティのセットの範囲外である場合、IDirect3DDevice9::LightEnable メソッドによって、次に示すプロパティの D3DLIGHT9 構造体により表わされる光源が作成され、有効なステートが bEnable で指定されている値に設定されます。

メンバー デフォルト
型 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

要件

ヘッダー: D3D9.h 宣言

ライブラリ: D3D9.lib 内容

関連項目

IDirect3DDevice9::GetLight, IDirect3DDevice9::GetLightEnable, IDirect3DDevice9::SetLight