java.awt
類別 Image

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

方法摘要

void	flush() 刷新此 Image 物件正在使用的所有可重構的資源。
float	getAccelerationPriority() 返回加速優先級提示的當前值。
ImageCapabilities	getCapabilities(GraphicsConfiguration gc) 返回 ImageCapabilities 物件，查詢該物件便可以瞭解使用指定 GraphicsConfiguration 時此 Image 的功能。
abstract Graphics	getGraphics() 創建供繪製閉屏圖像（off-screen image）使用的圖形上下文。
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()

創建供繪製閉屏圖像（off-screen image）使用的圖形上下文。此方法僅供閉屏圖像調用。

返回：

繪製閉屏圖像的圖形上下文。

拋出：

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)

創建此圖像的縮放版本。返回一個新的 Image 物件，預設情況下，該物件按指定的 width 和 height 呈現圖像。即使已經完全載入了初始源圖像，新的 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，但是刷新有關像素的快取記憶體資訊，比如上傳到用於加速位圖的顯示硬體的副本。
• Image 物件由帶有 width 和 height 參數的 Component 方法創建，該方法不改動像素的主要緩衝區，但是釋放所有快取記憶體的資訊，這與對 BufferedImage 物件的操作非常類似。
• VolatileImage 物件釋放其所有像素資源，這些資源包括通常存儲在缺乏資源的顯示硬體上的主要副本。這些物件稍後可以使用其 validate 方法還原。
• 卸載從檔案、URL 中載入或由 ImageProducer 產生的 Toolkit 和 Component 類別創建的 Image 物件，並釋放所有本地資源。稍後可在呈現這些物件時根據需要從初始源重新載入它們，就像第一次創建它們時那樣。

getCapabilities

public ImageCapabilities getCapabilities(GraphicsConfiguration gc)

返回 ImageCapabilities 物件，查詢該物件便可以瞭解使用指定 GraphicsConfiguration 時此 Image 的功能。這允許開發人員尋找關於他們已經創建的特定 Image 物件的更多運行時資訊。例如，使用者可能創建一個 BufferedImage，但是系統所剩顯存可能不足以在使用給定 GraphicsConfiguration 時創建該大小的圖像，因此儘管該物件一般而言是可加速的，但在使用 GraphicsConfiguration 時它確實不具有該功能。

參數：

gc - GraphicsConfiguration 物件。此參數值為 null 將導致獲取預設 GraphicsConfiguration 的圖像功能。

返回：

包含使用指定 GraphicsConfiguration 時此 Image 的功能的 ImageCapabilities 物件。

從以下版本開始：

1.5

另請參見：

VolatileImage#getCapabilities()

setAccelerationPriority

public void setAccelerationPriority(float priority)

就加速的重要性設置此圖像的提示。此優先級提示用於在確定如何使用稀缺的加速資源（如顯存）時與其他 Image 物件的優先級進行比較。如果可能加速此 Image，但在加速時進行該加速的可用資源不足，若可以通過取消加速具有較低優先級的其他圖像來釋放足夠資源，則其他那些 Image 可能為了這一目的而被取消加速。具有相同優先級的圖像利用資源的方式是先到先得。

參數：

priority - 介於 0 和 1 之間的值（包括 0 和 1），較大的值指示加速的重要性較高。值 0 意味著永遠不應該加速此 Image。其他值用於確定相對於其他 Image 的加速優先級。

拋出：

IllegalArgumentException - 如果 priority 小於零或大於 1。

從以下版本開始：

1.5

getAccelerationPriority

public float getAccelerationPriority()

返回加速優先級提示的當前值。

返回：

介於 0 和 1 之間的值（包括 0 和 1），表示當前優先級值

從以下版本開始：

1.5

另請參見：

setAccelerationPriority