javax.imageio.event
接口 IIOReadProgressListener

所有超级接口：

EventListener

public interface IIOReadProgressListener
extends EventListener

供 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) 报告缩略图读操作将要开始。

方法详细信息

sequenceStarted

void sequenceStarted(ImageReader source,
                     int minIndex)

报告读操作序列将要开始。ImageReader 实现需要从其 readAll(Iterator) 方法仅调用此方法一次。

参数：

source - 调用此方法的 ImageReader 对象。

minIndex - 要读取的第一个图像的索引。

sequenceComplete

void sequenceComplete(ImageReader source)

报告读操作序列已经完成。ImageReader 实现需要从其 readAll(Iterator) 方法仅调用此方法一次。

参数：

source - 调用此方法的 ImageReader 对象。

imageStarted

void imageStarted(ImageReader source,
                  int imageIndex)

报告图像读操作将要开始。所有 ImageReader 实现均需在开始图像读操作时仅调用此方法一次。

参数：

source - 调用此方法的 ImageReader 对象。

imageIndex - 图像的索引，该图像将从包含其的输入文件或流中读取。

imageProgress

void imageProgress(ImageReader source,
                   float percentageDone)

报告对关联 ImageReader 的 read 当前调用的近似完成程度。

完成程度以百分比表示，变动范围从 0.0F 到 100.0F。在理想情况下，应该按照完成的剩余时间来计算百分比，但使用定义更加明确的度量标准（如解码的像素或输入流的消耗部分）往往更为实际。无论如何，在给定读操作过程中调用此方法的序列都应该提供一个百分比值的单调渐增序列。没有必要提供确切值 0 和 100，因为来自其他方法的被调用者可以推导出这些值。

每个特定 ImageReader 实现可以用所需的任何频率调用此方法。单凭经验的方法是每 5 个百分点调用该方法一次。

参数：

source - 调用此方法的 ImageReader 对象。

percentageDone - 已经完成的解码的近似百分比。

imageComplete

void imageComplete(ImageReader source)

报告当前图像读操作已经完成。所有 ImageReader 实现均需在完成每个图像读操作时仅调用此方法一次。

参数：

source - 调用此方法的 ImageReader 对象。

thumbnailStarted

void thumbnailStarted(ImageReader source,
                      int imageIndex,
                      int thumbnailIndex)

报告缩略图读操作将要开始。所有 ImageReader 实现均需在开始缩略图读操作时仅调用此方法一次。

参数：

source - 调用此方法的 ImageReader 对象。

imageIndex - 图像的索引，该图像将从包含其的输入文件或流中读取。

thumbnailIndex - 要读取的缩略图的索引。

thumbnailProgress

void thumbnailProgress(ImageReader source,
                       float percentageDone)

报告在关联的 ImageReader 中完成当前 getThumbnail 调用的近似程度。该语义与 imageProgress 中的相同。

参数：

source - 调用此方法的 ImageReader 对象。

percentageDone - 已经完成的解码的近似百分比。

thumbnailComplete

void thumbnailComplete(ImageReader source)

报告缩略图读操作已经完成。所有 ImageReader 实现均需在完成每个缩略图读操作时仅调用此方法一次。

参数：

source - 调用此方法的 ImageReader 对象。

readAborted

void readAborted(ImageReader source)

报告已通过 reader 的 abort 方法中止读操作。没有给出进一步的通知。

参数：

source - 调用此方法的 ImageReader 对象。