Module java.desktop
Package javax.imageio.event

Interface IIOWriteProgressListener

所有超级接口:
EventListener
public interface IIOWriteProgressListener extends EventListener
由ImageWriter实现使用的接口，用于通知调用者其图像写入方法的进度。
参见:

  • Method Details

    • 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对象。