glClipPlane 函数

glClipPlane 函数指定对其剪裁所有几何图形的平面。

语法

void WINAPI glClipPlane(
         GLenum   plane,
   const GLdouble *equation
);

parameters

飞机

正在定位的剪切平面。 接受形式 GL_CLIP_PLANEi 的符号名称，其中 i 是介于 0 到 GL_MAX_CLIP_PLANES - 1 之间的整数。

equation

包含四个双精度浮点值的数组的地址。 这些值被解释为平面公式。

返回值

此函数不返回值。

错误代码

glGetError 函数可以检索以下错误代码。

名称	含义
GL_INVALID_ENUM	plane 不是接受的值。
GL_INVALID_OPERATION	在对 glBegin 的调用和对 glEnd 的相应调用之间调用了函数。

备注

始终根据 x、 y 和 z 中六平面视面的边界剪裁几何图形。 glClipPlane 函数允许指定其他平面，不一定垂直于所有几何图形的 x 轴、y 轴或 z 轴。 最多可以指定GL_MAX_CLIP_PLANES平面，其中GL_MAX_CLIP_PLANES在所有实现中至少为六个。 由于生成的剪裁区域是定义的半空格的交集，因此它始终是凸的。

glClipPlane 函数使用四分量平面公式指定半空间。 调用 glClipPlane 时，公式 由模型视图矩阵的反转进行转换，并存储在生成的眼睛坐标中。 对模型视图矩阵的后续更改对存储的平面公式分量没有影响。 如果存储的平面公式分量为正数或零的顶点坐标的点积，则顶点相对于该剪裁平面。 否则，它已退出。

使用 glEnable 和 glDisable 函数启用和禁用剪切平面。 使用参数 GL_CLIP_PLANEi 调用剪切平面，其中 i 是平面编号。

默认情况下，所有剪裁平面都定义为眼坐标 (0，0，0，0) ，并处于禁用状态。

GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i 始终如此。

以下函数检索 与 glClipPlane 相关的信息：

glGetClipPlane

glIsEnabled with argument GL_CLIP_PLANE i

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Gl.h
库	Opengl32.lib
DLL	Opengl32.dll

请参阅

glBegin

glDisable

glEnable

glEnd

glGetClipPlane

glIsEnabled