mesa: Enable GL_MESA_framebuffer_flip_y for GL 4.3
[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 302
31
32 Dependencies
33
34 OpenGL ES 3.1 or OpenGL 4.3 is required, for FramebufferParameteri.
35
36 Overview
37
38 This extension defines a new framebuffer parameter,
39 GL_FRAMEBUFFER_FLIP_Y_MESA, that changes the behavior of the reads and
40 writes to the framebuffer attachment points. When GL_FRAMEBUFFER_FLIP_Y_MESA
41 is GL_TRUE, render commands and pixel transfer operations access the
42 backing store of each attachment point with an y-inverted coordinate
43 system. This y-inversion is relative to the coordinate system set when
44 GL_FRAMEBUFFER_FLIP_Y_MESA is GL_FALSE.
45
46 Access through TexSubImage2D and similar calls will notice the effect of
47 the flip when they are not attached to framebuffer objects because
48 GL_FRAMEBUFFER_FLIP_Y_MESA is associated with the framebuffer object and
49 not the attachment points.
50
51 IP Status
52
53 None
54
55 Issues
56
57 None
58
59 New Procedures and Functions
60
61 None
62
63 New Types
64
65 None
66
67 New Tokens
68
69 Accepted by the <pname> argument of FramebufferParameteri and
70 GetFramebufferParameteriv:
71
72 GL_FRAMEBUFFER_FLIP_Y_MESA 0x8BBB
73
74 Errors
75
76 An INVALID_OPERATION error is generated by GetFramebufferParameteriv if the
77 default framebuffer is bound to <target> and <pname> is FRAMEBUFFER_FLIP_Y_MESA.
78
79 Revision History
80
81 Version 2, June, 2019
82 Added OpenGL 4.3 as alternative requirement
83
84 Version 1, June, 2018
85 Initial draft (Fritz Koenig)