C SPECIFICATION

       GLXPbuffer glXCreatePbuffer( Display *dpy,
                                    GLXFBConfig confi )
       GLXPbuffer glXCreatePbuffer( Display *,
                                    GLXFBConfig GLXFBConfig,
                                    const int * )

PARAMETERS

       Specifies the connection to the X server.

       GLXFBConfig  Specifies  a  GLXFBConfig  structure  with   the   desired
                    attributes for the window.


       Specifies  a  list  of  attribute value pairs, which must be terminated
       with
                    None,  or NULL. Accepted attributes are GLX_PBUFFER_WIDTH,
                    GLX_PBUFFER_HEIGHT,      GLX_PRESERVED_CONTENTS,       and
                    GLX_LARGEST_PBUFFER.

DESCRIPTION

       glXCreatePbuffer  creates  an off-screen rendering area and returns its
       XID.  Any GLX rendering context that was created with respect to GLXFB-
       Config    can    be   used   to   render   into   this   window.    Use
       glXMakeContextCurrent to associate the rendering area with a  GLX  ren-
       dering context.

       The accepted attributes for a GLXPbuffer are:

       GLX_PBUFFER_WIDTH     Specify  the  pixel  width of the requested GLXP-
                             buffer. The default value is 0.

       GLX_PBUFFER_HEIGHT    Specify the pixel height of the  requested  GLXP-
                             buffer. The default value is 0.

       GLX_LARGEST_PBUFFER   Specify  to  obtain  the  largest available pixel
                             buffer, if the requested  allocation  would  have
                             failed.  The  width  and  height of the allocated
                             pixel buffer  will  never  exceed  the  specified
                             GLX_PBUFFER_WIDTH  or GLX_PBUFFER_HEIGHT, respec-
                             tively.  Use  glXQueryDrawable  to  retrieve  the
                             dimensions  of  the  allocated  pixel buffer. The
                             default value is False.

       GLX_PRESERVED_CONTENTS
                             Specify if  the  contents  of  the  pixel  buffer
                             should  be  preserved  when  a  resource conflict
                             occurs.  If set to False,  the  contents  of  the
                             pixel  buffer may be lost at any time.  If set to

       glXCreatePbuffer  is  available  only  if  the  GLX  version  is 1.3 or
       greater.

       If the GLX version is 1.1 or 1.0, the GL version must be 1.0.   If  the
       GLX  version  is 1.2, then the GL version must be 1.1.  If the GLX ver-
       sion is 1.3, then the GL version must be 1.2.

       GLXPbuffers are allocated from  frame  buffer  resources;  applications
       should consider deallocating them when they are not in use.

ERRORS

       BadAlloc  is  generated if there are insufficient resources to allocate
       the requested GLXPbuffer.

       GLXBadFBConfig is generated if GLXFBConfig is not a valid  GLXFBConfig.

       BadMatch  is  generated  if  GLXFBConfig  does not support rendering to
       pixel   buffers.   (e.g.,   GLX_DRAWABLE_TYPE    does    not    contain
       GLX_PBUFFER_BIT).

SEE ALSO

       glXChooseFBConfig,       glXCreatePbuffer,       glXMakeContextCurrent,
       glXSelectEvent



                                                          GLXCREATEPBUFFER(3G)