org.lwjgl.opengles.EXTMapBufferRange Maven / Gradle / Ivy
Show all versions of lwjgl-opengles Show documentation
/*
* 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 static org.lwjgl.system.Checks.*;
import static org.lwjgl.system.JNI.*;
import static org.lwjgl.system.MemoryUtil.*;
/**
* Native bindings to the EXT_map_buffer_range extension.
*
* EXT_map_buffer_range expands the buffer object API to allow greater performance when a client application only needs to write to a sub-range of a
* buffer object. To that end, this extension introduces two new buffer object features: non-serialized buffer modification and explicit sub-range
* flushing for mapped buffer objects.
*
* OpenGL requires that commands occur in a FIFO manner meaning that any changes to buffer objects either block until the data has been processed by the
* OpenGL pipeline or else create extra copies to avoid such a block. By providing a method to asynchronously modify buffer object data, an application is
* then able to manage the synchronization points themselves and modify ranges of data contained by a buffer object even though OpenGL might still be
* using other parts of it.
*
* This extension also provides a method for explicitly flushing ranges of a mapped buffer object so OpenGL does not have to assume that the entire range
* may have been modified. Further, it allows the application to more precisely specify its intent with respect to reading, writing, and whether the
* previous contents of a mapped range of interest need be preserved prior to modification.
*
* Requires {@link GLES20 GLES 2.0} and {@link OESMapbuffer OES_mapbuffer}.
*/
public class EXTMapBufferRange {
/** Accepted by the {@code access} parameter of MapBufferRangeEXT. */
public static final int
GL_MAP_READ_BIT_EXT = 0x1,
GL_MAP_WRITE_BIT_EXT = 0x2,
GL_MAP_INVALIDATE_RANGE_BIT_EXT = 0x4,
GL_MAP_INVALIDATE_BUFFER_BIT_EXT = 0x8,
GL_MAP_FLUSH_EXPLICIT_BIT_EXT = 0x10,
GL_MAP_UNSYNCHRONIZED_BIT_EXT = 0x20;
protected EXTMapBufferRange() {
throw new UnsupportedOperationException();
}
static boolean isAvailable(GLESCapabilities caps) {
return checkFunctions(
caps.glMapBufferRangeEXT, caps.glFlushMappedBufferRangeEXT
);
}
// --- [ glMapBufferRangeEXT ] ---
public static long nglMapBufferRangeEXT(int target, long offset, long length, int access) {
long __functionAddress = GLES.getCapabilities().glMapBufferRangeEXT;
if ( CHECKS )
checkFunctionAddress(__functionAddress);
return callPPP(__functionAddress, target, offset, length, access);
}
public static ByteBuffer glMapBufferRangeEXT(int target, long offset, long length, int access) {
long __result = nglMapBufferRangeEXT(target, offset, length, access);
return memByteBuffer(__result, (int)length);
}
public static ByteBuffer glMapBufferRangeEXT(int target, long offset, long length, int access, ByteBuffer old_buffer) {
long __result = nglMapBufferRangeEXT(target, offset, length, access);
return old_buffer == null ? memByteBuffer(__result, (int)length) : memSetupBuffer(old_buffer, __result, (int)length);
}
// --- [ glFlushMappedBufferRangeEXT ] ---
public static void glFlushMappedBufferRangeEXT(int target, long offset, long length) {
long __functionAddress = GLES.getCapabilities().glFlushMappedBufferRangeEXT;
if ( CHECKS )
checkFunctionAddress(__functionAddress);
callPPV(__functionAddress, target, offset, length);
}
}