Package org.lwjgl.opengles

Class EXTMapBufferRange

java.lang.Object

org.lwjgl.opengles.EXTMapBufferRange

public class EXTMapBufferRange
extends 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	Description
static final int	GL_MAP_FLUSH_EXPLICIT_BIT_EXT	Accepted by the access parameter of MapBufferRangeEXT.
static final int	GL_MAP_INVALIDATE_BUFFER_BIT_EXT	Accepted by the access parameter of MapBufferRangeEXT.
static final int	GL_MAP_INVALIDATE_RANGE_BIT_EXT	Accepted by the access parameter of MapBufferRangeEXT.
static final int	GL_MAP_READ_BIT_EXT	Accepted by the access parameter of MapBufferRangeEXT.
static final int	GL_MAP_UNSYNCHRONIZED_BIT_EXT	Accepted by the access parameter of MapBufferRangeEXT.
static final int	GL_MAP_WRITE_BIT_EXT	Accepted by the access parameter of MapBufferRangeEXT.

Method Summary

Modifier and Type	Method	Description
static void	glFlushMappedBufferRangeEXT(int target, long offset, long length)
static ByteBuffer	glMapBufferRangeEXT(int target, long offset, long length, int access)
static ByteBuffer	glMapBufferRangeEXT(int target, long offset, long length, int access, 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 Details

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 Details

nglMapBufferRangeEXT

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

glMapBufferRangeEXT

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

glMapBufferRangeEXT

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

glFlushMappedBufferRangeEXT

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