java.awt.image
クラス ImageFilter

java.lang.Object
  |
  +--java.awt.image.ImageFilter

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

Cloneable, ImageConsumer

直系の既知のサブクラス:

BufferedImageFilter, CropImageFilter, ReplicateScaleFilter, RGBImageFilter

public class ImageFilter

extends Object

implements ImageConsumer, Cloneable

このクラスには、一連のインタフェースメソッド用のフィルタが実装されており、ImageProducer から ImageConsumer へデータを転送するために使われます。既存イメージをフィルタ処理するには、FilteredImageSource オブジェクトと連結して使います。この基本クラスは、「空フィルタ」を実装するための呼び出しを行います。「空フィルタ」は、転送されてくるデータに何の影響も与えません。フィルタを実装するときは、このクラスをサブクラス化して、データをフィルタ処理するメソッドをオーバーライドします。また、必要に応じて修正を加えます。

関連項目:

FilteredImageSource, ImageConsumer

フィールドの概要

protected ImageConsumer

consumer 特別なイメージデータストリームのコンシューマであり、ImageFilter のこのインスタンスがデータをフィルタ処理します。

インタフェース java.awt.image.ImageConsumer から継承したフィールド

COMPLETESCANLINES, IMAGEABORTED, IMAGEERROR, RANDOMPIXELORDER, SINGLEFRAME, SINGLEFRAMEDONE, SINGLEPASS, STATICIMAGEDONE, TOPDOWNLEFTRIGHT

コンストラクタの概要

ImageFilter()

メソッドの概要

Object	clone() このオブジェクトを複製します。
ImageFilter	getFilterInstance(ImageConsumer ic) 指定された ImageConsumer のフィルタリングを実際に行う ImageFilter オブジェクトの一意なインスタンスを返します。
void	imageComplete(int status) ImageConsumer インタフェースの imageComplete メソッドで提供される情報をフィルタ処理します。
void	resendTopDownLeftRight(ImageProducer ip) ImageConsumer からのピクセルデータ再転送要求に応じます。
void	setColorModel(ColorModel model) ImageConsumer インタフェースの setColorModel メソッドで提供される情報をフィルタ処理します。
void	setDimensions(int width, int height) ImageConsumer インタフェースの setDimensions メソッドで提供される情報をフィルタ処理します。
void	setHints(int hints) ImageConsumer インタフェースの setHints メソッドで提供される情報をフィルタ処理します。
void	setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize) byte 配列をとる、ImageConsumer インタフェースの setPixels メソッドで提供される情報をフィルタ処理します。
void	setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize) int 配列をとる、ImageConsumer インタフェースの setPixels メソッドで提供される情報をフィルタ処理します。
void	setProperties(Hashtable props) フィルタのストリームを通過したことを示すプロパティを追加したあと、ソースオブジェクトからプロパティを渡します。

クラス java.lang.Object から継承したメソッド

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

consumer

protected ImageConsumer consumer

特別なイメージデータストリームのコンシューマであり、ImageFilter のこのインスタンスがデータをフィルタ処理します。この初期化は、コンストラクタの中ではなく、getFilterInstance() メソッドの呼び出し中に行われます。そのときに、FilteredImageSource により、特別なイメージデータストリームのためのオブジェクト固有のインスタンスが生成されます。

関連項目:

getFilterInstance(java.awt.image.ImageConsumer), ImageConsumer

コンストラクタの詳細

ImageFilter

public ImageFilter()

メソッドの詳細

getFilterInstance

public ImageFilter getFilterInstance(ImageConsumer ic)

指定された ImageConsumer のフィルタリングを実際に行う ImageFilter オブジェクトの一意なインスタンスを返します。デフォルトの実装では、このオブジェクトを複製するだけです。

注: このメソッドは、フィルタ処理の対象となるピクセルで構成される Image の ImageProducer によって呼び出されます。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。このメソッドを直接呼び出すと、フィルタ処理を妨げる可能性があります。

パラメータ:

ic - 指定された ImageConsumer

戻り値:

指定された ImageConsumer のフィルタ処理に使用される ImageFilter

setDimensions

public void setDimensions(int width,
                          int height)

ImageConsumer インタフェースの setDimensions メソッドで提供される情報をフィルタ処理します。

注: このメソッドは、フィルタ処理の対象となるピクセルで構成される Image の ImageProducer によって呼び出されます。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。このメソッドを直接呼び出すと、フィルタ処理を妨げる可能性があります。

定義:

インタフェース ImageConsumer 内の setDimensions

パラメータ:

width - ソースイメージの幅

height - ソースイメージの高さ

関連項目:

ImageConsumer.setDimensions(int, int)

setProperties

public void setProperties(Hashtable props)

フィルタのストリームを通過したことを示すプロパティを追加したあと、ソースオブジェクトからプロパティを渡します。

