Subversion Repositories AndroidProjects

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
1452 chris 1 
<?xml version="1.0" encoding="UTF-8"?>
2 
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
3 
              "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
4 
<refentry id="glXImportContextEXT">
5 
    <refmeta>
6 
        <refmetainfo>
7 
            <copyright>
8 
                <year>1991-2006</year>
9 
                <holder>Silicon Graphics, Inc.</holder>
10 
            </copyright>
11 
        </refmetainfo>
12 
        <refentrytitle>glXImportContextEXT</refentrytitle>
13 
        <manvolnum>3G</manvolnum>
14 
    </refmeta>
15 
    <refnamediv>
16 
        <refname>glXImportContextEXT</refname>
17 
        <refpurpose>import another process's indirect rendering context.</refpurpose>
18 
    </refnamediv>
19 
    <refsynopsisdiv><title>C Specification</title>
20 
        <funcsynopsis>
21 
            <funcprototype>
22 
                <funcdef>GLXContext <function>glXImportContextEXT</function></funcdef>
23 
                <paramdef>Display * <parameter>dpy</parameter></paramdef>
24 
                <paramdef>GLXContextID <parameter>contextID</parameter></paramdef>
25 
            </funcprototype>
26 
        </funcsynopsis>
27 
    </refsynopsisdiv>
28 
    <!-- eqn: ignoring delim $$ -->
29 
    <refsect1 id="parameters"><title>Parameters</title>
30 
        <variablelist>
31 
        <varlistentry>
32 
            <term><parameter>dpy</parameter></term>
33 
            <listitem>
34 
                <para>
35 
                    Specifies the connection to the X server.
36 
                </para>
37 
            </listitem>
38 
        </varlistentry>
39 
        <varlistentry>
40 
            <term><parameter>contextID</parameter></term>
41 
            <listitem>
42 
                <para>
43 
                    Specifies a GLX rendering context.
44 
                </para>
45 
            </listitem>
46 
        </varlistentry>
47 
        </variablelist>
48 
    </refsect1>
49 
    <refsect1 id="description"><title>Description</title>
50 
        <para>
51 
            <function>glXImportContextEXT</function> creates a GLXContext given the XID of an existing GLXContext.
52 
            It may be used in place of <citerefentry><refentrytitle>glXCreateContext</refentrytitle></citerefentry>,
53 
            to share another process's indirect rendering context.
54 
        </para>
55 
        <para>
56 
            Only the server-side context information can be shared between
57 
            X clients; client-side state, such as pixel storage modes,
58 
            cannot be shared. Thus, <function>glXImportContextEXT</function> must allocate memory to store
59 
            client-side information. This memory is freed by calling
60 
            <citerefentry><refentrytitle>glXFreeContextEXT</refentrytitle></citerefentry>.
61 
        </para>
62 
        <para>
63 
            This call does not create a new XID.  It merely makes an
64 
            existing object available to the importing client (Display *).
65 
            Like any XID, it goes away when the creating client drops its
66 
            connection or the ID is explicitly deleted. Note that this is
67 
            when the XID goes away. The object goes away when the XID
68 
            goes away AND the context is not current to any thread.
69 
        </para>
70 
        <para>
71 
            If <parameter>contextID</parameter> refers to a
72 
            direct rendering context then no error is generated but
73 
            <function>glXImportContextEXT</function> returns NULL.
74 
        </para>
75 
        <para>
76 
            <function>glXImportContextEXT</function> is part of the <code>EXT_import_context</code> extension,
77 
            not part of the core GLX command set. If _glxextstring(EXT_import_context)
78 
            is included in the string returned by <citerefentry><refentrytitle>glXQueryExtensionsString</refentrytitle></citerefentry>,
79 
            when called with argument <constant>GLX_EXTENSIONS</constant>,
80 
            extension <code>EXT_import_context</code> is supported.
81 
        </para>
82 
    </refsect1>
83 
    <refsect1 id="errors"><title>Errors</title>
84 
        <para>
85 
            <constant>GLXBadContext</constant> is generated if <parameter>contextID</parameter> does not
86 
            refer to a valid context.
87 
        </para>
88 
    </refsect1>
89 
    <refsect1 id="seealso"><title>See Also</title>
90 
        <para>
91 
            <citerefentry><refentrytitle>glXCreateContext</refentrytitle></citerefentry>,
92 
            <citerefentry><refentrytitle>glXQueryVersion</refentrytitle></citerefentry>,
93 
            <citerefentry><refentrytitle>glXQueryExtensionsString</refentrytitle></citerefentry>,
94 
            <citerefentry><refentrytitle>glXGetContextIDEXT</refentrytitle></citerefentry>,
95 
            <citerefentry><refentrytitle>glXFreeContextEXT</refentrytitle></citerefentry>
96 
        </para>
97 
    </refsect1>
98 
    <refsect1 id="Copyright"><title>Copyright</title>
99 
        <para>
100 
            Copyright <trademark class="copyright"></trademark> 1991-2006
101 
            Silicon Graphics, Inc. This document is licensed under the SGI
102 
            Free Software B License. For details, see
103 
            <ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
104 
        </para>
105 
    </refsect1>
106 
</refentry>