Brian Paul | 3e07e16 | 1999-07-20 00:30:41 +0000 | [diff] [blame] | 1 | Name |
| 2 | |
| 3 | MESA_resize_buffers |
| 4 | |
| 5 | Name Strings |
| 6 | |
| 7 | GL_MESA_resize_buffers |
| 8 | |
| 9 | Contact |
| 10 | |
Brian Paul | d3b09fe | 2004-03-25 01:42:41 +0000 | [diff] [blame] | 11 | Brian Paul (brian.paul 'at' tungstengraphics.com) |
Brian Paul | 3e07e16 | 1999-07-20 00:30:41 +0000 | [diff] [blame] | 12 | |
| 13 | Status |
| 14 | |
| 15 | Shipping (since Mesa version 2.2) |
| 16 | |
| 17 | Version |
| 18 | |
Brian Paul | 3e07e16 | 1999-07-20 00:30:41 +0000 | [diff] [blame] | 19 | |
| 20 | Number |
| 21 | |
Brian Paul | 2f8b4c9 | 2000-04-04 23:29:32 +0000 | [diff] [blame] | 22 | 196 |
Brian Paul | 3e07e16 | 1999-07-20 00:30:41 +0000 | [diff] [blame] | 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 |