Module java.desktop

软件包 javax.imageio.event

Interface IIOWriteProgressListener

All Superinterfaces:

EventListener

public interface IIOWriteProgressListener
extends EventListener

ImageWriter实现使用的接口通知呼叫者他们的图像写入方法的进度。

另请参见：

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

方法摘要

Modifier and Type	方法	描述
void	imageComplete(ImageWriter source)	报告图像写入操作已完成。
void	imageProgress(ImageWriter source, float percentageDone)	报告当前完成近似程度 write调用相关的内 ImageWriter 。
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)	报告写入已经通过作者的 abort方法中止。

方法详细信息

imageStarted

void imageStarted(ImageWriter source,
                  int imageIndex)

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

参数

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

imageIndex - 图像的索引被写入其包含的输入文件或流中。

imageProgress

void imageProgress(ImageWriter source,
                   float percentageDone)

报告当前完成近似程度write调用相关的内ImageWriter 。

完成度表示为指示正在写入哪个图像的指标，并且从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)

报告写入已经通过作者的abort方法中止。 不会再发出通知。

参数

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