com.tagtraum.pcmsampledsp

Class BytesIntConverter

java.lang.Object

com.tagtraum.pcmsampledsp.BytesIntConverter

All Implemented Interfaces:

Converter<int[]>

public abstract class BytesIntConverter
extends Object
implements Converter<int[]>

Simple converter from bytes to ints and back, while taking into account the sign, bytes per int and byte order.

Specialized implementations (i.e. fast versions) are provided for signed 16bit and 24bit formats.

Author:

Hendrik Schreiber

Constructor Summary

Constructors

Constructor and Description
BytesIntConverter()

Method Summary

Modifier and Type	Method and Description
abstract int	decode(ByteBuffer source) Reads bytes from the provided buffer and converts them into an int.
void	decode(ByteBuffer source, int[] ibuf) Reads samples from the byte buffer and writes the resulting values to the provided array.
void	encode(int[] ibuf, ByteBuffer target) Writes the given array to the target byte buffer using the given byte order, bytes per sample etc.
void	encode(int[] ibuf, int length, ByteBuffer target) Writes the given array to the target byte buffer using the given byte order, bytes per sample etc.
abstract void	encode(int value, ByteBuffer target) Writes the given value to the given buffer.
static BytesIntConverter	getInstance(int bytesPerSample, boolean bigEndian, boolean signed) Returns a suitable instance.
static int	maxPossibleValue(int bitsPerSample, boolean signed)
static int	minPossibleValue(int bitsPerSample, boolean signed)

Methods inherited from class java.lang.Object

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

Constructor Detail

BytesIntConverter

public BytesIntConverter()

Method Detail

maxPossibleValue

public static int maxPossibleValue(int bitsPerSample,
                                   boolean signed)

minPossibleValue

public static int minPossibleValue(int bitsPerSample,
                                   boolean signed)

getInstance

public static BytesIntConverter getInstance(int bytesPerSample,
                                            boolean bigEndian,
                                            boolean signed)

Returns a suitable instance.

Parameters:

bytesPerSample - bytes per sample

bigEndian - big endian

signed - signed

Returns:

suitable converter instance

decode

public abstract int decode(ByteBuffer source)
                    throws IOException

Reads bytes from the provided buffer and converts them into an int.

Parameters:

source - byte buffer

Returns:

integer

Throws:

IOException - if the conversion fails

decode

public void decode(ByteBuffer source,
                   int[] ibuf)
            throws IOException

Description copied from interface: Converter

Reads samples from the byte buffer and writes the resulting values to the provided array.

Specified by:

decode in interface Converter<int[]>

Parameters:

source - byte buffer

ibuf - value array (output)

Throws:

IOException - if the conversion fails

encode

public abstract void encode(int value,
                            ByteBuffer target)

Writes the given value to the given buffer.

Parameters:

value - a integer value

target - byte buffer

encode

public void encode(int[] ibuf,
                   ByteBuffer target)

Description copied from interface: Converter

Writes the given array to the target byte buffer using the given byte order, bytes per sample etc.

Specified by:

encode in interface Converter<int[]>

Parameters:

ibuf - value array

target - target byte buffer

encode

public void encode(int[] ibuf,
                   int length,
                   ByteBuffer target)

Description copied from interface: Converter

Writes the given array to the target byte buffer using the given byte order, bytes per sample etc.

Specified by:

encode in interface Converter<int[]>

Parameters:

ibuf - value array

length - number of values from array to actually convert

target - target byte buffer