IDirect3DDevice9::GetClipStatus メソッド (d3d9helper.h)

クリップの状態を取得します。

構文

HRESULT GetClipStatus(
  [out] D3DCLIPSTATUS9 *pClipStatus
);

パラメーター

[out] pClipStatus

種類: D3DCLIPSTATUS9*

クリップの状態を説明する D3DCLIPSTATUS9 構造体へのポインター。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。

引数が無効な場合は、D3DERR_INVALIDCALLが返されます。

注釈

頂点処理中にクリッピングが有効になっている場合 ( IDirect3DDevice9::P rocessVertices、 IDirect3DDevice9::D rawPrimitive、またはその他の描画関数によって)、Direct3D はすべての頂点のクリップ コードを計算します。 クリップ コードは、D3DCS_* ビットの組み合わせです。 頂点が特定のクリッピング 平面の外側にある場合、対応するビットがクリッピング コードで設定されます。 Direct3D は、ClipUnion メンバーと ClipIntersection メンバーを持つ D3DCLIPSTATUS9を使用してクリップの状態を維持します。 ClipUnion は、すべての頂点クリップ コードのビットごとの "OR" であり、ClipIntersection はすべての頂点クリップ コードのビットごとの "AND" です。 初期値は ClipUnion の場合は 0、ClipIntersection の場合は0xFFFFFFFFです。 D3DRS_CLIPPINGが FALSE に設定されている場合、ClipUnion と ClipIntersection は 0 に設定されます。 Direct3D は、描画呼び出し中にクリップの状態を更新します。 特定のオブジェクトのクリップの状態を計算するには、ClipUnion と ClipIntersection を初期値に設定し、描画を続行します。

クリップの状態は 、IDirect3DDevice9::D rawRectPatch および IDirect3DDevice9::D rawTriPatch によって更新されません。

クリップの状態は、ソフトウェア頂点の処理中に使用されます。 したがって、このメソッドは、純粋または非pure ハードウェア処理デバイスではサポートされていません。 純粋デバイスの詳細については、「 D3DCREATE」を参照してください。

要件

こちらもご覧ください

IDirect3DDevice9

IDirect3DDevice9::SetClipStatus