Méthode IDirect3DDevice9 ::LightEnable (d3d9helper.h)

Article
02/28/2024

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.

Remarques

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 lumineuse représentée par une structure de 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