S
glXSwapBuffers
Chapter 17
408
glXSwapBuffers
glXSwapBuffers: make back buffer visible.
C Specification
void glXSwapBuffers(
Display *dpy,
GLXDrawable drawable)
Parameters
dpy Specifies the connection to the X server.
drawable Specifies the window 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 it returns. Subsequent GL
commands can be issued immediately after calling glXSwapBuffers, but are not executed
until the buffer exchange is completed.
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. Use the X Synchronization Extension to
facilitate such cooperation.
The X double buffer extension (DBE) has information on which buffer is the currently
displayed buffer. This information is shared with GLX.
Errors
• GLXBadDrawable is generated if drawable is not a valid GLX drawable.
• GLXBadCurrentWindow is generated if dpy and drawable are respectively the
display and drawable associated with the current context of the calling thread, and
drawable identifies a window that is no longer valid.
See Also
glFlush
To Next Page
Loading...
Need help?
General