1GLREADBUFFER(3G)                 OpenGL Manual                GLREADBUFFER(3G)
2
3
4

NAME

6       glReadBuffer - select a color buffer source for pixels
7

C SPECIFICATION

9       void glReadBuffer(GLenum mode);
10

PARAMETERS

12       mode
13           Specifies a color buffer. Accepted values are GL_FRONT_LEFT,
14           GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK,
15           GL_LEFT, GL_RIGHT, and the constants GL_COLOR_ATTACHMENTi.
16

DESCRIPTION

18       glReadBuffer specifies a color buffer as the source for subsequent
19       glReadPixels(), glCopyTexImage1D(), glCopyTexImage2D(),
20       glCopyTexSubImage1D(), glCopyTexSubImage2D(), and glCopyTexSubImage3D()
21       commands.  mode accepts one of twelve or more predefined values. In a
22       fully configured system, GL_FRONT, GL_LEFT, and GL_FRONT_LEFT all name
23       the front left buffer, GL_FRONT_RIGHT and GL_RIGHT name the front right
24       buffer, and GL_BACK_LEFT and GL_BACK name the back left buffer. Further
25       more, the constants GL_COLOR_ATTACHMENTi may be used to indicate the
26       ith color attachment where i ranges from zero to the value of
27       GL_MAX_COLOR_ATTACHMENTS minus one.
28
29       Nonstereo double-buffered configurations have only a front left and a
30       back left buffer. Single-buffered configurations have a front left and
31       a front right buffer if stereo, and only a front left buffer if
32       nonstereo. It is an error to specify a nonexistent buffer to
33       glReadBuffer.
34
35       mode is initially GL_FRONT in single-buffered configurations and
36       GL_BACK in double-buffered configurations.
37

ERRORS

39       GL_INVALID_ENUM is generated if mode is not one of the twelve (or more)
40       accepted values.
41
42       GL_INVALID_OPERATION is generated if mode specifies a buffer that does
43       not exist.
44

ASSOCIATED GETS

46       glGet() with argument GL_READ_BUFFER
47

SEE ALSO

49       glCopyTexImage1D(), glCopyTexImage2D(), glCopyTexSubImage1D(),
50       glCopyTexSubImage2D(), glCopyTexSubImage3D(), glDrawBuffer(),
51       glReadPixels()
52

54       Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2011 Khronos
55       Group. This document is licensed under the SGI Free Software B License.
56       For details, see http://oss.sgi.com/projects/FreeB/.
57

AUTHORS

59       opengl.org
60
61
62
63opengl.org                        06/10/2014                  GLREADBUFFER(3G)
Impressum