upstream-man-pages/man2/xhtml/glXImportContextEXT.xml

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
   2 <!-- saved from url=(0013)about:internet -->
   3 <?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>glXImportContextEXT</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glXImportContextEXT"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glXImportContextEXT — import another process's indirect rendering context.</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">GLXContext <b class="fsfunc">glXImportContextEXT</b>(</code></td><td>Display *  </td><td><var class="pdparam">dpy</var>, </td></tr><tr><td> </td><td>GLXContextID  </td><td><var class="pdparam">contextID</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dpy</code></em></span></dt><dd><p>
   4                     Specifies the connection to the X server.
   5                 </p></dd><dt><span class="term"><em class="parameter"><code>contextID</code></em></span></dt><dd><p>
   6                     Specifies a GLX rendering context.
   7                 </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
   8             <code class="function">glXImportContextEXT</code> creates a GLXContext given the XID of an existing GLXContext.
   9             It may be used in place of <a class="citerefentry" href="glXCreateContext.xml"><span class="citerefentry"><span class="refentrytitle">glXCreateContext</span></span></a>,
  10             to share another process's indirect rendering context.
  11         </p><p>
  12             Only the server-side context information can be shared between
  13             X clients; client-side state, such as pixel storage modes,
  14             cannot be shared. Thus, <code class="function">glXImportContextEXT</code> must allocate memory to store
  15             client-side information. This memory is freed by calling
  16             <a class="citerefentry" href="glXFreeContextEXT.xml"><span class="citerefentry"><span class="refentrytitle">glXFreeContextEXT</span></span></a>.
  17         </p><p>
  18             This call does not create a new XID.  It merely makes an
  19             existing object available to the importing client (Display *).
  20             Like any XID, it goes away when the creating client drops its
  21             connection or the ID is explicitly deleted. Note that this is
  22             when the XID goes away. The object goes away when the XID
  23             goes away AND the context is not current to any thread.
  24         </p><p>
  25             If <em class="parameter"><code>contextID</code></em> refers to a
  26             direct rendering context then no error is generated but
  27             <code class="function">glXImportContextEXT</code> returns NULL.
  28         </p><p>
  29             <code class="function">glXImportContextEXT</code> is part of the <code class="code">EXT_import_context</code> extension,
  30             not part of the core GLX command set. If _glxextstring(EXT_import_context)
  31             is included in the string returned by <a class="citerefentry" href="glXQueryExtensionsString.xml"><span class="citerefentry"><span class="refentrytitle">glXQueryExtensionsString</span></span></a>,
  32             when called with argument <code class="constant">GLX_EXTENSIONS</code>,
  33             extension <code class="code">EXT_import_context</code> is supported.
  34         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
  35             <code class="constant">GLXBadContext</code> is generated if <em class="parameter"><code>contextID</code></em> does not
  36             refer to a valid context.
  37         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
  38             <a class="citerefentry" href="glXCreateContext.xml"><span class="citerefentry"><span class="refentrytitle">glXCreateContext</span></span></a>,
  39             <a class="citerefentry" href="glXQueryVersion.xml"><span class="citerefentry"><span class="refentrytitle">glXQueryVersion</span></span></a>,
  40             <a class="citerefentry" href="glXQueryExtensionsString.xml"><span class="citerefentry"><span class="refentrytitle">glXQueryExtensionsString</span></span></a>,
  41             <a class="citerefentry" href="glXGetContextIDEXT.xml"><span class="citerefentry"><span class="refentrytitle">glXGetContextIDEXT</span></span></a>,
  42             <a class="citerefentry" href="glXFreeContextEXT.xml"><span class="citerefentry"><span class="refentrytitle">glXFreeContextEXT</span></span></a>
  43         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
  44             Copyright <span class="trademark"></span>© 1991-2006
  45             Silicon Graphics, Inc. This document is licensed under the SGI
  46             Free Software B License. For details, see
  47             <a class="ulink" href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
  48         </p></div></div></body></html>