Reports the approximate degree of completion of the current
write
call within the associated
ImageWriter
.
The degree of completion is expressed as an index
indicating which image is being written, and a percentage
varying from 0.0F
to 100.0F
indicating how much of the current image has been output. The
percentage should ideally be calculated in terms of the
remaining time to completion, but it is usually more practical
to use a more well-defined metric such as pixels decoded or
portion of input stream consumed. In any case, a sequence of
calls to this method during a given read operation should
supply a monotonically increasing sequence of percentage
values. It is not necessary to supply the exact values
0
and 100
, as these may be inferred
by the callee from other methods.
Each particular ImageWriter
implementation may
call this method at whatever frequency it desires. A rule of
thumb is to call it around each 5 percent mark.
Parameters:
- source - the ImageWriter
object calling this method.
- percentageDone - the approximate percentage of decoding that
has been completed.