IDirect3DDevice9：：GetClipPlane 方法 (d3d9helper.h)

  • 發行項

擷取裝置使用者定義裁剪平面的係數。

語法

HRESULT GetClipPlane(
  [in]  DWORD Index,
  [out] float *pPlane
);

參數

[in] Index

類型： DWORD

擷取平面方程式係數之裁剪平面的索引。

[out] pPlane

類型： float*

值的四個專案陣列指標，代表一般平面方程式形式的裁剪平面係數。 請參閱＜備註＞。

傳回值

類型： HRESULT

如果方法成功，傳回值會D3D_OK。 如果方法失敗，傳回值會D3DERR_INVALIDCALL。 此錯誤表示 Index 中的值超過裝置所支援的最大裁剪平面索引，或 pPlane 上的陣列不夠大，無法包含四個浮點值。

備註

這個方法不會傳回使用 D3DCREATE_PUREDEVICE建立之裝置的裝置狀態。 如果您想要使用此方法，您必須使用 D3DCREATE中的其他任何值來建立裝置。

這個方法所報告的係數會採用一般平面方程式的形式。 如果 pPlane 陣列中的值以出現在陣列中的順序標示為 A、B、C 和 D，它們就會放入一般平面方程式中，讓 Ax + By + Cz + Dw = 0。 如果 Ax + By + Cz + Dw > = 0，則具有同質座標的點 (x、y、z、w) 會顯示在平面的半形。 裁剪平面上或後方的點會從場景裁剪。

此方法所使用的平面方程式存在於世界空間中，而且是由先前呼叫 IDirect3DDevice9：：SetClipPlane 方法所設定。

需求

   
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9

IDirect3DDevice9：：SetClipPlane