IIOReadUpdateListener (Java Platform SE 6)

メソッドの概要
`void`	`imageUpdate(ImageReader source, BufferedImage theImage, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` 指定されたイメージ領域が更新されたことを通知します。
`void`	`passComplete(ImageReader source, BufferedImage theImage)` 現在の読み込みオペレーションがプログレッシブパスを完了したことを通知します。
`void`	`passStarted(ImageReader source, BufferedImage theImage, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` 現在の読み込みオペレーションがプログレッシブパスを開始することを通知します。
`void`	`thumbnailPassComplete(ImageReader source, BufferedImage theThumbnail)` 現在のサムネール読み込みオペレーションがプログレッシブパスを完了したことを通知します。
`void`	`thumbnailPassStarted(ImageReader source, BufferedImage theThumbnail, int pass, int minPass, int maxPass, int minX, int minY, int periodX, int periodY, int[] bands)` 現在のサムネール読み込みオペレーションがプログレッシブパスを開始することを通知します。
`void`	`thumbnailUpdate(ImageReader source, BufferedImage theThumbnail, int minX, int minY, int width, int height, int periodX, int periodY, int[] bands)` サムネールイメージの指定された領域が更新されたことを通知します。

メソッドの詳細

passStarted

void passStarted(ImageReader source,
                 BufferedImage theImage,
                 int pass,
                 int minPass,
                 int maxPass,
                 int minX,
                 int minY,
                 int periodX,
                 int periodY,
                 int[] bands)

現在の読み込みオペレーションがプログレッシブパスを開始することを通知します。プログレッシブエンコーディングをサポートする形式のリーダーはこれを使用して、段階的に符号化されたイメージを読み込むときに、各パスが完了するごとにクライアントに通知する必要があります。

パスにより更新される領域は、minX と minY パラメータで示されます。パスがインタレースになっている場合、つまり選択した行または列だけを更新する場合は、periodX および periodY パラメータがサブサンプリングの度合いを示します。影響を受けるバンドのセットは bands の値で示されます。

パラメータ:: source - このメソッドを呼び出す ImageReader オブジェクト; theImage - 更新された BufferedImage; pass - 0 から始まるパスの番号; minPass - 復号化される最初のパスのインデックス; maxPass - 復号化される最後のパスのインデックス; minX - 更新されたピクセルのもっとも左側の列の X 座標; minY - 更新されたピクセルの一番上の行の Y 座標; periodX - 更新されたピクセル間の水平間隔。値 1 は間隔なしを意味する; periodY - 更新されたピクセル間の垂直間隔。値 1 は間隔なしを意味する; bands - 更新されるバンドセットを示す int の配列

imageUpdate

void imageUpdate(ImageReader source,
                 BufferedImage theImage,
                 int minX,
                 int minY,
                 int width,
                 int height,
                 int periodX,
                 int periodY,
                 int[] bands)

指定されたイメージ領域が更新されたことを通知します。プログレッシブな表示効果を出したり、ほかの追加的な処理を実行したりするために、指定された領域をアプリケーションで再表示することもあります。

イメージ形式のリーダーが異なれば復号化されたピクセルの生成順序も異なる場合があります。多くのリーダーは上から下、左から右の順にピクセルを生成しますが、インタレース、タイリングなどの複数のパスを使用するものもあります。更新のシーケンスは、ネットワークの速度などにより、呼び出しのたびに異なる場合さえあります。このメソッドの呼び出しでは、指定されたピクセルがすべて実際に更新されたということは保証されません。指定された領域の一部で、ある作業が実行されたことだけが保証されます。

特定の ImageReader 実装で更新の頻度を選択することができます。各更新で、前回の更新以降指定された領域のイメージが更新されたことが指定されます。領域は空間バウンディングボックス (minX、minY、width、および height)、X および Y サブサンプリング係数 (periodX および periodY)、および更新されたバンドのセット (bands) で示されます。たとえば、次の更新について考えてみましょう。

 minX = 10
 minY = 20
 width = 3
 height = 4
 periodX = 2
 periodY = 3
 bands = { 1, 3 }

これは、次のピクセルのバンド 1 と 3 が更新されたことを示します。

 (10, 20) (12, 20) (14, 20)
 (10, 23) (12, 23) (14, 23)
 (10, 26) (12, 26) (14, 26)
 (10, 29) (12, 29) (14, 29)

