JavaTM 2 Platform
Standard Ed. 5.0

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.0F100.0F)表示。在理想情况下,应该按照完成的剩余时间来计算百分比,但使用更加定义明确的度量标准(如解码的像素或输入流的消耗部分)往往更为实际。无论如何,在给定读操作过程中调用此方法的序列都应该提供一个百分比值的单调渐增序列。没有必要提供确切值 0100,因为来自其他方法的被调用方可以推导出这些值。

每个特定 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 对象。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策