Index Index for
Section 3
Index Alphabetical
listing for G
Bottom of page Bottom of
page

glXImportContextEXT()

NAME

glXImportContextEXT - import another process's indirect rendering context.

SYNOPSIS

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()

Index Index for
Section 3
Index Alphabetical
listing for G
Top of page Top of
page