注: このメソッドは、フィルタ処理の対象となるピクセルで構成される Image の ImageProducer によって呼び出されます。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。このメソッドを直接呼び出すと、フィルタ処理が妨げられる可能性があります。

定義:

インタフェース ImageConsumer 内の setProperties

パラメータ:

props - このイメージに関連付けるプロパティのリスト

setColorModel

public void setColorModel(ColorModel model)

ImageConsumer インタフェースの setColorModel メソッドで提供される情報をフィルタ処理します。

注: このメソッドは、フィルタ処理の対象となるピクセルで構成される Image の ImageProducer によって呼び出されます。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。このメソッドを直接呼び出すと、フィルタ処理が妨げられる可能性があります。

定義:

インタフェース ImageConsumer 内の setColorModel

パラメータ:

model - 指定された ColorModel

関連項目:

ImageConsumer.setColorModel(java.awt.image.ColorModel)

setHints

public void setHints(int hints)

ImageConsumer インタフェースの setHints メソッドで提供される情報をフィルタ処理します。

注: このメソッドは、フィルタ処理の対象となるピクセルで構成される Image の ImageProducer によって呼び出されます。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。このメソッドを直接呼び出すと、フィルタ処理が妨げられる可能性があります。

定義:

インタフェース ImageConsumer 内の setHints

パラメータ:

hints - ImageConsumer がピクセル処理に使用するヒントのセット

関連項目:

ImageConsumer.setHints(int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      byte[] pixels,
                      int off,
                      int scansize)

byte 配列をとる、ImageConsumer インタフェースの setPixels メソッドで提供される情報をフィルタ処理します。

注: このメソッドは、フィルタ処理の対象となるピクセルで構成される Image の ImageProducer によって呼び出されます。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。このメソッドを直接呼び出すと、フィルタ処理が妨げられる可能性があります。

定義:

インタフェース ImageConsumer 内の setPixels

パラメータ:

w - ピクセル領域の幅

h - ピクセル領域の高さ

model - 指定された ColorModel

pixels - ピクセルの配列

off - pixels 配列のオフセット

scansize - pixels 配列内の、あるピクセル行から次のピクセル行までの距離

関連項目:

ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

setPixels

public void setPixels(int x,
                      int y,
                      int w,
                      int h,
                      ColorModel model,
                      int[] pixels,
                      int off,
                      int scansize)

int 配列をとる、ImageConsumer インタフェースの setPixels メソッドで提供される情報をフィルタ処理します。

注: このメソッドは、フィルタ処理の対象となるピクセルで構成される Image の ImageProducer によって呼び出されます。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。このメソッドを直接呼び出すと、フィルタ処理が妨げられる可能性があります。

定義:

インタフェース ImageConsumer 内の setPixels

パラメータ:

w - ピクセル領域の幅

h - ピクセル領域の高さ

model - 指定された ColorModel

pixels - ピクセルの配列

off - pixels 配列のオフセット

scansize - pixels 配列内の、あるピクセル行から次のピクセル行までの距離

関連項目:

ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

imageComplete

public void imageComplete(int status)

ImageConsumer インタフェースの imageComplete メソッドで提供される情報をフィルタ処理します。

注: このメソッドは、フィルタ処理の対象となるピクセルで構成される Image の ImageProducer によって呼び出されます。このクラスを使用してイメージのピクセルをフィルタ処理する開発者は、このメソッドを直接呼び出さないでください。このメソッドを直接呼び出すと、フィルタ処理が妨げられる可能性があります。

定義:

インタフェース ImageConsumer 内の imageComplete

パラメータ:

status - イメージロードの状態

関連項目:

ImageConsumer.imageComplete(int)

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer ip)

ImageConsumer からのピクセルデータ再転送要求に応じます。上から下、左から右の順番で処理されます。ImageFilter は、この要求に以下の 3 つの方法のいずれかで対応できます。

1. 上位のプロデューサオブジェクトがピクセルを上下左右順で送る場合に、そのピクセルを上下左右順で転送することをこのフィルタが決定できるときは、このフィルタを要求を出している ImageConsumer として使い、この要求を自動的に、指定された ImageProducer に対してデフォルトとして転送する。そのため、オーバーライドする必要がない。
2. このフィルタ自体が、ピクセルを (おそらくバッファのようなところに保存し) 正しい順序で再転送することができる場合、このメソッドをオーバーライドして、ImageProducer API で指定されたように上下左右順に単純に再転送できる。
3. このフィルタがこのメソッドから返されるだけの場合、要求は無視され、再転送は行われない。

パラメータ:

ip - このフィルタのインスタンスを供給する、また必要に応じて要求を転送する ImageProducer

関連項目:

ImageProducer.requestTopDownLeftRightResend(java.awt.image.ImageConsumer)

clone

public Object clone()

このオブジェクトを複製します。

オーバーライド:

クラス Object 内の clone

戻り値:

このインスタンスの複製

関連項目:

Cloneable