glBindTransformFeedback - OpenGL 4 Reference Pages

## Name

glBindTransformFeedback — bind a transform feedback object

## C Specification

`void glBindTransformFeedback(` | GLenum target,
| GLuint id`)`;

## Parameters

`target`

  Specifies the target to which to bind the transform feedback object `id`. `target` must be `GL_TRANSFORM_FEEDBACK`.

`id`

  Specifies the name of a transform feedback object reserved by glGenTransformFeedbacks.

## Description

`glBindTransformFeedback` binds the transform feedback object with name `id` to the current GL state. `id` must be a name previously returned from a call to glGenTransformFeedbacks. If `id` has not previously been bound, a new transform feedback object with name `id` and initialized with with the default transform state vector is created.

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.

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.

## Errors

`GL_INVALID_ENUM` is generated if `target` is not `GL_TRANSFORM_FEEDBACK`.

`GL_INVALID_OPERATION` is generated if the transform feedback operation is active on the currently bound transform feedback object, and that operation is not paused.

`GL_INVALID_OPERATION` is generated if `id` is not zero or the name of a transform feedback object returned from a previous call to glGenTransformFeedbacks, or if such a name has been deleted by glDeleteTransformFeedbacks.

## Associated Gets

glGet with argument `GL_TRANSFORM_FEEDBACK_BINDING`

## Version Support

| OpenGL Version
--- | ---
Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5
`glBindTransformFeedback` | - | - | - | - | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔

## See Also

glGenTransformFeedbacks, glDeleteTransformFeedbacks, glIsTransformFeedback, glBeginTransformFeedback, glPauseTransformFeedback, glResumeTransformFeedback, `glEndTransformFeedback`

## Copyright

Copyright © 2010-2014 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. http://opencontent.org/openpub/.