glXImportContextEXT(3G)

NAME
     glXImportContextEXT - import another process's indirect rendering
     context.


C SPECIFICATION
     GLXContext glXImportContextEXT( Display *dpy,
                                     GLXContextID contextID )


PARAMETERS
     dpy        Specifies the connection to the X server.


     contextID  Specifies a GLX rendering context.


DESCRIPTION
     glXImportContextEXT creates a GLXContext given the XID of an existing
     GLXContext.  It may be used in place of glXCreateContext, to share
     another process's indirect rendering context.

     Only the server-side context information can be shared between X clients;
     client-side state, such as pixel storage modes, cannot be shared. Thus,
     glXImportContextEXT must allocate memory to store client-side
     information. This memory is freed by calling glXFreeContextEXT.

     This call does not create a new XID.  It merely makes an existing object
     available to the importing client (Display *).  Like any XID, it goes
     away when the creating client drops its connection or the ID is
     explicitly deleted. Note that this is when the XID goes away. The object
     goes away when the XID goes away AND the context is not current to any
     thread.

     If contextID refers to a direct rendering context then no error is
     generated but glXImportContextEXT returns NULL.

     glXImportContextEXT is part of the EXT_import_context extension, not part
     of the core GLX command set. If GLX_EXT_import_context is included in the
     string returned by glXQueryExtensionsString, when called with argument
     GLX_EXTENSIONS, extension EXT_import_context is supported.


ERRORS
     GLXBadContext is generated if contextID does not refer to a valid
     context.
SEE ALSO
     glXCreateContext, glXQueryVersion, glXQueryExtensionsString,
     glXGetContextIDEXT, glXFreeContextEXT