EventListener
public interface IIOReadProgressListener extends EventListener
ImageReader
implementations to notify callers of their image and thumbnail reading methods of progress. This interface receives general indications of decoding progress (via the imageProgress
and thumbnailProgress
methods), and events indicating when an entire image has been updated (via the imageStarted
, imageComplete
, thumbnailStarted
and thumbnailComplete
methods). Applications that wish to be informed of pixel updates as they happen (for example, during progressive decoding), should provide an IIOReadUpdateListener
.
Modifier and Type | Method | Description |
---|---|---|
void |
imageComplete |
Reports that the current image read operation has completed. |
void |
imageProgress |
Reports the approximate degree of completion of the current read call of the associated ImageReader . |
void |
imageStarted |
Reports that an image read operation is beginning. |
void |
readAborted |
Reports that a read has been aborted via the reader's abort method. |
void |
sequenceComplete |
Reports that a sequence of read operations has completed. |
void |
sequenceStarted |
Reports that a sequence of read operations is beginning. |
void |
thumbnailComplete |
Reports that a thumbnail read operation has completed. |
void |
thumbnailProgress |
Reports the approximate degree of completion of the current getThumbnail call within the associated ImageReader . |
void |
thumbnailStarted |
Reports that a thumbnail read operation is beginning. |
void sequenceStarted(ImageReader source, int minIndex)
ImageReader
implementations are required to call this method exactly once from their readAll(Iterator)
method.source
- the ImageReader
object calling this method.minIndex
- the index of the first image to be read.void sequenceComplete(ImageReader source)
ImageReader
implementations are required to call this method exactly once from their readAll(Iterator)
method.source
- the ImageReader
object calling this method.void imageStarted(ImageReader source, int imageIndex)
ImageReader
implementations are required to call this method exactly once when beginning an image read operation.source
- the ImageReader
object calling this method.imageIndex
- the index of the image being read within its containing input file or stream.void imageProgress(ImageReader source, float percentageDone)
read
call of the associated ImageReader
. The degree of completion is expressed as a percentage varying from 0.0F
to 100.0F
. 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 ImageReader
implementation may call this method at whatever frequency it desires. A rule of thumb is to call it around each 5 percent mark.
source
- the ImageReader
object calling this method.percentageDone
- the approximate percentage of decoding that has been completed.void imageComplete(ImageReader source)
ImageReader
implementations are required to call this method exactly once upon completion of each image read operation.source
- the ImageReader
object calling this method.void thumbnailStarted(ImageReader source, int imageIndex, int thumbnailIndex)
ImageReader
implementations are required to call this method exactly once when beginning a thumbnail read operation.source
- the ImageReader
object calling this method.imageIndex
- the index of the image being read within its containing input file or stream.thumbnailIndex
- the index of the thumbnail being read.void thumbnailProgress(ImageReader source, float percentageDone)
getThumbnail
call within the associated ImageReader
. The semantics are identical to those of imageProgress
.source
- the ImageReader
object calling this method.percentageDone
- the approximate percentage of decoding that has been completed.void thumbnailComplete(ImageReader source)
ImageReader
implementations are required to call this method exactly once upon completion of each thumbnail read operation.source
- the ImageReader
object calling this method.void readAborted(ImageReader source)
abort
method. No further notifications will be given.source
- the ImageReader
object calling this method.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/imageio/event/IIOReadProgressListener.html