org.lwjgl.opengles

Class NVDrawInstanced

java.lang.Object

org.lwjgl.opengles.NVDrawInstanced

public class NVDrawInstanced
extends java.lang.Object

Native bindings to the NV_draw_instanced 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 limiting the number of required API calls, and keeping the amount of duplicate data to a minimum.

This extension introduces two draw calls which are conceptually equivalent to a series of draw calls. Each conceptual call in this series is considered an "instance" of the actual draw call.

This extension also introduces a read-only built-in variable to GLSL which contains the "instance ID." This variable initially contains 0, but increases by one after each conceptual draw call.

By using the instance ID or multiples thereof as an index into a uniform array containing transform data, vertex shaders can draw multiple instances of an object with a single draw call.

Requires GLES 2.0.

Method Summary

Modifier and Type	Method and Description
static void	glDrawArraysInstancedNV(int mode, int first, int count, int primcount)
static void	glDrawElementsInstancedNV(int mode, java.nio.ByteBuffer indices, int primcount)
static void	glDrawElementsInstancedNV(int mode, java.nio.IntBuffer indices, int primcount)
static void	glDrawElementsInstancedNV(int mode, int type, java.nio.ByteBuffer indices, int primcount)
static void	glDrawElementsInstancedNV(int mode, int count, int type, long indices, int primcount)
static void	glDrawElementsInstancedNV(int mode, java.nio.ShortBuffer indices, int primcount)
static void	nglDrawElementsInstancedNV(int mode, int count, int type, long indices, int primcount) Unsafe version of: DrawElementsInstancedNV

Methods inherited from class java.lang.Object

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

Method Detail

glDrawArraysInstancedNV

public static void glDrawArraysInstancedNV(int mode,
                                           int first,
                                           int count,
                                           int primcount)

nglDrawElementsInstancedNV

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

Unsafe version of: DrawElementsInstancedNV

Parameters:

type - UNSIGNED_BYTE UNSIGNED_SHORT UNSIGNED_INT

glDrawElementsInstancedNV

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

Parameters:

type - UNSIGNED_BYTE UNSIGNED_SHORT UNSIGNED_INT

glDrawElementsInstancedNV

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

Parameters:

type - UNSIGNED_BYTE UNSIGNED_SHORT UNSIGNED_INT

glDrawElementsInstancedNV

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

glDrawElementsInstancedNV

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

glDrawElementsInstancedNV

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