Método IDirect3DDevice9::LightEnable (d3d9.h)

Artículo
08/23/2023

Habilita o deshabilita un conjunto de parámetros de iluminación dentro de un dispositivo.

Sintaxis

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

Parámetros

[in] Index

Tipo: DWORD

Índice de base cero del conjunto de parámetros de iluminación que son el destino de este método.

[in] Enable

Tipo: BOOL

Valor que indica si el conjunto de parámetros de iluminación se habilita o deshabilita. Establezca este parámetro en TRUE para habilitar la iluminación con los parámetros en el índice especificado o FALSE para deshabilitarlo.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL.

Comentarios

Si un valor de LightIndex está fuera del intervalo de los conjuntos de propiedades de luz asignados dentro del dispositivo, el método IDirect3DDevice9::LightEnable crea una fuente de luz representada por una estructura D3DLIGHT9 con las siguientes propiedades y establece su estado habilitado en el valor especificado en bEnable.

Miembro	Valor predeterminado
Tipo	D3DLIGHT_DIRECTIONAL
Difusa	(R:1, G:1, B:1, A:0)
Especular	(R:0, G:0, B:0, A:0)
Ambiente	(R:0, G:0, B:0, A:0)
Posición	(0, 0, 0)
Dirección	(0, 0, 1)
Intervalo	0
Difuminación	0
Atenuación0	0
Atenuación1	0
Atenuación2	0
Theta	0
Phi	0