Metodo IDirect3DDevice9::LightEnable (d3d9helper.h)

Articolo
02/28/2024

Abilita o disabilita un set di parametri di illuminazione all'interno di un dispositivo.

Sintassi

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

Parametri

[in] Index

Tipo: DWORD

Indice in base zero del set di parametri di illuminazione destinati a questo metodo.

[in] Enable

Tipo: BOOL

Valore che indica se il set di parametri di illuminazione viene abilitato o disabilitato. Impostare questo parametro su TRUE per abilitare l'illuminazione con i parametri in corrispondenza dell'indice specificato o FALSE per disabilitarlo.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.

Commenti

Se un valore per LightIndex non è compreso nell'intervallo dei set di proprietà di luce assegnati all'interno del dispositivo, il metodo IDirect3DDevice9::LightEnable crea una fonte di luce rappresentata da una struttura D3DLIGHT9 con le proprietà seguenti e imposta lo stato abilitato sul valore specificato in bEnable.

Membro	Default
Tipo	D3DLIGHT_DIRECTIONAL
Diffusa	(R:1, G:1, B:1, A:0)
Speculare	(R:0, G:0, B:0, A:0)
Di ambiente	(R:0, G:0, B:0, A:0)
Position	(0, 0, 0)
Direzione	(0, 0, 1)
Intervallo	0
Falloff	0
Attenuazione0	0
Attenuazione1	0
Attenuazione2	0
Theta	0
Phi	0