javax.imageio.event
介面 IIOWriteProgressListener

所有父級介面：

EventListener

public interface IIOWriteProgressListener
extends EventListener

供 ImageWriter 實作用於通知其圖像和縮略圖寫入方法的調用者相關進度的方法。

另請參見：

ImageWriter.write(javax.imageio.metadata.IIOMetadata, javax.imageio.IIOImage, javax.imageio.ImageWriteParam)

方法摘要

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 方法中止寫操作。

方法詳細資訊

imageStarted

void imageStarted(ImageWriter source,
                  int imageIndex)

報告圖像寫操作將要開始。所有 ImageWriter 實作均需在開始圖像寫操作時僅調用此方法一次。

參數：

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

imageIndex - 圖像的索引，該圖像將寫入包含其的輸入檔案或串流。

imageProgress

void imageProgress(ImageWriter source,
                   float percentageDone)

報告在關聯的 ImageWriter 中完成當前 write 調用的近似程度。

完成程度以指示要寫入的圖像的索引以及指示已輸出當前圖像量的百分比（變動範圍從 0.0F 到 100.0F）表示。在理想情況下，應該按照完成的剩餘時間來計算百分比，但使用定義更加明確的度量標準（如解碼的像素或輸入串流的消耗部分）往往更為實際。無論如何，在給定讀操作過程中調用此方法的序列都應該提供一個百分比值的單調漸增序列。沒有必要提供確切值 0 和 100，因為來自其他方法的被調用者可以推導出這些值。

每個特定 ImageWriter 實作可以用所需的任何頻率調用此方法。單憑經驗的方法是每 5 個百分點調用該方法一次。

參數：

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

percentageDone - 已經完成的解碼的近似百分比。

imageComplete

void imageComplete(ImageWriter source)

報告圖像寫操作已經完成。所有 ImageWriter 實作均需在完成每個圖像寫操作時僅調用此方法一次。

參數：

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

thumbnailStarted

void thumbnailStarted(ImageWriter source,
                      int imageIndex,
                      int thumbnailIndex)

報告縮略圖寫操作將要開始。所有 ImageWriter 實作均需在開始縮略圖寫操作時僅調用此方法一次。

參數：

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

imageIndex - 圖像的索引，該圖像將寫入包含其的輸入檔案或串流。

thumbnailIndex - 要寫入的縮略圖的索引。

thumbnailProgress

void thumbnailProgress(ImageWriter source,
                       float percentageDone)

報告在關聯的 ImageWriter 中完成當前縮略圖寫操作的近似程度。該語義與 imageProgress 中的相同。

參數：

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

percentageDone - 已經完成的解碼的近似百分比。

thumbnailComplete

void thumbnailComplete(ImageWriter source)

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

參數：

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

writeAborted

void writeAborted(ImageWriter source)

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

參數：

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