|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
public interface IIOReadProgressListener
呼び出し側にイメージとサムネールの進捗の読み込みメソッドを通知する、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)
サムネールの読み込みオペレーションが始まることを通知します。 |
メソッドの詳細 |
---|
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
オブジェクト
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。