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

メソッドの概要

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