JavaTM 2 Platform
Standard Ed. 5.0

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 的引用。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策