Lighweight Java Game Library 2.9.3 · org.lwjgl.opengl.ATIMapObjectBuffer

Access	Constructor and Description
private	ATIMapObjectBuffer()

Method Summary

Modifier and Type	Method and Description
public static ByteBuffer	Returns: A ByteBuffer representing the mapped buffer memory. glMapObjectBufferATI(int the length of the mapped memory in bytes. buffer, ByteBuffer A ByteBuffer. If this argument points to the same address and has the same capacity as the new mapping, it will be returned and no new buffer will be created. old_buffer) glMapObjectBufferATI maps an ATI vertex array object to a ByteBuffer.
public static ByteBuffer	Returns: A ByteBuffer representing the mapped buffer memory. glMapObjectBufferATI(int buffer, long the length of the mapped memory in bytes. length, ByteBuffer A ByteBuffer. If this argument points to the same address and has the same capacity as the new mapping, it will be returned and no new buffer will be created. old_buffer) glMapObjectBufferATI maps an ATI vertex array object to a ByteBuffer.
public static void	glUnmapObjectBufferATI(int buffer)
pack-priv static native ByteBuffer	nglMapObjectBufferATI(int buffer, long result_size, ByteBuffer old_buffer, long function_pointer)
pack-priv static native void	nglUnmapObjectBufferATI(int buffer, long function_pointer)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

ATIMapObjectBuffer	back to summary
private ATIMapObjectBuffer()

Method Detail

glMapObjectBufferATI	back to summary
public static ByteBuffer glMapObjectBufferATI(int buffer, ByteBuffer old_buffer) glMapObjectBufferATI maps an ATI vertex array object to a ByteBuffer. The old_buffer argument can be null, in which case a new ByteBuffer will be created, pointing to the returned memory. If old_buffer is non-null, it will be returned if it points to the same mapped memory and has the same capacity as the vertex array object, otherwise a new ByteBuffer is created. That way, an application will normally use glMapObjectBufferATI like this: ByteBuffer mapped_buffer; mapped_buffer = glMapObjectBufferATI(..., null); ... // Another map on the same buffer mapped_buffer = glMapObjectBufferATI(..., mapped_buffer); Only ByteBuffers returned from this method are to be passed as the old_buffer argument. User-created ByteBuffers cannot be reused. The version of this method without an explicit length argument calls glGetObjectBufferATI internally to retrieve the current vertex array object size, which may cause a pipeline flush and reduce application performance. The version of this method with an explicit length argument is a fast alternative to the one without. No GL call is made to retrieve the vertex array object size, so the user is responsible for tracking and using the appropriate length. Security warning: The length argument should match the vertex array object size. Reading from or writing to outside the memory region that corresponds to the mapped vertex array object will cause native crashes. Parameters buffer:int the length of the mapped memory in bytes. old_buffer:ByteBuffer A ByteBuffer. If this argument points to the same address and has the same capacity as the new mapping, it will be returned and no new buffer will be created. Returns:ByteBuffer A ByteBuffer representing the mapped buffer memory.

glMapObjectBufferATI

back to summary

public static ByteBuffer glMapObjectBufferATI(int buffer, ByteBuffer old_buffer)

glMapObjectBufferATI maps an ATI vertex array object to a ByteBuffer. The old_buffer argument can be null, in which case a new ByteBuffer will be created, pointing to the returned memory. If old_buffer is non-null, it will be returned if it points to the same mapped memory and has the same capacity as the vertex array object, otherwise a new ByteBuffer is created. That way, an application will normally use glMapObjectBufferATI like this:

ByteBuffer mapped_buffer; mapped_buffer = glMapObjectBufferATI(..., null); ... // Another map on the same buffer mapped_buffer = glMapObjectBufferATI(..., mapped_buffer);

Only ByteBuffers returned from this method are to be passed as the old_buffer argument. User-created ByteBuffers cannot be reused.

The version of this method without an explicit length argument calls glGetObjectBufferATI internally to retrieve the current vertex array object size, which may cause a pipeline flush and reduce application performance.

The version of this method with an explicit length argument is a fast alternative to the one without. No GL call is made to retrieve the vertex array object size, so the user is responsible for tracking and using the appropriate length.
Security warning: The length argument should match the vertex array object size. Reading from or writing to outside the memory region that corresponds to the mapped vertex array object will cause native crashes.

Parameters

buffer:int

the length of the mapped memory in bytes.

old_buffer:ByteBuffer

A ByteBuffer. If this argument points to the same address and has the same capacity as the new mapping, it will be returned and no new buffer will be created.

Returns:ByteBuffer

A ByteBuffer representing the mapped buffer memory.

glMapObjectBufferATI	back to summary
public static ByteBuffer glMapObjectBufferATI(int buffer, long length, ByteBuffer old_buffer) glMapObjectBufferATI maps an ATI vertex array object to a ByteBuffer. The old_buffer argument can be null, in which case a new ByteBuffer will be created, pointing to the returned memory. If old_buffer is non-null, it will be returned if it points to the same mapped memory and has the same capacity as the vertex array object, otherwise a new ByteBuffer is created. That way, an application will normally use glMapObjectBufferATI like this: ByteBuffer mapped_buffer; mapped_buffer = glMapObjectBufferATI(..., null); ... // Another map on the same buffer mapped_buffer = glMapObjectBufferATI(..., mapped_buffer); Only ByteBuffers returned from this method are to be passed as the old_buffer argument. User-created ByteBuffers cannot be reused. The version of this method without an explicit length argument calls glGetObjectBufferATI internally to retrieve the current vertex array object size, which may cause a pipeline flush and reduce application performance. The version of this method with an explicit length argument is a fast alternative to the one without. No GL call is made to retrieve the vertex array object size, so the user is responsible for tracking and using the appropriate length. Security warning: The length argument should match the vertex array object size. Reading from or writing to outside the memory region that corresponds to the mapped vertex array object will cause native crashes. Parameters length:long the length of the mapped memory in bytes. old_buffer:ByteBuffer A ByteBuffer. If this argument points to the same address and has the same capacity as the new mapping, it will be returned and no new buffer will be created. Returns:ByteBuffer A ByteBuffer representing the mapped buffer memory.