org.lwjgl.opengles.EXTDrawElementsBaseVertex Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of lwjgl-opengles Show documentation
Show all versions of lwjgl-opengles Show documentation
A royalty-free, cross-platform API for full-function 2D and 3D graphics on embedded systems - including consoles, phones, appliances and vehicles.
/*
* Copyright LWJGL. All rights reserved.
* License terms: https://www.lwjgl.org/license
* MACHINE GENERATED FILE, DO NOT EDIT
*/
package org.lwjgl.opengles;
import java.nio.*;
import org.lwjgl.*;
import org.lwjgl.system.*;
import static org.lwjgl.system.Checks.*;
import static org.lwjgl.system.JNI.*;
import static org.lwjgl.system.MemoryUtil.*;
/**
* Native bindings to the EXT_draw_elements_base_vertex extension.
*
* This extension provides a method to specify a "base vertex offset" value which is effectively added to every vertex index that is transferred through
* {@link GLES20#glDrawElements DrawElements}.
*
* This mechanism can be used to decouple a set of indices from the actual vertex array that it is referencing. This is useful if an application stores
* multiple indexed models in a single vertex array. The same index array can be used to draw the model no matter where it ends up in a larger vertex array
* simply by changing the base vertex value. Without this functionality, it would be necessary to rebind all the vertex attributes every time geometry is
* switched and this can have larger performance penalty.
*
* For example consider the (very contrived and simple) example of drawing two triangles to form a quad. In the typical example you have the following
* setup:
*
*
* vertices indices
* ---------- -----
* 0 | (-1, 1) | 0 | 0 |
* 1 | (-1, -1) | 1 | 1 |
* 2 | ( 1, -1) | 2 | 2 |
* 3 | ( 1, 1) | 3 | 3 |
* ---------- 4 | 0 |
* 5 | 2 |
* -----
which is normally rendered with the call
*
*
* DrawElements(TRIANGLES, 6, UNSIGNED_BYTE, &indices).
Now consider the case where the vertices you want to draw are not at the start of a vertex array but are instead located at offset 100 into a larger
* array:
*
*
* vertices2 indices2
* ---------- -----
* .... 0 | 100 |
* 100 | (-1, 1) | 1 | 101 |
* 101 | (-1, -1) | 2 | 102 |
* 102 | ( 1, -1) | 3 | 103 |
* 103 | ( 1, 1) | 4 | 100 |
* .... 5 | 102 |
* ---------- -----
The typical choices for rendering this are to rebind your vertex attributes with an additional offset of 100*stride, or to create an new array of
* indices (as indices2 in the example). However both rebinding vertex attributes and rebuilding index arrays can be quite costly activities.
*
* With the new drawing commands introduced by this extension you can instead draw using vertices2 and the new draw call:
*
*
* DrawElementsBaseVertexEXT(TRIANGLES, 6, UNSIGNED_BYTE, &indices, 100)
Requires {@link GLES20 GLES 2.0}.
*/
public class EXTDrawElementsBaseVertex {
static { GLES.initialize(); }
protected EXTDrawElementsBaseVertex() {
throw new UnsupportedOperationException();
}
static boolean isAvailable(GLESCapabilities caps, java.util.Set ext) {
return checkFunctions(
caps.glDrawElementsBaseVertexEXT, ext.contains("GLES30") ? caps.glDrawRangeElementsBaseVertexEXT : -1L,
ext.contains("GLES30") ? caps.glDrawElementsInstancedBaseVertexEXT : -1L,
ext.contains("GL_EXT_multi_draw_arrays") ? caps.glMultiDrawElementsBaseVertexEXT : -1L
);
}
// --- [ glDrawElementsBaseVertexEXT ] ---
public static native void nglDrawElementsBaseVertexEXT(int mode, int count, int type, long indices, int basevertex);
public static void glDrawElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLsizei") int count, @NativeType("GLenum") int type, @NativeType("const void *") long indices, @NativeType("GLint") int basevertex) {
nglDrawElementsBaseVertexEXT(mode, count, type, indices, basevertex);
}
public static void glDrawElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLenum") int type, @NativeType("const void *") ByteBuffer indices, @NativeType("GLint") int basevertex) {
nglDrawElementsBaseVertexEXT(mode, indices.remaining() >> GLESChecks.typeToByteShift(type), type, memAddress(indices), basevertex);
}
public static void glDrawElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("const void *") ByteBuffer indices, @NativeType("GLint") int basevertex) {
nglDrawElementsBaseVertexEXT(mode, indices.remaining(), GLES20.GL_UNSIGNED_BYTE, memAddress(indices), basevertex);
}
public static void glDrawElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("const void *") ShortBuffer indices, @NativeType("GLint") int basevertex) {
nglDrawElementsBaseVertexEXT(mode, indices.remaining(), GLES20.GL_UNSIGNED_SHORT, memAddress(indices), basevertex);
}
public static void glDrawElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("const void *") IntBuffer indices, @NativeType("GLint") int basevertex) {
nglDrawElementsBaseVertexEXT(mode, indices.remaining(), GLES20.GL_UNSIGNED_INT, memAddress(indices), basevertex);
}
// --- [ glDrawRangeElementsBaseVertexEXT ] ---
public static native void nglDrawRangeElementsBaseVertexEXT(int mode, int start, int end, int count, int type, long indices, int basevertex);
public static void glDrawRangeElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLuint") int start, @NativeType("GLuint") int end, @NativeType("GLsizei") int count, @NativeType("GLenum") int type, @NativeType("const void *") long indices, @NativeType("GLint") int basevertex) {
nglDrawRangeElementsBaseVertexEXT(mode, start, end, count, type, indices, basevertex);
}
public static void glDrawRangeElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLuint") int start, @NativeType("GLuint") int end, @NativeType("GLenum") int type, @NativeType("const void *") ByteBuffer indices, @NativeType("GLint") int basevertex) {
nglDrawRangeElementsBaseVertexEXT(mode, start, end, indices.remaining() >> GLESChecks.typeToByteShift(type), type, memAddress(indices), basevertex);
}
public static void glDrawRangeElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLuint") int start, @NativeType("GLuint") int end, @NativeType("const void *") ByteBuffer indices, @NativeType("GLint") int basevertex) {
nglDrawRangeElementsBaseVertexEXT(mode, start, end, indices.remaining(), GLES20.GL_UNSIGNED_BYTE, memAddress(indices), basevertex);
}
public static void glDrawRangeElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLuint") int start, @NativeType("GLuint") int end, @NativeType("const void *") ShortBuffer indices, @NativeType("GLint") int basevertex) {
nglDrawRangeElementsBaseVertexEXT(mode, start, end, indices.remaining(), GLES20.GL_UNSIGNED_SHORT, memAddress(indices), basevertex);
}
public static void glDrawRangeElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLuint") int start, @NativeType("GLuint") int end, @NativeType("const void *") IntBuffer indices, @NativeType("GLint") int basevertex) {
nglDrawRangeElementsBaseVertexEXT(mode, start, end, indices.remaining(), GLES20.GL_UNSIGNED_INT, memAddress(indices), basevertex);
}
// --- [ glDrawElementsInstancedBaseVertexEXT ] ---
public static native void nglDrawElementsInstancedBaseVertexEXT(int mode, int count, int type, long indices, int instancecount, int basevertex);
public static void glDrawElementsInstancedBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLsizei") int count, @NativeType("GLenum") int type, @NativeType("const void *") long indices, @NativeType("GLsizei") int instancecount, @NativeType("GLint") int basevertex) {
nglDrawElementsInstancedBaseVertexEXT(mode, count, type, indices, instancecount, basevertex);
}
public static void glDrawElementsInstancedBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("GLenum") int type, @NativeType("const void *") ByteBuffer indices, @NativeType("GLsizei") int instancecount, @NativeType("GLint") int basevertex) {
nglDrawElementsInstancedBaseVertexEXT(mode, indices.remaining() >> GLESChecks.typeToByteShift(type), type, memAddress(indices), instancecount, basevertex);
}
public static void glDrawElementsInstancedBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("const void *") ByteBuffer indices, @NativeType("GLsizei") int instancecount, @NativeType("GLint") int basevertex) {
nglDrawElementsInstancedBaseVertexEXT(mode, indices.remaining(), GLES20.GL_UNSIGNED_BYTE, memAddress(indices), instancecount, basevertex);
}
public static void glDrawElementsInstancedBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("const void *") ShortBuffer indices, @NativeType("GLsizei") int instancecount, @NativeType("GLint") int basevertex) {
nglDrawElementsInstancedBaseVertexEXT(mode, indices.remaining(), GLES20.GL_UNSIGNED_SHORT, memAddress(indices), instancecount, basevertex);
}
public static void glDrawElementsInstancedBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("const void *") IntBuffer indices, @NativeType("GLsizei") int instancecount, @NativeType("GLint") int basevertex) {
nglDrawElementsInstancedBaseVertexEXT(mode, indices.remaining(), GLES20.GL_UNSIGNED_INT, memAddress(indices), instancecount, basevertex);
}
// --- [ glMultiDrawElementsBaseVertexEXT ] ---
public static native void nglMultiDrawElementsBaseVertexEXT(int mode, long count, int type, long indices, int primcount, long basevertex);
public static void glMultiDrawElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("const GLsizei *") IntBuffer count, @NativeType("GLenum") int type, @NativeType("const void * const *") PointerBuffer indices, @NativeType("const GLint *") IntBuffer basevertex) {
if (CHECKS) {
check(indices, count.remaining());
check(basevertex, count.remaining());
}
nglMultiDrawElementsBaseVertexEXT(mode, memAddress(count), type, memAddress(indices), count.remaining(), memAddress(basevertex));
}
/** Array version of: {@link #glMultiDrawElementsBaseVertexEXT MultiDrawElementsBaseVertexEXT} */
public static void glMultiDrawElementsBaseVertexEXT(@NativeType("GLenum") int mode, @NativeType("const GLsizei *") int[] count, @NativeType("GLenum") int type, @NativeType("const void * const *") PointerBuffer indices, @NativeType("const GLint *") int[] basevertex) {
long __functionAddress = GLES.getICD().glMultiDrawElementsBaseVertexEXT;
if (CHECKS) {
check(__functionAddress);
check(indices, count.length);
check(basevertex, count.length);
}
callPPPV(__functionAddress, mode, count, type, memAddress(indices), count.length, basevertex);
}
}