Module java.desktop
Package javax.imageio.event

Interface IIOReadUpdateListener

所有超接口:
EventListener
public interface IIOReadUpdateListener extends EventListener
由ImageReader实现使用的接口，用于通知调用者其像素更新的图像和缩略图读取方法。
参见:

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    imageUpdate(ImageReader source, BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
    报告图像的给定区域已更新。
    void
    passComplete(ImageReader source, BufferedImage theImage)
    报告当前读取操作已完成渐进式传递。
    void
    passStarted(ImageReader source, BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
    报告当前读取操作即将开始渐进式传递。
    void
    thumbnailPassComplete(ImageReader source, BufferedImage theThumbnail)
    报告当前缩略图读取操作已完成渐进式传递。
    void
    thumbnailPassStarted(ImageReader source, BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
    报告当前缩略图读取操作即将开始渐进式传递。
    void
    thumbnailUpdate(ImageReader source, BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
    报告缩略图图像的给定区域已更新。

  • Method Details

    • passStarted

      void passStarted(ImageReader source, BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
      报告当前读取操作即将开始渐进式传递。支持渐进式编码的格式的读取器应该使用此方法，在读取渐进式编码图像时，通知客户端每个传递何时完成。

      通过minX、minY、width和height参数指示将由传递更新的区域的估计。如果传递是隔行的，即仅更新选定的行或列，则periodX和periodY参数将指示子采样的程度。受影响的波段集由bands的值指示。

      参数:
      source - 调用此方法的ImageReader对象。
      theImage - 正在更新的BufferedImage。
      pass - 即将开始的传递号，从0开始。
      minPass - 将被解码的第一个传递的索引。
      maxPass - 将被解码的最后一个传递的索引。
      minX - 更新的像素最左侧列的X坐标。
      minY - 更新的像素最上方行的Y坐标。
      periodX - 更新像素之间的水平间距；值为1表示没有间隙。
      periodY - 更新像素之间的垂直间距；值为1表示没有间隙。
      bands - 一个表示可能被更新的波段的int数组。

    • imageUpdate

      void imageUpdate(ImageReader source, BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
      报告图像的给定区域已更新。应用程序可能选择重新显示指定区域，例如，为了提供渐进式显示效果，或执行其他增量处理。

      请注意，不同的图像格式读取器可能以各种不同的顺序生成解码像素。许多读取器将以简单的自上而下、从左到右的顺序生成像素，但其他读取器可能使用多次交错、平铺等。更新的顺序甚至可能因网络速度等原因在每次调用时有所不同。调用此方法并不保证所有指定的像素实际上已被更新，只是表明在指定的某个子区域内发生了一些活动。

      特定的ImageReader实现可以选择多久提供更新。每次更新指定图像的给定区域自上次更新以来已更新。区域由其空间边界框（minX、minY、width和height）、X和Y子采样因子（periodX和periodY）以及一组更新的波段（bands）描述。例如，更新:

       minX = 10
 minY = 20
 width = 3
 height = 4
 periodX = 2
 periodY = 3
 bands = { 1, 3 }
      将指示以下像素的1和3波段已更新： 
       (10, 20) (12, 20) (14, 20)
 (10, 23) (12, 23) (14, 23)
 (10, 26) (12, 26) (14, 26)
 (10, 29) (12, 29) (14, 29)
      参数:
      source - 调用此方法的ImageReader对象。
      theImage - 正在更新的BufferedImage。
      minX - 更新的像素最左侧列的X坐标。
      minY - 更新的像素最上方行的Y坐标。
      width - 水平方向更新的像素数。
      height - 垂直方向更新的像素数。
      periodX - 更新像素之间的水平间距；值为1表示没有间隙。
      periodY - 更新像素之间的垂直间距；值为1表示没有间隙。
      bands - 一个表示正在更新的波段的int数组。

    • passComplete

      void passComplete(ImageReader source, BufferedImage theImage)
      报告当前读取操作已完成渐进式传递。支持渐进式编码的格式的读取器应该使用此方法，在读取渐进式编码图像时，通知客户端每个传递何时完成。
      参数:
      source - 调用此方法的ImageReader对象。
      theImage - 正在更新的BufferedImage。
      参见:

    • thumbnailPassStarted

      void thumbnailPassStarted(ImageReader source, BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)
      报告当前缩略图读取操作即将开始渐进式传递。支持渐进式编码的格式的读取器应该使用此方法，在读取渐进式编码缩略图图像时，通知客户端每个传递何时完成。
      参数:
      source - 调用此方法的ImageReader对象。
      theThumbnail - 正在更新的BufferedImage缩略图。
      pass - 即将开始的传递号，从0开始。
      minPass - 将被解码的第一个传递的索引。
      maxPass - 将被解码的最后一个传递的索引。
      minX - 更新的像素最左侧列的X坐标。
      minY - 更新的像素最上方行的Y坐标。
      periodX - 更新像素之间的水平间距；值为1表示没有间隙。
      periodY - 更新像素之间的垂直间距；值为1表示没有间隙。
      bands - 一个表示可能被更新的波段的int数组。
      参见:

    • thumbnailUpdate

      void thumbnailUpdate(ImageReader source, BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)
      报告缩略图图像的给定区域已更新。应用程序可能选择重新显示指定区域，例如，为了提供渐进式显示效果，或执行其他增量处理。
      参数:
      source - 调用此方法的ImageReader对象。
      theThumbnail - 正在更新的BufferedImage缩略图。
      minX - 更新的像素最左侧列的X坐标。
      minY - 更新的像素最上方行的Y坐标。
      width - 水平方向更新的像素数。
      height - 垂直方向更新的像素数。
      periodX - 更新像素之间的水平间距；值为1表示没有间隙。
      periodY - 更新像素之间的垂直间距；值为1表示没有间隙。
      bands - 一个表示正在更新的波段的int数组。
      参见:

    • thumbnailPassComplete

      void thumbnailPassComplete(ImageReader source, BufferedImage theThumbnail)
      报告当前缩略图读取操作已完成渐进式传递。支持渐进式编码的格式的读取器应该使用此方法，在读取渐进式编码缩略图图像时，通知客户端每个传递何时完成。
      参数:
      source - 调用此方法的ImageReader对象。
      theThumbnail - 正在更新的BufferedImage缩略图。
      参见: