JavaTM 2
Platform
Std. Ed. v1.4.0

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

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

public interface IIOReadUpdateListener
extends EventListener

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

関連項目:
ImageReader.addIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener), ImageReader.removeIIOReadUpdateListener(javax.imageio.event.IIOReadUpdateListener)

メソッドの概要
 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

public void passStarted(ImageReader source,
                        BufferedImage theImage,
                        int pass,
                        int minPass,
                        int maxPass,
                        int minX,
                        int minY,
                        int periodX,
                        int periodY,
                        int[] bands)
現在の読み込みオペレーションがプログレッシブパスを開始することを通知します。プログレッシブエンコーディングをサポートする形式のリーダはこれを使用して、段階的に符号化されたイメージを読み込むときに、各パスが完了するごとにクライアントに通知する必要があります。

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

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

imageUpdate

public void imageUpdate(ImageReader source,
                        BufferedImage theImage,
                        int minX,
                        int minY,
                        int width,
                        int height,
                        int periodX,
                        int periodY,
                        int[] bands)
指定されたイメージ領域が更新されたことを通知します。プログレッシブな表示効果を出したり、ほかの追加的な処理を実行したりするために、指定された領域をアプリケーションで再表示することもあります。

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

特定の ImageReader 実装で更新の頻度を選択することができます。各更新で、前回の更新以降指定された領域のイメージが更新されたことが指定されます。領域は空間バウンディングボックス (minXminYwidth、および 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

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

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

thumbnailPassStarted

public 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

public 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

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

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

JavaTM 2
Platform
Std. Ed. v1.4.0

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

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.