glXCreateGLXPixmap  -  create  an off-screen GLX rendering
       area



C SPECIFICATION

       GLXPixmap glXCreateGLXPixmap( Display *dpy,
                                     XVisualInfo *vis,
                                     Pixmap pixmap )



PARAMETERS

       dpy     Specifies the connection to the X server.

       vis     Specifies the visual that defines the structure of
               the  rendering  area.   It  is  a  pointer  to  an
               XVisualInfo  structure,  not  a  visual  ID  or  a
               pointer to a Visual.

       pixmap  Specifies  the  X  pixmap that will be used as the
               front left color buffer of the off-screen  render-
               ing area.


DESCRIPTION

       glXCreateGLXPixmap  creates  an  off-screen rendering area
       and returns its XID.  Any GLX rendering context  that  was
       created  with  respect  to  vis can be used to render into
       this off-screen area.  Use glXMakeCurrent to associate the
       rendering area with a GLX rendering context.

       The  X  pixmap  identified  by pixmap is used as the front
       left buffer of the resulting  off-screen  rendering  area.
       All  other  buffers  specified  by  vis,  including  color
       buffers other than the  front  left  buffer,  are  created
       without  externally  visible names.  GLX pixmaps with dou-
       ble-buffering are supported.  However,  glXSwapBuffers  is
       ignored by these pixmaps.

       Some  implementations  may  not  support  GLX pixmaps with
       direct rendering contexts.


NOTES

       XVisualInfo is defined in Xutil.h.  It is a structure that
       includes visual, visualID, screen, and depth elements.


ERRORS

       BadMatch  is  generated  if  the  depth of pixmap does not
       match the depth value reported by core X11 for vis, or  if
       pixmap  was not created with respect to the same screen as
       vis.

       BadValue is generated if vis is not  a  valid  XVisualInfo
       pointer  (for  example, if a particular GLX implementation