1f47388dfe
Copied language from the glXSwapBuffers manual page about the implicit glFlush and expected command completion. This just codifies what people already expect from glXCopySubBufferMESA. The intention of this command is to work like glXSwapBuffers but on a sub-rectangle of the drawable. Acked-by: Brian Paul <brianp@vmware.com>
97 lines
2.2 KiB
Python
97 lines
2.2 KiB
Python
Name
|
|
|
|
MESA_copy_sub_buffer
|
|
|
|
Name Strings
|
|
|
|
GLX_MESA_copy_sub_buffer
|
|
|
|
Contact
|
|
|
|
Brian Paul (brian.paul 'at' tungstengraphics.com)
|
|
|
|
Status
|
|
|
|
Shipping since Mesa 2.6 in February, 1998.
|
|
|
|
Version
|
|
|
|
Last Modified Date: 12 January 2009
|
|
|
|
Number
|
|
|
|
215
|
|
|
|
Dependencies
|
|
|
|
OpenGL 1.0 or later is required.
|
|
GLX 1.0 or later is required.
|
|
|
|
Overview
|
|
|
|
The glxCopySubBufferMESA() function copies a rectangular region
|
|
of the back color buffer to the front color buffer. This can be
|
|
used to quickly repaint 3D windows in response to expose events
|
|
when the back color buffer cannot be damaged by other windows.
|
|
|
|
IP Status
|
|
|
|
Open-source; freely implementable.
|
|
|
|
Issues
|
|
|
|
None.
|
|
|
|
New Procedures and Functions
|
|
|
|
void glXCopySubBufferMESA( Display *dpy, GLXDrawable drawable,
|
|
int x, int y, int width, int height );
|
|
|
|
New Tokens
|
|
|
|
None.
|
|
|
|
Additions to Chapter 3 of the GLX 1.3 Specification (Functions and Errors)
|
|
|
|
Add to section 3.3.10 Double Buffering:
|
|
|
|
The function
|
|
|
|
void glXCopySubBufferMESA( Display *dpy, GLXDrawable drawable,
|
|
int x, int y, int width, int height );
|
|
|
|
may be used to copy a rectangular region of the back color buffer to
|
|
the front color buffer. This can be used to quickly repaint 3D windows
|
|
in response to expose events when the back color buffer cannot be
|
|
damaged by other windows.
|
|
|
|
<x> and <y> indicates the lower-left corner of the region to copy and
|
|
<width> and <height> indicate the size in pixels. Coordinate (0,0)
|
|
corresponds to the lower-left pixel of the window, like glReadPixels.
|
|
|
|
If dpy and drawable are the display and drawable for the calling
|
|
thread's current context, glXCopySubBufferMESA performs an
|
|
implicit glFlush before it returns. Subsequent OpenGL commands
|
|
may be issued immediately after calling glXCopySubBufferMESA, but
|
|
are not executed until the copy is completed.
|
|
|
|
GLX Protocol
|
|
|
|
None at this time. The extension is implemented in terms of ordinary
|
|
Xlib protocol inside of Mesa.
|
|
|
|
Errors
|
|
|
|
None.
|
|
|
|
New State
|
|
|
|
None.
|
|
|
|
Revision History
|
|
|
|
12 January 2009 Ian Romanick - Added language about implicit flush
|
|
and command completion.
|
|
8 June 2000 Brian Paul - initial specification
|
|
|