java.awt
クラス Image

java.lang.Object
  java.awt.Image

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

BufferedImage, VolatileImage

public abstract class Image
extends Object

abstract クラス Image は、グラフィカルイメージを表現するすべてのクラスのスーパークラスです。イメージは、必ずプラットフォーム固有の方法で取得してください。

導入されたバージョン:

JDK1.0

フィールドの概要

protected float	accelerationPriority このイメージの高速化の優先順位。
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 オブジェクトに使用されているすべてのリソースを解放します。
float	getAccelerationPriority() 高速化の優先順位のヒントの現在の値を返します。
ImageCapabilities	getCapabilities(GraphicsConfiguration gc) 指定された GraphicsConfiguration のこのイメージの機能を照会できる ImageCapabilities オブジェクトを返します。
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) イメージの幅を指定します。
void	setAccelerationPriority(float priority) このイメージの高速化の重要性に関するヒントを設定します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

フィールドの詳細

accelerationPriority

protected float accelerationPriority

このイメージの高速化の優先順位。サブクラスは自由にさまざまなデフォルトの優先順位を設定し、アプリケーションは setAccelerationPriority(float) メソッドを使用して自由に特定のイメージの優先順位を設定できます。

導入されたバージョン:

1.5

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()

オフスクリーンイメージに描画するためのグラフィックスコンテキストを作成します。このメソッドは、オフスクリーンイメージにだけ呼び出すことができます。

戻り値:

オフスクリーンイメージに描画するグラフィックスコンテキスト

例外:

UnsupportedOperationException - オフスクリーンイメージ以外に対して呼び出された場合

関連項目:

Graphics, Component.createImage(int, int)

getProperty

public abstract Object getProperty(String name,
                                   ImageObserver observer)

このイメージのプロパティを名前で返します。

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

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

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

パラメータ:

name - プロパティ名

observer - このイメージがロードされるのを待機しているオブジェクト

戻り値:

名前付きプロパティの値

例外:

NullPointerException - プロパティ名が null の場合

関連項目:

ImageObserver, UndefinedProperty

getScaledInstance

public Image getScaledInstance(int width,
                               int height,
                               int hints)

このイメージのスケーリングバージョンを作成します。デフォルトで指定された width と height でイメージをレンダリングする、新しい Image オブジェクトが返されます。新しい Image オブジェクトは、元のソースイメージがすでに完全にロード済みであっても非同期にロードされます。

width と height のどちらかが負の数値の場合、元のイメージ寸法の縦横比を維持するような値で代用されます。width と height のどちらも負の数値の場合、元のイメージ寸法が使用されます。

パラメータ:

width - イメージのスケーリング後の幅

height - イメージのスケーリング後の高さ

hints - イメージの再抽出のために使うアルゴリズムの種類を示すフラグ

戻り値:

イメージのスケーリングバージョン

例外:

IllegalArgumentException - width、または height がゼロの場合

導入されたバージョン:

JDK1.1

関連項目:

SCALE_DEFAULT, SCALE_FAST, SCALE_SMOOTH, SCALE_REPLICATE, SCALE_AREA_AVERAGING

flush

public abstract void flush()

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

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

getCapabilities

public ImageCapabilities getCapabilities(GraphicsConfiguration gc)

指定された GraphicsConfiguration のこのイメージの機能を照会できる ImageCapabilities オブジェクトを返します。プログラマが、生成した特定のイメージオブジェクトの、より詳細な実行時の情報を取得できるようになります。たとえばユーザが BufferedImage を生成する時に、そのサイズのイメージを生成するための空き領域がビデオメモリに残っていない場合、オブジェクトは一般に高速化可能ですが、この GraphicsConfiguration ではその機能がありません。

パラメータ:

gc - GraphicsConfiguration オブジェクト。このパラメータの値が null の場合、デフォルトの GraphicsConfiguration のイメージ機能が取得される

戻り値:

指定された GraphicsConfiguration のこの Image の機能についての情報を持つ ImageCapabilities オブジェクト

導入されたバージョン:

1.5

関連項目:

VolatileImage.getCapabilities()

setAccelerationPriority

public void setAccelerationPriority(float priority)

このイメージの高速化の重要性に関するヒントを設定します。この優先順位のヒントは、ビデオメモリなどの高速化が難しいリソースの使用方法を判断する場合に、ほかのイメージオブジェクトの優先順位と比較するために使用します。このイメージの高速化が可能な場合、その高速化を実現するために使用可能なリソースが不足しているが、優先順位の低い他のイメージの高速化を解除することによって、十分なリソースが解放できる場合、このイメージを優先して、そのほかのイメージの高速化を解除できます。同じ優先順位のイメージの場合、先着順でリソースを使用します。

パラメータ:

priority - 0 から 1 までの値。値が大きいほど、高速化の重要度が高いことを示す。0 の値はこのイメージは高速化する必要がないことを示す。0 以外の値は、ほかのイメージと相対的な高速化の優先順位を判断するためにだけ使用される

例外:

IllegalArgumentException - priority が 0 より小さいか、1 より大きい場合

導入されたバージョン:

1.5

getAccelerationPriority

public float getAccelerationPriority()

高速化の優先順位のヒントの現在の値を返します。

戻り値:

0 から 1 までの値、現在の優先順位値を示す

導入されたバージョン:

1.5

関連項目:

setAccelerationPriority