- すべてのスーパー・インタフェース:
EventListener
public interface IIOReadProgressListener extends EventListener
呼出し側にイメージとサムネールの進捗の読込みメソッドを通知する、
ImageReader
実装で使用されるインタフェースです。
このインタフェースは、imageProgress
およびthumbnailProgress
メソッドを介して復号化の進捗に関する一般的な指示を受け取り、imageStarted
、imageComplete
、thumbnailStarted
、およびthumbnailComplete
メソッドを介してイメージ全体の更新が完了したことを示すイベントを受け取ります。 たとえば段階的に復号化するときに、ピクセルの更新が発生したことをアプリケーションに通知する場合は、アプリケーションがIIOReadUpdateListener
を提供する必要があります。
- 関連項目:
-
メソッドのサマリー
修飾子と型メソッド説明void
imageComplete
(ImageReader source) 現在のイメージの読込みオペレーションが完了したことを通知します。void
imageProgress
(ImageReader source, float percentageDone) 関連するImageReader
の、現在のread
呼出しのおおよその完了度合いを通知します。void
imageStarted
(ImageReader source, int imageIndex) イメージの読込みオペレーションが始まることを通知します。void
readAborted
(ImageReader source) リーダーの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)
メソッドからこのメソッドを1回だけ呼び出す必要があります。- パラメータ:
source
- このメソッドを呼び出すImageReader
オブジェクト。minIndex
- 読み込まれる最初のイメージのインデックス。
-
sequenceComplete
void sequenceComplete(ImageReader source) 読込みオペレーションのシーケンスが完了したことを通知します。ImageReader
実装は、そのreadAll(Iterator)
メソッドからこのメソッドを1回だけ呼び出す必要があります。- パラメータ:
source
- このメソッドを呼び出すImageReader
オブジェクト。
-
imageStarted
void imageStarted(ImageReader source, int imageIndex) イメージの読込みオペレーションが始まることを通知します。ImageReader
実装はすべて、イメージの読込みオペレーションの開始時にこのメソッドを1回だけ呼び出す必要があります。- パラメータ:
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
実装はすべて、イメージの読込みオペレーションが完了するごとにこのメソッドを1回だけ呼び出す必要があります。- パラメータ:
source
- このメソッドを呼び出すImageReader
オブジェクト。
-
thumbnailStarted
void thumbnailStarted(ImageReader source, int imageIndex, int thumbnailIndex) サムネールの読込みオペレーションが始まることを通知します。ImageReader
実装はすべて、サムネールの読込みオペレーションの開始時にこのメソッドを1回だけ呼び出す必要があります。- パラメータ:
source
- このメソッドを呼び出すImageReader
オブジェクト。imageIndex
- 入力ファイルまたはストリーム内に含まれる、読み込まれるイメージのインデックス。thumbnailIndex
- 読み込まれるサムネールのインデックス。
-
thumbnailProgress
void thumbnailProgress(ImageReader source, float percentageDone) 関連するImageReader
内の、現在のgetThumbnail
呼出しのおおよその完了度合いを通知します。 セマンティックスはimageProgress
の場合と同じです。- パラメータ:
source
- このメソッドを呼び出すImageReader
オブジェクト。percentageDone
- 完了した復号化のおおよそのパーセント値。
-
thumbnailComplete
void thumbnailComplete(ImageReader source) サムネールの読込みオペレーションが完了したことを通知します。ImageReader
実装はすべて、サムネールの読込みオペレーションが完了するごとにこのメソッドを1回だけ呼び出す必要があります。- パラメータ:
source
- このメソッドを呼び出すImageReader
オブジェクト。
-
readAborted
void readAborted(ImageReader source) リーダーのabort
メソッドにより読込みが中断されたことを通知します。 これ以外の通知は行われません。- パラメータ:
source
- このメソッドを呼び出すImageReader
オブジェクト。
-