specs: Sync framebuffer_flip_y text with GL registry
[mesa.git] / docs / specs / MESA_framebuffer_flip_y.txt
1 Name
2
3 MESA_framebuffer_flip_y
4
5 Name Strings
6
7 GL_MESA_framebuffer_flip_y
8
9 Contact
10
11 Fritz Koenig <frkoenig@google.com>
12
13 Contributors
14
15 Fritz Koenig, Google
16 Kristian Høgsberg, Google
17 Chad Versace, Google
18 Heinrich Fink, DAQRI
19
20 Status
21
22 Proposal
23
24 Version
25
26 Version 2, June 4, 2019
27
28 Number
29
30 OpenGL Extension #540
31 OpenGL ES Extension #302
32
33 Dependencies
34
35 OpenGL ES 3.1 or OpenGL 4.3 is required, for FramebufferParameteri.
36
37 Overview
38
39 This extension defines a new framebuffer parameter,
40 GL_FRAMEBUFFER_FLIP_Y_MESA, that changes the behavior of the reads and
41 writes to the framebuffer attachment points. When GL_FRAMEBUFFER_FLIP_Y_MESA
42 is GL_TRUE, render commands and pixel transfer operations access the
43 backing store of each attachment point with an y-inverted coordinate
44 system. This y-inversion is relative to the coordinate system set when
45 GL_FRAMEBUFFER_FLIP_Y_MESA is GL_FALSE.
46
47 Access through TexSubImage2D and similar calls will notice the effect of
48 the flip when they are not attached to framebuffer objects because
49 GL_FRAMEBUFFER_FLIP_Y_MESA is associated with the framebuffer object and
50 not the attachment points.
51
52 IP Status
53
54 None
55
56 Issues
57
58 None
59
60 New Procedures and Functions
61
62 None
63
64 New Types
65
66 None
67
68 New Tokens
69
70 Accepted by the <pname> argument of FramebufferParameteri and
71 GetFramebufferParameteriv:
72
73 GL_FRAMEBUFFER_FLIP_Y_MESA 0x8BBB
74
75 Errors
76
77 An INVALID_OPERATION error is generated by GetFramebufferParameteriv if the
78 default framebuffer is bound to <target> and <pname> is FRAMEBUFFER_FLIP_Y_MESA.
79
80
81
82 Revision History
83
84 Version 2, June, 2019
85 Enable extension for OpenGL 4.3 and beyond
86
87 Version 1, June, 2018
88 Initial draft (Fritz Koenig)