Opentk/Source/Bind/Specifications/Docs/glXGetClientString.xml
2009-03-08 00:46:58 +00:00

107 lines
4.8 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
"http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
<refentry id="glXGetClientString">
<refmeta>
<refmetainfo>
<copyright>
<year>1991-2006</year>
<holder>Silicon Graphics, Inc.</holder>
</copyright>
</refmetainfo>
<refentrytitle>glXGetClientString</refentrytitle>
<manvolnum>3G</manvolnum>
</refmeta>
<refnamediv>
<refname>glXGetClientString</refname>
<refpurpose>return a string describing the client</refpurpose>
</refnamediv>
<refsynopsisdiv><title>C Specification</title>
<funcsynopsis>
<funcprototype>
<funcdef>const char * <function>glXGetClientString</function></funcdef>
<paramdef>Display * <parameter>dpy</parameter></paramdef>
<paramdef>int <parameter>name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<!-- eqn: ignoring delim $$ -->
<refsect1 id="parameters"><title>Parameters</title>
<variablelist>
<varlistentry>
<term><parameter>dpy</parameter></term>
<listitem>
<para>
Specifies the connection to the X server.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>name</parameter></term>
<listitem>
<para>
Specifies which string is returned.
The symbolic constants <constant>GLX_VENDOR</constant>, <constant>GLX_VERSION</constant>,
and <constant>GLX_EXTENSIONS</constant> are accepted.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="description"><title>Description</title>
<para>
<function>glXGetClientString</function> returns a string
describing some aspect of the client library. The possible values for <parameter>name</parameter>
are <constant>GLX_VENDOR</constant>, <constant>GLX_VERSION</constant>, and
<constant>GLX_EXTENSIONS</constant>. If <parameter>name</parameter>
is not set to one of these values, <function>glXGetClientString</function> returns <constant>NULL</constant>.
The format and contents of the vendor string is implementation dependent.
</para>
<para>
The extensions string is null-terminated and contains a
space-separated list of extension names. (The extension names never
contain spaces.)
If there are no extensions to GLX, then the empty string is returned.
</para>
<para>
The version string is laid out as follows:
</para>
<para>
&lt;major_version.minor_version&gt;&lt;space&gt;&lt;vendor-specific info&gt;
</para>
<para>
Both the major and minor portions of the version number are of arbitrary
length. The vendor-specific information is optional. However, if it is
present, the format and contents are implementation specific.
</para>
</refsect1>
<refsect1 id="notes"><title>Notes</title>
<para>
<function>glXGetClientString</function> is available only if the GLX version is 1.1 or greater.
</para>
<para>
If the GLX version is 1.1 or 1.0, the GL version must be 1.0.
If the GLX version is 1.2, then the GL version must be 1.1.
If the GLX version is 1.3, then the GL version must be 1.2.
</para>
<para>
<function>glXGetClientString</function> only returns information about GLX extensions supported by the client.
Call <citerefentry><refentrytitle>glGetString</refentrytitle></citerefentry> to get a list of GL extensions supported by the server.
</para>
</refsect1>
<refsect1 id="seealso"><title>See Also</title>
<para>
<citerefentry><refentrytitle>glXQueryVersion</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>glXQueryExtensionsString</refentrytitle></citerefentry>,
<citerefentry><refentrytitle>glXQueryServerString</refentrytitle></citerefentry>
</para>
</refsect1>
<refsect1 id="Copyright"><title>Copyright</title>
<para>
Copyright <trademark class="copyright"></trademark> 1991-2006
Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<ulink url="http://oss.sgi.com/projects/FreeB/">http://oss.sgi.com/projects/FreeB/</ulink>.
</para>
</refsect1>
</refentry>