Интерфейс 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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/WritableRenderedImage.html