模块  java.desktop
软件包  javax.imageio.event

Interface IIOReadUpdateListener

    • 方法详细信息

      • 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 - 将被解码的 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 。
        另请参见：
        ImageReadParam.setSourceProgressivePasses(int, int)

      • 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以及指示可以被更新该组条带。
        另请参见：
        passStarted(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int, 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以及指示正被更新的频带。
        另请参见：
        imageUpdate(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int[])

      • thumbnailPassComplete

        void thumbnailPassComplete​(ImageReader source,
                           BufferedImage theThumbnail)
        报告当前缩略图读取操作已完成渐进式传递。 支持渐进式编码的格式的读者应该在读取逐步编码的缩略图图像时使用此方法在完成每次传递时通知客户端。
        参数
        source - 调用此方法的 ImageReader对象。
        theThumbnail - 正在更新的 BufferedImage缩略图。
        另请参见：
        passComplete(javax.imageio.ImageReader, java.awt.image.BufferedImage)