IDirect3DDevice9::LightEnable, méthode (d3d9.h)

Article
08/23/2023

Active ou désactive un ensemble de paramètres d’éclairage au sein d’un appareil.

Syntaxe

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

Paramètres

[in] Index

Type : DWORD

Index de base zéro de l’ensemble de paramètres d’éclairage qui sont la cible de cette méthode.

[in] Enable

Type : BOOL

Valeur qui indique si l’ensemble de paramètres d’éclairage est activé ou désactivé. Définissez ce paramètre sur TRUE pour activer l’éclairage avec les paramètres à l’index spécifié, ou FALSE pour le désactiver.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL.

Notes

Si une valeur pour LightIndex est en dehors de la plage des jeux de propriétés light attribués dans l’appareil, la méthode IDirect3DDevice9::LightEnable crée une source de lumière représentée par une structure D3DLIGHT9 avec les propriétés suivantes et définit son état activé sur la valeur spécifiée dans bEnable.

Membre	Default
Type	D3DLIGHT_DIRECTIONAL
Diffus	(R:1, G:1, B:1, A:0)
Spéculaire	(R:0, G:0, B:0, A:0)
Ambiant	(R:0, G:0, B:0, A:0)
Position	(0, 0, 0)
Sens	(0, 0, 1)
Plage	0
Diminution	0
Atténuation0	0
Atténuation1	0
Atténuation2	0
Theta	0
Phi	0