Module java.desktop

软件包 javax.imageio.event

Interface IIOReadProgressListener

All Superinterfaces:

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)

方法摘要

Modifier and Type	方法	描述
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电话的大致完成程度。
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 。 语义与imageProgress相同。

参数

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

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

thumbnailComplete

void thumbnailComplete(ImageReader source)

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

参数

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

readAborted

void readAborted(ImageReader source)

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

参数

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