public interface IIOReadProgressListener
供 ImageReader
实现用于通知其图像和缩略图读取方法的调用者相关进度的接口。
此接口接收解码进度的通用指示(通过 imageProgress
和 thumbnailProgress
方法)和指示何时整个图像已经更新的事件(通过 imageStarted
、imageComplete
、thumbnailStarted
和 thumbnailComplete
方法)。希望在像素更新发生时得到通知的应用程序(例如,在逐步解码过程中)应该提供 IIOReadUpdateListener
。
IIOReadUpdateListener
,
ImageReader.addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)
,
ImageReader.removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)
方法摘要 | |
---|---|
void |
imageComplete(ImageReader source) 报告当前图像读操作已经完成。 |
void |
imageProgress(ImageReader source, float percentageDone) 报告对关联 ImageReader 的 read 当前调用的近似完成程度。 |
void |
imageStarted(ImageReader source, int imageIndex) 报告图像读操作将要开始。 |
void |
readAborted(ImageReader source) 报告已通过 reader 的 abort 方法中止读操作。 |
void |
sequenceComplete(ImageReader source) 报告读操作序列已经完成。 |
void |
sequenceStarted(ImageReader source, int minIndex) 报告读操作序列将要开始。 |
void |
thumbnailComplete(ImageReader source) 报告缩略图读操作已经完成。 |
void |
thumbnailProgress(ImageReader source, float percentageDone) 报告在关联的 ImageReader 中完成当前 getThumbnail 调用的近似程度。 |
void |
thumbnailStarted(ImageReader source, int imageIndex, int thumbnailIndex) 报告缩略图读操作将要开始。 |
方法详细信息 |
---|
void sequenceStarted(ImageReader source, int minIndex)
ImageReader
实现需要从其
readAll(Iterator)
方法仅调用此方法一次。
source
- 调用此方法的
ImageReader
对象。
minIndex
- 要读取的第一个图像的索引。
void sequenceComplete(ImageReader source)
ImageReader
实现需要从其
readAll(Iterator)
方法仅调用此方法一次。
source
- 调用此方法的
ImageReader
对象。
void imageStarted(ImageReader source, int imageIndex)
ImageReader
实现均需在开始图像读操作时仅调用此方法一次。
source
- 调用此方法的
ImageReader
对象。
imageIndex
- 图像的索引,该图像将从包含其的输入文件或流中读取。
void imageProgress(ImageReader source, float percentageDone)
ImageReader
的
read
当前调用的近似完成程度。
完成程度以百分比表示,变动范围从 0.0F
到 100.0F
。在理想情况下,应该按照完成的剩余时间来计算百分比,但使用定义更加明确的度量标准(如解码的像素或输入流的消耗部分)往往更为实际。无论如何,在给定读操作过程中调用此方法的序列都应该提供一个百分比值的单调渐增序列。没有必要提供确切值 0
和 100
,因为来自其他方法的被调用者可以推导出这些值。
每个特定 ImageReader
实现可以用所需的任何频率调用此方法。单凭经验的方法是每 5 个百分点调用该方法一次。
source
- 调用此方法的
ImageReader
对象。
percentageDone
- 已经完成的解码的近似百分比。
void imageComplete(ImageReader source)
ImageReader
实现均需在完成每个图像读操作时仅调用此方法一次。
source
- 调用此方法的
ImageReader
对象。
void thumbnailStarted(ImageReader source, int imageIndex, int thumbnailIndex)
ImageReader
实现均需在开始缩略图读操作时仅调用此方法一次。
source
- 调用此方法的
ImageReader
对象。
imageIndex
- 图像的索引,该图像将从包含其的输入文件或流中读取。
thumbnailIndex
- 要读取的缩略图的索引。
void thumbnailProgress(ImageReader source, float percentageDone)
ImageReader
中完成当前
getThumbnail
调用的近似程度。该语义与
imageProgress
中的相同。
source
- 调用此方法的
ImageReader
对象。
percentageDone
- 已经完成的解码的近似百分比。
void thumbnailComplete(ImageReader source)
ImageReader
实现均需在完成每个缩略图读操作时仅调用此方法一次。
source
- 调用此方法的
ImageReader
对象。
void readAborted(ImageReader source)
abort
方法中止读操作。没有给出进一步的通知。
source
- 调用此方法的
ImageReader
对象。