IDirect3DDevice9::LightEnable-Methode (d3d9helper.h)
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 |
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9helper.h (include D3D9.h) |
| Bibliothek | D3D9.lib |