upstream-man-pages/man4/xhtml/glBindTransformFeedback.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
   3 <!-- saved from url=(0013)about:internet -->
   4 <?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glBindTransformFeedback - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glBindTransformFeedback"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glBindTransformFeedback — bind a transform feedback object</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glBindTransformFeedback</b>(</code></td><td>GLenum  </td><td><var class="pdparam">target</var>, </td></tr><tr><td> </td><td>GLuint  </td><td><var class="pdparam">id</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>target</code></em></span></dt><dd><p>
   5                     Specifies the target to which to bind the transform feedback object <em class="parameter"><code>id</code></em>. <em class="parameter"><code>target</code></em>
   6                     must be <code class="constant">GL_TRANSFORM_FEEDBACK</code>.
   7                 </p></dd><dt><span class="term"><em class="parameter"><code>id</code></em></span></dt><dd><p>
   8                     Specifies the name of a transform feedback object reserved by <a href="glGenTransformFeedbacks.xml"><span class="citerefentry"><span class="refentrytitle">glGenTransformFeedbacks</span></span></a>.
   9                 </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
  10             <code class="function">glBindTransformFeedback</code> binds the transform feedback object with name <em class="parameter"><code>id</code></em> to the current
  11             GL state. <em class="parameter"><code>id</code></em> must be a name previously returned from a call to
  12             <a href="glGenTransformFeedbacks.xml"><span class="citerefentry"><span class="refentrytitle">glGenTransformFeedbacks</span></span></a>. If <em class="parameter"><code>id</code></em> has not
  13             previously been bound, a new transform feedback object with name <em class="parameter"><code>id</code></em> and initialized with with the
  14             default transform state vector is created.
  15         </p><p>
  16             In the initial state, a default transform feedback object is bound and treated as
  17             a transform feedback object with a name of zero. If the name zero is subsequently bound, the default
  18             transform feedback object is again bound to the GL state.
  19         </p><p>
  20             While a transform feedback buffer object is bound, GL operations on the target
  21             to which it is bound affect the bound transform feedback object, and queries of the
  22             target to which a transform feedback object is bound return state from the bound
  23             object. When buffer objects are bound for transform feedback, they are attached to
  24             the currently bound transform feedback object. Buffer objects are used for trans-
  25             form feedback only if they are attached to the currently bound transform feedback
  26             object.
  27         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
  28             <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>target</code></em> is not <code class="constant">GL_TRANSFORM_FEEDBACK</code>.
  29         </p><p>
  30             <code class="constant">GL_INVALID_OPERATION</code> is generated if the transform feedback operation is
  31             active on the currently bound transform feedback object, and that operation is not paused.
  32         </p><p>
  33             <code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>id</code></em> is not
  34             zero or the name of a transform feedback object returned from a previous call to
  35             <a href="glGenTransformFeedbacks.xml"><span class="citerefentry"><span class="refentrytitle">glGenTransformFeedbacks</span></span></a>, or
  36             if such a name has been deleted by <a href="glDeleteTransformFeedbacks.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteTransformFeedbacks</span></span></a>.
  37         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
  38             <a href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a> with argument <code class="constant">GL_TRANSFORM_FEEDBACK_BINDING</code>
  39         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
  40             <a href="glGenTransformFeedbacks.xml"><span class="citerefentry"><span class="refentrytitle">glGenTransformFeedbacks</span></span></a>,
  41             <a href="glDeleteTransformFeedbacks.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteTransformFeedbacks</span></span></a>,
  42             <a href="glIsTransformFeedback.xml"><span class="citerefentry"><span class="refentrytitle">glIsTransformFeedback</span></span></a>,
  43             <a href="glBeginTransformFeedback.xml"><span class="citerefentry"><span class="refentrytitle">glBeginTransformFeedback</span></span></a>,
  44             <a href="glPauseTransformFeedback.xml"><span class="citerefentry"><span class="refentrytitle">glPauseTransformFeedback</span></span></a>,
  45             <a href="glResumeTransformFeedback.xml"><span class="citerefentry"><span class="refentrytitle">glResumeTransformFeedback</span></span></a>,
  46             <a href="glEndTransformFeedback.xml"><span class="citerefentry"><span class="refentrytitle">glEndTransformFeedback</span></span></a>
  47         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
  48             Copyright <span class="trademark"></span>© 2010 Khronos Group.
  49             This material may be distributed subject to the terms and conditions set forth in
  50             the Open Publication License, v 1.0, 8 June 1999.
  51             <a href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
  52         </p></div></div></body></html>