Metode IDirect3DDevice9::LightEnable (d3d9.h)

Artikel
08/23/2023

Mengaktifkan atau menonaktifkan sekumpulan parameter pencahayaan dalam perangkat.

Sintaks

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

Parameter

[in] Index

Jenis: DWORD

Indeks berbasis nol dari set parameter pencahayaan yang merupakan target dari metode ini.

[in] Enable

Jenis: BOOL

Nilai yang menunjukkan apakah kumpulan parameter pencahayaan diaktifkan atau dinonaktifkan. Atur parameter ini ke TRUE untuk mengaktifkan pencahayaan dengan parameter pada indeks yang ditentukan, atau FALSE untuk menonaktifkannya.

Menampilkan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL.

Keterangan

Jika nilai untuk LightIndex berada di luar rentang kumpulan properti cahaya yang ditetapkan dalam perangkat, metode IDirect3DDevice9::LightEnable membuat sumber cahaya yang diwakili oleh struktur D3DLIGHT9 dengan properti berikut dan mengatur status diaktifkan ke nilai yang ditentukan dalam bEnable.

Anggota	Default
Jenis	D3DLIGHT_DIRECTIONAL
Diffuse	(R:1, G:1, B:1, A:0)
Spekular	(R:0, G:0, B:0, A:0)
Ambient	(R:0, G:0, B:0, A:0)
Position	(0, 0, 0)
Petunjuk	(0, 0, 1)
Rentang	0
Falloff	0
Redaman0	0
Redaman1	0
Redaman2	0
Theta	0
Phi	0