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