模块 java.desktop
包 javax.imageio.event

接口 IIOWriteProgressListener

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

  • 方法详情

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