glReadBuffer 函数

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

语法

void WINAPI glReadBuffer(
   GLenum 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
mode 不是接受的 12 个(或更多)值之一。
GL_INVALID_OPERATION
模式 指定了不存在的缓冲区。
GL_INVALID_OPERATION
函数是在 对 glBegin 的调用与 glEnd 的相应调用之间调用的。

注解

glReadBuffer 函数将颜色缓冲区指定为后续 glReadPixelsglCopyPixels 命令的源。 模式参数接受十二个或多个预定义值之一。 (始终定义通过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 相关的信息:

带参数的 glGet GL_READ_BUFFER

要求

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

另请参阅

glBegin

glCopyPixels

glDrawBuffer

glEnd

glReadPixels