模块 java.desktop
包 javax.imageio.event

接口 IIOReadProgressListener

所有父级接口：
EventListener
public interface IIOReadProgressListener extends EventListener
ImageReader 实现使用的接口，用于通知调用者其图像和缩略图读取方法的进度。

此接口接收解码进度的一般指示（通过 imageProgress 和 thumbnailProgress 方法），以及指示整个图像何时更新的事件（通过 imageStarted 、 imageComplete 、 thumbnailStarted 和 thumbnailComplete 方法）。希望在像素更新发生时（例如，在渐进式解码期间）被告知的应用程序应提供 IIOReadUpdateListener 。

参见：

  • 方法详情

    • sequenceStarted

      void sequenceStarted(ImageReader  source, int minIndex)
      报告一系列读取操作正在开始。 ImageReader 实现需要从它们的 readAll(Iterator) 方法中恰好调用此方法一次。
      参数：
      source - 调用此方法的 ImageReader 对象。
      minIndex - 要读取的第一张图像的索引。

    • sequenceComplete

      void sequenceComplete(ImageReader  source)
      报告一系列读取操作已完成。 ImageReader 实现需要从它们的 readAll(Iterator) 方法中恰好调用此方法一次。
      参数：
      source - 调用此方法的 ImageReader 对象。

    • imageStarted

      void imageStarted(ImageReader  source, int imageIndex)
      报告图像读取操作正在开始。所有 ImageReader 实现都需要在开始图像读取操作时调用此方法一次。
      参数：
      source - 调用此方法的 ImageReader 对象。
      imageIndex - 在其包含的输入文件或流中读取的图像的索引。

    • imageProgress

      void imageProgress(ImageReader  source, float percentageDone)
      报告关联 ImageReader 的当前 read 调用的大致完成程度。

      完成度表示为从 0.0F 到 100.0F 的百分比。理想情况下，百分比应该根据完成的剩余时间来计算，但通常更实际的做法是使用定义更明确的指标，例如解码的像素或消耗的输入流部分。在任何情况下，在给定读取操作期间对该方法的一系列调用应该提供单调递增的百分比值序列。没有必要提供确切的值 0 和 100 ，因为这些值可以由被调用者从其他方法中推断出来。

      每个特定的 ImageReader 实现都可以按其需要的任何频率调用此方法。一个经验法则是在每 5% 标记附近调用它。

      参数：
      source - 调用此方法的 ImageReader 对象。
      percentageDone - 已完成解码的近似百分比。

    • imageComplete

      void imageComplete(ImageReader  source)
      报告当前图像读取操作已完成。所有 ImageReader 实现都需要在每个图像读取操作完成后恰好调用此方法一次。
      参数：
      source - 调用此方法的 ImageReader 对象。

    • thumbnailStarted

      void thumbnailStarted(ImageReader  source, int imageIndex, int thumbnailIndex)
      报告缩略图读取操作正在开始。所有 ImageReader 实现都需要在开始缩略图读取操作时恰好调用此方法一次。
      参数：
      source - 调用此方法的 ImageReader 对象。
      imageIndex - 在其包含的输入文件或流中读取的图像的索引。
      thumbnailIndex - 正在读取的缩略图的索引。

    • thumbnailProgress

      void thumbnailProgress(ImageReader  source, float percentageDone)
      报告关联的 ImageReader 中当前 getThumbnail 调用的大致完成程度。语义与 imageProgress 的语义相同。
      参数：
      source - 调用此方法的 ImageReader 对象。
      percentageDone - 已完成解码的近似百分比。

    • thumbnailComplete

      void thumbnailComplete(ImageReader  source)
      报告缩略图读取操作已完成。所有 ImageReader 实现都需要在每个缩略图读取操作完成后恰好调用此方法一次。
      参数：
      source - 调用此方法的 ImageReader 对象。

    • readAborted

      void readAborted(ImageReader  source)
      报告读取已通过读取器的 abort 方法中止。将不再另行通知。
      参数：
      source - 调用此方法的 ImageReader 对象。