To Next Page

To Previous Page

glReadBuffer

Chapter 16

378

glReadBuffer

glReadBuffer: select a color buffer source for pixels.

C Speciﬁcation

void glReadBuffer(

GLenum mode)

Parameters

mode Speciﬁes a color buffer. Accepted values are GL_FRONT_LEFT,

GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT,

GL_FRONT, GL_BACK, GL_LEFT, GL_RIGHT, and GL_AUXi, where i

is between 0 and GL_AUX_BUFFERS - 1.

Description

glReadBuffer speciﬁes a color buffer as the source for subsequent glReadPixels,

glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D,

glCopyTexSubImage2D, and glCopyPixels commands. mode accepts one of twelve or

more predeﬁned values. (GL_AUX0 through GL_AUX3 are always deﬁned.) In a fully

conﬁgured system, GL_FRONT, GL_LEFT, and GL_FRONT_LEFT all name the front

left buffer, GL_FRONT_RIGHT and GL_RIGHT name the front right buffer, and

GL_BACK_LEFT and GL_BACK name the back left buffer.

Non-stereo double-buffered conﬁgurations have only a front left and a back left buffer.

Single-buffered conﬁgurations have a front left and a front right buffer if stereo, and

only a front left buffer if non-stereo. It is an error to specify a nonexistent buffer to

glReadBuffer.

mode is initially GL_FRONT in single-buffered conﬁgurations, and GL_BACK in

double-buffered conﬁgurations.

Errors

• GL_INVALID_ENUM is generated if mode is not one of the twelve (or more)

accepted values.

• GL_INVALID_OPERATION is generated if mode speciﬁes a buffer that does not

exist.

• GL_INVALID_OPERATION is generated if glReadBuffer is executed between the

execution of glBegin and the corresponding execution of glEnd.

Associated Gets

glGet with argument GL_READ_BUFFER

HP b2600 Reference Guide

Other manuals for HP b2600