org.lwjgl.opengl

Class NVPrimitiveRestart

java.lang.Object

org.lwjgl.opengl.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 and 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.

Method Summary

Modifier and Type	Method and Description
static void	glPrimitiveRestartIndexNV(int index)
static void	glPrimitiveRestartNV()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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)