com.github.hoary.javaav

Class Audio

java.lang.Object

com.github.hoary.javaav.Audio

public class Audio
extends Object

Helper class to convert audio samples into interleaved byte array ready for playback with Java Sound.

Author:

Alex Andres

Constructor Summary

Constructors

Constructor and Description
Audio()

Method Summary

Methods

Modifier and Type	Method and Description
static byte[]	getAudio16(AudioFrame frame) Get byte array with interleaved signed two byte samples.
static byte[]	getAudio24(AudioFrame frame) Get byte array with interleaved signed three byte samples.
static byte[]	getAudio32(AudioFrame frame) Get byte array with interleaved signed four byte samples.
static byte[]	getAudio8(AudioFrame frame) Get byte array with interleaved signed byte samples.
static int	getFormatDepth(SampleFormat format) Get number of bytes per sample for specified sample format.
static Number	getValue(ByteBuffer buffer, SampleFormat format, int index) Read a Number at specified index from ByteBuffer for specified SampleFormat.

Methods inherited from class java.lang.Object

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

Constructor Detail

Audio

public Audio()

Method Detail

getFormatDepth

public static int getFormatDepth(SampleFormat format)

Get number of bytes per sample for specified sample format.

Parameters:

format - the sample format.

Returns:

number of bytes per sample, or zero if sample format is unknown.

getValue

public static Number getValue(ByteBuffer buffer,
              SampleFormat format,
              int index)

Read a Number at specified index from ByteBuffer for specified SampleFormat. Depending on the sample format the value is represented by a byte, short, integer, float or double number.

Parameters:

buffer - ByteBuffer with audio samples.

format - SampleFormat of audio samples in the buffer.

index - the position in the buffer.

Returns:

a value for a sample format represented by a Number, or zero if sample format is unknown.

getAudio8

public static byte[] getAudio8(AudioFrame frame)

Get byte array with interleaved signed byte samples. Since each sample fits in one byte the possible sample values are within the interval [-2^7, 2^7-1]. It is assumed that the samples within the AudioFrame are normalized, meaning in [-1, 1].

Parameters:

frame - AudioFrame with audio samples.

Returns:

interleaved byte array with signed samples within [-2^7, 2^7-1].

getAudio16

public static byte[] getAudio16(AudioFrame frame)

Get byte array with interleaved signed two byte samples. Since each sample has a length of two bytes the possible sample values are within the interval [-2^15, 2^15-1]. It is assumed that the samples within the AudioFrame are normalized, meaning in [-1, 1].

Parameters:

frame - AudioFrame with audio samples.

Returns:

interleaved byte array with signed samples within [-2^15, 2^15-1].

getAudio24

public static byte[] getAudio24(AudioFrame frame)

Get byte array with interleaved signed three byte samples. Since each sample has a length of three bytes the possible sample values are within the interval [-2^23, 2^23-1]. It is assumed that the samples within the AudioFrame are normalized, meaning in [-1, 1].

Parameters:

frame - AudioFrame with audio samples.

Returns:

interleaved byte array with signed samples within [-2^23, 2^23-1].

getAudio32

public static byte[] getAudio32(AudioFrame frame)

Get byte array with interleaved signed four byte samples. Since each sample has a length of four bytes the possible sample values are within the interval [-2^31, 2^31-1]. It is assumed that the samples within the AudioFrame are normalized, meaning in [-1, 1].

Parameters:

frame - AudioFrame with audio samples.

Returns:

interleaved byte array with signed samples within [-2^31, 2^31-1].