WWBufferUtil (NASA World Wind)

java.lang.Object
- gov.nasa.worldwind.util.WWBufferUtil

```
public class WWBufferUtil
extends Object
```
A collection of useful Buffer methods, all static.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`SIZEOF_CHAR` The size of a char primitive type, in bytes.
`static int`	`SIZEOF_DOUBLE` The size of a double primitive type, in bytes.
`static int`	`SIZEOF_FLOAT` The size of a float primitive type, in bytes.
`static int`	`SIZEOF_INT` The size of a int primitive type, in bytes.
`static int`	`SIZEOF_SHORT` The size of a short primitive type, in bytes.

Constructor Summary

Constructors
Constructor and Description

WWBufferUtil()

Constructors
Constructor and Description
`WWBufferUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static double[]`	`computeExtremeValues(BufferWrapper buffer)` Returns the minimum and maximum floating point values in the specified buffer.
`static double[]`	`computeExtremeValues(BufferWrapper buffer, double missingDataSignal)` Returns the minimum and maximum floating point values in the specified buffer.
`static FloatBuffer`	`copyArrayToBuffer(Vec4[] array, FloatBuffer buffer)` Copies a specified array of vertices to a specified vertex buffer.
`static ByteBuffer`	`copyOf(ByteBuffer buffer, int newSize)` Returns a copy of the specified buffer, with the specified new size.
`static CharBuffer`	`copyOf(CharBuffer buffer, int newSize)` Returns a copy of the specified buffer, with the specified new size.
`static DoubleBuffer`	`copyOf(DoubleBuffer buffer, int newSize)` Returns a copy of the specified buffer, with the specified new size.
`static FloatBuffer`	`copyOf(FloatBuffer buffer, int newSize)` Returns a copy of the specified buffer, with the specified new size.
`static IntBuffer`	`copyOf(IntBuffer buffer, int newSize)` Returns a copy of the specified buffer, with the specified new size.
`static ShortBuffer`	`copyOf(ShortBuffer buffer, int newSize)` Returns a copy of the specified buffer, with the specified new size.
`static ByteBuffer`	`newByteBuffer(int size, boolean allocateDirect)` Allocates a new direct `ByteBuffer` of the specified size, in chars.
`static BufferWrapper`	`newByteBufferWrapper(int size, boolean allocateDirect)` Allocates a new `BufferWrapper` of the specified size, in bytes.
`static CharBuffer`	`newCharBuffer(int size, boolean allocateDirect)` Allocates a new direct `CharBuffer` of the specified size, in chars.
`protected static ByteBuffer`	`newDirectByteBuffer(int size)`
`static DoubleBuffer`	`newDoubleBuffer(int size, boolean allocateDirect)` Allocates a new direct `DoubleBuffer` of the specified size, in chars.
`static BufferWrapper`	`newDoubleBufferWrapper(int size, boolean allocateDirect)` Allocates a new `BufferWrapper` of the specified size, in doubles.
`static FloatBuffer`	`newFloatBuffer(int size, boolean allocateDirect)` Allocates a new direct `FloatBuffer` of the specified size, in chars.
`static BufferWrapper`	`newFloatBufferWrapper(int size, boolean allocateDirect)` Allocates a new `BufferWrapper` of the specified size, in floats.
`static IntBuffer`	`newIntBuffer(int size, boolean allocateDirect)` Allocates a new direct `IntBuffer` of the specified size, in chars.
`static BufferWrapper`	`newIntBufferWrapper(int size, boolean allocateDirect)` Allocates a new `BufferWrapper` of the specified size, in ints.
`static ShortBuffer`	`newShortBuffer(int size, boolean allocateDirect)` Allocates a new direct `ShortBuffer` of the specified size, in chars.
`static BufferWrapper`	`newShortBufferWrapper(int size, boolean allocateDirect)` Allocates a new `BufferWrapper` of the specified size, in shorts.
`static int`	`sizeOfPrimitiveType(Object dataType)` Returns the size in bytes of the specified primitive data type, or -1 if the specified type is unrecognized.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SIZEOF_CHAR
```
public static final int SIZEOF_CHAR
```
    The size of a char primitive type, in bytes.
    
    See Also:
    
    Constant Field Values
  - SIZEOF_DOUBLE
