glutil

Class BufferUtils

java.lang.Object

glutil.BufferUtils

public final class BufferUtils
extends Object

BufferUtils is a helper class for generating nio buffers from jME data classes such as Vectors and ColorRGBA.

Version:

$Id: BufferUtils.java,v 1.16 2007/10/29 16:56:18 nca Exp $

Author:

Joshua Slack

Constructor Summary

Constructors

Constructor and Description
BufferUtils()

Method Summary

Modifier and Type	Method and Description
static Buffer	clone(Buffer buf) Creates a clone of the given buffer.
static ByteBuffer	createByteBuffer(int size) Create a new ByteBuffer of the specified size.
static void	destroyDirectBuffer(Buffer toBeDestroyed) Direct buffers are garbage collected by using a phantom reference and a reference queue.
static void	printCurrentDirectMemory(StringBuilder store)
static void	setTrackDirectMemoryEnabled(boolean enabled) Set it to true if you want to enable direct memory tracking for debugging purpose.

Methods inherited from class java.lang.Object

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

Constructor Detail

BufferUtils

public BufferUtils()

Method Detail

setTrackDirectMemoryEnabled

public static void setTrackDirectMemoryEnabled(boolean enabled)

Set it to true if you want to enable direct memory tracking for debugging purpose. Default is false. To print direct memory usage use BufferUtils.printCurrentDirectMemory(StringBuilder store);

Parameters:

enabled -

clone

public static Buffer clone(Buffer buf)

Creates a clone of the given buffer. The clone's capacity is equal to the given buffer's limit.

Parameters:

buf - The buffer to clone

Returns:

The cloned buffer

printCurrentDirectMemory

public static void printCurrentDirectMemory(StringBuilder store)

createByteBuffer

public static ByteBuffer createByteBuffer(int size)

Create a new ByteBuffer of the specified size.

Parameters:

size - required number of ints to store.

Returns:

the new IntBuffer

destroyDirectBuffer

public static void destroyDirectBuffer(Buffer toBeDestroyed)

Direct buffers are garbage collected by using a phantom reference and a reference queue. Every once a while, the JVM checks the reference queue and cleans the direct buffers. However, as this doesn't happen immediately after discarding all references to a direct buffer, it's easy to OutOfMemoryError yourself using direct buffers. This function explicitly calls the Cleaner method of a direct buffer.

Parameters:

toBeDestroyed - The direct buffer that will be "cleaned". Utilizes reflection.