java.awt.image

Интерфейс WritableRenderedImage

Все Суперинтерфейсы:

RenderedImage

Все Известные Классы с реализацией:

BufferedImage

public interface WritableRenderedImage
extends RenderedImage

WriteableRenderedImage является общим интерфейсом для объектов, которые содержат или могут произвести данные изображения в форме Растров и которые могут быть изменены и/или переписаны. Данные изображения могут храниться/производиться как единственная мозаика или регулярный массив мозаик.

WritableRenderedImage обеспечивает уведомление другим заинтересованным объектам, когда мозаика проверяется для того, чтобы записать (через getWritableTile метод) и когда последний писатель определенной мозаики оставляет ее доступ (через звонок releaseWritableTile). Дополнительно, это позволяет любой вызывающей стороне определять, проверяются ли какие-либо мозаики в настоящий момент (через hasTileWriters), и получить список таких мозаик (через getWritableTileIndices, в форме Вектора Точечных объектов).

Объекты, желающие быть уведомленными относительно изменений в мозаике writability, должны реализовать интерфейс TileObserver, и добавляются звонком addTileObserver. Множественные вызовы addTileObserver для того же самого объекта приведут к многократным уведомлениям. Существующий наблюдатель может уменьшить его уведомления, вызывая removeTileObserver; если у наблюдателя не было никаких уведомлений, работа нет.

Необходимо для WritableRenderedImage гарантировать, что уведомления происходят только, когда первый писатель получает мозаику, и последний писатель выпускает это.

Сводка метода

Модификатор и Тип	Метод и Описание
void	addTileObserver(TileObserver to) Добавляет наблюдатель.
WritableRaster	getWritableTile(int tileX, int tileY) Проверяет мозаику для того, чтобы записать.
Точка[]	getWritableTileIndices() Возвращает массив Точечных объектов, указывающих, какие мозаики проверяются для того, чтобы записать.
boolean	hasTileWriters() Возвраты, проверяется ли какая-либо мозаика для того, чтобы записать.
boolean	isTileWritable(int tileX, int tileY) Возвраты, проверяется ли мозаика в настоящий момент для того, чтобы записать.
void	releaseWritableTile(int tileX, int tileY) Оставляет право записать в мозаику.
void	removeTileObserver(TileObserver to) Удаляет наблюдателя.
void	setData(Raster r) Устанавливает rect изображения к содержанию Растра r, который, как предполагается, находится в том же самом координатном пространстве как WritableRenderedImage.

Методы, наследованные от интерфейса 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, когда мозаика идет от наличия никаких писателей к наличию одного писателя.

Параметры:

tileX - эти X индексируют мозаики.

tileY - Y индексируют мозаики.

Возвраты:

перезаписываемая мозаика.

releaseWritableTile

void releaseWritableTile(int tileX,
                         int tileY)

Оставляет право записать в мозаику. Если вызывающая сторона продолжает писать в мозаику, результаты неопределены. Звонки в этот метод должны только появиться в соответствии пар со звонками getWritableTile; любое другое использование приведет к неопределенным результатам. WritableRenderedImage ответственен за уведомление всех его TileObservers, когда мозаика идет от наличия одного писателя к наличию никаких писателей.

Параметры:

tileX - эти X индексируют мозаики.

tileY - Y индексируют мозаики.

isTileWritable

boolean isTileWritable(int tileX,
                       int tileY)

Возвраты, проверяется ли мозаика в настоящий момент для того, чтобы записать.

Параметры:

tileX - эти X индексируют мозаики.

tileY - Y индексируют мозаики.

Возвраты:

true если определенная мозаика проверяется для того, чтобы записать; false иначе.

getWritableTileIndices

Point[] getWritableTileIndices()

Возвращает массив Точечных объектов, указывающих, какие мозаики проверяются для того, чтобы записать. Нуль возвратов, если ни один не проверяется.

Возвраты:

массив, содержащий расположения мозаик, которые проверяются для того, чтобы записать.

hasTileWriters

boolean hasTileWriters()

Возвраты, проверяется ли какая-либо мозаика для того, чтобы записать. Семантически эквивалентный (getWritableTileIndices ()! = нуль).

Возвраты:

true если какие-либо мозаики проверяются для того, чтобы записать; false иначе.

setData

void setData(Raster r)

Устанавливает rect изображения к содержанию Растра r, который, как предполагается, находится в том же самом координатном пространстве как WritableRenderedImage. Работа отсекается к границам WritableRenderedImage.

Параметры:

r - указанное Raster