javax.imageio.event

Interface IIOWriteProgressListener

All Superinterfaces:

EventListener

public interface IIOWriteProgressListener
extends EventListener

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

另请参见：

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

方法摘要

Modifier and Type	Method and Description
void	imageComplete(ImageWriter source) 报告图像写入操作已完成。
void	imageProgress(ImageWriter source, float percentageDone) 报告在相关联的ImageWriter内的当前 write通话的大致 ImageWriter 。
void	imageStarted(ImageWriter source, int imageIndex) 报告图像写入操作开始。
void	thumbnailComplete(ImageWriter source) 报告缩略图写入操作已完成。
void	thumbnailProgress(ImageWriter source, float percentageDone) 报告相关联的ImageWriter中当前缩略图写入的完成 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)

报告在相关联的ImageWriter内的当前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内当前缩略图的大致ImageWriter 。 语义与imageProgress 。

参数

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

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

thumbnailComplete

void thumbnailComplete(ImageWriter source)

报告缩略图写入操作已完成。 在完成每个缩略图写入操作后，所有ImageWriter实现都需要调用此方法一次。

参数

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

writeAborted

void writeAborted(ImageWriter source)

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

参数

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