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.