パラメータ:: source - このメソッドを呼び出す ImageReader オブジェクト; theImage - 更新された BufferedImage; minX - 更新されたピクセルのもっとも左側の列の X 座標; minY - 更新されたピクセルの一番上の行の Y 座標; width - 水平方向の更新されたピクセル数; height - 垂直方向の更新されたピクセル数; periodX - 更新されたピクセル間の水平間隔。値 1 は間隔なしを意味する; periodY - 更新されたピクセル間の垂直間隔。値 1 は間隔なしを意味する; bands - 更新中のバンドを示す int の配列

passComplete

void passComplete(ImageReader source,
                  BufferedImage theImage)

現在の読み込みオペレーションがプログレッシブパスを完了したことを通知します。プログレッシブエンコーディングをサポートする形式のリーダーはこれを使用して、段階的に符号化されたイメージを読み込むときに、各パスが完了するごとにクライアントに通知する必要があります。

パラメータ:: source - このメソッドを呼び出す ImageReader オブジェクト; theImage - 更新された BufferedImage
関連項目:: ImageReadParam.setSourceProgressivePasses(int, int)

thumbnailPassStarted

void thumbnailPassStarted(ImageReader source,
                          BufferedImage theThumbnail,
                          int pass,
                          int minPass,
                          int maxPass,
                          int minX,
                          int minY,
                          int periodX,
                          int periodY,
                          int[] bands)

現在のサムネール読み込みオペレーションがプログレッシブパスを開始することを通知します。プログレッシブエンコーディングをサポートする形式のリーダーはこれを使用して、段階的に符号化されたサムネールイメージを読み込むときに、各パスが完了するごとにクライアントに通知する必要があります。

パラメータ:: source - このメソッドを呼び出す ImageReader オブジェクト; theThumbnail - 更新された BufferedImage サムネール; pass - 0 から始まるパスの番号; minPass - 復号化される最初のパスのインデックス; maxPass - 復号化される最後のパスのインデックス; minX - 更新されたピクセルのもっとも左側の列の X 座標; minY - 更新されたピクセルの一番上の行の Y 座標; periodX - 更新されたピクセル間の水平間隔。値 1 は間隔なしを意味する; periodY - 更新されたピクセル間の垂直間隔。値 1 は間隔なしを意味する; bands - 更新されるバンドセットを示す int の配列
関連項目:: passStarted(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int, int[])

thumbnailUpdate

void thumbnailUpdate(ImageReader source,
                     BufferedImage theThumbnail,
                     int minX,
                     int minY,
                     int width,
                     int height,
                     int periodX,
                     int periodY,
                     int[] bands)

サムネールイメージの指定された領域が更新されたことを通知します。プログレッシブな表示効果を出したり、ほかの追加的な処理を実行したりするために、指定された領域をアプリケーションで再表示することもあります。

パラメータ:: source - このメソッドを呼び出す ImageReader オブジェクト; theThumbnail - 更新された BufferedImage サムネール; minX - 更新されたピクセルのもっとも左側の列の X 座標; minY - 更新されたピクセルの一番上の行の Y 座標; width - 水平方向の更新されたピクセル数; height - 垂直方向の更新されたピクセル数; periodX - 更新されたピクセル間の水平間隔。値 1 は間隔なしを意味する; periodY - 更新されたピクセル間の垂直間隔。値 1 は間隔なしを意味する; bands - 更新中のバンドを示す int の配列
関連項目:: imageUpdate(javax.imageio.ImageReader, java.awt.image.BufferedImage, int, int, int, int, int, int, int[])

thumbnailPassComplete

void thumbnailPassComplete(ImageReader source,
                           BufferedImage theThumbnail)

現在のサムネール読み込みオペレーションがプログレッシブパスを完了したことを通知します。プログレッシブエンコーディングをサポートする形式のリーダーはこれを使用して、段階的に符号化されたサムネールイメージを読み込むときに、各パスが完了するごとにクライアントに通知する必要があります。

パラメータ:: source - このメソッドを呼び出す ImageReader オブジェクト; theThumbnail - 更新された BufferedImage サムネール
関連項目:: passComplete(javax.imageio.ImageReader, java.awt.image.BufferedImage)