java.awt.image
クラス ImageFilter

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

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

BufferedImageFilter, CropImageFilter, ReplicateScaleFilter, RGBImageFilter

public class ImageFilter

extends Object

implements ImageConsumer, Cloneable

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

関連項目:

FilteredImageSource, ImageConsumer

フィールドの概要

protected ImageConsumer

consumer 特別なイメージデータストリームのコンシューマにより、ImageFilter のこのインスタンスがデータにフィルタをかけます。

コンストラクタの概要

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 オブジェクトの一意なインスタンスを返します。デフォルトの実装は、このオブジェクトを複製するだけです。

setDimensions

public void setDimensions(int width,
                          int height)

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

定義:

インタフェース ImageConsumer 内の setDimensions

関連項目:

ImageConsumer.setDimensions(int, int)

setProperties

public void setProperties(Hashtable props)

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

定義:

インタフェース ImageConsumer 内の setProperties

setColorModel

public void setColorModel(ColorModel model)

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

定義:

インタフェース ImageConsumer 内の setColorModel

関連項目:

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

setHints

public void setHints(int hints)

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

定義:

インタフェース ImageConsumer 内の setHints

関連項目:

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 メソッドで提供される情報にフィルタをかけます。

定義:

インタフェース ImageConsumer 内の setPixels

関連項目:

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 メソッドで提供される情報にフィルタをかけます。

定義:

インタフェース ImageConsumer 内の setPixels

関連項目:

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

imageComplete

public void imageComplete(int status)

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

定義:

インタフェース ImageConsumer 内の imageComplete

関連項目:

ImageConsumer.imageComplete(int)

resendTopDownLeftRight

public void resendTopDownLeftRight(ImageProducer ip)

ImageConsumer からの上下左右順による、ピクセルデータ再転送の要求に応じます。ImageFilter は、この要求に、以下の 3 つのうちのどれかで応じます。

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

パラメータ:

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

関連項目:

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

clone

public Object clone()

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

オーバーライド:

クラス Object 内の clone