java.awt.image.renderable
介面 RenderableImage

所有已知實作類別：

RenderableImageOp

public interface RenderableImage

RenderableImage 是與呈現無關的圖像（該概念包含與分辨率無關的意思）的公共介面。與呈現無關的圖像也就是被描述的、應用與其任何特定呈現無關的操作的那些圖像。例如，一個滿足以下條件的 RenderableImage：它可以旋轉並可以按與分辨率無關的條件進行裁剪。然後，它可以針對各種特定的上下文（如草圖預覽、高質量螢幕顯示或印表機）以最優方式呈現。

RenderedImage 通過 createRendering() 方法從 RenderableImage 返回，該方法採用 RenderContext 作為參數。RenderContext 指定 RenderedImage 的建構方式。注意，不能直接從 RenderableImage 中提取像素。

createDefaultRendering() 和 createScaledRendering() 方法是內部建構適當 RenderContext 的便捷方法。所有呈現方法都可以返回對以前產生的呈現的參考。

欄位摘要

static String

HINTS_OBSERVED 可以用於在通過 createRendering 或 createScaledRendering 方法獲取的 RenderedImage 上標識屬性的字元串常數。

方法摘要

RenderedImage	createDefaultRendering() 返回此圖像具有預設寬度和高度（以像素為單位）的一個 RenderedImage 實例。
RenderedImage	createRendering(RenderContext renderContext) 使用給定的 RenderContext 創建表示此圖像一個呈現的 RenderedImage。
RenderedImage	createScaledRendering(int w, int h, RenderingHints hints) 創建此圖像具有寬度 w 和高度 h（以像素為單位）的一個 RenderedImage 實例。
float	getHeight() 獲取使用者坐標空間中的高度。
float	getMinX() 獲取與呈現無關的圖像資料的最小 X 坐標。
float	getMinY() 獲取與呈現無關的圖像資料的最小 Y 坐標。
Object	getProperty(String name) 從此圖像的屬性集中獲取某個屬性。
String[]	getPropertyNames() 返回由 getProperty 識別的名稱列表。
Vector<RenderableImage>	getSources() 返回作為此 RenderableImage 的圖像資料源的 RenderableImage 的向量。
float	getWidth() 獲取使用者坐標空間中的寬度。
boolean	isDynamic() 如果使用相同參數的後續呈現（即調用 createRendering() 或 createScaledRendering()）可以產生不同的結果，則返回 true。

欄位詳細資訊

HINTS_OBSERVED

static final String HINTS_OBSERVED

可以用於在通過 createRendering 或 createScaledRendering 方法獲取的 RenderedImage 上標識屬性的字元串常數。如果存在此類別屬性，則該屬性的值將是一個 RenderingHints 物件，該物件指定在創建該呈現時要注意的提示。

另請參見：

常數欄位值

方法詳細資訊

getSources

Vector<RenderableImage> getSources()

返回作為此 RenderableImage 的圖像資料源的 RenderableImage 的向量。注意，此方法可能返回空向量，指示該圖像沒有源，或者返回 null，指示沒有可用資訊。

返回：

RenderableImages 的（可能為空的）Vector，或者 null。

getProperty

Object getProperty(String name)

從此圖像的屬性集中獲取某個屬性。如果該屬性名無法識別，將返回 java.awt.Image.UndefinedProperty。

參數：

name - 要獲取的屬性名稱（以 String 形式）。

返回：

對屬性 Object 的參考，或者值 java.awt.Image.UndefinedProperty。

getPropertyNames

String[] getPropertyNames()

返回由 getProperty 識別的名稱列表。

返回：

屬性名稱列表。

isDynamic

boolean isDynamic()

如果使用相同參數的後續呈現（即調用 createRendering() 或 createScaledRendering()）可以產生不同的結果，則返回 true。此方法可用於確定是否可以快取記憶體和重用現有呈現。返回 true 始終安全。

返回：

如果使用相同參數的後續呈現可以產生不同結果，則返回 true；否則返回 false。

getWidth

float getWidth()

獲取使用者坐標空間中的寬度。按照慣例，RenderableImage 的常規寬度等於該圖像的高寬比（寬度除以高度）。

返回：

使用者坐標中圖像的寬度。

getHeight

float getHeight()

獲取使用者坐標空間中的高度。按照慣例，RenderedImage 的常規寬度等於 1.0F。

返回：

使用者坐標中圖像的高度。

getMinX

float getMinX()

獲取與呈現無關的圖像資料的最小 X 坐標。

返回：

與呈現無關的圖像資料的最小 X 坐標。

getMinY

float getMinY()

獲取與呈現無關的圖像資料的最小 Y 坐標。

返回：

與呈現無關的圖像資料的最小 Y 坐標。

createScaledRendering

RenderedImage createScaledRendering(int w,
                                    int h,
                                    RenderingHints hints)

創建此圖像具有寬度 w 和高度 h（以像素為單位）的一個 RenderedImage 實例。使用適當的 usr2dev 變換和完整圖像的感興趣區域自動建構 RenderContext。所有呈現提示均來自傳入的提示。

如果 w == 0，則該值將等於 Math.round(h*(getWidth()/getHeight()))。類似地，如果 h == 0，則該值將等於 Math.round(w*(getHeight()/getWidth()))。w 和 h 中必須有一個不為零，否則將拋出 IllegalArgumentException。

創建的 RenderedImage 可能有一個由字元串 HINTS_OBSERVED 標識的屬性，以指示使用了哪些 RenderingHints 創建該圖像。此外，通過創建的 RenderedImage 上的 getSources() 方法獲得的任何 RenderedImage 都可能具該屬性。

參數：

w - 所呈現圖像的寬度（以像素為單位），或者為 0。

h - 所呈現圖像的高度（以像素為單位），或者為 0。

hints - 套件含提示的 RenderingHints 物件。

返回：

包含所呈現資料的 RenderedImage。

createDefaultRendering

RenderedImage createDefaultRendering()

返回此圖像具有預設寬度和高度（以像素為單位）的一個 RenderedImage 實例。使用適當的 usr2dev 變換和完整圖像的感興趣區域自動建構 RenderContext。該呈現提示為空。為提高速度，createDefaultRendering 可能會使用已存儲的呈現。

返回：

包含所呈現資料的 RenderedImage。

createRendering

RenderedImage createRendering(RenderContext renderContext)

使用給定的 RenderContext 創建表示此圖像一個呈現的 RenderedImage。這是獲得 RenderableImage 的呈現的最通用的方法。

創建的 RenderedImage 可能有一個由字元串 HINTS_OBSERVED 標識的屬性，以指示使用了哪些 RenderingHints（來自 RenderContext）創建該圖像。此外，通過創建的 RenderedImage 上的 getSources() 方法獲得的任何 RenderedImage 都可能具有該屬性。

參數：

renderContext - 用於產生呈現的 RenderContext。

返回：

包含所呈現資料的 RenderedImage。