glXCreateWindow(3G)

NAME
     glXCreateWindow - create an on-screen rendering area


C SPECIFICATION
     GLXWindow glXCreateWindow( Display *dpy,
                                GLXFBConfig config,
                                Window win,
                                int *attrib_list )


PARAMETERS
     dpy          Specifies the connection to the X server.

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

     win          Specifies the X window to be used as the rendering area.

     attrib_list  Currently unused. This must be set to NULL, or be an empty
                  list (i.e. one in which the first element is None).

DESCRIPTION
     glXCreateWindow creates an on-screen rendering area from an existing X
     window which was created with a visual which matches config. the XID of
     the GLXWindow is returned.  Any GLX rendering context that was created
     with respect to config can be used to render into this window.  Use
     glXMakeContextCurrent to associate the rendering area with a GLX
     rendering context.

NOTES
     glXCreateWindow 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 version is
     1.3, then the GL version must be 1.2.

ERRORS
     BadMatch is generated if win was not created with a visual that
     corresponds to config.

     BadMatch is generated if config does not support rendering to windows
     (i.e. GLX_DRAWABLE_TYPE does not contain GLX_WINDOW_BIT).

     BadWindow is generated if win is not a valid window XID.

     BadAlloc is generated if there is already a GLXFBConfig associated with
     win.

     BadAlloc is generated if the X server cannot allocate a new GLX window.
     GLXBadFBConfig is generated if config is not a valid GLXFBConfig.

SEE ALSO
     glXChooseFBConfig, glXDestroyWindow, glXMakeContextCurrent