java.awt.image
介面 RenderedImage

所有已知子介面：

WritableRenderedImage

所有已知實作類別：

BufferedImage

public interface RenderedImage

RenderedImage 是一個通用介面，用於包含或產生 Raster 形式圖像資料的物件。圖像資料可以作為單個 tile 或 tile 規則陣列被存儲/產生。

方法摘要

WritableRaster	copyData(WritableRaster raster) 計算 RenderedImage 的任意矩形區域，並將其複製到調用者提供的 WritableRaster 中。
ColorModel	getColorModel() 返回與此圖像相關的 ColorModel。
Raster	getData() 以一個大 tile 的形式返回圖像（對於基於 tile 的圖像，此方法需要獲取整個圖像並複製全部圖像資料）。
Raster	getData(Rectangle rect) 計算並返回 RenderedImage 的任意區域。
int	getHeight() 返回 RenderedImage 的高度。
int	getMinTileX() 返回 X 方向的最小 tile 索引。
int	getMinTileY() 返回 Y 方向的最小 tile 索引。
int	getMinX() 返回 RenderedImage 的最小 X 坐標（包括）。
int	getMinY() 返回 RenderedImage 的最小 Y 坐標（包括）。
int	getNumXTiles() 返回 X 方向的 tile 數量。
int	getNumYTiles() 返回 Y 方向的 tile 數量。
Object	getProperty(String name) 從此圖像的屬性設置中獲取一個屬性。
String[]	getPropertyNames() 返回由 getProperty(String) 識別的名稱的陣列，如果沒有屬性名被識別，則返回 null。
SampleModel	getSampleModel() 返回與此圖像相關的 SampleModel。
Vector<RenderedImage>	getSources() 返回作為此 RenderedImage 直接圖像資料源的 RenderedImage 向量。
Raster	getTile(int tileX, int tileY) 返回 tile (tileX, tileY)。
int	getTileGridXOffset() 返回 tile 網格相對於原點的 X 偏移量，即 tile (0, 0) 左上角像素的 X 坐標。
int	getTileGridYOffset() 返回 tile 網格相對於原點的 Y 偏移量，即 tile (0, 0) 左上角像素的 Y 坐標。
int	getTileHeight() 返回 tile 的高度，以像素為單位。
int	getTileWidth() 返回 tile 的寬度，以像素為單位。
int	getWidth() 返回 RenderedImage 的寬度。

方法詳細資訊

getSources

Vector<RenderedImage> getSources()

返回作為此 RenderedImage 直接圖像資料源的 RenderedImage 向量。如果 RenderedImage 物件沒有關於其直接源的資訊，則此方法返回 null。如果 RenderedImage 物件沒有直接源，則返回一個空向量。

返回：

RenderedImage 物件的一個 Vector。

getProperty

Object getProperty(String name)

從此圖像的屬性設置中獲取一個屬性。屬性的設置以及它是否不可變由正在實作的類別確定。如果此 RenderedImage 沒有定義指定屬性，則此方法返回 java.awt.Image.UndefinedProperty。

參數：

name - 屬性名

返回：

由指定名稱指示的屬性。

另請參見：

Image.UndefinedProperty

getPropertyNames

String[] getPropertyNames()

返回由 getProperty(String) 識別的名稱的陣列，如果沒有屬性名被識別，則返回 null。

返回：

包含 getProperty(String) 識別的所有屬性名的 String 陣列；如果沒有屬性名被識別，則返回 null。

getColorModel

ColorModel getColorModel()

返回與此圖像相關的 ColorModel。所有從此圖像返回的 Raster 都將該 ColorModel 作為其 ColorModel。此方法可以返回 null。

返回：

此圖像的 ColorModel。

getSampleModel

SampleModel getSampleModel()

返回與此圖像相關的 SampleModel。所有從此圖像返回的 Raster 都將該 SampleModel 作為其 SampleModel。

返回：

此圖像的 SampleModel。

getWidth

int getWidth()

返回 RenderedImage 的寬度。

返回：

此 RenderedImage 的寬度。

getHeight

int getHeight()

返回 RenderedImage 的高度。

返回：

此 RenderedImage 的高度。

getMinX

int getMinX()

返回 RenderedImage 的最小 X 坐標（包括）。

返回：

此 RenderedImage 的 X 坐標。

getMinY

int getMinY()

返回 RenderedImage 的最小 Y 坐標（包括）。

返回：

此 RenderedImage 的 Y 坐標。

getNumXTiles

int getNumXTiles()

返回 X 方向的 tile 數量。

返回：

X 方向的 tile 數量。

getNumYTiles

int getNumYTiles()

返回 Y 方向的 tile 數量。

返回：

Y 方向的 tile 數量。

getMinTileX

int getMinTileX()

返回 X 方向的最小 tile 索引。

返回：

X 方向的最小 tile 索引。

getMinTileY

int getMinTileY()

返回 Y 方向的最小 tile 索引。

返回：

Y 方向的最小 tile 索引。

getTileWidth

int getTileWidth()

返回 tile 的寬度，以像素為單位。所有 tile 都必須有相同的寬度。

返回：

tile 的寬度，以像素為單位。

getTileHeight

int getTileHeight()

返回 tile 的高度，以像素為單位。所有 tile 都必須有相同的高度。

返回：

tile 的高度，以像素為單位。

getTileGridXOffset

int getTileGridXOffset()

返回 tile 網格相對於原點的 X 偏移量，即 tile (0, 0) 左上角像素的 X 坐標。（注意，實際上可能不存在 tile (0, 0)。）

返回：

tile 網格相對於原點的 X 偏移量。

getTileGridYOffset

int getTileGridYOffset()

返回 tile 網格相對於原點的 Y 偏移量，即 tile (0, 0) 左上角像素的 Y 坐標。（注意，實際上可能不存在 tile (0, 0)。）

返回：

tile 網格相對於原點的 Y 偏移量。

getTile

Raster getTile(int tileX,
               int tileY)

返回 tile (tileX, tileY)。注意，tileX 和 tileY 是 tile 陣列中的索引，不是像素位置。返回的 Raster 是活動的，隨圖像更改而更新。

參數：

tileX - tile 陣列中請求 tile 的 X 索引

tileY - tile 陣列中請求 tile 的 Y 索引

返回：

已給出指定索引的 tile。

getData

Raster getData()

以一個大 tile 的形式返回圖像（對於基於 tile 的圖像，此方法需要獲取整個圖像並複製全部圖像資料）。返回的 Raster 是圖像資料的副本，不會隨圖像更改而更新。

返回：

以一個大 tile 的形式返回圖像。

getData

Raster getData(Rectangle rect)

計算並返回 RenderedImage 的任意區域。返回的 Raster 是圖像資料的副本，不會隨圖像更改而更新。

參數：

rect - 要返回的 RenderedImage 的區域。

返回：

指定 Rectangle 指示的 RenderedImage 的區域。

copyData

WritableRaster copyData(WritableRaster raster)

計算 RenderedImage 的任意矩形區域，並將其複製到調用者提供的 WritableRaster 中。要計算的區域根據提供的 WritableRaster 的邊界確定。提供的 WritableRaster 必須有一個與此圖像相容的 SampleModel。如果 raster 為 null，則創建一個合適的 WritableRaster。

參數：

raster - 保存圖像返回部分的 WritableRaster，或者為 null。

返回：

對提供的或創建的 WritableRaster 的參考。