Compartilhar via


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

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

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9helper.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DDevice9

IDirect3DDevice9::GetLight

IDirect3DDevice9::GetLightEnable

IDirect3DDevice9::SetLight