JavaTM 2 Platform
Std. Ed. v1.3

java.awt
クラス Image

java.lang.Object
  |
  +--java.awt.Image
直系の既知のサブクラス:
BufferedImage

public abstract class Image
extends Object

抽象クラス Image は、グラフィカルイメージを表現するすべてのクラスのスーパークラスです。イメージは、プラットフォーム固有の方法で取得されなければなりません。

導入されたバージョン:
JDK1.0

フィールドの概要
static int SCALE_AREA_AVERAGING
          Area Averaging イメージスケーリングアルゴリズムを使用します。
static int SCALE_DEFAULT
          デフォルトのイメージスケーリングアルゴリズムを使用します。
static int SCALE_FAST
          スケーリング後のイメージの滑らかさよりもスケーリング速度に高い優先順位を与えるイメージスケーリングアルゴリズムを選択します。
static int SCALE_REPLICATE
          ReplicateScaleFilter クラスで具体化されたイメージスケーリングアルゴリズムを使用します。
static int SCALE_SMOOTH
          スケーリング速度よりもイメージの滑らかさに高い優先順位を与えるイメージスケーリングアルゴリズムを選択します。
static Object UndefinedProperty
          UndefinedProperty オブジェクトは、特定イメージ用に定義済みでないプロパティがフェッチされるたびに返されなければなりません。
 
コンストラクタの概要
Image()
           
 
メソッドの概要
abstract  void flush()
          Image オブジェクトに使用されているすべてのリソースを解放します。
abstract  Graphics getGraphics()
          オフスクリーンイメージに描画するためのグラフィックスコンテキストを作成します。
abstract  int getHeight(ImageObserver observer)
          イメージの高さを指定します。
abstract  Object getProperty(String name, ImageObserver observer)
          このイメージのプロパティを名前で返します。
 Image getScaledInstance(int width, int height, int hints)
          このイメージのスケーリングバージョンを作成します。
abstract  ImageProducer getSource()
          イメージのピクセルを作成するオブジェクトを返します。
abstract  int getWidth(ImageObserver observer)
          イメージの幅を指定します。
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

UndefinedProperty

public static final Object UndefinedProperty
UndefinedProperty オブジェクトは、特定イメージ用に定義済みでないプロパティがフェッチされるたびに返されなければなりません。

SCALE_DEFAULT

public static final int SCALE_DEFAULT
デフォルトのイメージスケーリングアルゴリズムを使用します。
導入されたバージョン:
JDK1.1

SCALE_FAST

public static final int SCALE_FAST
スケーリング後のイメージの滑らかさよりもスケーリング速度に高い優先順位を与えるイメージスケーリングアルゴリズムを選択します。
導入されたバージョン:
JDK1.1

SCALE_SMOOTH

public static final int SCALE_SMOOTH
スケーリング速度よりもイメージの滑らかさに高い優先順位を与えるイメージスケーリングアルゴリズムを選択します。
導入されたバージョン:
JDK1.1

SCALE_REPLICATE

public static final int SCALE_REPLICATE
ReplicateScaleFilter クラスで具体化されたイメージスケーリングアルゴリズムを使用します。Image オブジェクトは、ツールキットが供給するイメージ処理の基盤により効率的に統合され、かつ同じアルゴリズムを実行するフィルタで代用することもできます。
関連項目:
ReplicateScaleFilter
導入されたバージョン:
JDK1.1

SCALE_AREA_AVERAGING

public static final int SCALE_AREA_AVERAGING
Area Averaging イメージスケーリングアルゴリズムを使用します。イメージオブジェクトは、ツールキットが供給するイメージ処理の基盤により効率的に統合され、かつ同じアルゴリズムを実行するフィルタで代用することもできます。
関連項目:
AreaAveragingScaleFilter
導入されたバージョン:
JDK1.1
コンストラクタの詳細

Image

public Image()
メソッドの詳細

getWidth