```
public static final int SIZEOF_DOUBLE
```
    The size of a double primitive type, in bytes.
    
    See Also:
    
    Constant Field Values
  - SIZEOF_FLOAT
```
public static final int SIZEOF_FLOAT
```
    The size of a float primitive type, in bytes.
    
    See Also:
    
    Constant Field Values
  - SIZEOF_INT
```
public static final int SIZEOF_INT
```
    The size of a int primitive type, in bytes.
    
    See Also:
    
    Constant Field Values
  - SIZEOF_SHORT
```
public static final int SIZEOF_SHORT
```
    The size of a short primitive type, in bytes.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - WWBufferUtil
```
public WWBufferUtil()
```
- Method Detail
  - computeExtremeValues
```
public static double[] computeExtremeValues(BufferWrapper buffer)
```
    Returns the minimum and maximum floating point values in the specified buffer. Values equivalent to Double.NaN are ignored. This returns null if the buffer is empty or contains only NaN values.
    
    Parameters:
    
    buffer - the buffer to search for the minimum and maximum values.
    
    Returns:
    
    an array containing the minimum value in index 0 and the maximum value in index 1, or null if the buffer is empty or contains only NaN values.
    
    Throws:
    
    IllegalArgumentException - if the buffer is null.
  - computeExtremeValues
```
public static double[] computeExtremeValues(BufferWrapper buffer,
                                            double missingDataSignal)
```
    Returns the minimum and maximum floating point values in the specified buffer. Values equivalent to the specified missingDataSignal are ignored. This returns null if the buffer is empty or contains only missing values.
    
    Parameters:
    
    buffer - the buffer to search for the minimum and maximum values.
    
    missingDataSignal - the number indicating a specific floating point value to ignore.
    
    Returns:
    
    an array containing the minimum value in index 0 and the maximum value in index 1, or null if the buffer is empty or contains only missing values.
    
    Throws:
    
    IllegalArgumentException - if the buffer is null.
  - copyArrayToBuffer
```
public static FloatBuffer copyArrayToBuffer(Vec4[] array,
                                            FloatBuffer buffer)
```
    Copies a specified array of vertices to a specified vertex buffer. This method calls Buffer.flip() prior to returning.
    
    Parameters:
    
    array - the vertices to copy.
    
    buffer - the buffer to copy the vertices to. Must have enough remaining space to hold the vertices.
    
    Returns:
    
    the buffer specified as input, with its limit incremented by the number of vertices copied, and its position set to 0.
  - copyOf
```
public static ByteBuffer copyOf(ByteBuffer buffer,
                                int newSize)
```
    Returns a copy of the specified buffer, with the specified new size. The new size must be greater than or equal to the specified buffer's size. If the new size is greater than the specified buffer's size, this returns a new buffer which is partially filled with the contents of the specified buffer.The returned buffer is a direct ByteBuffer if and only if the specified buffer is direct.
    
    Parameters:
    
    buffer - the buffer to copy.
    
    newSize - the new buffer's size, in bytes.
    
    Returns:
    
    the new buffer, with the specified size.
    
    Throws:
    
    IllegalArgumentException - if the buffer is null, if the new size is negative, or if the new size is less than the buffer's remaing elements.
  - copyOf
```
public static CharBuffer copyOf(CharBuffer buffer,
                                int newSize)
```
    Returns a copy of the specified buffer, with the specified new size. The new size must be greater than or equal to the specified buffer's size. If the new size is greater than the specified buffer's size, this returns a new buffer which is partially filled with the contents of the specified buffer. The returned buffer is a backed by a direct ByteBuffer if and only if the specified buffer is direct.
    
    Parameters:
    
    buffer - the buffer to copy.
    
    newSize - the new buffer's size, in chars.
    
    Returns:
    
    the new buffer, with the specified size.
    
    Throws:
    
    IllegalArgumentException - if the buffer is null, if the new size is negative, or if the new size is less than the buffer's remaing elements.
  - copyOf
