glXSwapBuffers.3gl




Name

  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.

  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.


See Also

  glFlush




Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV