glXImportContextEXT(3G)

NAME
     glXImportContextEXT - import an existing GLX rendering context


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


PARAMETERS
     dpy        Specifies the connection to the X server.

     contextID  Specifies the XID of the GLX rendering context to be imported.


DESCRIPTION
     glXImportContextEXT imports an existing GLX rendering context into the
     client's process and returns a handle to it. Use it in place of
     glXCreateContext to share another process's indirect rendering context.

     Only the server-side context information can be shared between GLX
     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 i.d. 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.


NOTES
     glXImportContextEXT is part of the EXT_import_context extension.


ERRORS
     If contextID does not refer to a valid context a GLXBadContext error is
     generated.


ASSOCIATED GETS
     glXGetContextIDEXT
SEE ALSO
     glXCreateContext,glXFreeContextEXT