|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
javax.imageio.event
接口 IIOReadProgressListener
- 所有超级接口:
- EventListener
-
public interface IIOReadProgressListener
- extends EventListener
供 ImageReader
实现用于通知其图像和缩略图读取方法的调用方相关进度的接口。
此接口接收解码进度的通用指示(通过 imageProgress
和 thumbnailProgress
方法)和指示何时整个图像已经更新的事件(通过 imageStarted
、imageComplete
、thumbnailStarted
和 thumbnailComplete
方法)。希望在像素更新发生时得到通知的应用程序(例如,在逐步解码过程中)应该提供 IIOReadUpdateListener
。
- 另请参见:
-
IIOReadUpdateListener
,ImageReader.addIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)
,ImageReader.removeIIOReadProgressListener(javax.imageio.event.IIOReadProgressListener)
方法摘要 | |
---|---|
void |
imageComplete(ImageReader source) 报告当前图像读操作已经完成。 |
void |
imageProgress(ImageReader source, float percentageDone) 报告对关联 ImageReader 的 read 当前调用的近似完成程度。 |
void |
imageStarted(ImageReader source, int imageIndex) 报告图像读操作将要开始。 |
void |
readAborted(ImageReader source) 报告已通过 reader 的 abort 方法中止读操作。 |
void |
sequenceComplete(ImageReader source) 报告读操作序列已经完成。 |
void |
sequenceStarted(ImageReader source, int minIndex) 报告读操作序列将要开始。 |
void |
thumbnailComplete(ImageReader source) 报告缩略图读操作已经完成。 |
void |
thumbnailProgress(ImageReader source, float percentageDone) 报告在关联的 ImageReader 中完成当前 getThumbnail 调用的近似程度。 |
void |
thumbnailStarted(ImageReader source, int imageIndex, int thumbnailIndex) 报告缩略图读操作将要开始。 |
方法详细信息 |
---|
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
- 已经完成的解码的近似百分比。