glDepthRange 函数

glDepthRange 函数指定 z 值从规范化设备坐标到窗口坐标的映射。

语法

void WINAPI glDepthRange(
   GLclampd zNear,
   GLclampd zFar
);

参数

zNear

近剪裁平面到窗口坐标的映射。 默认值为零。

zFar

远剪平面到窗口坐标的映射。 默认值为 1。

返回值

此函数不返回值。

错误代码

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

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

备注

按 w 进行剪裁和除法后， z 坐标的范围从 0.0 到 1.0，对应于近距和远距剪裁平面。 glDepthRange 函数指定此范围内规范化 z 坐标到窗口 z 坐标的线性映射。 无论实际深度缓冲区实现如何，窗口坐标深度值都被视为从 0.0 到 1.0 (，就像颜色分量) 一样。 因此， glDepthRange 接受的值在接受之前都固定到此范围。

默认映射 (0，1) 将近平面映射到 0，远平面映射到 1。 通过此映射，可以充分利用深度缓冲区范围。

zNear 不必小于 zFar。 可以接受反向映射，例如 (1，0) 。

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

带参数GL_DEPTH_RANGE的 glGet

要求

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

另请参阅

glBegin

glDepthFunc

glEnd

glGet

glViewport