public abstract class RingedAudioInputStream extends AudioInputStream
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.| Modifier and Type | Field and Description |
|---|---|
protected RingBuffer |
buffer
The current position in the unfiltered data buffer.
|
static int |
DEFAULT_BUFFER_SIZE
The default size of the buffer.
|
protected InputStream |
in
The underlying inputStream.
|
format, frameLength, framePos, frameSize| Constructor and Description |
|---|
RingedAudioInputStream(InputStream in,
AudioFormat format,
long length)
Creates a
RingedAudioInputStream and saves its argument,
the input stream in, for later use. |
RingedAudioInputStream(InputStream in,
AudioFormat format,
long length,
int size)
Creates a
RingedAudioInputStream with the specified
buffer size, and saves its argument, the inputstream in
for later use. |
RingedAudioInputStream(InputStream in,
AudioFormat format,
long length,
int size,
int presize)
Creates a
RingedAudioInputStream with the specified
buffer size, and saves its argument, the inputstream in
for later use. |
| Modifier and Type | Method and Description |
|---|---|
int |
available()
Returns the number of bytes that can be read from this inputstream
without blocking.
|
void |
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.
|
void |
mark(int readlimit)
See the general contract of the
mark method of
InputStream. |
boolean |
markSupported()
Tests if this input stream supports the
mark and
reset methods. |
int |
read()
See the general contract of the
read method of
InputStream. |
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 the
reset method of
InputStream. |
long |
skip(long n)
See the general contract of the
skip method of
InputStream. |
getFormat, getFrameLength, readpublic static final int DEFAULT_BUFFER_SIZE
protected InputStream in
protected RingBuffer buffer
prebuf array.
This value is always in the range 0 through precount. If
it is less than precount, then prebuf[pos]
is the next byte to be supplied as input. If it is equal to
precount, then the next read or
skip operation will require more bytes to be read from the
contained inputstream.
#prebufpublic RingedAudioInputStream(InputStream in, AudioFormat format, long length)
RingedAudioInputStream and saves its argument,
the input stream in, for later use. An internal buffer
array is created and stored in buf.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.public RingedAudioInputStream(InputStream in, AudioFormat format, long length, int size)
RingedAudioInputStream with the specified
buffer size, and saves its argument, the inputstream in
for later use. An internal buffer array of length size is
created and stored in buf.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.public RingedAudioInputStream(InputStream in, AudioFormat format, long length, int size, int presize)
RingedAudioInputStream with the specified
buffer size, and saves its argument, the inputstream in
for later use. An internal buffer array of length size is
created and stored in buf.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.protected void fill()
throws IOException
IOExceptionpublic int read()
throws IOException
read method of
InputStream.read in class AudioInputStream-1 if the end of the
stream is reached.IOException - if an I/O error occurs.public int read(byte[] b,
int off,
int len)
throws IOException
This method implements the general contract of the corresponding
readInputStreamread method of the underlying stream. This
iterated read continues until one of the following
conditions becomes true:
read method of the underlying stream returns
-1, indicating end-of-file, or
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.
read in class AudioInputStreamb - destination buffer.off - offset at which to start storing bytes.len - maximum number of bytes to read.-1 if the end of the
stream has been reached.IOException - if an I/O error occurs.public long skip(long n)
throws IOException
skip method of
InputStream.skip in class AudioInputStreamn - the number of bytes to be skipped.IOException - if an I/O error occurs.public int available()
throws IOException
The available method of
FilteredAudioInputStream returns the sum of the the number
of bytes remaining to be read in the buffer (count - pos).
The result of calling the available 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).
available in class AudioInputStreamIOException - if an I/O error occurs.public void mark(int readlimit)
mark method of
InputStream.mark in class AudioInputStreamreadlimit - the maximum limit of bytes that can be read before the mark
position becomes invalid.reset()public void reset()
throws IOException
reset method of
InputStream.
If markpos is -1 (no mark has been set or the mark has
been invalidated), an IOException is thrown. Otherwise,
pos is set equal to markpos.
reset in class AudioInputStreamIOException - if this stream has not been marked or if the mark has been
invalidated.mark(int)public boolean markSupported()
mark and
reset methods. The markSupported method of
FilteredAudioInputStream returns true.markSupported in class AudioInputStreamboolean indicating if this stream type supports
the mark and reset methods.mark(int),
reset()public void close()
throws IOException
close in interface Closeableclose in interface AutoCloseableclose in class AudioInputStreamIOException - if an I/O error occurs.Copyright © 2004–2017. All rights reserved.