javax.imageio.event

Interface IIOReadUpdateListener

All Superinterfaces:

EventListener

public interface IIOReadUpdateListener
extends EventListener

通过 ImageReader实现用于通知他们的图像和缩略图的阅读方法像素更新用户界面。

另请参见：

ImageReader.addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)， ImageReader.removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)

方法摘要

Modifier and Type	Method and 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) 报告说，一个给定区域的缩略图图像已被更新。

方法详细信息

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 - ints显示设定的频带可以更新数组。

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）。例如，更新：

X = 10迷你= 20宽度= 3高度= 4periodx = 2periody = 3波段= { 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 - ints指示乐队正在更新数组。

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 - ints显示设定的频带可以更新数组。

另请参见：

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 - ints指示乐队正在更新数组。

另请参见：

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)