Remove CVS keywords.
[profile/ivi/mesa.git] / docs / MESA_resize_buffers.spec
1 Name
2
3     MESA_resize_buffers
4
5 Name Strings
6
7     GL_MESA_resize_buffers
8
9 Contact
10
11     Brian Paul (brian.paul 'at' tungstengraphics.com)
12
13 Status
14
15     Shipping (since Mesa version 2.2)
16
17 Version
18
19
20 Number
21
22     196
23
24 Dependencies
25
26     Mesa 2.2 or later is required.
27
28 Overview
29
30     Mesa is often used as a client library with no integration with
31     the computer's window system (an X server, for example).  And since
32     Mesa does not have an event loop nor window system callbacks, it
33     cannot properly respond to window system events.  In particular,
34     Mesa cannot automatically detect when a window has been resized.
35
36     Mesa's glViewport command queries the current window size and updates
37     its internal data structors accordingly.  This normally works fine
38     since most applications call glViewport in responce to window size
39     changes.
40
41     In some situations, however, the application may not call glViewport
42     when a window size changes but would still like Mesa to adjust to
43     the new window size.  This extension exports a new function to solve
44     this problem.
45
46 New Procedures and Functions
47
48     void glResizeBuffersMESA( void )
49
50 New Tokens
51
52     none
53
54 Additions to the OpenGL Specification (no particular section)
55
56     The glResizeBuffersMESA command may be called when the client
57     determines that a window has been resized.  Calling
58     glResizeBuffersMESA causes Mesa to query the current window size
59     and adjust its internal data structures.  This may include
60     reallocating depth, stencil, alpha and accumulation buffers.
61
62 Additions to the AGL/GLX/WGL Specifications
63
64     None
65
66 Errors
67
68     INVALID_OPERATION is generated if ResizeBuffersMESA is called betweeen
69     Begin and End.
70
71 New State
72
73     None.
74
75 New Implementation Dependent State
76
77     None.
78
79 Revision History
80
81   * Revision 1.0 - Initial specification