java.awt
クラス Image

java.lang.Object
  |
  +--java.awt.Image

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

BufferedImage, VolatileImage

public abstract class Image

extends Object

abstract クラス 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 オブジェクトは、ツールキットが供給するイメージ処理の基盤により効率的に統合され、かつ同じアルゴリズムを実行するフィルタで代用することもできます。

導入されたバージョン:

JDK1.1

関連項目:

ReplicateScaleFilter, 定数フィールド値

SCALE_AREA_AVERAGING

public static final int SCALE_AREA_AVERAGING

Area Averaging イメージスケーリングアルゴリズムを使用します。イメージオブジェクトは、ツールキットが供給するイメージ処理の基盤により効率的に統合され、かつ同じアルゴリズムを実行するフィルタで代用することもできます。

導入されたバージョン:

JDK1.1

関連項目:

AreaAveragingScaleFilter, 定数フィールド値

コンストラクタの詳細

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