glPolygonOffset 函数

  • 项目

glPolygonOffset 函数设置 OpenGL 用于计算深度值的规模和单位。

语法

void WINAPI glPolygonOffset(
   GLfloat factor,
   GLfloat units
);

参数

factor

指定用于为每个多边形创建可变深度偏移量的比例因子。 初始值为零。

units

指定一个值，该值乘以特定于实现的值，以创建恒定的深度偏移量。 初始值为 0。

返回值

此函数不返回值。

错误代码

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

名称 含义
GL_INVALID_OPERATION
 在对 glBegin 的调用和对 glEnd 的相应调用之间调用了函数。

备注

启用GL_POLYGON_OFFSET后，每个片段的深度值将在从相应顶点的深度值内插后偏移。 偏移量的值是 因子 * ？z + r *单位，其中？z 是相对于多边形屏幕面积的深度变化的度量值，r 是保证为给定实现生成可解析偏移量的最小值。 在执行深度测试之前和值写入深度缓冲区之前添加偏移量。

glPolygonOffset 函数可用于呈现隐藏线图像、将贴花应用于表面以及呈现具有突出显示边缘的实体。

glPolygonOffset 函数对放置在反馈缓冲区中的深度坐标没有影响。 它也不会对选择产生影响。

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

  • 带参数GL_POLYGON_OFFSET_FACTOR的 glGet
  • 带参数GL_POLYGON_OFFSET_UNITS的 glGet
  • glIsEnabled with argument GL_POLYGON_OFFSET_FILL
  • glIsEnabled with argument GL_POLYGON_OFFSET_LINE
  • glIsEnabled with argument GL_POLYGON_OFFSET_POINT

注意

glPolygonOffset 函数仅在 OpenGl 版本 1.1 或更高版本中可用。

要求

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

另请参阅

glDepthFunc

glDisable

glEnable

glGet

glIsEnabled

glLineWidth

glStencilOp

glTexEnv