GLES3.0中文API-glDrawBuffers

名称

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来查询。

注意

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