java.awt.image
クラス ImageFilter

java.lang.Object
  java.awt.image.ImageFilter

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

ImageConsumer, Cloneable

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

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 - ソースオブジェクトからのプロパティ

例外:

NullPointerException - props が null の場合

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 のインスタンスによって指定された ImageConsumer が上下左右順でのデータの再送信を要求する場合、FilteredImageSource は ImageFilter のこのメソッドを呼び出します。

ImageFilter サブクラスは、上下左右順でデータを送信するかどうか、およびその方法によって、このメソッドをオーバーライドできる場合とできない場合があります。可能性は 3 つあります。

• このメソッドはオーバーライドしない。これによって、サブクラスはデフォルトの実装を使用する。デフォルトの実装は、要求している ImageConsumer としてこのフィルタを使用して、指定された ImageProducer へ要求を転送する。この動作は、上位のプロデューサオブジェクトが上下左右順でピクセルを送信する場合に、フィルタが上下左右順でピクセルを送信することを判断できる場合に適切
• データを単に送信する場合はメソッドをオーバーライドする。これはフィルタ自体が要求を処理できる場合に適切。たとえば、生成されたピクセルがバッファなどに保存されている場合など
• 何も実行しない場合はメソッドをオーバーライドする。これはフィルタで上下左右順にフィルタを通したデータを生成できない場合に適切

パラメータ:

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

例外:

NullPointerException - ip が null の場合

関連項目:

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

clone

public Object clone()

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

オーバーライド:

クラス Object 内の clone

戻り値:

このインスタンスの複製

関連項目:

Cloneable