Image (Java Platform SE 7)

java.lang.Object
- java.awt.Image

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

BufferedImage, VolatileImage
```
public abstract class Image
extends Object
```
抽象クラス 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()

コンストラクタ
コンストラクタと説明
`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

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス Image

フィールドのサマリー

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

メソッドのサマリー

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

フィールドの詳細

accelerationPriority

UndefinedProperty

SCALE_DEFAULT

SCALE_FAST

SCALE_SMOOTH

SCALE_REPLICATE

SCALE_AREA_AVERAGING

コンストラクタの詳細

Image

メソッドの詳細

getWidth

getHeight

getSource

getGraphics

getProperty

getScaledInstance

flush

getCapabilities

setAccelerationPriority

getAccelerationPriority