JavaTM 2 Platform
Std. Ed. v1.3

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

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


setDimensions

public void setDimensions(int width,
                          int height)
ImageConsumer インタフェースの setDimensions メソッドで提供される情報にフィルタをかけます。

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

定義:
インタフェース ImageConsumer 内の setDimensions
関連項目:
ImageConsumer.setDimensions(int, int)

setProperties

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

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

定義:
インタフェース ImageConsumer 内の setProperties

setColorModel

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

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

定義:
インタフェース ImageConsumer 内の setColorModel
関連項目:
ImageConsumer.setColorModel(java.awt.image.ColorModel)

setHints

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

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

定義:
インタフェース 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 メソッドで提供される情報にフィルタをかけます。

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

定義:
インタフェース 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 メソッドで提供される情報にフィルタをかけます。

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

定義:
インタフェース ImageConsumer 内の setPixels
関連項目:
ImageConsumer.setPixels(int, int, int, int, java.awt.image.ColorModel, byte[], int, int)

imageComplete

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

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

定義:
インタフェース 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
クラス java.lang.Object からコピーされたタグ:
戻り値:
このインスタンスの複製
例外:
CloneNotSupportedException - オブジェクトのクラスが Cloneable インタフェースをサポートしていない場合。clone メソッドをオーバーライドしたサブクラスも、インスタンスを複製できないことを示すためにこの例外をスローすることがある
OutOfMemoryError - 十分なメモリがない場合
関連項目:
Cloneable

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

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