RenderedImage

概述

软件包

类

使用

树

已过时

索引

帮助

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

概述