java.awt.image

Interface WritableRenderedImage

All Superinterfaces:

RenderedImage

所有已知实现类：

BufferedImage

public interface WritableRenderedImage
extends RenderedImage

WriteableRenderedImage是包含或可以以Raster形式生成图像数据并可以修改和/或写入的对象的公共接口。 图像数据可以被存储/生成为单个瓦片或普通瓦片阵列。

WritableRenderedImage在通过签出书签（通过getWritableTile方法）和特定瓦片的最后一个作者放弃其访问（通过调用releaseWritableTile）时，向其他感兴趣的对象提供通知。 另外，它允许任何调用者确定当前是否已经检出了任何图块（通过hasTileWriters），并获得这样的图块列表（通过getWritableTileIndices，以Point对象的向量的形式）。

希望通知瓦片可写性更改的对象必须实现TileObserver接口，并通过调用addTileObserver来添加。 对同一个对象的多次调用addTileObserver将导致多个通知。 现有的观察者可以通过调用removeTileObserver来减少通知; 如果观察者没有通知，则操作是无效的。

WritableRenderedImage有必要确保仅当第一个作者获取图块并且最后一个作者发布时才会发生通知。

方法摘要

Modifier and Type	Method and Description
void	addTileObserver(TileObserver to) 添加观察者
WritableRaster	getWritableTile(int tileX, int tileY) 检查一个瓦片写作。
Point[]	getWritableTileIndices() 返回一个Point对象数组，指示哪些tile被签出用于写入。
boolean	hasTileWriters() 返回是否签出任何图块以进行写入。
boolean	isTileWritable(int tileX, int tileY) 返回是否当前签出图块以进行写入。
void	releaseWritableTile(int tileX, int tileY) 放弃写入瓦片的权利。
void	removeTileObserver(TileObserver to) 删除观察者
void	setData(Raster r) 将图像的直角设置为Raster r的内容，假定它与WritableRenderedImage位于相同的坐标空间。

Methods inherited from interface java.awt.image.RenderedImage

copyData, getColorModel, getData, getData, getHeight, getMinTileX, getMinTileY, getMinX, getMinY, getNumXTiles, getNumYTiles, getProperty, getPropertyNames, getSampleModel, getSources, getTile, getTileGridXOffset, getTileGridYOffset, getTileHeight, getTileWidth, getWidth

方法详细信息

addTileObserver

void addTileObserver(TileObserver to)

添加观察者 如果观察者已经存在，它将收到多个通知。

参数

to - 指定的 TileObserver

removeTileObserver

void removeTileObserver(TileObserver to)

删除观察者 如果观察员没有注册，没有任何反应。 如果观察员注册了多个通知，则现在将被注册少一个。

参数

to - 指定的 TileObserver

getWritableTile

WritableRaster getWritableTile(int tileX,
                               int tileY)

检查一个瓦片写作。 WritableRenderedImage负责通知所有TileObservers，当一个tile从没有写入器到一个写入器。

参数

tileX - 瓦片的X索引。

tileY - 瓷砖的Y指数。

结果

一个可写的瓷砖。

releaseWritableTile

void releaseWritableTile(int tileX,
                         int tileY)

放弃写入瓦片的权利。 如果呼叫者继续写入瓦片，结果是未定义的。 对此方法的调用只能与匹配的getContextTile调用对匹配; 任何其他用途将导致未定义的结果。 WritableRenderedImage负责通知所有TileObserver当一个tile从一个作家到没有写者。

参数

tileX - 瓦片的X索引。

tileY - 瓷砖的Y指数。

isTileWritable

boolean isTileWritable(int tileX,
                       int tileY)

返回是否当前签出图块以进行写入。

参数

tileX - 瓦片的X索引。

tileY - 瓷砖的Y指数。

结果

true如果指定的瓦片被签出写入; false否则。

getWritableTileIndices

Point[] getWritableTileIndices()

返回一个Point对象数组，指示哪些tile被签出用于写入。 如果没有签出，则返回null。

结果

一个数组，其中包含被签出用于写入的图块的位置。

hasTileWriters

boolean hasTileWriters()

返回是否签出任何图块以进行写入。 语义上相当于（getWritableTileIndices（）！= null）。

结果

true如果任何瓷砖被签出用于书写; false否则。

setData

void setData(Raster r)

将图像的直角设置为Raster r的内容，假定它与WritableRenderedImage位于相同的坐标空间。 该操作被剪切到WritableRenderedImage的边界。

参数

r - 指定的 Raster