Class NVPrimitiveRestart


  • public class NVPrimitiveRestart
    extends java.lang.Object
    Native bindings to the NV_primitive_restart extension.

    This extension allows applications to easily and inexpensively restart a primitive in its middle. A "primitive restart" is simply the same as an End command, followed by another Begin command with the same mode as the original. The typical expected use of this feature is to draw a mesh with many triangle strips, though primitive restarts are legal for all primitive types, even for points (where they are not useful).

    Although the EXT_multi_draw_arrays extension did reduce the overhead of such drawing techniques, they still remain more expensive than one would like.

    This extension provides an extremely lightweight primitive restart, which is accomplished by allowing the application to choose a special index number that signals that a primitive restart should occur, rather than a vertex being provoked. This index can be an arbitrary 32-bit integer for maximum application convenience.

    In addition, for full orthogonality, a special OpenGL command is provided to restart primitives when in immediate mode. This command is not likely to increase performance in any significant fashion, but providing it greatly simplifies the specification and implementation of display list compilation and indirect rendering.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int GL_PRIMITIVE_RESTART_INDEX_NV
      Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
      static int GL_PRIMITIVE_RESTART_NV
      Accepted by the array parameter of EnableClientState and DisableClientState, by the cap parameter of IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
    • Field Detail

      • GL_PRIMITIVE_RESTART_NV

        public static final int GL_PRIMITIVE_RESTART_NV
        Accepted by the array parameter of EnableClientState and DisableClientState, by the cap parameter of IsEnabled, and by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
        See Also:
        Constant Field Values
      • GL_PRIMITIVE_RESTART_INDEX_NV

        public static final int GL_PRIMITIVE_RESTART_INDEX_NV
        Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
        See Also:
        Constant Field Values
    • Method Detail

      • glPrimitiveRestartNV

        public static void glPrimitiveRestartNV()
      • glPrimitiveRestartIndexNV

        public static void glPrimitiveRestartIndexNV​(int index)