Class FilteredAudioInputStream
- All Implemented Interfaces:
Closeable
,AutoCloseable
- Direct Known Subclasses:
Pcm2SpeexAudioInputStream
,Speex2PcmAudioInputStream
FilteredAudioInputStream
is an AudioInputStream with buffers
to facilitate transcoding the audio.
A first byte array can buffer the data from the underlying inputstream until
sufficient data for transcoding is present.
A second byte array can hold the transcoded audio data, ready to be read out
by the stream user.- Version:
- $Revision: 1.2 $
- Author:
- Marc Gimpel, Wimba S.A. (mgimpel@horizonwimba.com)
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected byte[]
The internal buffer array where the data is stored.protected int
The index one greater than the index of the last valid byte in the buffer.static final int
The default size of the buffer.protected InputStream
The underlying inputStream.protected int
The maximum read ahead allowed after a call to themark
method before subsequent calls to thereset
method fail.protected int
The value of thepos
field at the time the lastmark
method was called.protected int
The current position in the buffer.protected byte[]
The internal buffer array where the unfiltered data is temporarily stored.protected int
The index one greater than the index of the last valid byte in the unfiltered data buffer.protected int
The current position in the unfiltered data buffer.private final byte[]
Array of size 1, used by the read method to read just 1 byte.Fields inherited from class javax.sound.sampled.AudioInputStream
format, frameLength, framePos, frameSize
-
Constructor Summary
ConstructorsConstructorDescriptionFilteredAudioInputStream
(InputStream in, AudioFormat format, long length) Creates aFilteredAudioInputStream
and saves its argument, the input streamin
, for later use.FilteredAudioInputStream
(InputStream in, AudioFormat format, long length, int size) Creates aFilteredAudioInputStream
with the specified buffer size, and saves its argument, the inputstreamin
for later use.FilteredAudioInputStream
(InputStream in, AudioFormat format, long length, int size, int presize) Creates aFilteredAudioInputStream
with the specified buffer size, and saves its argument, the inputstreamin
for later use. -
Method Summary
Modifier and TypeMethodDescriptionint
Returns the number of bytes that can be read from this inputstream without blocking.protected void
Check to make sure that this stream has not been closedvoid
close()
Closes this input stream and releases any system resources associated with the stream.protected void
fill()
Fills the buffer with more data, taking into account shuffling and other tricks for dealing with marks.protected void
Free up some space in the buffers.void
mark
(int readlimit) See the general contract of themark
method ofInputStream
.boolean
Tests if this input stream supports themark
andreset
methods.int
read()
See the general contract of theread
method ofInputStream
.int
read
(byte[] b, int off, int len) Reads bytes from this byte-input stream into the specified byte array, starting at the given offset.void
reset()
See the general contract of thereset
method ofInputStream
.long
skip
(long n) See the general contract of theskip
method ofInputStream
.Methods inherited from class javax.sound.sampled.AudioInputStream
getFormat, getFrameLength, read
Methods inherited from class java.io.InputStream
nullInputStream, readAllBytes, readNBytes, readNBytes, skipNBytes, transferTo
-
Field Details
-
DEFAULT_BUFFER_SIZE
public static final int DEFAULT_BUFFER_SIZEThe default size of the buffer.- See Also:
-
in
The underlying inputStream. -
buf
protected byte[] bufThe internal buffer array where the data is stored. When necessary, it may be replaced by another array of a different size. -
count
protected int countThe index one greater than the index of the last valid byte in the buffer. This value is always in the range 0 throughbuf.length
; elementsbuf[0]
throughbuf[count-1]
contain buffered input data obtained and filtered from the underlying inputstream. -
pos
protected int posThe current position in the buffer. This is the index of the next character to be read from thebuf
array.This value is always in the range 0 through
count
. If it is less thancount
, thenbuf[pos]
is the next byte to be supplied as input. If it is equal tocount
, then the nextread
orskip
operation will require more bytes to be read and filtered from the underlying inputstream.- See Also:
-
markpos
protected int markposThe value of thepos
field at the time the lastmark
method was called.This value is always in the range -1 through
pos
. If there is no marked position in the inputstream, this field is -1. If there is a marked position in the inputstream, thenbuf[markpos]
is the first byte to be supplied as input after areset
operation. Ifmarkpos
is not -1, then all bytes from positionsbuf[markpos]
throughbuf[pos-1]
must remain in the buffer array (though they may be moved to another place in the buffer array, with suitable adjustments to the values ofcount
,pos
, andmarkpos
); they may not be discarded unless and until the difference betweenpos
andmarkpos
exceedsmarklimit
.- See Also:
-
marklimit
protected int marklimitThe maximum read ahead allowed after a call to themark
method before subsequent calls to thereset
method fail. Whenever the difference betweenpos
andmarkpos
exceedsmarklimit
, then the mark may be dropped by settingmarkpos
to -1.- See Also:
-
single
private final byte[] singleArray of size 1, used by the read method to read just 1 byte. -
prebuf
protected byte[] prebufThe internal buffer array where the unfiltered data is temporarily stored. -
precount
protected int precountThe index one greater than the index of the last valid byte in the unfiltered data buffer. This value is always in the range 0 throughprebuf.length
; elementsprebuf[0]
throughprebuf[count-1]
contain buffered input data obtained from the underlying input stream. -
prepos
protected int preposThe current position in the unfiltered data buffer. This is the index of the next character to be read from theprebuf
array.This value is always in the range 0 through
precount
. If it is less thanprecount
, thenprebuf[pos]
is the next byte to be supplied as input. If it is equal toprecount
, then the nextread
orskip
operation will require more bytes to be read from the contained inputstream.- See Also:
-
-
Constructor Details
-
FilteredAudioInputStream
Creates aFilteredAudioInputStream
and saves its argument, the input streamin
, for later use. An internal buffer array is created and stored inbuf
.- Parameters:
in
- the underlying input stream.format
- the format of this stream's audio data.length
- the length in sample frames of the data in this stream.- Throws:
IllegalArgumentException
- if size invalid input: '<'= 0 or presize invalid input: '<'= 0.
-
FilteredAudioInputStream
Creates aFilteredAudioInputStream
with the specified buffer size, and saves its argument, the inputstreamin
for later use. An internal buffer array of lengthsize
is created and stored inbuf
.- Parameters:
in
- the underlying input stream.format
- the format of this stream's audio data.length
- the length in sample frames of the data in this stream.size
- the buffer sizes.- Throws:
IllegalArgumentException
- if size invalid input: '<'= 0.
-
FilteredAudioInputStream
public FilteredAudioInputStream(InputStream in, AudioFormat format, long length, int size, int presize) Creates aFilteredAudioInputStream
with the specified buffer size, and saves its argument, the inputstreamin
for later use. An internal buffer array of lengthsize
is created and stored inbuf
.- Parameters:
in
- the underlying input stream.format
- the format of this stream's audio data.length
- the length in sample frames of the data in this stream.size
- the buffer size.presize
- the prebuffer size.- Throws:
IllegalArgumentException
- if size invalid input: '<'= 0 or presize invalid input: '<'= 0.
-
-
Method Details
-
checkIfStillOpen
Check to make sure that this stream has not been closed- Throws:
IOException
-
fill
Fills the buffer with more data, taking into account shuffling and other tricks for dealing with marks. Assumes that it is being called by a synchronized method. This method also assumes that all data has already been read in, hence pos > count.- Throws:
IOException
-
makeSpace
protected void makeSpace()Free up some space in the buffers. -
read
See the general contract of theread
method ofInputStream
.- Overrides:
read
in classAudioInputStream
- Returns:
- the next byte of data, or
-1
if the end of the stream is reached. - Throws:
IOException
- if an I/O error occurs.- See Also:
-
read
Reads bytes from this byte-input stream into the specified byte array, starting at the given offset.This method implements the general contract of the corresponding
method of theread
class. As an additional convenience, it attempts to read as many bytes as possible by repeatedly invoking theInputStream
read
method of the underlying stream. This iteratedread
continues until one of the following conditions becomes true:- The specified number of bytes have been read,
- The
read
method of the underlying stream returns-1
, indicating end-of-file, or - The
available
method of the underlying stream returns zero, indicating that further input requests would block.
read
on the underlying stream returns-1
to indicate end-of-file then this method returns-1
. Otherwise this method returns the number of bytes actually read.Subclasses of this class are encouraged, but not required, to attempt to read as many bytes as possible in the same fashion.
- Overrides:
read
in classAudioInputStream
- Parameters:
b
- destination buffer.off
- offset at which to start storing bytes.len
- maximum number of bytes to read.- Returns:
- the number of bytes read, or
-1
if the end of the stream has been reached. - Throws:
IOException
- if an I/O error occurs.
-
skip
See the general contract of theskip
method ofInputStream
.- Overrides:
skip
in classAudioInputStream
- Parameters:
n
- the number of bytes to be skipped.- Returns:
- the actual number of bytes skipped.
- Throws:
IOException
- if an I/O error occurs.
-
available
Returns the number of bytes that can be read from this inputstream without blocking.The
available
method ofFilteredAudioInputStream
returns the sum of the the number of bytes remaining to be read in the buffer (count - pos
). The result of calling theavailable
method of the underlying inputstream is not used, as this data will have to be filtered, and thus may not be the same size after processing (although subclasses that do the filtering should override this method and use the amount of data available in the underlying inputstream).- Overrides:
available
in classAudioInputStream
- Returns:
- the number of bytes that can be read from this inputstream without blocking.
- Throws:
IOException
- if an I/O error occurs.- See Also:
-
mark
public void mark(int readlimit) See the general contract of themark
method ofInputStream
.- Overrides:
mark
in classAudioInputStream
- Parameters:
readlimit
- the maximum limit of bytes that can be read before the mark position becomes invalid.- See Also:
-
reset
See the general contract of thereset
method ofInputStream
.If
markpos
is -1 (no mark has been set or the mark has been invalidated), anIOException
is thrown. Otherwise,pos
is set equal tomarkpos
.- Overrides:
reset
in classAudioInputStream
- Throws:
IOException
- if this stream has not been marked or if the mark has been invalidated.- See Also:
-
markSupported
public boolean markSupported()Tests if this input stream supports themark
andreset
methods. ThemarkSupported
method ofFilteredAudioInputStream
returnstrue
.- Overrides:
markSupported
in classAudioInputStream
- Returns:
- a
boolean
indicating if this stream type supports themark
andreset
methods. - See Also:
-
close
Closes this input stream and releases any system resources associated with the stream.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Overrides:
close
in classAudioInputStream
- Throws:
IOException
- if an I/O error occurs.
-