<?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 xml:base="" id="glDeleteBuffers">
    <refmeta>
        <refmetainfo>
            <copyright>
                <year>2003-2004</year>
                <holder>Silicon Graphics, Inc.</holder>
            </copyright>
        </refmetainfo>
        <refentrytitle>glDeleteBuffers</refentrytitle>
        <manvolnum>3G</manvolnum>
    </refmeta>

    <refnamediv>
        <refname>glDeleteBuffers</refname>
        <refpurpose>delete named buffer objects</refpurpose>
    </refnamediv>

    <refsynopsisdiv>
        <title>C Specification</title>

        <funcsynopsis>
            <funcprototype>
                <funcdef>void <function>glDeleteBuffers</function></funcdef>
                <paramdef>GLsizei <parameter>n</parameter></paramdef>
                <paramdef>const GLuint * <parameter>buffers</parameter></paramdef>
            </funcprototype>
        </funcsynopsis>
    </refsynopsisdiv>

    <refsect1 id="parameters"><title>Parameters</title>

        <variablelist>
            <varlistentry>
                <term>
                    <parameter>n</parameter>
                </term>
                <listitem>
                    <para>Specifies the number of buffer objects to be
                    deleted.</para>
                </listitem>
            </varlistentry>

            <varlistentry>
                <term>
                    <parameter>buffers</parameter>
                </term>
                <listitem>
                    <para>Specifies an array of buffer object names to be
                    deleted.</para>
                </listitem>
            </varlistentry>
        </variablelist>


    </refsect1>

    <refsect1 id="description"><title>Description</title>

        <para>
        <function>glDeleteBuffers</function>
        deletes <parameter>n</parameter>
        buffer objects named by the elements of the array
        <parameter>buffers</parameter>.
        After a buffer object is deleted, it has no contents,
        and its name is free for reuse.</para>

        <para><function>glDeleteBuffers</function>
        silently ignores <constant>zero</constant> and names that do not correspond to
        existing buffer objects.</para>
    </refsect1>

    <refsect1 id="notes"><title>Notes</title>

        <para>
        If a buffer object is deleted while it is bound, all
        bindings to that object in the current context (i.e. in the thread that called
        <function>glDeleteBuffers</function>) are reset to zero.
        Bindings to that buffer in other contexts and other
        threads are not affected, but attempting to use a deleted buffer in another thread
        produces undefined results, including but not limited to possible GL errors and
        rendering corruption. Using a deleted buffer in another context or thread may not,
        however, result in program termination.
        </para>

    </refsect1>

    <refsect1 id="errors"><title>Errors</title>

        <para><constant>GL_INVALID_VALUE</constant> is generated if
        <parameter>n</parameter> is negative.</para>
    </refsect1>

    <refsect1 id="associatedgets"><title>Associated Gets</title>

        <para>
            <citerefentry><refentrytitle>glIsBuffer</refentrytitle></citerefentry>
        </para>
    </refsect1>

    <refsect1 id="seealso"><title>See Also</title>

        <para>
        <citerefentry><refentrytitle>glBufferData</refentrytitle></citerefentry>,
        <citerefentry><refentrytitle>glBufferSubData</refentrytitle></citerefentry>,
        <citerefentry><refentrytitle>glBindBuffer</refentrytitle></citerefentry>,
        <citerefentry><refentrytitle>glGenBuffers</refentrytitle></citerefentry>
        </para>
    </refsect1>

    <refsect1 id="copyright"><title>Copyright</title>
        <para>
            Copyright <trademark class="copyright"></trademark> 2003-2004
            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>
