1GLREADBUFFER(3G)                [FIXME: manual]               GLREADBUFFER(3G)
2
3
4

NAME

6       glReadBuffer, glNamedFramebufferReadBuffer - select a color buffer
7       source for pixels
8

C SPECIFICATION

10       void glReadBuffer(GLenum mode);
11
12       void glNamedFramebufferReadBuffer(GLuint framebuffer, GLenum mode);
13

PARAMETERS

15       framebuffer
16           Specifies the name of the framebuffer object for
17           glNamedFramebufferReadBuffer function.
18
19       mode
20           Specifies a color buffer. Accepted values are GL_FRONT_LEFT,
21           GL_FRONT_RIGHT, GL_BACK_LEFT, GL_BACK_RIGHT, GL_FRONT, GL_BACK,
22           GL_LEFT, GL_RIGHT, and the constants GL_COLOR_ATTACHMENTi.
23

DESCRIPTION

25       glReadBuffer specifies a color buffer as the source for subsequent
26       glReadPixels(), glCopyTexImage1D(), glCopyTexImage2D(),
27       glCopyTexSubImage1D(), glCopyTexSubImage2D(), and glCopyTexSubImage3D()
28       commands.  mode accepts one of twelve or more predefined values. In a
29       fully configured system, GL_FRONT, GL_LEFT, and GL_FRONT_LEFT all name
30       the front left buffer, GL_FRONT_RIGHT and GL_RIGHT name the front right
31       buffer, and GL_BACK_LEFT and GL_BACK name the back left buffer. Further
32       more, the constants GL_COLOR_ATTACHMENTi may be used to indicate the
33       ith color attachment where i ranges from zero to the value of
34       GL_MAX_COLOR_ATTACHMENTS minus one.
35
36       Nonstereo double-buffered configurations have only a front left and a
37       back left buffer. Single-buffered configurations have a front left and
38       a front right buffer if stereo, and only a front left buffer if
39       nonstereo. It is an error to specify a nonexistent buffer to
40       glReadBuffer.
41
42       mode is initially GL_FRONT in single-buffered configurations and
43       GL_BACK in double-buffered configurations.
44
45       For glReadBuffer, the target framebuffer object is that bound to
46       GL_READ_FRAMEBUFFER. For glNamedFramebufferReadBuffer, framebuffer must
47       either be zero or the name of the target framebuffer object. If
48       framebuffer is zero, then the default read framebuffer is affected.
49

ERRORS

51       GL_INVALID_ENUM is generated if mode is not one of the twelve (or more)
52       accepted values.
53
54       GL_INVALID_OPERATION is generated if mode specifies a buffer that does
55       not exist.
56
57       GL_INVALID_OPERATION is generated by glNamedFramebufferReadBuffer if
58       framebuffer is not zero or the name of an existing framebuffer object.
59

ASSOCIATED GETS

61       glGet() with argument GL_READ_BUFFER
62

VERSION SUPPORT

64       ┌─────────────────────────────┬───────────────────────────────────────────────────────────────────────┐
65       │                             │                OpenGL Version                                         │
66       ├─────────────────────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
67       │Function                     │ 2.0 │ 2.1 │ 3.0 │ 3.1 │ 3.2 │ 3.3 │ 4.0 │ 4.1 │ 4.2 │ 4.3 │ 4.4 │ 4.5 │
68       │/                            │     │     │     │     │     │     │     │     │     │     │     │     │
69       │Feature                      │     │     │     │     │     │     │     │     │     │     │     │     │
70       │Name                         │     │     │     │     │     │     │     │     │     │     │     │     │
71       ├─────────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
72       │glNamedFramebufferReadBuffer │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  ✔  │
73       ├─────────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
74       │glReadBuffer                 │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │  ✔  │
75       └─────────────────────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘
76

SEE ALSO

78       glCopyTexImage1D(), glCopyTexImage2D(), glCopyTexSubImage1D(),
79       glCopyTexSubImage2D(), glCopyTexSubImage3D(), glDrawBuffer(),
80       glReadPixels()
81

83       Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2011-2014
84       Khronos Group. This document is licensed under the SGI Free Software B
85       License. For details, see http://oss.sgi.com/projects/FreeB/.
86

88       Copyright © 1991-2006 Silicon Graphics, Inc.
89       Copyright © 2011-2014 Khronos Group
90
91
92
93[FIXME: source]                   03/06/2019                  GLREADBUFFER(3G)
Impressum