Share via

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

  • [アーティクル]

クリップの状態を設定します。

構文

HRESULT SetClipStatus(
  [in] const D3DCLIPSTATUS9 *pClipStatus
);

パラメーター

[in] pClipStatus

型: const D3DCLIPSTATUS9*

設定するクリップの状態設定を記述する D3DCLIPSTATUS9 構造体へのポインター。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 いずれかの引数が無効な場合、戻り値はD3DERR_INVALIDCALL。

解説

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

頂点処理中にクリッピングが有効になっている場合 ( 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 によって更新されません。

要件

   
対象プラットフォーム Windows
ヘッダー d3d9helper.h (D3D9.h を含む)
Library D3D9.lib

関連項目

IDirect3DDevice9

IDirect3DDevice9::GetClipStatus