インタフェース java.awt.image.ImageConsumer 
全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス

インタフェース java.awt.image.ImageConsumer

public interface ImageConsumer
extends Object
ImageProducer インターフェイスを通してイメージデータを表示する オブジェクトのためのインターフェイス。 イメージの消費がイメージ供給者に伝えられると、供給者は このインターフェイスで定義されたメソッドを呼び出すことでイメージデータを転送する。
参照:
ImageProducer

Variable Index

o COMPLETESCANLINES
ピクセルは1度に(複数もしくは1つの)完全な走査線で転送される。
o IMAGEABORTED
イメージ生成が故意に中断された。
o IMAGEERROR
イメージの生成中にエラーが起きた。
o RANDOMPIXELORDER
無順序でピクセルが転送される。
o SINGLEFRAME
イメージデータは、1枚の静的なイメージのみを含んでいる。
o SINGLEFRAMEDONE
イメージ1フレームの転送が完了したが、転送すべきフレームがまだある。
o SINGLEPASS
ピクセルは1回のパスで転送される。
o STATICIMAGEDONE
イメージの転送が完了し、転送すべきピクセルもフレームもない。
o TOPDOWNLEFTRIGHT
ピクセルは上下左右の順で転送される。

Method Index

o imageComplete(int)
このメソッドは、 ImageProducer がイメージのすべてのピクセルの転送を終えたときか、 アニメーションの1フレームの転送を終えたときか、 イメージの生成中にエラーが発生したときに呼ばれる。
o setColorModel(ColorModel)
このメソッドによって主に使われる ColorModel オブジェクトが報告される。
o setDimensions(int, int)
イメージのサイズがこのメソッドによって報告される。
o setHints(int)
ImageProducer はあらゆる順序でピクセルを転送することができるが、 ImageConsumer がどのようにしてピクセルが転送されてくるかを知っていれば、 ImageConsumer はより能率的・高品質の拡縮や ColorModel に 合わせたピクセル変換を行なうことができる。
o setPixels(int, int, int, int, ColorModel, byte[], int, int)
イメージのピクセルは1回以上の setPixels メソッドの 呼び出しによって転送される。
o setPixels(int, int, int, int, ColorModel, int[], int, int)
イメージのピクセルは1回以上の setPixels メソッドの 呼び出しによって転送される。
o setProperties(Hashtable)
このイメージに関連するプロパティのリストを設定する。

Variables

o RANDOMPIXELORDER 
  public final static int RANDOMPIXELORDER
無順序でピクセルが転送される。 ImageConsumer はピクセルの転送順序に依存した最適化はできない。 setHints メソッドが呼ばれていないときは、 無順序な転送を前提とするべきである。
参照:
setHints
o TOPDOWNLEFTRIGHT 
  public final static int TOPDOWNLEFTRIGHT
ピクセルは上下左右の順で転送される。
参照:
setHints
o COMPLETESCANLINES 
  public final static int COMPLETESCANLINES
ピクセルは1度に(複数もしくは1つの)完全な走査線で転送される。
参照:
setHints
o SINGLEPASS 
  public final static int SINGLEPASS
ピクセルは1回のパスで転送される。 各ピクセルは setPixels メソッド中では1回しか転送されない。 この基準に合わないイメージの例として、JPEG がある。 この形式は複数のパスでピクセルを定義し、 後のパスで前のパスより鮮明なイメージを構成する。
参照:
setHints
o SINGLEFRAME 
  public final static int SINGLEFRAME
イメージデータは、1枚の静的なイメージのみを含んでいる。 ピクセルが setPixels メソッドの呼び出しで定義された後、 転送すべきデータが無くなると imageComplete メソッドが STATICIMAGEDONE 付きで呼ばれる。 この基準に合わないイメージの例は、ユーザに操作されている 3Dレンダリングの表示やビデオ出力である。 これらの各フレームの終りは、SINGLEFRAMEDONE 付きの imageComplete の呼び出しで示される。
参照:
setHints, imageComplete
o IMAGEERROR 
  public final static int IMAGEERROR
