C SPECIFICATION

       GLXPixmap glXCreateGLXPixmap( Display *dpy,
                                     XVisualInfo *visua )

PARAMETERS

       dpy    Specifies the connection to the X server.

       visua  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.

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

DESCRIPTION

       glXCreateGLXPixmap creates an off-screen rendering area and returns its
       XID.   Any GLX rendering context that was created with respect to visua
       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 _param3 is used as the front left buffer of
       the resulting off-screen rendering area.  All other  buffers  specified
       by visua, including color buffers other than the front left buffer, are
       created without externally visible names.   GLX  pixmaps  with  double-
       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 _param3 does not match the  depth
       value  reported  by  core  X11 for visua, or if _param3 was not created
       with respect to the same screen as visua.

       BadValue is generated if visua is not a valid XVisualInfo pointer  (for
       example,  if  a  particular  GLX  implementation  does not support this
       visual).

       BadPixmap is generated if _param3 is not a valid pixmap.

       BadAlloc is generated if the server cannot allocate the GLX pixmap.

SEE ALSO

       glXCreateContext,  glXCreatePixmap,  glXDestoryGLXPixmap,  glXIsDirect,