IDirect3DDevice9::GetClipPlane-Methode (d3d9.h)
Ruft die Koeffizienten einer benutzerdefinierten Clippingebene für das Gerät ab.
Syntax
HRESULT GetClipPlane(
[in] DWORD Index,
[out] float *pPlane
);
Parameter
[in] Index
Typ: DWORD
Index der Clippingebene, für die die Ebenengleichungskoeffizienten abgerufen werden.
[out] pPlane
Typ: float*
Zeiger auf ein Vier-Element-Array von Werten, die die Koeffizienten der Clippingebene in Form der allgemeinen Ebenengleichung darstellen. Siehe Hinweise.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, wird der Rückgabewert D3DERR_INVALIDCALL. Dieser Fehler gibt an, dass der Wert in Index den vom Gerät unterstützten maximalen Index der Clippingebene überschreitet oder dass das Array bei pPlane nicht groß genug ist, um vier Gleitkommawerte zu enthalten.
Hinweise
Diese Methode gibt keinen Gerätestatus für ein Gerät zurück, das mit D3DCREATE_PUREDEVICE erstellt wird. Wenn Sie diese Methode verwenden möchten, müssen Sie Ihr Gerät mit einem der anderen Werte in D3DCREATE erstellen."
Die von dieser Methode gemeldeten Koeffizienten haben die Form der allgemeinen Ebenengleichung. Wenn die Werte im Array bei pPlane mit A, B, C und D in der Reihenfolge bezeichnet würden, in der sie im Array angezeigt werden, würden sie in die allgemeine Ebenengleichung passen, sodass Ax + By + Cz + Dw = 0. Ein Punkt mit homogenen Koordinaten (x, y, z, w) ist im Halbraum der Ebene sichtbar, wenn Ax + By + Cz + Dw >= 0. Punkte, die auf oder hinter der Clippingebene vorhanden sind, werden von der Szene abgeschnitten.
Die von dieser Methode verwendete Ebenengleichung befindet sich im Weltraum und wird durch einen vorherigen Aufruf der IDirect3DDevice9::SetClipPlane-Methode festgelegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |