2006-11-29 10:00:35 -07:00
|
|
|
'\"! eqn | mmdoc
|
|
|
|
'\"macro stdmacro
|
|
|
|
.ds Vn Version 1.2
|
|
|
|
.ds Dt 6 March 1997
|
|
|
|
.ds Re Release 1.2.0
|
|
|
|
.ds Dp Feb 16 02:56
|
|
|
|
.ds Dm Feb 10 17:2
|
|
|
|
.ds Xs 38402 4 ximportcontextext.gl
|
2010-10-24 04:14:44 -06:00
|
|
|
.TH GLXIMPORTCONTEXTEXT 3
|
2006-11-29 10:00:35 -07:00
|
|
|
.SH NAME
|
|
|
|
glXImportContextEXT
|
|
|
|
\- import another process's indirect rendering context.
|
|
|
|
|
|
|
|
.SH C SPECIFICATION
|
|
|
|
GLXContext \f3glXImportContextEXT\fP(
|
|
|
|
Display \fI*dpy\fP,
|
|
|
|
.nf
|
|
|
|
.ta \w'\f3GLXContext \fPglXImportContextEXT( 'u
|
|
|
|
GLXContextID \fIcontextID\fP )
|
|
|
|
.fi
|
|
|
|
|
|
|
|
.EQ
|
|
|
|
delim $$
|
|
|
|
.EN
|
|
|
|
.SH PARAMETERS
|
|
|
|
.TP \w'\fIcontextID\fP\ \ 'u
|
|
|
|
\f2dpy\fP
|
|
|
|
Specifies the connection to the X server.
|
|
|
|
|
|
|
|
.TP
|
|
|
|
\f2contextID\fP
|
|
|
|
Specifies a GLX rendering context.
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
\f3glXImportContextEXT\fP creates a GLXContext given the XID of an existing GLXContext.
|
|
|
|
It may be used in place of \f3glXCreateContext\fP,
|
|
|
|
to share another process's indirect rendering context.
|
|
|
|
.P
|
|
|
|
Only the server-side context information can be shared between
|
|
|
|
X clients; client-side state, such as pixel storage modes,
|
|
|
|
cannot be shared. Thus, \f3glXImportContextEXT\fP must allocate memory to store
|
|
|
|
client-side information. This memory is freed by calling
|
|
|
|
\f3glXFreeContextEXT\fP.
|
|
|
|
.P
|
|
|
|
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.
|
|
|
|
.P
|
|
|
|
If \f2contextID\fP refers to a
|
|
|
|
direct rendering context then no error is generated but
|
|
|
|
\f3glXImportContextEXT\fP returns NULL.
|
|
|
|
.P
|
|
|
|
\f3glXImportContextEXT\fP is part of the \f3EXT_import_context\fP extension,
|
|
|
|
not part of the core GLX command set. If \f3GLX_EXT_import_context\fP
|
|
|
|
is included in the string returned by \f3glXQueryExtensionsString\fP,
|
|
|
|
when called with argument \f3GLX_EXTENSIONS\fP,
|
|
|
|
extension \f3EXT_import_context\fP is supported.
|
|
|
|
|
|
|
|
.SH ERRORS
|
|
|
|
\f3GLXBadContext\fP is generated if \f2contextID\fP does not
|
|
|
|
refer to a valid context.
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
\f3glXCreateContext\fP,
|
|
|
|
\f3glXQueryVersion\fP,
|
|
|
|
\f3glXQueryExtensionsString\fP,
|
|
|
|
\f3glXGetContextIDEXT\fP,
|
|
|
|
\f3glXFreeContextEXT\fP
|