共用方式為


IDirect3DDevice9::GetClipPlane 方法 (d3d9.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
標頭 d3d9.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane