模块 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)

方法摘要

变量和类型	方法	描述
void	imageComplete(ImageReader source)	报告当前图像读取操作已完成。
void	imageProgress(ImageReader source, float percentageDone)	报告相关 ImageReader当前 read电话的大致完成程度。
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)

报告相关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)

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

参数

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