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 |