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