org.jsresources

Class AppendableSequenceAudioInputStream

java.lang.Object

java.io.InputStream

javax.sound.sampled.AudioInputStream

org.jsresources.SequenceAudioInputStream

org.jsresources.AppendableSequenceAudioInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public class AppendableSequenceAudioInputStream
extends SequenceAudioInputStream

Author:

Marc Schröder

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	doneAppending

Fields inherited from class org.jsresources.SequenceAudioInputStream

m_audioInputStreamList, m_nCurrentStream

Fields inherited from class javax.sound.sampled.AudioInputStream

format, frameLength, framePos, frameSize

Constructor Summary

Constructors

Constructor and Description
AppendableSequenceAudioInputStream(AudioFormat audioFormat, Collection audioInputStreams) Create a sequence audio input stream to which more AudioInputStreams can be appended after creation.

Method Summary

Methods

Modifier and Type	Method and Description
void	append(AudioInputStream ais) Append the new audio input stream to the end of the list of audio input streams.
void	doneAppending() Inform this audio input stream not to expect any further calls to append(), and report end-of-stream when all data has been read.
long	getFrameLength() Return the frame length of this appendable sequence audio input stream.
int	read()
int	read(byte[] buf, int off, int len)

Methods inherited from class org.jsresources.SequenceAudioInputStream

available, close, mark, markSupported, reset, skip

Methods inherited from class javax.sound.sampled.AudioInputStream

getFormat, read

Methods inherited from class java.lang.Object

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

Field Detail

doneAppending

protected boolean doneAppending

Constructor Detail

AppendableSequenceAudioInputStream

public AppendableSequenceAudioInputStream(AudioFormat audioFormat,
                                  Collection audioInputStreams)

Create a sequence audio input stream to which more AudioInputStreams can be appended after creation. When the currently available audio input streams have been read, calls to read() will block until new audio data is appended or doneAppending() is called. After doneAppending() is called, read() will return -1 when running out of data.

Parameters:

audioFormat - audioformat

audioInputStreams - audioinputstreams

Method Detail

append

public void append(AudioInputStream ais)

Append the new audio input stream to the end of the list of audio input streams.

Parameters:

ais - ais

Throws:

IllegalArgumentException - if this method is called after doneAppending() was called.

doneAppending

public void doneAppending()

Inform this audio input stream not to expect any further calls to append(), and report end-of-stream when all data has been read.

read

public int read()
         throws IOException

Overrides:

read in class SequenceAudioInputStream

Throws:

IOException

read

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

Overrides:

read in class SequenceAudioInputStream

Throws:

IOException

getFrameLength

public long getFrameLength()

Return the frame length of this appendable sequence audio input stream. As long as doneAppending() has not been called, returns AudioSystem.NOT_SPECIFIED; after that, the frame length is the sum of the frame lengths of individual frame lengths.

Overrides:

getFrameLength in class AudioInputStream

Returns:

total