org.lwjgl.opengles

Class EXTInstancedArrays

java.lang.Object

org.lwjgl.opengles.EXTInstancedArrays

public class EXTInstancedArrays
extends java.lang.Object

Native bindings to the EXT_instanced_arrays extension.

A common use case in GL for some applications is to be able to draw the same object, or groups of similar objects that share vertex data, primitive count and type, multiple times. This extension provides a means of accelerating such use cases while reducing the number of API calls, and keeping the amount of duplicate data to a minimum.

This extension introduces an array "divisor" for generic vertex array attributes, which when non-zero specifies that the attribute is "instanced." An instanced attribute does not advance per-vertex as usual, but rather after every divisor conceptual draw calls.

(Attributes which aren't instanced are repeated in their entirety for every conceptual draw call.)

By specifying transform data in an instanced attribute or series of instanced attributes, vertex shaders can, in concert with the instancing draw calls, draw multiple instances of an object with one draw call.

Requires GLES 2.0.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_VERTEX_ATTRIB_ARRAY_DIVISOR_EXT Accepted by the pname parameters of GetVertexAttribfv and GetVertexAttribiv.

Method Summary

Modifier and Type	Method and Description
static void	glDrawArraysInstancedEXT(int mode, int start, int count, int primcount)
static void	glDrawElementsInstancedEXT(int mode, java.nio.ByteBuffer indices, int primcount)
static void	glDrawElementsInstancedEXT(int mode, java.nio.IntBuffer indices, int primcount)
static void	glDrawElementsInstancedEXT(int mode, int type, java.nio.ByteBuffer indices, int primcount)
static void	glDrawElementsInstancedEXT(int mode, int count, int type, long indices, int primcount)
static void	glDrawElementsInstancedEXT(int mode, java.nio.ShortBuffer indices, int primcount)
static void	glVertexAttribDivisorEXT(int index, int divisor)
static void	nglDrawElementsInstancedEXT(int mode, int count, int type, long indices, int primcount)

Methods inherited from class java.lang.Object

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

Field Detail

GL_VERTEX_ATTRIB_ARRAY_DIVISOR_EXT

public static final int GL_VERTEX_ATTRIB_ARRAY_DIVISOR_EXT

Accepted by the pname parameters of GetVertexAttribfv and GetVertexAttribiv.

See Also:

Constant Field Values

Method Detail

glDrawArraysInstancedEXT

public static void glDrawArraysInstancedEXT(int mode,
                                            int start,
                                            int count,
                                            int primcount)

nglDrawElementsInstancedEXT

public static void nglDrawElementsInstancedEXT(int mode,
                                               int count,
                                               int type,
                                               long indices,
                                               int primcount)

glDrawElementsInstancedEXT

public static void glDrawElementsInstancedEXT(int mode,
                                              int count,
                                              int type,
                                              long indices,
                                              int primcount)

glDrawElementsInstancedEXT

public static void glDrawElementsInstancedEXT(int mode,
                                              int type,
                                              java.nio.ByteBuffer indices,
                                              int primcount)

glDrawElementsInstancedEXT

public static void glDrawElementsInstancedEXT(int mode,
                                              java.nio.ByteBuffer indices,
                                              int primcount)

glDrawElementsInstancedEXT

public static void glDrawElementsInstancedEXT(int mode,
                                              java.nio.ShortBuffer indices,
                                              int primcount)

glDrawElementsInstancedEXT

public static void glDrawElementsInstancedEXT(int mode,
                                              java.nio.IntBuffer indices,
                                              int primcount)

glVertexAttribDivisorEXT

public static void glVertexAttribDivisorEXT(int index,
                                            int divisor)