Интерфейс WritableRenderedImage

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

Все известные реализующие классы:: BufferedImage

public interface WritableRenderedImage
extends RenderedImage

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

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

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

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

Методы

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

Возвращает массив объектов Point, указывающих, какие плитки проверяются для записи. Возвращает null, если таковых нет.

Возвращает:: массив, содержащий местоположения плиток, которые проверяются для записи.

hasTileWriters

boolean hasTileWriters()

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

Возвращает:: true если какие-либо плитки проверяются для записи; false в противном случае.

setData

void setData(Raster r)

Устанавливает прямоугольник изображения в содержимое растра r, который предполагается в той же системе координат, что и WritableRenderedImage. Операция обрезается до границ WritableRenderedImage.

Параметры:: r - указанный Raster