Opentk/Source/Bind/Specifications/Docs/glBindTransformFeedback.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="glBindTransformFeedback">
    <refentryinfo>
        <copyright>
            <year>2010-2013</year>
            <holder>Khronos Group.</holder>
        </copyright>
    </refentryinfo>
    <refmeta>
        <refentrytitle>glBindTransformFeedback</refentrytitle>
        <manvolnum>3G</manvolnum>
    </refmeta>
    <refnamediv>
        <refname>glBindTransformFeedback</refname>
        <refpurpose>bind a transform feedback object</refpurpose>
    </refnamediv>
    <refsynopsisdiv><title>C Specification</title>
        <funcsynopsis>
            <funcprototype>
                <funcdef>void <function>glBindTransformFeedback</function></funcdef>
                <paramdef>GLenum <parameter>target</parameter></paramdef>
                <paramdef>GLuint <parameter>id</parameter></paramdef>
            </funcprototype>
        </funcsynopsis>
    </refsynopsisdiv>
    <refsect1 id="parameters"><title>Parameters</title>
        <variablelist>
        <varlistentry>
            <term><parameter>target</parameter></term>
            <listitem>
                <para>
                    Specifies the target to which to bind the transform feedback object <parameter>id</parameter>. <parameter>target</parameter>
                    must be <constant>GL_TRANSFORM_FEEDBACK</constant>.
                </para>
            </listitem>
        </varlistentry>
        <varlistentry>
            <term><parameter>id</parameter></term>
            <listitem>
                <para>
                    Specifies the name of a transform feedback object reserved by <citerefentry><refentrytitle>glGenTransformFeedbacks</refentrytitle></citerefentry>.
                </para>
            </listitem>
        </varlistentry>
        </variablelist>
    </refsect1>
    <refsect1 id="description"><title>Description</title>
        <para>
            <function>glBindTransformFeedback</function> binds the transform feedback object with name <parameter>id</parameter> to the current
            GL state. <parameter>id</parameter> must be a name previously returned from a call to
            <citerefentry><refentrytitle>glGenTransformFeedbacks</refentrytitle></citerefentry>. If <parameter>id</parameter> has not
            previously been bound, a new transform feedback object with name <parameter>id</parameter> and initialized with with the
            default transform state vector is created.
        </para>
        <para>
            In the initial state, a default transform feedback object is bound and treated as
            a transform feedback object with a name of zero. If the name zero is subsequently bound, the default
            transform feedback object is again bound to the GL state.
        </para>
        <para>
            While a transform feedback buffer object is bound, GL operations on the target
            to which it is bound affect the bound transform feedback object, and queries of the
            target to which a transform feedback object is bound return state from the bound
            object. When buffer objects are bound for transform feedback, they are attached to
            the currently bound transform feedback object. Buffer objects are used for trans-
            form feedback only if they are attached to the currently bound transform feedback
            object.
        </para>
    </refsect1>
    <refsect1 id="errors"><title>Errors</title>
        <para>
            <constant>GL_INVALID_ENUM</constant> is generated if <parameter>target</parameter> is not <constant>GL_TRANSFORM_FEEDBACK</constant>.
        </para>
        <para>
            <constant>GL_INVALID_OPERATION</constant> is generated if the transform feedback operation is
            active on the currently bound transform feedback object, and that operation is not paused.
        </para>
        <para>
            <constant>GL_INVALID_OPERATION</constant> is generated if <parameter>id</parameter> is not
            zero or the name of a transform feedback object returned from a previous call to
            <citerefentry><refentrytitle>glGenTransformFeedbacks</refentrytitle></citerefentry>, or
            if such a name has been deleted by <citerefentry><refentrytitle>glDeleteTransformFeedbacks</refentrytitle></citerefentry>.
        </para>
    </refsect1>
    <refsect1 id="associatedgets"><title>Associated Gets</title>
        <para>
            <citerefentry><refentrytitle>glGet</refentrytitle></citerefentry> with argument <constant>GL_TRANSFORM_FEEDBACK_BINDING</constant>
        </para>
    </refsect1>
    <refsect1 id="seealso"><title>See Also</title>
        <para>
            <citerefentry><refentrytitle>glGenTransformFeedbacks</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>glDeleteTransformFeedbacks</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>glIsTransformFeedback</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>glBeginTransformFeedback</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>glPauseTransformFeedback</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>glResumeTransformFeedback</refentrytitle></citerefentry>,
            <citerefentry><refentrytitle>glEndTransformFeedback</refentrytitle></citerefentry>
        </para>
    </refsect1>
    <refsect1 id="Copyright"><title>Copyright</title>
        <para>
            Copyright <trademark class="copyright"></trademark> 2010-2013 Khronos Group.
            This material may be distributed subject to the terms and conditions set forth in
            the Open Publication License, v 1.0, 8 June 1999.
            <ulink url="http://opencontent.org/openpub/">http://opencontent.org/openpub/</ulink>.
        </para>
    </refsect1>
</refentry>