IIOReadProgressListener (Java Platform SE 7)

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

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
```
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 オブジェクト。

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース IIOReadProgressListener

メソッドのサマリー

メソッドの詳細

sequenceStarted

sequenceComplete

imageStarted

imageProgress

imageComplete

thumbnailStarted

thumbnailProgress

thumbnailComplete

readAborted