Package javazoom.jl.decoder
Class Decoder
java.lang.Object
javazoom.jl.decoder.Decoder
- All Implemented Interfaces:
DecoderErrors
,JavaLayerErrors
The
Decoder
class encapsulates the details of
decoding an MPEG audio frame.- Since:
- 0.0.5
- Version:
- 0.0.7 12/12/99
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic class
TheParams
class presents the customizable aspects of the decoder. -
Field Summary
Fields inherited from interface javazoom.jl.decoder.DecoderErrors
ILLEGAL_SUBBAND_ALLOCATION, UNKNOWN_ERROR, UNSUPPORTED_LAYER
Fields inherited from interface javazoom.jl.decoder.JavaLayerErrors
BITSTREAM_ERROR, DECODER_ERROR
-
Constructor Summary
ConstructorsConstructorDescriptionDecoder()
Creates a newDecoder
instance with default parameters.Decoder
(Decoder.Params params0) Creates a newDecoder
instance with default parameters. -
Method Summary
Modifier and TypeMethodDescriptiondecodeFrame
(Header header, Bitstream stream) Decodes one frame from an MPEG audio bitstream.static Decoder.Params
int
Retrieves the maximum number of samples that will be written to the output buffer when one frame is decoded.int
Retrieves the number of channels of PCM samples output by this decoder.int
Retrieves the sample frequency of the PCM samples output by this decoder.protected DecoderException
newDecoderException
(int errorcode) protected DecoderException
newDecoderException
(int errorcode, Throwable throwable) protected FrameDecoder
retrieveDecoder
(Header header, Bitstream stream, int layer) void
void
setOutputBuffer
(Obuffer out) Changes the output buffer.
-
Constructor Details
-
Decoder
public Decoder()Creates a newDecoder
instance with default parameters. -
Decoder
Creates a newDecoder
instance with default parameters.- Parameters:
params
- TheParams
instance that describes the customizable aspects of the decoder.
-
-
Method Details
-
getDefaultParams
-
setEqualizer
-
decodeFrame
Decodes one frame from an MPEG audio bitstream.- Parameters:
header
- The header describing the frame to decode.bitstream
- The bistream that provides the bits for te body of the frame.- Returns:
- A SampleBuffer containing the decoded samples.
- Throws:
DecoderException
-
setOutputBuffer
Changes the output buffer. This will take effect the next time decodeFrame() is called. -
getOutputFrequency
public int getOutputFrequency()Retrieves the sample frequency of the PCM samples output by this decoder. This typically corresponds to the sample rate encoded in the MPEG audio stream.- Parameters:
the
- sample rate (in Hz) of the samples written to the output buffer when decoding.
-
getOutputChannels
public int getOutputChannels()Retrieves the number of channels of PCM samples output by this decoder. This usually corresponds to the number of channels in the MPEG audio stream, although it may differ.- Returns:
- The number of output channels in the decoded samples: 1 for mono, or 2 for stereo.
-
getOutputBlockSize
public int getOutputBlockSize()Retrieves the maximum number of samples that will be written to the output buffer when one frame is decoded. This can be used to help calculate the size of other buffers whose size is based upon the number of samples written to the output buffer. NB: this is an upper bound and fewer samples may actually be written, depending upon the sample rate and number of channels.- Returns:
- The maximum number of samples that are written to the output buffer when decoding a single frame of MPEG audio.
-
newDecoderException
-
newDecoderException
-
retrieveDecoder
protected FrameDecoder retrieveDecoder(Header header, Bitstream stream, int layer) throws DecoderException - Throws:
DecoderException
-