javax.imageio.event

Interface IIOReadProgressListener

All Superinterfaces:

EventListener

public interface IIOReadProgressListener
extends EventListener

ImageReader实现使用的ImageReader来通知呼叫者他们的图像和缩略图读取进度方法。

此接口接收解码进展（经由一般指示imageProgress种thumbnailProgress表示当整个图像已经被更新（通过方法），和事件imageStarted ， imageComplete ， thumbnailStarted和thumbnailComplete方法）。 希望在像素更新发生时被通知的应用程序（例如，在逐行解码期间）应该提供一个IIOReadUpdateListener 。

另请参见：

IIOReadUpdateListener ， ImageReader.addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener) ， ImageReader.removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)

方法摘要

Modifier and Type	Method and Description
void	imageComplete(ImageReader source) 报告当前图像读取操作已完成。
void	imageProgress(ImageReader source, float percentageDone) 报告当前 read呼叫的大致完成程度，相关联的 ImageReader 。
void	imageStarted(ImageReader source, int imageIndex) 报告图像读取操作开始。
void	readAborted(ImageReader source) 报告读取已经通过读者的 abort方法中止。
void	sequenceComplete(ImageReader source) 报告一系列读取操作已完成。
void	sequenceStarted(ImageReader source, int minIndex) 报告一系列读操作开始。
void	thumbnailComplete(ImageReader source) 报告缩略图读取操作已完成。
void	thumbnailProgress(ImageReader source, float percentageDone) 报告在相关的ImageReader内的当前 getThumbnail通话的大致 ImageReader 。
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)

报告相关联的read电话的大致ImageReader 。

完成程度以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)

报告当前getThumbnail呼叫在相关联的ImageReader内的大致ImageReader 。 语义与imageProgress 。

参数

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

percentageDone - 已完成的解码大致百分比。

thumbnailComplete

void thumbnailComplete(ImageReader source)

报告缩略图读取操作已完成。 在每个缩略图读取操作完成后，所有ImageReader实现都需要调用此方法一次。

参数

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

readAborted

void readAborted(ImageReader source)

通过读者的abort方法报告读取已被中止。 不会再发出通知。

参数

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