IDirect3DDevice9::LightEnable-Methode (d3d9helper.h)

Artikel
02/28/2024

Aktiviert oder deaktiviert eine Reihe von Beleuchtungsparametern in einem Gerät.

Syntax

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

Parameter

[in] Index

Typ: DWORD

Nullbasierter Index des Satzes von Beleuchtungsparametern, die das Ziel dieser Methode sind.

[in] Enable

Typ: BOOL

Wert, der angibt, ob der Satz von Beleuchtungsparametern aktiviert oder deaktiviert wird. Legen Sie diesen Parameter auf TRUE fest, um die Beleuchtung mit den Parametern am angegebenen Index zu aktivieren, oder auf FALSE , um ihn zu deaktivieren.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Hinweise

Wenn ein Wert für LightIndex außerhalb des Bereichs der light-Eigenschaftssätze liegt, die innerhalb des Geräts zugewiesen sind, erstellt die IDirect3DDevice9::LightEnable-Methode eine Lichtquelle, die durch eine D3DLIGHT9-Struktur mit den folgenden Eigenschaften dargestellt wird, und legt ihren aktivierten Zustand auf den in bEnable angegebenen Wert fest.

Mitglied	Standard
Typ	D3DLIGHT_DIRECTIONAL
Diffus	(R:1, G:1, B:1, A:0)
Glänzend	(R:0, G:0, B:0, A:0)
Umgebend	(R:0, G:0, B:0, A:0)
Position	(0, 0, 0)
Direction	(0, 0, 1)
Range	0
Abfall	0
Dämpfung0	0
Dämpfung1	0
Dämpfung2	0
Theta	0
Phi	0