javazoom.jl.converter
Interface Converter.ProgressListener
- Converter.PrintWriterProgressListener
public static interface Converter.ProgressListener
This interface is used by the Converter to provide
notification of tasks being carried out by the converter,
and to provide new information as it becomes available.
boolean | converterException(Throwable t) - Called when an exception is thrown during while converting
a frame.
|
void | converterUpdate(int updateID, int param1, int param2) - Notifies the listener that new information is available.
|
void | decodedFrame(int frameNo, Header header, Obuffer o) - This method is called after a frame has been decoded.
|
void | parsedFrame(int frameNo, Header header) - If the converter wishes to make a first pass over the
audio frames, this is called as each frame is parsed.
|
void | readFrame(int frameNo, Header header) - This method is called after each frame has been read,
but before it has been decoded.
|
UPDATE_CONVERT_COMPLETE
public static final int UPDATE_CONVERT_COMPLETE
Conversion is complete. Param1 contains the time
to convert in milliseconds. Param2 contains the number
of MPEG audio frames converted.
UPDATE_FRAME_COUNT
public static final int UPDATE_FRAME_COUNT
converterException
public boolean converterException(Throwable t)
Called when an exception is thrown during while converting
a frame.
t
- The Throwable
instance that
was thrown.
true
to continue processing, or false
to abort conversion.
If this method returns false
, the exception
is propagated to the caller of the convert() method. If
true
is returned, the exception is silently
ignored and the converter moves onto the next frame.
converterUpdate
public void converterUpdate(int updateID,
int param1,
int param2)
Notifies the listener that new information is available.
updateID
- Code indicating the information that has been
updated.param1
- Parameter whose value depends upon the update code.param2
- Parameter whose value depends upon the update code.
The updateID
parameter can take these values:
UPDATE_FRAME_COUNT: param1 is the frame count, or -1 if not known.
UPDATE_CONVERT_COMPLETE: param1 is the conversion time, param2
is the number of frames converted.
decodedFrame
public void decodedFrame(int frameNo,
Header header,
Obuffer o)
This method is called after a frame has been decoded.
frameNo
- The 0-based sequence number of the frame.header
- The Header rerpesenting the frame just read.o
- The Obuffer the deocded data was written to.
parsedFrame
public void parsedFrame(int frameNo,
Header header)
If the converter wishes to make a first pass over the
audio frames, this is called as each frame is parsed.
readFrame
public void readFrame(int frameNo,
Header header)
This method is called after each frame has been read,
but before it has been decoded.
frameNo
- The 0-based sequence number of the frame.header
- The Header rerpesenting the frame just read.
JavaZOOM 1999-2005