```
public static DoubleBuffer copyOf(DoubleBuffer buffer,
                                  int newSize)
```
    Returns a copy of the specified buffer, with the specified new size. The new size must be greater than or equal to the specified buffer's size. If the new size is greater than the specified buffer's size, this returns a new buffer which is partially filled with the contents of the specified buffer. The returned buffer is a backed by a direct ByteBuffer if and only if the specified buffer is direct.
    
    Parameters:
    
    buffer - the buffer to copy.
    
    newSize - the new buffer's size, in doubles.
    
    Returns:
    
    the new buffer, with the specified size.
    
    Throws:
    
    IllegalArgumentException - if the buffer is null, if the new size is negative, or if the new size is less than the buffer's remaing elements.
  - copyOf
```
public static FloatBuffer copyOf(FloatBuffer buffer,
                                 int newSize)
```
    Returns a copy of the specified buffer, with the specified new size. The new size must be greater than or equal to the specified buffer's size. If the new size is greater than the specified buffer's size, this returns a new buffer which is partially filled with the contents of the specified buffer. The returned buffer is a backed by a direct ByteBuffer if and only if the specified buffer is direct.
    
    Parameters:
    
    buffer - the buffer to copy.
    
    newSize - the new buffer's size, in floats.
    
    Returns:
    
    the new buffer, with the specified size.
    
    Throws:
    
    IllegalArgumentException - if the buffer is null, if the new size is negative, or if the new size is less than the buffer's remaing elements.
  - copyOf
```
public static IntBuffer copyOf(IntBuffer buffer,
                               int newSize)
```
    Returns a copy of the specified buffer, with the specified new size. The new size must be greater than or equal to the specified buffer's size. If the new size is greater than the specified buffer's size, this returns a new buffer which is partially filled with the contents of the specified buffer.The returned buffer is a backed by a direct ByteBuffer if and only if the specified buffer is direct.
    
    Parameters:
    
    buffer - the buffer to copy.
    
    newSize - the new buffer's size, in ints.
    
    Returns:
    
    the new buffer, with the specified size.
    
    Throws:
    
    IllegalArgumentException - if the buffer is null, if the new size is negative, or if the new size is less than the buffer's remaing elements.
  - copyOf
```
public static ShortBuffer copyOf(ShortBuffer buffer,
                                 int newSize)
```
    Returns a copy of the specified buffer, with the specified new size. The new size must be greater than or equal to the specified buffer's size. If the new size is greater than the specified buffer's size, this returns a new buffer which is partially filled with the contents of the specified buffer. The returned buffer is a backed by a direct ByteBuffer if and only if the specified buffer is direct.
    
    Parameters:
    
    buffer - the buffer to copy.
    
    newSize - the new buffer's size, in shorts.
    
    Returns:
    
    the new buffer, with the specified size.
    
    Throws:
    
    IllegalArgumentException - if the buffer is null, if the new size is negative, or if the new size is less than the buffer's remaing elements.
  - newByteBuffer
```
public static ByteBuffer newByteBuffer(int size,
                                       boolean allocateDirect)
```
    Allocates a new direct ByteBuffer of the specified size, in chars.
    
    Parameters:
    
    size - the new ByteBuffer's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new buffer.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newByteBufferWrapper
```
public static BufferWrapper newByteBufferWrapper(int size,
                                                 boolean allocateDirect)
```
    Allocates a new BufferWrapper of the specified size, in bytes. The BufferWrapper is backed by a Buffer of bytes.
    
    Parameters:
    
    size - the new BufferWrapper's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new BufferWrapper.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newCharBuffer
```
public static CharBuffer newCharBuffer(int size,
                                       boolean allocateDirect)
```
    Allocates a new direct CharBuffer of the specified size, in chars.
    
    Parameters:
    
    size - the new CharBuffer's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new buffer.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newDirectByteBuffer
