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 |