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

Artigo
03/05/2024

Habilita ou desabilita um conjunto de parâmetros de iluminação em um dispositivo.

Sintaxe

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

Parâmetros

[in] Index

Tipo: DWORD

Índice baseado em zero do conjunto de parâmetros de iluminação que são o destino desse método.

[in] Enable

Tipo: BOOL

Valor que indica se o conjunto de parâmetros de iluminação está sendo habilitado ou desabilitado. Defina esse parâmetro como TRUE para habilitar a iluminação com os parâmetros no índice especificado ou FALSE para desabilitá-lo.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL.

Comentários

Se um valor para LightIndex estiver fora do intervalo dos conjuntos de propriedades de luz atribuídos no dispositivo, o método IDirect3DDevice9::LightEnable criará uma fonte de luz representada por uma estrutura D3DLIGHT9 com as propriedades a seguir e definirá seu estado habilitado como o valor especificado em bEnable.

Membro	Padrão
Digite	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)
Posição	(0, 0, 0)
Direção	(0, 0, 1)
Intervalo	0
Queda	0
Atenuação0	0
Atenuação1	0
Atenuação2	0
Theta	0
Phi	0