```
protected static ByteBuffer newDirectByteBuffer(int size)
```
  - newDoubleBuffer
```
public static DoubleBuffer newDoubleBuffer(int size,
                                           boolean allocateDirect)
```
    Allocates a new direct DoubleBuffer of the specified size, in chars.
    
    Parameters:
    
    size - the new DoubleBuffer's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new buffer.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newDoubleBufferWrapper
```
public static BufferWrapper newDoubleBufferWrapper(int size,
                                                   boolean allocateDirect)
```
    Allocates a new BufferWrapper of the specified size, in doubles. The BufferWrapper is backed by a Buffer of doubles.
    
    Parameters:
    
    size - the new BufferWrapper's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new BufferWrapper.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newFloatBuffer
```
public static FloatBuffer newFloatBuffer(int size,
                                         boolean allocateDirect)
```
    Allocates a new direct FloatBuffer of the specified size, in chars.
    
    Parameters:
    
    size - the new FloatBuffer's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new buffer.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newFloatBufferWrapper
```
public static BufferWrapper newFloatBufferWrapper(int size,
                                                  boolean allocateDirect)
```
    Allocates a new BufferWrapper of the specified size, in floats. The BufferWrapper is backed by a Buffer of floats.
    
    Parameters:
    
    size - the new BufferWrapper's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new BufferWrapper.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newIntBuffer
```
public static IntBuffer newIntBuffer(int size,
                                     boolean allocateDirect)
```
    Allocates a new direct IntBuffer of the specified size, in chars.
    
    Parameters:
    
    size - the new IntBuffer's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new buffer.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newIntBufferWrapper
```
public static BufferWrapper newIntBufferWrapper(int size,
                                                boolean allocateDirect)
```
    Allocates a new BufferWrapper of the specified size, in ints. The BufferWrapper is backed by a Buffer of ints.
    
    Parameters:
    
    size - the new BufferWrapper's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new BufferWrapper.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newShortBuffer
```
public static ShortBuffer newShortBuffer(int size,
                                         boolean allocateDirect)
```
    Allocates a new direct ShortBuffer of the specified size, in chars.
    
    Parameters:
    
    size - the new ShortBuffer's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new buffer.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - newShortBufferWrapper
```
public static BufferWrapper newShortBufferWrapper(int size,
                                                  boolean allocateDirect)
```
    Allocates a new BufferWrapper of the specified size, in shorts. The BufferWrapper is backed by a Buffer of shorts.
    
    Parameters:
    
    size - the new BufferWrapper's size.
    
    allocateDirect - true to allocate and return a direct buffer, false to allocate and return a non-direct buffer.
    
    Returns:
    
    the new BufferWrapper.
    
    Throws:
    
    IllegalArgumentException - if size is negative.
  - sizeOfPrimitiveType
```
public static int sizeOfPrimitiveType(Object dataType)
```
    Returns the size in bytes of the specified primitive data type, or -1 if the specified type is unrecognized. Recognized primitive types are as follows:
    Parameters:
    
    dataType - the primitive data type.
    
    Returns:
    
    the size of the primitive data type, in bytes.
    
    Throws:
    
    IllegalArgumentException - if the data type is null.

Class WWBufferUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SIZEOF_CHAR

SIZEOF_DOUBLE

SIZEOF_FLOAT

SIZEOF_INT

SIZEOF_SHORT

Constructor Detail

WWBufferUtil

Method Detail

computeExtremeValues

computeExtremeValues

copyArrayToBuffer

copyOf

copyOf

copyOf

copyOf

copyOf

copyOf

newByteBuffer

newByteBufferWrapper

newCharBuffer

newDirectByteBuffer

newDoubleBuffer

newDoubleBufferWrapper

newFloatBuffer

newFloatBufferWrapper

newIntBuffer

newIntBufferWrapper

newShortBuffer

newShortBufferWrapper

sizeOfPrimitiveType