IDirect3DDevice9：：GetClipStatus 方法 (d3d9.h)

项目
02/28/2024

检索剪辑状态。

语法

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 的初始值为零，ClipIntersection 的初始值为0xFFFFFFFF。当D3DRS_CLIPPING设置为 FALSE 时，ClipUnion 和 ClipIntersection 设置为零。 Direct3D 在绘图调用期间更新剪辑状态。若要计算特定对象的剪辑状态，请将 ClipUnion 和 ClipIntersection 设置为其初始值并继续绘制。

IDirect3DDevice9：:D rawRectPatch 和 IDirect3DDevice9：:D rawTriPatch 不会更新剪辑状态，因为它们没有软件仿真。

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