イメージの生成中にエラーが起きた。
参照:
imageComplete
o SINGLEFRAMEDONE 
  public final static int SINGLEFRAMEDONE
イメージ1フレームの転送が完了したが、転送すべきフレームがまだある。
参照:
imageComplete
o STATICIMAGEDONE 
  public final static int STATICIMAGEDONE
イメージの転送が完了し、転送すべきピクセルもフレームもない。
参照:
imageComplete
o IMAGEABORTED 
  public final static int IMAGEABORTED
イメージ生成が故意に中断された。
参照:
imageComplete

Methods

o setDimensions 
  public abstract void setDimensions(int width,
                                     int height)
イメージのサイズがこのメソッドによって報告される。
o setProperties 
  public abstract void setProperties(Hashtable props)
このイメージに関連するプロパティのリストを設定する。
o setColorModel 
  public abstract void setColorModel(ColorModel model)
このメソッドによって主に使われる ColorModel オブジェクトが報告される。 setPixels メソッドによって転送されたピクセルの塊はそれぞれ ColorModel オブジェクトを含んでいるので、ピクセル値の転送において このメソッドで指定した ColorModel だけが使われるわけではない。 複数の ColorModel オブジェクトが使われる例としては、 フィルタを通したイメージがある。フィルタは無修正で送るピクセルには元の ColorModel を用い、修正するピクセルにはより適した ColorModel を用いる。
参照:
ColorModel
o setHints 
  public abstract void setHints(int hintflags)
ImageProducer はあらゆる順序でピクセルを転送することができるが、 ImageConsumer がどのようにしてピクセルが転送されてくるかを知っていれば、 ImageConsumer はより能率的・高品質の拡縮や ColorModel に 合わせたピクセル変換を行なうことができる。 引数は、ピクセルが転送される方法に関する情報のビットマスクである。 setHints メソッドは setPixels メソッドが呼ばれるより前に呼ばれなければならない。 ImageProducer がこのガイドラインを守らないときの結果は未定義である。
o setPixels 
  public abstract void setPixels(int x,
                                 int y,
                                 int w,
                                 int h,
                                 ColorModel model,
                                 byte pixels[],
                                 int off,
                                 int scansize)
イメージのピクセルは1回以上の setPixels メソッドの 呼び出しによって転送される。 各呼び出しは配列に入っているピクセルの位置と矩形の大きさを指定する。 ピクセルを適切な色とアルファ成分に変換するには、 指定の ColorModel オブジェクトを用いなければならない。 (m, n) の位置のピクセルは、pixels 配列の (n * scansize + m + off) のインデックスに置かれる。 このメソッドで転送されるピクセルは、すべて byte で格納されている。
参照:
ColorModel
o setPixels 
  public abstract void setPixels(int x,
                                 int y,
                                 int w,
                                 int h,
                                 ColorModel model,
                                 int pixels[],
                                 int off,
                                 int scansize)
イメージのピクセルは1回以上の setPixels メソッドの 呼び出しによって転送される。 各呼び出しは配列に入っているピクセルの位置と矩形の大きさを指定する。 ピクセルを適切な色とアルファ成分に変換するには、 指定の ColorModel オブジェクトを用いなければならない。 (m, n) の位置のピクセルは、pixels 配列の (n * scansize + m + off) のインデックスに置かれる。 このメソッドで転送されるピクセルは、すべて int で格納されている。
参照:
ColorModel
o imageComplete 
  public abstract void imageComplete(int status)
このメソッドは、 ImageProducer がイメージのすべてのピクセルの転送を終えたときか、 アニメーションの1フレームの転送を終えたときか、 イメージの生成中にエラーが発生したときに呼ばれる。 エラーが発生したとき、転送に成功したフレームが必要なければ ImageConsumer は ImageProducer に登録された消費者リストから 自分を削除すべきである。
参照:
removeConsumer 
全パッケージ  クラス階層  このパッケージ  前項目  次項目  インデックス
本マニュアルに関する著作権および商標