javax.imageio.event
接口 IIOWriteProgressListener

所有超级接口：

EventListener

public interface IIOWriteProgressListener
extends EventListener

供 ImageWriter 实现用于通知其图像和缩略图写入方法的调用方相关进度的方法。

另请参见：

ImageWriter.write(javax.imageio.metadata.IIOMetadata, javax.imageio.IIOImage, javax.imageio.ImageWriteParam)

方法摘要

void	imageComplete(ImageWriter source) 报告图像写操作已经完成。
void	imageProgress(ImageWriter source, float percentageDone) 报告在关联的 ImageWriter 中完成当前 write 调用的近似程度。
void	imageStarted(ImageWriter source, int imageIndex) 报告图像写操作将要开始。
void	thumbnailComplete(ImageWriter source) 报告缩略图写操作已经完成。
void	thumbnailProgress(ImageWriter source, float percentageDone) 报告在关联的 ImageWriter 中完成当前缩略图写操作的近似程度。
void	thumbnailStarted(ImageWriter source, int imageIndex, int thumbnailIndex) 报告缩略图写操作将要开始。
void	writeAborted(ImageWriter source) 报告已通过 writer 的 abort 方法中止写操作。

方法详细信息

imageStarted

void imageStarted(ImageWriter source,
                  int imageIndex)

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

参数：

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

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

imageProgress

void imageProgress(ImageWriter source,
                   float percentageDone)

报告在关联的 ImageWriter 中完成当前 write 调用的近似程度。

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

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

参数：

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

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

imageComplete

void imageComplete(ImageWriter source)

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

参数：

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

thumbnailStarted

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

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

参数：

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

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

thumbnailIndex - 要写入的缩略图的索引。

thumbnailProgress

void thumbnailProgress(ImageWriter source,
                       float percentageDone)

报告在关联的 ImageWriter 中完成当前缩略图写操作的近似程度。该语义与 imageProgress 中的相同。

参数：

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

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

thumbnailComplete

void thumbnailComplete(ImageWriter source)

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

参数：

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

writeAborted

void writeAborted(ImageWriter source)

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

参数：

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