org.andengine.opengl.vbo

Class SharedMemoryVertexBufferObject

java.lang.Object

org.andengine.opengl.vbo.ZeroMemoryVertexBufferObject

org.andengine.opengl.vbo.SharedMemoryVertexBufferObject

All Implemented Interfaces:

IVertexBufferObject, IDisposable

public abstract class SharedMemoryVertexBufferObject
extends ZeroMemoryVertexBufferObject

Compared to ZeroMemoryVertexBufferObject, all SharedMemoryVertexBufferObjects share a single ByteBuffer which is used by whichever SharedMemoryVertexBufferObject instance is currently buffering data, at the cost of expensive data buffering (up to 5x slower!) and a little synchronization overhead.

Usually a SharedMemoryVertexBufferObject is preferred to a ZeroMemoryVertexBufferObject when the following conditions need to be met:

1. Minimum amount of runtime GarbageCollector activity.

(c) Zynga 2011

Since:

19:22:13 - 10.02.2012

Nested Class Summary

Nested classes/interfaces inherited from interface org.andengine.util.IDisposable

IDisposable.AlreadyDisposedException

Field Summary

Fields inherited from class org.andengine.opengl.vbo.ZeroMemoryVertexBufferObject

mAutoDispose, mCapacity, mDirtyOnHardware, mDisposed, mHardwareBufferID, mUsage, mVertexBufferObjectAttributes, mVertexBufferObjectManager

Fields inherited from interface org.andengine.opengl.vbo.IVertexBufferObject

HARDWARE_BUFFER_ID_INVALID

Constructor Summary

Constructors

Constructor and Description
SharedMemoryVertexBufferObject(VertexBufferObjectManager pVertexBufferObjectManager, int pCapacity, DrawType pDrawType, VertexBufferObjectAttributes pVertexBufferObjectAttributes)

Method Summary

Modifier and Type	Method and Description
protected java.nio.ByteBuffer	aquireByteBuffer() When a non null ByteBuffer is returned by this function, it is guaranteed that ZeroMemoryVertexBufferObject.releaseByteBuffer(ByteBuffer) is called.
void	dispose()
static int	getSharedByteBufferByteCapacity()
protected void	releaseByteBuffer(java.nio.ByteBuffer byteBuffer)

Methods inherited from class org.andengine.opengl.vbo.ZeroMemoryVertexBufferObject

bind, bind, draw, draw, finalize, getByteCapacity, getCapacity, getGPUMemoryByteSize, getHardwareBufferID, getHeapMemoryByteSize, getNativeHeapMemoryByteSize, getVertexBufferObjectManager, isAutoDispose, isDirtyOnHardware, isDisposed, isLoadedToHardware, onPopulateBufferData, setDirtyOnHardware, setNotLoadedToHardware, unbind, unloadFromHardware

Methods inherited from class java.lang.Object

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

Constructor Detail

SharedMemoryVertexBufferObject

public SharedMemoryVertexBufferObject(VertexBufferObjectManager pVertexBufferObjectManager,
                                      int pCapacity,
                                      DrawType pDrawType,
                                      VertexBufferObjectAttributes pVertexBufferObjectAttributes)

Method Detail

getSharedByteBufferByteCapacity

public static int getSharedByteBufferByteCapacity()

dispose

public void dispose()

Specified by:

dispose in interface IDisposable

Overrides:

dispose in class ZeroMemoryVertexBufferObject

aquireByteBuffer

protected java.nio.ByteBuffer aquireByteBuffer()

Description copied from class: ZeroMemoryVertexBufferObject

When a non null ByteBuffer is returned by this function, it is guaranteed that ZeroMemoryVertexBufferObject.releaseByteBuffer(ByteBuffer) is called.

Overrides:

aquireByteBuffer in class ZeroMemoryVertexBufferObject

Returns:

a ByteBuffer to be passed to ZeroMemoryVertexBufferObject.onPopulateBufferData(ByteBuffer).

releaseByteBuffer

protected void releaseByteBuffer(java.nio.ByteBuffer byteBuffer)

Overrides:

releaseByteBuffer in class ZeroMemoryVertexBufferObject