glDrawBuffer 函数

glDrawBuffer 函数指定要绘制到哪些颜色缓冲区中。

语法

void WINAPI glDrawBuffer(
   GLenum mode
);

mode

指定要使用以下可接受的符号常量绘制到的最多四个颜色缓冲区。

值	含义
GL_NONE	不写入任何颜色缓冲区。
GL_FRONT_LEFT	仅写入左前颜色缓冲区。
GL_FRONT_RIGHT	仅写入右前颜色缓冲区。
GL_BACK_LEFT	仅写入左后的颜色缓冲区。
GL_BACK_RIGHT	仅写入右后的颜色缓冲区。
GL_FRONT	仅写入左前和右前颜色缓冲区。如果没有右前颜色缓冲区，则只写入左前色缓冲区。
GL_BACK	仅写入后左和右后颜色缓冲区。如果没有右后颜色缓冲区，则仅写入左后颜色缓冲区。
GL_LEFT	仅写入左前和左后颜色缓冲区。如果没有左后的颜色缓冲区，则只写入左前颜色缓冲区。
GL_RIGHT	仅写入右前和右后颜色缓冲区。如果没有右后的颜色缓冲区，则只写入右前的颜色缓冲区。
GL_FRONT_AND_BACK	所有正面和背面颜色缓冲区 (前左、前右、后左、后-右) 都写入。如果没有后退颜色缓冲区，则只写入左前和右前颜色缓冲区。如果没有右色缓冲区，则只写入左前和后左颜色缓冲区。如果没有右侧或背面的颜色缓冲区，则只写入左前颜色缓冲区。
GL_AUXi	仅写入辅助颜色缓冲区 i ; i 介于 0 和 GL_AUX_BUFFERS - 1 之间。 (GL_AUX_BUFFERS不是上限;使用 glGet 查询可用辅助缓冲区的数量。)

对于单缓冲上下文，默认值为GL_FRONT，对于双缓冲上下文，默认值为GL_BACK。

此函数不返回值。

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

名称	含义
GL_INVALID_ENUM	mode 不是接受的值。
GL_INVALID_OPERATION	模式指示的缓冲区不存在。
GL_INVALID_OPERATION	函数是在对 glBegin 的调用和对 glEnd 的相应调用之间调用的。

将颜色写入 framebuffer 时，它们将写入 glDrawBuffer 指定的颜色缓冲区。

如果选择了多个颜色缓冲区进行绘制，则会为每个颜色缓冲区单独计算和应用混合或逻辑操作，并可以在每个缓冲区中产生不同的结果。

单声道上下文仅包括左缓冲区，立体上下文包括左缓冲区和右缓冲区。同样，单缓冲上下文仅包括前缓冲区，双缓冲上下文包括前端缓冲区和后端缓冲区。在 OpenGL 初始化时选择上下文。

始终GL_AUX i = GL_AUX0 + i。

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

带参数GL_DRAW_BUFFER的 glGet

带参数GL_AUX_BUFFERS的 glGet

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