Select a color buffer source for pixels.
C Specification |
 |
void glReadBuffer(GLenum mode)
|
Parameters |
 |
- mode
Specifies a color buffer. Accepted values are GL_FRONT_LEFT,
GL_BACK_LEFT, GL_FRONT, and GL_BACK.
Description |
 |
glReadBuffer specifies a color buffer as the source for subsequent
glCopyPixels and
glReadPixels commands. The mode
argument can be one of four predefined values. In a fully configured system,
GL_FRONT and GL_FRONT_LEFT name the front left buffer, and
GL_BACK_LEFT and GL_BACK name the back left buffer.
Non-stereo double-buffered configurations have only a front left and a back
left buffer. Single-buffered configurations have a front left and a front
right buffer if stereo, and only a front left buffer if the output device does
not support stereo. It is an error to specify a nonexistent buffer to
glReadBuffer.
Defaults |
 |
By default, mode is GL_FRONT in single-buffered configurations,
and GL_BACK in double-buffered configurations.
Notes |
 |
Stereo is not supported in the initial release of IVL.
Errors |
 |
GL_INVALID_ENUM is generated if mode is not one of the accepted
values.
GL_INVALID_OPERATION is generated if mode specifies a buffer
that does not exist.
Associated Gets |
 |
glGet (GL_READ_BUFFER)
See Also |
 |
glCopyPixels,
glDrawBuffer,
glReadPixels.