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 - 已經完成的解碼的近似百分比。

thumbnailComplete

void thumbnailComplete(ImageReader source)

報告縮略圖讀操作已經完成。所有 ImageReader 實作均需在完成每個縮略圖讀操作時僅調用此方法一次。

參數：

source - 調用此方法的 ImageReader 物件。

readAborted

void readAborted(ImageReader source)

報告已通過 reader 的 abort 方法中止讀操作。沒有給出進一步的通知。

參數：

source - 調用此方法的 ImageReader 物件。