glViewport 函数

glViewport 函数设置视区。

语法

void WINAPI glViewport(
   GLint   x,
   GLint   y,
   GLsizei width,
   GLsizei height
);

参数

x

视区矩形的左下角（以像素为单位）。 默认值为 (0,0)。

y

视区矩形的左下角（以像素为单位）。 默认值为 (0,0)。

width

视区宽度。 当 OpenGL 上下文首次附加到窗口时， 宽度 和 高度 将设置为该窗口的尺寸。

height

视区的高度。 当 OpenGL 上下文首次附加到窗口时， 宽度 和 高度 将设置为该窗口的尺寸。

返回值

此函数不返回值。

错误代码

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

名称	含义
GL_INVALID_VALUE	宽度或高度为负值。
GL_INVALID_OPERATION	在对 glBegin 的调用和对 glEnd 的相应调用之间调用了函数。

备注

glViewport 函数指定 x 和 y 从规范化设备坐标到窗口坐标的仿射转换。 让 (x_nd 、 y_nd ) 规范化设备坐标。 然后计算 (x_w 、 y_w ) 的窗口坐标，如下所示：

视区宽度和高度以无提示方式固定到依赖于实现的范围。 通过调用带参数的 glGet 来查询此范围GL_MAX_VIEWPORT_DIMS。

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

带参数GL_VIEWPORT的 glGet

带参数GL_MAX_VIEWPORT_DIMS的 glGet

要求

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

另请参阅

glBegin

glDepthRange