Module java.desktop
Package javax.imageio.event

Interface IIOReadProgressListener

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

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

参见:

  • Method Details

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