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)

このイメージのスケーリングバージョンを作成します。デフォルトで指定された width と height でイメージをレンダリングする、新しい Image オブジェクトが返されます。新しい Image オブジェクトは、元のソースイメージがすでに完全にロード済みであっても非同期にロードされます。width と height のどちらかが負の数値の場合、元のイメージ寸法の縦横比を維持するような値で代用されます。

パラメータ:

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 つしかないオフスクリーンイメージに対しては何も行いません。