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)
サムネールの読み込みオペレーションが始まることを通知します。
|
void sequenceStarted(ImageReader source, int minIndex)
ImageReader
実装は、その readAll(Iterator)
メソッドからこのメソッドを 1 回だけ呼び出す必要があります。source
- このメソッドを呼び出す ImageReader
オブジェクト。minIndex
- 読み込まれる最初のイメージのインデックス。void sequenceComplete(ImageReader source)
ImageReader
実装は、その readAll(Iterator)
メソッドからこのメソッドを 1 回だけ呼び出す必要があります。source
- このメソッドを呼び出す ImageReader
オブジェクト。void imageStarted(ImageReader source, int imageIndex)
ImageReader
実装はすべて、イメージの読み込みオペレーションの開始時にこのメソッドを 1 回だけ呼び出す必要があります。source
- このメソッドを呼び出す ImageReader
オブジェクト。imageIndex
- 入力ファイルまたはストリーム内に含まれる、読み込まれるイメージのインデックス。void imageProgress(ImageReader source, float percentageDone)
ImageReader
の、現在の read
呼び出しのおおよその完了度合いを通知します。
完了の度合いは、0.0F
から 100.0F
までのパーセント値で表現されます。パーセントは完了までの残り時間について計算するのが理想的ですが、通常は復号化されたピクセルや使用された入力ストリームの一部などの明確なメトリックスを使用するほうが実際的です。いずれにしても、指定された読み込みオペレーション中のこのメソッドの一連の呼び出しにより、パーセント値が単調に増加していくようにする必要があります。0
と 100
の正確な値は、ほかのメソッドから呼び出される側で推測できるので、指定する必要はありません。
特定の ImageReader
実装は、それぞれ必要な頻度でこのメソッドを呼び出すことができます。経験値では、約 5 パーセントきざみとなるように呼び出します。
source
- このメソッドを呼び出す ImageReader
オブジェクト。percentageDone
- 完了した復号化のおおよそのパーセント値。void imageComplete(ImageReader source)
ImageReader
実装はすべて、イメージの読み込みオペレーションが完了するごとにこのメソッドを 1 回だけ呼び出す必要があります。source
- このメソッドを呼び出す ImageReader
オブジェクト。void thumbnailStarted(ImageReader source, int imageIndex, int thumbnailIndex)
ImageReader
実装はすべて、サムネールの読み込みオペレーションの開始時にこのメソッドを 1 回だけ呼び出す必要があります。source
- このメソッドを呼び出す ImageReader
オブジェクト。imageIndex
- 入力ファイルまたはストリーム内に含まれる、読み込まれるイメージのインデックス。thumbnailIndex
- 読み込まれるサムネールのインデックス。void thumbnailProgress(ImageReader source, float percentageDone)
ImageReader
内の、現在の getThumbnail
呼び出しのおおよその完了度合いを通知します。セマンティクスは imageProgress
の場合と同じです。source
- このメソッドを呼び出す ImageReader
オブジェクト。percentageDone
- 完了した復号化のおおよそのパーセント値。void thumbnailComplete(ImageReader source)
ImageReader
実装はすべて、サムネールの読み込みオペレーションが完了するごとにこのメソッドを 1 回だけ呼び出す必要があります。source
- このメソッドを呼び出す ImageReader
オブジェクト。void readAborted(ImageReader source)
abort
メソッドにより読み込みが中断されたことを通知します。これ以外の通知は行われません。source
- このメソッドを呼び出す ImageReader
オブジェクト。 バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.