IDirect3DDevice9::GetClipPlane 方法 (d3d9.h)

检索设备的用户定义剪裁平面的系数。

语法

HRESULT GetClipPlane(
  [in]  DWORD Index,
  [out] float *pPlane
);

参数

[in] Index

类型: DWORD

为其检索平面公式系数的剪裁平面的索引。

[out] pPlane

类型: float*

指向一个由四个元素构成的值数组的指针,这些值以一般平面公式的形式表示剪裁平面的系数。 请参阅“备注”。

返回值

类型: HRESULT

如果方法成功,则返回值D3D_OK。 如果 方法失败,则返回值D3DERR_INVALIDCALL。 此错误指示 Index 中的值超过了设备支持的最大剪切平面索引,或者 pPlane 处的数组不够大,无法包含四个浮点值。

注解

此方法不会返回使用 D3DCREATE_PUREDEVICE 创建的设备的设备状态。 如果要使用此方法,则必须使用 D3DCREATE 中的其他任何值创建设备。”

此方法报告的系数采用一般平面公式的形式。 如果 pPlane 数组中的值按数组中的出现顺序标记为 A、B、C 和 D,则它们将适合一般平面公式,以便 Ax + By + Cz + Dw = 0。 如果 Ax + By + Cz + Dw >= 0,则具有同质坐标 (x、y、z、w) 的点在平面的半空间中可见。 剪切平面上或后面的点将从场景中剪裁。

此方法使用的平面公式存在于世界空间中,由之前对 IDirect3DDevice9::SetClipPlane 方法的调用设置。

要求

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

另请参阅

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane