<?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="glBindFramebuffer"> <refentryinfo> <copyright> <year>2010-2013</year> <holder>Khronos Group</holder> </copyright> </refentryinfo> <refmeta> <refentrytitle>glBindFramebuffer</refentrytitle> <manvolnum>3G</manvolnum> </refmeta> <refnamediv> <refname>glBindFramebuffer</refname> <refpurpose>bind a framebuffer to a framebuffer target</refpurpose> </refnamediv> <refsynopsisdiv><title>C Specification</title> <funcsynopsis> <funcprototype> <funcdef>void <function>glBindFramebuffer</function></funcdef> <paramdef>GLenum <parameter>target</parameter></paramdef> <paramdef>GLuint <parameter>framebuffer</parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1 id="parameters"><title>Parameters</title> <variablelist> <varlistentry> <term><parameter>target</parameter></term> <listitem> <para> Specifies the framebuffer target of the binding operation. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>framebuffer</parameter></term> <listitem> <para> Specifies the name of the framebuffer object to bind. </para> </listitem> </varlistentry> </variablelist> </refsect1> <refsect1 id="description"><title>Description</title> <para> <function>glBindFramebuffer</function> binds the framebuffer object with name <parameter>framebuffer</parameter> to the framebuffer target specified by <parameter>target</parameter>. <parameter>target</parameter> must be either <constant>GL_DRAW_FRAMEBUFFER</constant>, <constant>GL_READ_FRAMEBUFFER</constant> or <constant>GL_FRAMEBUFFER</constant>. If a framebuffer object is bound to <constant>GL_DRAW_FRAMEBUFFER</constant> or <constant>GL_READ_FRAMEBUFFER</constant>, it becomes the target for rendering or readback operations, respectively, until it is deleted or another framebuffer is bound to the corresponding bind point. Calling <function>glBindFramebuffer</function> with <parameter>target</parameter> set to <constant>GL_FRAMEBUFFER</constant> binds <parameter>framebuffer</parameter> to both the read and draw framebuffer targets. <parameter>framebuffer</parameter> is the name of a framebuffer object previously returned from a call to <citerefentry><refentrytitle>glGenFramebuffers</refentrytitle></citerefentry>, or zero to break the existing binding of a framebuffer object to <parameter>target</parameter>. </para> </refsect1> <refsect1 id="errors"><title>Errors</title> <para> <constant>GL_INVALID_ENUM</constant> is generated if <parameter>target</parameter> is not <constant>GL_DRAW_FRAMEBUFFER</constant>, <constant>GL_READ_FRAMEBUFFER</constant> or <constant>GL_FRAMEBUFFER</constant>. </para> <para> <constant>GL_INVALID_OPERATION</constant> is generated if <parameter>framebuffer</parameter> is not zero or the name of a framebuffer previously returned from a call to <citerefentry><refentrytitle>glGenFramebuffers</refentrytitle></citerefentry>. </para> </refsect1> <refsect1 id="seealso"><title>See Also</title> <para> <citerefentry><refentrytitle>glGenFramebuffers</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glDeleteFramebuffers</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glFramebufferRenderbuffer</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glFramebufferTexture</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glFramebufferTexture1D</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glFramebufferTexture2D</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glFramebufferTexture3D</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glFramebufferTextureFace</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glFramebufferTextureLayer</refentrytitle></citerefentry>, <citerefentry><refentrytitle>glIsFramebuffer</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>