IDirect3DDevice9::LightEnable-Methode (d3d9.h)
Aktiviert oder deaktiviert eine Reihe von Beleuchtungsparametern innerhalb eines Geräts.
Syntax
HRESULT LightEnable(
[in] DWORD Index,
[in] BOOL Enable
);
Parameter
[in] Index
Typ: DWORD
Nullbasierter Index des Satz 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 sich ein Wert für LightIndex außerhalb des Bereichs der innerhalb des Geräts zugewiesenen light-Eigenschaftssätze befindet, 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) |
| Bereich | 0 |
| Abfall | 0 |
| Dämpfung0 | 0 |
| Dämpfung1 | 0 |
| Dämpfung2 | 0 |
| Theta | 0 |
| Phi | 0 |
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |