Exchange front and back buffers.
C Specification |
 |
void glXSwapBuffers(Display *dpy,
GLXDrawable drawable)
|
Parameters |
|
- dpy
Specifies the connection to the X server.
- drawable
Specifies the drawable whose buffers are to be swapped.
Description |
|
glXSwapBuffers promotes the contents of the back buffer of
drawable to become the contents of the front buffer of drawable.
The contents of the back buffer then become undefined. The update typically
takes place during the vertical retrace of the monitor, rather than immediately
after glXSwapBuffers is called. All GLX rendering contexts share the
same notion of which are front buffers and which are back buffers.
glXSwapBuffers performs an implicit glFlush before returning.
Subsequent IVL commands can be issued immediately after calling
glXSwapBuffers, but are not executed until after the buffer exchange
completes.
If drawable was not created with respect to a double-buffered visual,
glXSwapBuffers has no effect, and no error is generated.
Notes |
|
Synchronization of multiple GLX contexts rendering to the same double-buffered
window is the responsibility of the clients. The X Synchronization Extension
can be used to facilitate such cooperation.
Errors |
|
GLX_BAD_DRAWABLE is generated if drawable is not a valid GLX
drawable.
GLX_BAD_CURRENT_WINDOW is generated if dpy and drawable
are respectively the display and drawable associated with the current context
of the calling thread/process, and drawable identifies a window that is no
longer valid.
See Also |
|
glFlush.
Printable version
