モジュール java.desktop

パッケージ java.awt

クラスImage

java.lang.Object

java.awt.Image

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

AbstractMultiResolutionImage, BufferedImage, VolatileImage

public abstract class Image extends Object

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

導入されたバージョン:

1.0

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected float	accelerationPriority	このイメージの高速化の優先順位。
static final int	SCALE_AREA_AVERAGING	Area Averagingイメージ・スケーリング・アルゴリズムを使用します。
static final int	SCALE_DEFAULT	デフォルトのイメージ・スケーリング・アルゴリズムを使用します。
static final int	SCALE_FAST	スケーリング後のイメージの滑らかさよりもスケーリング速度に高い優先順位を与えるイメージ・スケーリング・アルゴリズムを選択します。
static final int	SCALE_REPLICATE	ReplicateScaleFilterクラスで具体化されたイメージ・スケーリング・アルゴリズムを使用します。
static final int	SCALE_SMOOTH	スケーリング速度よりもイメージの滑らかさに高い優先順位を与えるイメージ・スケーリング・アルゴリズムを選択します。
static final Object	UndefinedProperty	特定のイメージに対して定義されていないプロパティが取得された場合は常に、UndefinedPropertyオブジェクトを返すようにしてください。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	Image()	サブクラスが呼び出すためのコンストラクタ。

メソッドのサマリー

修飾子と型	メソッド	説明
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

デフォルトのイメージ・スケーリング・アルゴリズムを使用します。

導入されたバージョン:

1.1

関連項目:

• 定数フィールド値

SCALE_FAST

public static final int SCALE_FAST

スケーリング後のイメージの滑らかさよりもスケーリング速度に高い優先順位を与えるイメージ・スケーリング・アルゴリズムを選択します。

導入されたバージョン:

1.1

関連項目:

• 定数フィールド値

SCALE_SMOOTH

public static final int SCALE_SMOOTH

スケーリング速度よりもイメージの滑らかさに高い優先順位を与えるイメージ・スケーリング・アルゴリズムを選択します。

導入されたバージョン:

1.1

関連項目:

• 定数フィールド値

SCALE_REPLICATE

public static final int SCALE_REPLICATE

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

導入されたバージョン:

1.1

関連項目:

• ReplicateScaleFilter
• 定数フィールド値

SCALE_AREA_AVERAGING

public static final int SCALE_AREA_AVERAGING

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

導入されたバージョン:

1.1

関連項目:

• AreaAveragingScaleFilter
• 定数フィールド値

コンストラクタの詳細

Image

protected 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がゼロの場合。

導入されたバージョン:

1.1

関連項目:

• SCALE_DEFAULT
• SCALE_FAST
• SCALE_SMOOTH
• SCALE_REPLICATE
• SCALE_AREA_AVERAGING

flush

public void flush()

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

このメソッドがImageオブジェクトの特定タイプにどのように影響するかを次の例に示します。

• BufferedImageオブジェクトは、自身のピクセルを格納するプライマリRasterを変更しませんが、ピクセルに関するキャッシュされたすべての情報(高速Blit用に表示ハードウェアへアップ・ロードされたコピーなど)をフラッシュします。
• 幅と高さを使用してComponentのメソッドによって作成されるImageオブジェクトは、ピクセルのプライマリ・バッファを変更しませんが、BufferedImageオブジェクトの場合と同様に、キャッシュされたすべての情報を解放します。
• VolatileImageオブジェクトは、自身のピクセル・リソースをすべて解放します。これには、通常はリソースが乏しい表示ハードウェアに格納されるプライマリ・コピーを含みます。 これらのオブジェクトは、後でそれぞれのvalidateメソッドを使用して復元できます。
• ToolkitクラスやComponentクラスによって作成されたImageオブジェクト(ファイルやURLからロードされたか、ImageProducerによって生成されたもの)はアンロードされ、すべてのローカル・リソースが解放されます。 これらのオブジェクトは、最初に作成されたときと同様に、描画時に必要に応じてあとから元のソースから再ロードできます。

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