glReadBuffer 函数

  • 项目

glReadBuffer 函数选择像素的颜色缓冲区源。

语法

void WINAPI glReadBuffer(
   GLenum mode
);

参数

mode

颜色缓冲区。 接受的值为 GL_FRONT_LEFT、GL_FRONT_RIGHT、GL_BACK_LEFT、GL_BACK_RIGHT、GL_FRONT、GL_BACK、GL_LEFT、GL_RIGHT 和 GL_AUX i，其中 i 介于 0 到 GL_AUX_BUFFERS 1 之间。

返回值

此函数不返回值。

错误代码

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

名称 含义
GL_INVALID_ENUM
 模式 不是十二个 (或更多) 接受值之一。
GL_INVALID_OPERATION
 mode 指定了不存在的缓冲区。
GL_INVALID_OPERATION
 函数是在 对 glBegin 的调用和对 glEnd 的相应调用之间调用的。

备注

glReadBuffer 函数指定颜色缓冲区作为后续 glReadPixels 和 glCopyPixels 命令的源。 mode 参数接受十二个或更多个预定义值中的一个。 始终定义通过GL_AUX3 (GL_AUX0。) 在完全配置的系统中，GL_FRONT、GL_LEFT和GL_FRONT_LEFT所有名称都命名左前缓冲区，GL_FRONT_RIGHT和GL_RIGHT为右前缓冲区命名，GL_BACK_LEFT和GL_BACK为左后缓冲区命名。

非stereo 双缓冲配置只有一个左前缓冲区和一个左后缓冲区。 单缓冲配置有一个左前缓冲区和一个前右缓冲区（如果是立体声），如果不是，则只有一个左前缓冲区。 将不存在的缓冲区指定为 glReadBuffer 是错误的。

默认情况下， 模式 在单缓冲配置中GL_FRONT，在双缓冲配置中GL_BACK。

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

带参数GL_READ_BUFFER的 glGet

要求

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

另请参阅

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels