<?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="gluQuadricCallback">
    <refmeta>
        <refmetainfo>
            <copyright>
                <year>1991-2006</year>
                <holder>Silicon Graphics, Inc.</holder>
            </copyright>
        </refmetainfo>
        <refentrytitle>gluQuadricCallback</refentrytitle>
        <manvolnum>3G</manvolnum>
    </refmeta>
    <refnamediv>
        <refname>gluQuadricCallback</refname>
        <refpurpose>define a callback for a quadrics object</refpurpose>
    </refnamediv>
    <refsynopsisdiv><title>C Specification</title>
        <funcsynopsis>
            <funcprototype>
                <funcdef>void <function>gluQuadricCallback</function></funcdef>
                <paramdef>GLUquadric* <parameter>quad</parameter></paramdef>
                <paramdef>GLenum <parameter>which</parameter></paramdef>
                <paramdef>_GLUfuncptr <parameter>CallBackFunc</parameter></paramdef>
            </funcprototype>
        </funcsynopsis>
    </refsynopsisdiv>
    <!-- eqn: ignoring delim $$ -->
    <refsect1 id="parameters"><title>Parameters</title>
        <variablelist>
        <varlistentry>
            <term><parameter>quad</parameter></term>
            <listitem>
                <para>
                    Specifies the quadrics object (created with <citerefentry><refentrytitle>gluNewQuadric</refentrytitle></citerefentry>).
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><parameter>which</parameter></term>
            <listitem>
                <para>
                    Specifies the callback being defined.
                    The only valid value is <constant>GLU_ERROR</constant>.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><parameter>CallBackFunc</parameter></term>
            <listitem>
                <para>
                    Specifies the function to be called.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsect1>
    <refsect1 id="description"><title>Description</title>
        <para>
            <function>gluQuadricCallback</function> is used to define a new callback to be used by a quadrics object.
            If the specified callback is already defined, then it is replaced. If 
            <parameter>CallBackFunc</parameter> is NULL, then any existing callback is erased.
        </para>
        <para>
            The one legal callback is <constant>GLU_ERROR</constant>:
        </para>
        <variablelist>
            <varlistentry>
                <term><constant>GLU_ERROR</constant></term>
                <listitem>
                    <para>
                        The function is called when an error is encountered. Its single argument
                        is of type GLenum, and it indicates the specific error that occurred.
                        Character strings describing these errors can be retrieved with the
                        <citerefentry><refentrytitle>gluErrorString</refentrytitle></citerefentry> call.
                    </para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsect1>
    <refsect1 id="seealso"><title>See Also</title>
        <para>
            <citerefentry><refentrytitle>gluErrorString</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>gluNewQuadric</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>
