APIdia Launch Partner
Top Description Inners Fields Constructors Methods
com.sun.media.sound

public final Class AudioFloatFormatConverter

extends FormatConversionProvider
Class Inheritance
Imports
java.io.IOException, .InputStream, java.util.ArrayList, .Arrays, .Objects, javax.sound.sampled.AudioFormat, .AudioFormat.Encoding, .AudioInputStream, .AudioSystem, javax.sound.sampled.spi.FormatConversionProvider

This class is used to convert between 8,16,24,32 bit signed/unsigned big/little endian fixed/floating stereo/mono/multi-channel audio streams and perform sample-rate conversion if needed.
Author
Karl Helgason

Nested and Inner Type Summary

Modifier and TypeClass and Description
private static class
private static class
private static class

Field Summary

Modifier and TypeField and Description
private final AudioFormat.Encoding[]

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
public AudioInputStream
getAudioInputStream(AudioFormat.Encoding targetEncoding, AudioInputStream sourceStream)

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getAudioInputStream.

Obtains an audio input stream with the specified encoding from the given audio input stream.

public AudioInputStream
getAudioInputStream(AudioFormat targetFormat, AudioInputStream sourceStream)

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getAudioInputStream.

Obtains an audio input stream with the specified format from the given audio input stream.

public AudioInputStream
public AudioFormat.Encoding[]
getSourceEncodings()

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getSourceEncodings.

Obtains the set of source format encodings from which format conversion services are provided by this provider.

public AudioFormat.Encoding[]
getTargetEncodings()

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getTargetEncodings.

Obtains the set of target format encodings to which format conversion services are provided by this provider.

public AudioFormat.Encoding[]
getTargetEncodings(AudioFormat sourceFormat)

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getTargetEncodings.

Obtains the set of target format encodings supported by the format converter given a particular source format.

