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) リーダの 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

public void sequenceStarted(ImageReader source,
                            int minIndex)

読み込みオペレーションのシーケンスが始まることを通知します。ImageReader 実装は、その readAll(Iterator) メソッドからこのメソッドを 1 回だけ呼び出す必要があります。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト

minIndex - 読み込まれる最初のイメージのインデックス

sequenceComplete

public void sequenceComplete(ImageReader source)

読み込みオペレーションのシーケンスが完了したことを通知します。ImageReader 実装は、その readAll(Iterator) メソッドからこのメソッドを 1 回だけ呼び出す必要があります。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト

imageStarted

public void imageStarted(ImageReader source,
                         int imageIndex)

イメージの読み込みオペレーションが始まることを通知します。ImageReader 実装はすべて、イメージの読み込みオペレーションの開始時にこのメソッドを 1 回だけ呼び出す必要があります。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト

imageIndex - 入力ファイルまたはストリーム内に含まれる、読み込まれるイメージのインデックス

imageProgress

public void imageProgress(ImageReader source,
                          float percentageDone)

関連する ImageReader の、現在の read 呼び出しのおおよその完了度合いを通知します。

完了の度合いは、0.0F から 100.0F までのパーセント値で表現されます。パーセントは完了までの残り時間について計算するのが理想的ですが、通常は復号化されたピクセルや使用された入力ストリームの一部などの明確なメトリックスを使用するほうが実際的です。いずれにしても、指定された読み込みオペレーション中のこのメソッドの一連の呼び出しにより、パーセント値が単調に増加していくようにする必要があります。0 と 100 の正確な値は、ほかのメソッドから呼び出される側で推測できるので、指定する必要はありません。

特定の ImageReader 実装は、それぞれ必要な頻度でこのメソッドを呼び出すことができます。経験値では、約 5 パーセントきざみとなるように呼び出します。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト

percentageDone - 完了した復号化のおおよそのパーセント値

imageComplete

public void imageComplete(ImageReader source)

現在のイメージの読み込みオペレーションが完了したことを通知します。ImageReader 実装はすべて、イメージの読み込みオペレーションが完了するごとにこのメソッドを 1 回だけ呼び出す必要があります。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト

thumbnailStarted

public void thumbnailStarted(ImageReader source,
                             int imageIndex,
                             int thumbnailIndex)

サムネールの読み込みオペレーションが始まることを通知します。ImageReader 実装はすべて、サムネールの読み込みオペレーションの開始時にこのメソッドを 1 回だけ呼び出す必要があります。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト

imageIndex - 入力ファイルまたはストリーム内に含まれる、読み込まれるイメージのインデックス

thumbnailIndex - 読み込まれるサムネールのインデックス

thumbnailProgress

public void thumbnailProgress(ImageReader source,
                              float percentageDone)

関連する ImageReader 内の、現在の getThumbnail 呼び出しのおおよその完了度合いを通知します。セマンティクスは imageProgress の場合と同じです。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト

percentageDone - 完了した復号化のおおよそのパーセント値

thumbnailComplete

public void thumbnailComplete(ImageReader source)

サムネールの読み込みオペレーションが完了したことを通知します。ImageReader 実装はすべて、サムネールの読み込みオペレーションが完了するごとにこのメソッドを 1 回だけ呼び出す必要があります。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト

readAborted

public void readAborted(ImageReader source)

リーダの abort メソッドにより読み込みが中断されたことを通知します。これ以外の通知は行われません。

パラメータ:

source - このメソッドを呼び出す ImageReader オブジェクト