名称

glDrawBuffers — 指定要绘制到的颜色缓冲区的列表

C 规范

void glDrawBuffers( GLsizei n,
const GLenum *bufs);

参数

n
指定缓冲区中的缓冲区数。

bufs
指向符号常量数组，这些符号常量指定将片段颜色或数据值写入其中的缓冲区。

描述

glDrawBuffers定义了一个缓冲区数组，片段着色器数据的输出将写入其中。如果片段着色器将一个值写入一个或多个用户定义的输出变量，则每个变量的值将被写入缓冲区中bufs中指定的位置，该位置与分配给该用户定义的输出的位置相对应。用于分配给大于或等于n的位置的用户定义输出的绘图缓冲区被隐式设置为GL_NONE，并且写入该输出的任何数据都将被丢弃。

bufs中包含的符号常量必须为下列之一，这取决于GL是否绑定到默认帧缓冲区：

GL_NONE
片段着色器的输出值未写入任何颜色缓冲区。

GL_BACK
片段着色器的输出值被写入背景色缓冲区。

GL_COLOR_ATTACHMENT n
片段着色器的输出值将写入当前帧缓冲区的第n个颜色附件中。 n的范围可以从零到GL_MAX_COLOR_ATTACHMENTS的值。

除GL_NONE以外，前面的符号常量在bufs中的出现不得超过一次。支持的最大绘制缓冲区数量取决于实现，可以通过使用参数GL_MAX_DRAW_BUFFERS调用glGet来查询。

注意

如果片段着色器未写入用户定义的输出变量，则在着色器执行后片段颜色的值未定义。对于在这种情况下生成的每个片段，可以将不同的值写入bufs指定的每个缓冲区中。

错误

如果bufs中的值之一不是可接受的值，则生成GL_INVALID_ENUM。

如果GL绑定到默认帧缓冲区并且n不为1，或者bufs中的值是GL_COLOR_ATTACHMENTn令牌之一，则生成GL_INVALID_OPERATION。

如果GL绑定到帧缓冲区对象，并且bufs中列出的第i个缓冲区不是GL_NONE或GL_COLOR_ATTACHMENTSi，则生成GL_INVALID_OPERATION。

如果n小于0或大于GL_MAX_DRAW_BUFFERS，则生成GL_INVALID_VALUE。

相关gets

glGet参数GL_MAX_DRAW_BUFFERS

使用参数GL_DRAW_BUFFERi的glGet，其中i表示要查询其值的绘制缓冲区的编号。

API支持版本

另见

glReadBuffer

版权

https://www.khronos.org/registry/OpenGL-Refpages/es3/html/glDrawBuffers.xhtml
Copyright © 2003-2005 3Dlabs Inc. Ltd. Copyright © 2010-2015 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.