public AudioFormat[]
getTargetFormats(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getTargetFormats.

Obtains the set of target formats with the encoding specified supported by the format converter.

public boolean
isConversionSupported(AudioFormat targetFormat, AudioFormat sourceFormat)

Overrides javax.sound.sampled.spi.FormatConversionProvider.isConversionSupported.

Indicates whether the format converter supports conversion to one particular format from another.

public boolean
isConversionSupported(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)

Overrides javax.sound.sampled.spi.FormatConversionProvider.isConversionSupported.

Indicates whether the format converter supports conversion to a particular encoding from a particular format.

Inherited from javax.sound.sampled.spi.FormatConversionProvider:
isSourceEncodingSupportedisTargetEncodingSupported

Field Detail

formatsback to summary
private final AudioFormat.Encoding[] formats

Constructor Detail

AudioFloatFormatConverterback to summary
public AudioFloatFormatConverter()

Method Detail

getAudioInputStreamback to summary
public AudioInputStream getAudioInputStream(AudioFormat.Encoding targetEncoding, AudioInputStream sourceStream)

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getAudioInputStream.

Doc from javax.sound.sampled.spi.FormatConversionProvider.getAudioInputStream.

Obtains an audio input stream with the specified encoding from the given audio input stream.

Annotations
@Override
getAudioInputStreamback to summary
public AudioInputStream getAudioInputStream(AudioFormat targetFormat, AudioInputStream sourceStream)

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getAudioInputStream.

Doc from javax.sound.sampled.spi.FormatConversionProvider.getAudioInputStream.

Obtains an audio input stream with the specified format from the given audio input stream.

Annotations
@Override
getAudioInputStreamback to summary
public AudioInputStream getAudioInputStream(AudioFormat targetFormat, AudioFloatInputStream sourceStream)
getSourceEncodingsback to summary
public AudioFormat.Encoding[] getSourceEncodings()

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getSourceEncodings.

Doc from javax.sound.sampled.spi.FormatConversionProvider.getSourceEncodings.

Obtains the set of source format encodings from which format conversion services are provided by this provider.

Annotations
@Override
getTargetEncodingsback to summary
public AudioFormat.Encoding[] getTargetEncodings()

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getTargetEncodings.

Doc from javax.sound.sampled.spi.FormatConversionProvider.getTargetEncodings.

Obtains the set of target format encodings to which format conversion services are provided by this provider.

Annotations
@Override
getTargetEncodingsback to summary
public AudioFormat.Encoding[] getTargetEncodings(AudioFormat sourceFormat)

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getTargetEncodings.

Doc from javax.sound.sampled.spi.FormatConversionProvider.getTargetEncodings.

Obtains the set of target format encodings supported by the format converter given a particular source format. If no target format encodings are supported for this source format, an array of length 0 is returned.

Annotations
@Override
getTargetFormatsback to summary
public AudioFormat[] getTargetFormats(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)

Implements abstract javax.sound.sampled.spi.FormatConversionProvider.getTargetFormats.

Doc from javax.sound.sampled.spi.FormatConversionProvider.getTargetFormats.

Obtains the set of target formats with the encoding specified supported by the format converter. If no target formats with the specified encoding are supported for this source format, an array of length 0 is returned.

Annotations
@Override
isConversionSupportedback to summary
public boolean isConversionSupported(AudioFormat targetFormat, AudioFormat sourceFormat)

Overrides javax.sound.sampled.spi.FormatConversionProvider.isConversionSupported.

Doc from javax.sound.sampled.spi.FormatConversionProvider.isConversionSupported.

Indicates whether the format converter supports conversion to one particular format from another.

Annotations
@Override
isConversionSupportedback to summary
public boolean isConversionSupported(AudioFormat.Encoding targetEncoding, AudioFormat sourceFormat)

Overrides javax.sound.sampled.spi.FormatConversionProvider.isConversionSupported.

Doc from javax.sound.sampled.spi.FormatConversionProvider.isConversionSupported.

Indicates whether the format converter supports conversion to a particular encoding from a particular format.

Annotations
@Override
com.sun.media.sound back to summary

private Class AudioFloatFormatConverter.AudioFloatFormatConverterInputStream

extends InputStream
Class Inheritance

Field Summary

Modifier and TypeField and Description
private final AudioFloatConverter
private final int
private float[]
private final AudioFloatInputStream

Constructor Summary

AccessConstructor and Description
pack-priv

Method Summary

Modifier and TypeMethod and Description
public int
available()

Overrides java.io.InputStream.available.

Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking, which may be 0, or 0 when end of stream is detected.

public void
close()

Overrides java.io.InputStream.close.

Implements java.io.Closeable.close.

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

public synchronized void
mark(int readlimit)

Overrides java.io.InputStream.mark.

Marks the current position in this input stream.

public boolean
markSupported()

Overrides java.io.InputStream.markSupported.

Tests if this input stream supports the mark and reset methods.

public int
read()

Implements abstract java.io.InputStream.read.

Reads the next byte of data from the input stream.

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

Overrides java.io.InputStream.read.

Reads up to len bytes of data from the input stream into an array of bytes.

public synchronized void
reset()

Overrides java.io.InputStream.reset.

Repositions this stream to the position at the time the mark method was last called on this input stream.

public long
skip(long n)

Overrides java.io.InputStream.skip.

Skips over and discards n bytes of data from this input stream.

Inherited from java.io.InputStream:
nullInputStreamreadreadAllBytesreadNBytesreadNBytesskipNBytestransferTo

Field Detail

converterback to summary
private final AudioFloatConverter converter
fsizeback to summary
private final int fsize
readfloatbufferback to summary
private float[] readfloatbuffer
streamback to summary
private final AudioFloatInputStream stream

Constructor Detail

AudioFloatFormatConverterInputStreamback to summary
pack-priv AudioFloatFormatConverterInputStream(AudioFormat targetFormat, AudioFloatInputStream stream)

Method Detail

availableback to summary
public int available() throws IOException

Overrides java.io.InputStream.available.

Doc from java.io.InputStream.available.

Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without blocking, which may be 0, or 0 when end of stream is detected. The read might be on the same thread or another thread. A single read or skip of this many bytes will not block, but may read or skip fewer bytes.

Note that while some implementations of InputStream will return the total number of bytes in the stream, many will not. It is never correct to use the return value of this method to allocate a buffer intended to hold all data in this stream.

A subclass's implementation of this method may choose to throw an IOException if this input stream has been closed by invoking the close() method.

Annotations
@Override
Exceptions
IOException:
if an I/O error occurs.
closeback to summary
public void close() throws IOException

Overrides java.io.InputStream.close.

Implements java.io.Closeable.close.

Doc from java.io.InputStream.close.

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

Annotations
@Override
Exceptions
IOException:
if an I/O error occurs.
markback to summary
public synchronized void mark(int readlimit)

Overrides java.io.InputStream.mark.

Doc from java.io.InputStream.mark.

Marks the current position in this input stream. A subsequent call to the reset method repositions this stream at the last marked position so that subsequent reads re-read the same bytes.

The readlimit arguments tells this input stream to allow that many bytes to be read before the mark position gets invalidated.

The general contract of mark is that, if the method markSupported returns true, the stream somehow remembers all the bytes read after the call to mark and stands ready to supply those same bytes again if and whenever the method reset is called. However, the stream is not required to remember any data at all if more than readlimit bytes are read from the stream before reset is called.

Marking a closed stream should not have any effect on the stream.

Annotations
@Override
markSupportedback to summary
public boolean markSupported()

Overrides java.io.InputStream.markSupported.

Doc from java.io.InputStream.markSupported.

Tests if this input stream supports the mark and reset methods. Whether or not mark and reset are supported is an invariant property of a particular input stream instance.

Annotations
@Override
readback to summary
public int read() throws IOException

Implements abstract java.io.InputStream.read.

Doc from java.io.InputStream.read.

Reads the next byte of data from the input stream. The value byte is returned as an int in the range 0 to 255. If no byte is available because the end of the stream has been reached, the value -1 is returned. This method blocks until input data is available, the end of the stream is detected, or an exception is thrown.

Annotations
@Override
Exceptions
IOException:
if an I/O error occurs.
readback to summary
public int read(byte[] b, int off, int len) throws IOException

Overrides java.io.InputStream.read.

Doc from java.io.InputStream.read.

Reads up to len bytes of data from the input stream into an array of bytes. An attempt is made to read as many as len bytes, but a smaller number may be read. The number of bytes actually read is returned as an integer.

This method blocks until input data is available, end of file is detected, or an exception is thrown.

If len is zero, then no bytes are read and 0 is returned; otherwise, there is an attempt to read at least one byte. If no byte is available because the stream is at end of file, the value -1 is returned; otherwise, at least one byte is read and stored into b.

The first byte read is stored into element b[off], the next one into b[off+1], and so on. The number of bytes read is, at most, equal to len. Let k be the number of bytes actually read; these bytes will be stored in elements b[off] through b[off+k-1], leaving elements b[off+k] through b[off+len-1] unaffected.

In every case, elements b[0] through b[off-1] and elements b[off+len] through b[b.length-1] are unaffected.

Annotations
@Override
Exceptions
IOException:
If the first byte cannot be read for any reason other than end of file, or if the input stream has been closed, or if some other I/O error occurs.
resetback to summary
public synchronized void reset() throws IOException

Overrides java.io.InputStream.reset.

Doc from java.io.InputStream.reset.

Repositions this stream to the position at the time the mark method was last called on this input stream.

The general contract of reset is:

  • If the method markSupported returns true, then:
    • If the method mark has not been called since the stream was created, or the number of bytes read from the stream since mark was last called is larger than the argument to mark at that last call, then an IOException might be thrown.
    • If such an IOException is not thrown, then the stream is reset to a state such that all the bytes read since the most recent call to mark (or since the start of the file, if mark has not been called) will be resupplied to subsequent callers of the read method, followed by any bytes that otherwise would have been the next input data as of the time of the call to reset.
  • If the method markSupported returns false, then:
    • The call to reset may throw an IOException.
    • If an IOException is not thrown, then the stream is reset to a fixed state that depends on the particular type of the input stream and how it was created. The bytes that will be supplied to subsequent callers of the read method depend on the particular type of the input stream.
Annotations
@Override
Exceptions
IOException:
if this stream has not been marked or if the mark has been invalidated.
skipback to summary
public long skip(long n) throws IOException

Overrides java.io.InputStream.skip.

Doc from java.io.InputStream.skip.

Skips over and discards n bytes of data from this input stream. The skip method may, for a variety of reasons, end up skipping over some smaller number of bytes, possibly 0. This may result from any of a number of conditions; reaching end of file before n bytes have been skipped is only one possibility. The actual number of bytes skipped is returned. If n is negative, the skip method for class InputStream always returns 0, and no bytes are skipped. Subclasses may handle the negative value differently.

Annotations
@Override
Exceptions
IOException:
if an I/O error occurs.
com.sun.media.sound back to summary

private Class AudioFloatFormatConverter.AudioFloatInputStreamChannelMixer

extends AudioFloatInputStream
Class Inheritance

Field Summary

Modifier and TypeField and Description
private final AudioFloatInputStream
private float[]
private final int
private final int
private final AudioFormat

Constructor Summary

AccessConstructor and Description
pack-priv

Method Summary

Modifier and TypeMethod and Description
public int
public void
public AudioFormat
public long
public void
mark(int readlimit)

Implements abstract com.sun.media.sound.AudioFloatInputStream.mark.

public boolean
public int
read(float[] b, int off, int len)

Implements abstract com.sun.media.sound.AudioFloatInputStream.read.

public void
public long
Inherited from com.sun.media.sound.AudioFloatInputStream:
getInputStreamgetInputStreamgetInputStreamgetInputStreamgetInputStreamreadread

Field Detail

aisback to summary
private final AudioFloatInputStream ais
conversion_bufferback to summary
private float[] conversion_buffer
sourceChannelsback to summary
private final int sourceChannels
targetChannelsback to summary
private final int targetChannels
targetFormatback to summary
private final AudioFormat targetFormat

Constructor Detail

AudioFloatInputStreamChannelMixerback to summary
pack-priv AudioFloatInputStreamChannelMixer(AudioFloatInputStream ais, int targetChannels)

Method Detail

availableback to summary
public int available() throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.available.

Annotations
@Override
closeback to summary
public void close() throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.close.

Annotations
@Override
getFormatback to summary
public AudioFormat getFormat()

Implements abstract com.sun.media.sound.AudioFloatInputStream.getFormat.

Annotations
@Override
getFrameLengthback to summary
public long getFrameLength()

Implements abstract com.sun.media.sound.AudioFloatInputStream.getFrameLength.

Annotations
@Override
markback to summary
public void mark(int readlimit)

Implements abstract com.sun.media.sound.AudioFloatInputStream.mark.

Annotations
@Override
markSupportedback to summary
public boolean markSupported()

Implements abstract com.sun.media.sound.AudioFloatInputStream.markSupported.

Annotations
@Override
readback to summary
public int read(float[] b, int off, int len) throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.read.

Annotations
@Override
resetback to summary
public void reset() throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.reset.

Annotations
@Override
skipback to summary
public long skip(long len) throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.skip.

Annotations
@Override
com.sun.media.sound back to summary

private Class AudioFloatFormatConverter.AudioFloatInputStreamResampler

extends AudioFloatInputStream
Class Inheritance

Field Summary

Modifier and TypeField and Description
private final AudioFloatInputStream
private final int
private float[][]
private final float[][]
private final float[]
private float
private int
private final float[]
private float[][]
private float
private int
private final int
private final int[]
private final int
private final int
private final float[]
private SoftAbstractResampler
private float[]
private final AudioFormat

Constructor Summary

AccessConstructor and Description
pack-priv

Method Summary

Modifier and TypeMethod and Description
public int
public void
public AudioFormat
public long
public void
mark(int readlimit)

Implements abstract com.sun.media.sound.AudioFloatInputStream.mark.

public boolean
public int
read(float[] b, int off, int len)

Implements abstract com.sun.media.sound.AudioFloatInputStream.read.

private void
public void
public long
Inherited from com.sun.media.sound.AudioFloatInputStream:
getInputStreamgetInputStreamgetInputStreamgetInputStreamgetInputStreamreadread

Field Detail

aisback to summary
private final AudioFloatInputStream ais
buffer_lenback to summary
private final int buffer_len
cbufferback to summary
private float[][] cbuffer
ibufferback to summary
private final float[][] ibuffer
ibuffer2back to summary
private final float[] ibuffer2
ibuffer_indexback to summary
private float ibuffer_index
ibuffer_lenback to summary
private int ibuffer_len
ixback to summary
private final float[] ix
mark_ibufferback to summary
private float[][] mark_ibuffer
mark_ibuffer_indexback to summary
private float mark_ibuffer_index
mark_ibuffer_lenback to summary
private int mark_ibuffer_len
nrofchannelsback to summary
private final int nrofchannels
oxback to summary
private final int[] ox
padback to summary
private final int pad
pad2back to summary
private final int pad2
pitchback to summary
private final float[] pitch
resamplerback to summary
private SoftAbstractResampler resampler
skipbufferback to summary
private float[] skipbuffer
targetFormatback to summary
private final AudioFormat targetFormat

Constructor Detail

AudioFloatInputStreamResamplerback to summary
pack-priv AudioFloatInputStreamResampler(AudioFloatInputStream ais, AudioFormat format)

Method Detail

availableback to summary
public int available() throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.available.

Annotations
@Override
closeback to summary
public void close() throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.close.

Annotations
@Override
getFormatback to summary
public AudioFormat getFormat()

Implements abstract com.sun.media.sound.AudioFloatInputStream.getFormat.

Annotations
@Override
getFrameLengthback to summary
public long getFrameLength()

Implements abstract com.sun.media.sound.AudioFloatInputStream.getFrameLength.

Annotations
@Override
markback to summary
public void mark(int readlimit)

Implements abstract com.sun.media.sound.AudioFloatInputStream.mark.

Annotations
@Override
markSupportedback to summary
public boolean markSupported()

Implements abstract com.sun.media.sound.AudioFloatInputStream.markSupported.

Annotations
@Override
readback to summary
public int read(float[] b, int off, int len) throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.read.

Annotations
@Override
readNextBufferback to summary
private void readNextBuffer() throws IOException
resetback to summary
public void reset() throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.reset.

Annotations
@Override
skipback to summary
public long skip(long len) throws IOException

Implements abstract com.sun.media.sound.AudioFloatInputStream.skip.

Annotations
@Override