IDirect3DDevice9::GetClipPlane メソッド (d3d9.h)

デバイスのユーザー定義クリッピング プレーンの係数を取得します。

構文

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

パラメーター

[in] Index

種類: DWORD

平面方程式係数が取得されるクリッピング平面のインデックス。

[out] pPlane

型: float*

クリッピング平面の係数を一般的な平面方程式の形式で表す値の 4 要素配列へのポインター。 「解説」を参照してください。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値はD3DERR_INVALIDCALL。 このエラーは、Index の値がデバイスでサポートされている最大クリッピング プレーン インデックスを超えているか、pPlane の配列が 4 つの浮動小数点値を格納するのに十分な大きさではないことを示します。

注釈

このメソッドは、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 を含む)
Library	D3D9.lib

こちらもご覧ください

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane