JavaTM Platform
Standard Ed. 6

javax.imageio.event
インタフェース IIOReadProgressListener

すべてのスーパーインタフェース:
EventListener

public interface IIOReadProgressListener
extends EventListener

呼び出し側にイメージとサムネールの進捗の読み込みメソッドを通知する、ImageReader 実装で使用されるインタフェースです。

このインタフェースは、imageProgress および thumbnailProgress メソッドを介して復号化の進捗に関する一般的な指示を受け取り、imageStartedimageCompletethumbnailStarted、および 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

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

特定の 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 オブジェクト

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。