glxswapbuffers - Man Page






glXSwapBuffers(3G)	    OpenGL Reference - GLX	    glXSwapBuffers(3G)



NAME
     glXSwapBuffers - 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 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.

     An	implicit glFlush is done by glXSwapBuffers before it returns.
     Subsequent	OpenGL 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.  The	X
     Synchronization Extension can be used to facilitate such cooperation.


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.



MACHINE	DEPENDENCIES
     Gang swap (multipipe synchronized buffer swaps) is	not supported on
     InfiniteReality systems or	on RealityEngine, RealityEngine2, and VTX
     systems.  This will be fixed in a future release.



									Page 1






glXSwapBuffers(3G)	    OpenGL Reference - GLX	    glXSwapBuffers(3G)



     Before a window's buffers can be swapped, at least	one thread must	have
     attached an OpenGL	rendering context to the window	via glXMakeCurrent.


SEE ALSO
     glFlush

















































									Page 2