Freigeben über


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

Weitere Informationen

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane