Package org.lwjgl.opengl

Class ARBTransformFeedback2


  • public class ARBTransformFeedback2
extends java.lang.Object
    Native bindings to the ARB_transform_feedback2 extension.

    The EXT_transform_feedback extension allows applications to capture primitives to one or more buffer objects when transformed by the GL. This extension provides a few additional capabilities to these extensions, making transform feedback mode more useful.

    First, it provides transform feedback objects which encapsulate transform feedback-related state, allowing applications to replace the entire transform feedback configuration in a single bind call. Second, it provides the ability to pause and resume transform feedback operations. When transform feedback is paused, applications may render without transform feedback or may use transform feedback with different state and a different transform feedback object. When transform feedback is resumed, additional primitives are captured and appended to previously captured primitives for the object.

    Additionally, this extension provides the ability to draw primitives captured in transform feedback mode without querying the captured primitive count. The command DrawTransformFeedback is equivalent to glDrawArrays(<mode>, 0, <count>), where count is the number of vertices captured to buffer objects during the last transform feedback capture operation on the transform feedback object used. This draw operation only provides a vertex count -- it does not automatically set up vertex array state or vertex buffer object bindings, which must be done separately by the application.

    Requires GL20 or ARB_shader_objects and NV_transform_feedback or EXT_transform_feedback. Promoted to core in OpenGL 4.0.

    • Method Detail

      • glBindTransformFeedback

        public static void glBindTransformFeedback(int target,
                                           int id)
        Binds a transform feedback object.
        Parameters:
        target - the target to which to bind the transform feedback object id. Must be:
        TRANSFORM_FEEDBACK
        id - the name of a transform feedback object

      • glDeleteTransformFeedbacks

        public static void glDeleteTransformFeedbacks(java.nio.IntBuffer ids)
        Deletes transform feedback objects.
        Parameters:
        ids - an array of names of transform feedback objects to delete

      • glDeleteTransformFeedbacks

        public static void glDeleteTransformFeedbacks(int id)
        Deletes transform feedback objects.

      • glGenTransformFeedbacks

        public static void glGenTransformFeedbacks(java.nio.IntBuffer ids)
        Reserves transform feedback object names.
        Parameters:
        ids - an array of into which the reserved names will be written

      • glGenTransformFeedbacks

        public static int glGenTransformFeedbacks()
        Reserves transform feedback object names.

      • glIsTransformFeedback

        public static boolean glIsTransformFeedback(int id)
        Determines if a name corresponds to a transform feedback object.
        Parameters:
        id - a value that may be the name of a transform feedback object

      • glPauseTransformFeedback

        public static void glPauseTransformFeedback()
        Pauses transform feedback operations for the currently bound transform feedback object.

        When transform feedback operations are paused, transform feedback is still considered active and changing most transform feedback state related to the object results in an error. However, a new transform feedback object may be bound while transform feedback is paused. The error INVALID_OPERATION is generated by PauseTransformFeedback if the currently bound transform feedback is not active or is paused.

        When transform feedback is active and not paused, all geometric primitives generated must be compatible with the value of primitiveMode passed to BeginTransformFeedback. The error INVALID_OPERATION is generated by Begin or any operation that implicitly calls Begin (such as DrawElements) if mode is not one of the allowed modes. If a geometry shader is active, its output primitive type is used instead of the mode parameter passed to Begin for the purposes of this error check. Any primitive type may be used while transform feedback is paused.

      • glResumeTransformFeedback

        public static void glResumeTransformFeedback()
        Resumes transform feedback operations for the currently bound transform feedback object.

        The error INVALID_OPERATION is generated by ResumeTransformFeedback if the currently bound transform feedback is not active or is not paused.

      • glDeleteTransformFeedbacks

        public static void glDeleteTransformFeedbacks(int[] ids)
        Array version of: DeleteTransformFeedbacks

      • glGenTransformFeedbacks

        public static void glGenTransformFeedbacks(int[] ids)
        Array version of: GenTransformFeedbacks