public interface IIOWriteProgressListener
供 ImageWriter
实现用于通知其图像和缩略图写入方法的调用者相关进度的方法。
方法摘要 | |
---|---|
void |
imageComplete(ImageWriter source) 报告图像写操作已经完成。 |
void |
imageProgress(ImageWriter source, float percentageDone) 报告在关联的 ImageWriter 中完成当前 write 调用的近似程度。 |
void |
imageStarted(ImageWriter source, int imageIndex) 报告图像写操作将要开始。 |
void |
thumbnailComplete(ImageWriter source) 报告缩略图写操作已经完成。 |
void |
thumbnailProgress(ImageWriter source, float percentageDone) 报告在关联的 ImageWriter 中完成当前缩略图写操作的近似程度。 |
void |
thumbnailStarted(ImageWriter source, int imageIndex, int thumbnailIndex) 报告缩略图写操作将要开始。 |
void |
writeAborted(ImageWriter source) 报告已通过 writer 的 abort 方法中止写操作。 |
方法详细信息 |
---|
void imageStarted(ImageWriter source, int imageIndex)
ImageWriter
实现均需在开始图像写操作时仅调用此方法一次。
source
- 调用此方法的
ImageWriter
对象。
imageIndex
- 图像的索引,该图像将写入包含其的输入文件或流。
void imageProgress(ImageWriter source, float percentageDone)
ImageWriter
中完成当前
write
调用的近似程度。
完成程度以指示要写入的图像的索引以及指示已输出当前图像量的百分比(变动范围从 0.0F
到 100.0F
)表示。在理想情况下,应该按照完成的剩余时间来计算百分比,但使用定义更加明确的度量标准(如解码的像素或输入流的消耗部分)往往更为实际。无论如何,在给定读操作过程中调用此方法的序列都应该提供一个百分比值的单调渐增序列。没有必要提供确切值 0
和 100
,因为来自其他方法的被调用者可以推导出这些值。
每个特定 ImageWriter
实现可以用所需的任何频率调用此方法。单凭经验的方法是每 5 个百分点调用该方法一次。
source
- 调用此方法的
ImageWriter
对象。
percentageDone
- 已经完成的解码的近似百分比。
void imageComplete(ImageWriter source)
ImageWriter
实现均需在完成每个图像写操作时仅调用此方法一次。
source
- 调用此方法的
ImageWriter
对象。
void thumbnailStarted(ImageWriter source, int imageIndex, int thumbnailIndex)
ImageWriter
实现均需在开始缩略图写操作时仅调用此方法一次。
source
- 调用此方法的
ImageWrite
对象。
imageIndex
- 图像的索引,该图像将写入包含其的输入文件或流。
thumbnailIndex
- 要写入的缩略图的索引。
void thumbnailProgress(ImageWriter source, float percentageDone)
ImageWriter
中完成当前缩略图写操作的近似程度。该语义与
imageProgress
中的相同。
source
- 调用此方法的
ImageWriter
对象。
percentageDone
- 已经完成的解码的近似百分比。
void thumbnailComplete(ImageWriter source)
ImageWriter
实现均需在完成每个缩略图写操作时仅调用此方法一次。
source
- 调用此方法的
ImageWriter
对象。
void writeAborted(ImageWriter source)
abort
方法中止写操作。没有给出进一步的通知。
source
- 调用此方法的
ImageWriter
对象。