glXCreateGLXPixmap()                         glXCreateGLXPixmap()

NAME    [Toc]    [Back]

       glXCreateGLXPixmap  -  create  an off-screen GLX rendering
       area

SYNOPSIS    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

       Specifies the connection to the X server.   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.  Specifies the X pixmap that
       will be used as the front left color buffer  of  the  offscreen
 rendering area.

DESCRIPTION    [Toc]    [Back]

       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 double-buffering
 are supported. However, glXSwapBuffers()  is
       ignored by these pixmaps.

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

NOTES    [Toc]    [Back]

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

ERRORS    [Toc]    [Back]

       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
       does not support this visual).

       BadPixmap is generated if pixmap is not a valid pixmap.

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

SEE ALSO    [Toc]    [Back]

       glXCreateContext(3), glXIsDirect(3), glXMakeCurrent(3)



                                             glXCreateGLXPixmap()