marytts.util.data.audio

Class DDSAudioInputStream

java.lang.Object

java.io.InputStream

javax.sound.sampled.AudioInputStream

marytts.util.data.audio.DDSAudioInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public class DDSAudioInputStream
extends AudioInputStream

Author:

Marc Schröder An audio input stream that draws its audio data from a DoubleDataSource.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_AMPLITUDE
protected double[]	sampleBuf
protected static int	SAMPLEBUFFERSIZE
protected DoubleDataSource	source

Fields inherited from class javax.sound.sampled.AudioInputStream

format, frameLength, framePos, frameSize

Constructor Summary

Constructors

Constructor and Description
DDSAudioInputStream(DoubleDataSource source, AudioFormat format) From the given DoubleDataSource, create an AudioInputStream of the given audio format.

Method Summary

Methods

Modifier and Type	Method and Description
int	available() Returns the maximum number of bytes that can be read (or skipped over) from this audio input stream without blocking.
void	close() Closes this audio input stream and releases any system resources associated with the stream.
long	getFrameLength()
void	mark(int readlimit) Marks the current position in this audio input stream.
boolean	markSupported() Tests whether this audio input stream supports the mark and reset methods.
int	read(byte[] b, int off, int len) Reads up to a specified maximum number of bytes of data from the audio stream, putting them into the given byte array.
void	reset() Repositions this audio input stream to the position it had at the time its mark method was last invoked.
long	skip(long n) Skips over and discards a specified number of bytes from this audio input stream.

Methods inherited from class javax.sound.sampled.AudioInputStream

getFormat, read, read

Methods inherited from class java.lang.Object

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

Field Detail

MAX_AMPLITUDE

public static final int MAX_AMPLITUDE

See Also:

Constant Field Values

source

protected DoubleDataSource source

sampleBuf

protected double[] sampleBuf

SAMPLEBUFFERSIZE

protected static final int SAMPLEBUFFERSIZE

See Also:

Constant Field Values

Constructor Detail

DDSAudioInputStream

public DDSAudioInputStream(DoubleDataSource source,
                   AudioFormat format)

From the given DoubleDataSource, create an AudioInputStream of the given audio format.

Parameters:

source - source

format - format

Throws:

IllegalArgumentException - if the format is not mono, not PCM_SIGNED or PCM_UNSIGNED, or has a sample size in bits other than 8 or 16.

Method Detail

read

public int read(byte[] b,
       int off,
       int len)
         throws IOException

Reads up to a specified maximum number of bytes of data from the audio stream, putting them into the given byte array.

This method will always read an integral number of frames. If len does not specify an integral number of frames, a maximum of len - (len % frameSize) bytes will be read.

Overrides:

read in class AudioInputStream

Parameters:

b - the buffer into which the data is read

off - the offset, from the beginning of array b, at which the data will be written

len - the maximum number of bytes to read

Returns:

the total number of bytes read into the buffer, or -1 if there is no more data because the end of the stream has been reached

Throws:

IOException - if an input or output error occurs

See Also:

AudioInputStream.read(byte[]), AudioInputStream.read(), skip(long), available()

skip

public long skip(long n)
          throws IOException

Skips over and discards a specified number of bytes from this audio input stream.

Overrides:

skip in class AudioInputStream

Parameters:

n - the requested number of bytes to be skipped

Returns:

the actual number of bytes skipped

Throws:

IOException - if an input or output error occurs

See Also:

read(byte[], int, int), available()

available

public int available()
              throws IOException

Returns the maximum number of bytes that can be read (or skipped over) from this audio input stream without blocking. This limit applies only to the next invocation of a read or skip method for this audio input stream; the limit can vary each time these methods are invoked. Depending on the underlying stream,an IOException may be thrown if this stream is closed.

Overrides:

available in class AudioInputStream

Returns:

the number of bytes that can be read from this audio input stream without blocking

Throws:

IOException - if an input or output error occurs

See Also:

read(byte[], int, int), AudioInputStream.read(byte[]), AudioInputStream.read(), skip(long)

close

public void close()
           throws IOException

Closes this audio input stream and releases any system resources associated with the stream.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class AudioInputStream

Throws:

IOException - if an input or output error occurs

mark

public void mark(int readlimit)

Marks the current position in this audio input stream.

Overrides:

mark in class AudioInputStream

Parameters:

readlimit - the maximum number of bytes that can be read before the mark position becomes invalid.

See Also:

reset(), markSupported()

reset

public void reset()
           throws IOException

Repositions this audio input stream to the position it had at the time its mark method was last invoked.

Overrides:

reset in class AudioInputStream

Throws:

IOException - if an input or output error occurs.

See Also:

mark(int), markSupported()

markSupported

public boolean markSupported()

Tests whether this audio input stream supports the mark and reset methods.

Overrides:

markSupported in class AudioInputStream

Returns:

true if this stream supports the mark and reset methods; false otherwise

See Also:

mark(int), reset()

getFrameLength

public long getFrameLength()

Overrides:

getFrameLength in class AudioInputStream