Интерфейс 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)`	Устанавливает прямоугольник изображения в соответствии с содержимым Raster 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)

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

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

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/image/WritableRenderedImage.html