IDirect3DDevice9::GetClipStatus 方法 (d3d9.h)

检索剪辑状态。

语法

HRESULT GetClipStatus(
  [out] D3DCLIPSTATUS9 *pClipStatus
);

参数

[out] pClipStatus

类型: D3DCLIPSTATUS9*

指向描述剪辑状态 的D3DCLIPSTATUS9 结构的指针。

返回值

类型: HRESULT

如果该方法成功,则返回值D3D_OK。

如果参数无效,则返回D3DERR_INVALIDCALL。

注解

IDirect3DDevice9::P rocessVertices、IDirect3DDevice9::DrawPrimitive 或其他绘图函数) (顶点处理期间启用剪裁时,Direct3D 将计算每个顶点的剪辑代码。 剪辑代码是D3DCS_位的组合。 当顶点位于特定剪裁平面之外时,在剪裁代码中设置相应的位。 Direct3D 使用具有 ClipUnion 和 ClipIntersection 成员 的 D3DCLIPSTATUS9 来维护剪辑状态。 ClipUnion 是所有顶点剪辑代码的按位“OR”,ClipIntersection 是所有顶点剪辑代码的按位“AND”。 ClipUnion 的初始值为零,ClipIntersection 的初始值为0xFFFFFFFF。 当D3DRS_CLIPPING设置为 FALSE 时,ClipUnion 和 ClipIntersection 设置为零。 Direct3D 在绘图调用期间更新剪辑状态。 若要计算特定对象的剪辑状态,请将 ClipUnion 和 ClipIntersection 设置为其初始值并继续绘制。

IDirect3DDevice9::D rawRectPatchIDirect3DDevice9::D rawTriPatch 不会更新剪辑状态,因为它们没有软件仿真。

在软件顶点处理期间使用剪辑状态。 因此,纯硬件处理设备或非纯硬件处理设备不支持此方法。 有关纯设备的详细信息,请参阅 D3DCREATE

要求

要求
目标平台 Windows
标头 d3d9.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DDevice9

IDirect3DDevice9::SetClipStatus