public abstract int getWidth(ImageObserver observer)
イメージの幅を指定します。幅が定義されていない場合、このメソッドは -1 を返し、指定された ImageObserver オブジェクトにはあとで通知されます。
パラメータ:
observer - イメージがロードされるのを待機しているオブジェクト
戻り値:
このイメージの幅。幅が定義されていない場合は -1
関連項目:
getHeight(java.awt.image.ImageObserver), ImageObserver

getHeight

public abstract int getHeight(ImageObserver observer)
イメージの高さを指定します。高さが定義されていない場合、このメソッドは -1 を返し、指定された ImageObserver オブジェクトにはあとで通知されます。
パラメータ:
observer - イメージがロードされるのを待機しているオブジェクト
戻り値:
このイメージの高さ。高さが定義されていない場合は -1
関連項目:
getWidth(java.awt.image.ImageObserver), ImageObserver

getSource

public abstract ImageProducer getSource()
イメージのピクセルを作成するオブジェクトを返します。このメソッドは、イメージフィルタリングクラスと、イメージの変換とスケーリングを実行するメソッドによって呼び出されます。
戻り値:
このイメージのピクセルを作成するイメージプロデューサ
関連項目:
ImageProducer

getGraphics

public abstract Graphics getGraphics()
オフスクリーンイメージに描画するためのグラフィックスコンテキストを作成します。このメソッドは、オフスクリーンイメージにだけ呼び出すことができます。
戻り値:
オフスクリーンイメージに描画するグラフィックスコンテキスト
関連項目:
Graphics, Component.createImage(int, int)

getProperty

public abstract Object getProperty(String name,
                                   ImageObserver observer)
このイメージのプロパティを名前で返します。

個別のプロパティ名はイメージ形式によって定義されます。プロパティが特定イメージ用に定義されていない場合、このメソッドは UndefinedProperty オブジェクトを返します。

このイメージのプロパティが定義されていない場合、このメソッドは null を返し、ImageObserver オブジェクトにはあとで通知されます。

プロパティ名 「comment」を使用すると、アプリケーションに提示できるオプションのコメントをイメージ、そのソース、またはその作成者の記述として格納できます。

パラメータ:
name - プロパティ名
observer - このイメージがロードされるのを待機しているオブジェクト
戻り値:
名前付きプロパティの値
関連項目:
ImageObserver, UndefinedProperty

getScaledInstance

public Image getScaledInstance(int width,
                               int height,
                               int hints)
このイメージのスケーリングバージョンを作成します。デフォルトで指定された widthheight でイメージをレンダリングする、新しい Image オブジェクトが返されます。新しい Image オブジェクトは、元のソースイメージがすでに完全にロード済みであっても非同期にロードされます。widthheight のどちらかが負の数値の場合、元のイメージ寸法の縦横比を維持するような値で代用されます。
パラメータ:
width - イメージのスケーリング後の幅
height - イメージのスケーリング後の高さ
hints - イメージの再抽出のために使うアルゴリズムの種類を示すフラグ
戻り値:
イメージのスケーリングバージョン
導入されたバージョン:
JDK1.1
関連項目:
SCALE_DEFAULT, SCALE_FAST, SCALE_SMOOTH, SCALE_REPLICATE, SCALE_AREA_AVERAGING

flush

public abstract void flush()
Image オブジェクトに使用されているすべてのリソースを解放します。 これはレンダリングのために画面にキャッシュされているすべての ピクセルデータと、このイメージのピクセルおよびデータを格納するすべてのシステムリソースを含みます。イメージは最初に作成された状態に近い状態にリセットされ、再びレンダリングされる場合、イメージデータを作成し直すか、ソースから再度フェッチしなければなりません。

イメージを常に再構築可能な状態にしておくメソッドです。これはつまり、イメージのキャッシュされた表現、または ImageProducer から生成された (たとえばファイルから読み込まれた) イメージの表現など他の 2 次表現に限り、このメソッドが適用されるということです。このメソッドは、データのコピーが 1 つしかないオフスクリーンイメージに対しては何も行いません。


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.