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	Method and Description
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对象调用此方法。