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

方法摘要

变量和类型	方法	描述
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)	报告写入已通过编写器的 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)

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

参数

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