org.lwjgl.opengles

Class EXTMapBufferRange

java.lang.Object

org.lwjgl.opengles.EXTMapBufferRange

public class EXTMapBufferRange
extends java.lang.Object

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 GLES 2.0 and OES_mapbuffer.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_MAP_FLUSH_EXPLICIT_BIT_EXT Accepted by the access parameter of MapBufferRangeEXT.
static int	GL_MAP_INVALIDATE_BUFFER_BIT_EXT Accepted by the access parameter of MapBufferRangeEXT.
static int	GL_MAP_INVALIDATE_RANGE_BIT_EXT Accepted by the access parameter of MapBufferRangeEXT.
static int	GL_MAP_READ_BIT_EXT Accepted by the access parameter of MapBufferRangeEXT.
static int	GL_MAP_UNSYNCHRONIZED_BIT_EXT Accepted by the access parameter of MapBufferRangeEXT.
static int	GL_MAP_WRITE_BIT_EXT Accepted by the access parameter of MapBufferRangeEXT.

Method Summary

Modifier and Type	Method and Description
static void	glFlushMappedBufferRangeEXT(int target, long offset, long length)
static java.nio.ByteBuffer	glMapBufferRangeEXT(int target, long offset, long length, int access)
static java.nio.ByteBuffer	glMapBufferRangeEXT(int target, long offset, long length, int access, java.nio.ByteBuffer old_buffer)
static long	nglMapBufferRangeEXT(int target, long offset, long length, int access)

Methods inherited from class java.lang.Object

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

Field Detail

GL_MAP_READ_BIT_EXT

public static final int GL_MAP_READ_BIT_EXT

Accepted by the access parameter of MapBufferRangeEXT.

See Also:

Constant Field Values

GL_MAP_WRITE_BIT_EXT

public static final int GL_MAP_WRITE_BIT_EXT

Accepted by the access parameter of MapBufferRangeEXT.

See Also:

Constant Field Values

GL_MAP_INVALIDATE_RANGE_BIT_EXT

public static final int GL_MAP_INVALIDATE_RANGE_BIT_EXT

Accepted by the access parameter of MapBufferRangeEXT.

See Also:

Constant Field Values

GL_MAP_INVALIDATE_BUFFER_BIT_EXT

public static final int GL_MAP_INVALIDATE_BUFFER_BIT_EXT

Accepted by the access parameter of MapBufferRangeEXT.

See Also:

Constant Field Values

GL_MAP_FLUSH_EXPLICIT_BIT_EXT

public static final int GL_MAP_FLUSH_EXPLICIT_BIT_EXT

Accepted by the access parameter of MapBufferRangeEXT.

See Also:

Constant Field Values

GL_MAP_UNSYNCHRONIZED_BIT_EXT

public static final int GL_MAP_UNSYNCHRONIZED_BIT_EXT

Accepted by the access parameter of MapBufferRangeEXT.

See Also:

Constant Field Values

Method Detail

nglMapBufferRangeEXT

public static long nglMapBufferRangeEXT(int target,
                                        long offset,
                                        long length,
                                        int access)

glMapBufferRangeEXT

@Nullable
public static java.nio.ByteBuffer glMapBufferRangeEXT(int target,
                                                                long offset,
                                                                long length,
                                                                int access)

glMapBufferRangeEXT

@Nullable
public static java.nio.ByteBuffer glMapBufferRangeEXT(int target,
                                                                long offset,
                                                                long length,
                                                                int access,
                                                                @Nullable
                                                                java.nio.ByteBuffer old_buffer)

glFlushMappedBufferRangeEXT

public static void glFlushMappedBufferRangeEXT(int target,
                                               long offset,
                                               long length)