Интерфейс RenderedImage

Все известные подинтерфейсы:: WritableRenderedImage

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

public interface RenderedImage

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

Краткое описание методов

Модификатор и тип	Метод	Описание
`WritableRaster`	`copyData(WritableRaster raster)`	Вычисляет произвольную прямоугольную область RenderedImage и копирует её в предоставленный вызывающей стороной WritableRaster.
`ColorModel`	`getColorModel()`	Возвращает ColorModel, связанный с этим изображением.
`Raster`	`getData()`	Возвращает изображение в виде одного большого тайла (для изображений, основанных на тайлах, потребуется получить всё изображение и скопировать данные изображения).
`Raster`	`getData(Rectangle rect)`	Вычисляет и возвращает произвольную область RenderedImage.
`int`	`getHeight()`	Возвращает высоту RenderedImage.
`int`	`getMinTileX()`	Возвращает минимальный индекс тайла в направлении X.
`int`	`getMinTileY()`	Возвращает минимальный индекс тайла в направлении Y.
`int`	`getMinX()`	Возвращает минимальную координату X (включительно) для RenderedImage.
`int`	`getMinY()`	Возвращает минимальную координату Y (включительно) для RenderedImage.
`int`	`getNumXTiles()`	Возвращает количество тайлов в направлении X.
`int`	`getNumYTiles()`	Возвращает количество тайлов в направлении Y.
`Object`	`getProperty(String name)`	Получает свойство из набора свойств этого изображения.
`String[]`	`getPropertyNames()`	Возвращает массив имён, распознаваемых методом `getProperty(String)`, или `null`, если имена свойств не распознаны.
`SampleModel`	`getSampleModel()`	Возвращает SampleModel, связанный с этим изображением.
`Vector<RenderedImage>`	`getSources()`	Возвращает вектор RenderedImage, являющихся непосредственными источниками данных изображения для этого RenderedImage.
`Raster`	`getTile(int tileX, int tileY)`	Возвращает тайл (tileX, tileY).
`int`	`getTileGridXOffset()`	Возвращает смещение сетки тайлов по X относительно начала координат, то есть координату X пикселя в верхнем левом углу тайла (0, 0).
`int`	`getTileGridYOffset()`	Возвращает смещение сетки тайлов по Y относительно начала координат, то есть координату Y пикселя в верхнем левом углу тайла (0, 0).
`int`	`getTileHeight()`	Возвращает высоту тайла в пикселях.
`int`	`getTileWidth()`	Возвращает ширину тайла в пикселях.
`int`	`getWidth()`	Возвращает ширину RenderedImage.

Подробное описание методов

getSources

Vector<RenderedImage> getSources()

Возвращает вектор RenderedImage, являющихся непосредственными источниками данных изображения для этого RenderedImage. Этот метод возвращает null, если объект RenderedImage не содержит сведений о непосредственных источниках. Он возвращает пустой Vector, если у объекта RenderedImage нет непосредственных источников.

Возвращает:: Vector объектов RenderedImage.

getProperty

Object getProperty(String name)

Получает свойство из набора свойств этого изображения. Набор свойств и его неизменяемость определяются реализующим классом. Этот метод возвращает java.awt.Image.UndefinedProperty, если указанное свойство не определено для данного RenderedImage.

Параметры:

name — имя свойства

Возвращает:

свойство, указанное заданным именем.

См. также:

getPropertyNames

String[] getPropertyNames()

Возвращает массив имён, распознаваемых методом getProperty(String), или null, если имена свойств не распознаны.

Возвращает:: массив String, содержащий все имена свойств, распознаваемые методом getProperty(String); или null, если имена свойств не распознаны.

getColorModel

ColorModel getColorModel()

Возвращает ColorModel, связанный с этим изображением. Все Raster, возвращаемые этим изображением, будут иметь эту модель ColorModel. Метод может вернуть null.

Возвращает:: ColorModel этого изображения.

getSampleModel

SampleModel getSampleModel()

Возвращает SampleModel, связанный с этим изображением. Все Raster, возвращаемые этим изображением, будут иметь эту модель SampleModel.

Возвращает:: SampleModel этого изображения.

getWidth

int getWidth()

Возвращает ширину RenderedImage.

Возвращает:: ширину этого RenderedImage.

getHeight

int getHeight()

Возвращает высоту RenderedImage.

Возвращает:: высоту этого RenderedImage.

getMinX

int getMinX()

Возвращает минимальную координату X (включительно) для RenderedImage.

Возвращает:: координату X этого RenderedImage.

getMinY

int getMinY()

Возвращает минимальную координату Y (включительно) для RenderedImage.

Возвращает:: координату Y этого RenderedImage.

getNumXTiles

int getNumXTiles()

Возвращает количество тайлов в направлении X.

Возвращает:: количество тайлов в направлении X.

getNumYTiles

int getNumYTiles()

Возвращает количество тайлов в направлении Y.

Возвращает:: количество тайлов в направлении Y.

getMinTileX

int getMinTileX()

Возвращает минимальный индекс тайла в направлении X.

Возвращает:: минимальный индекс тайла в направлении X.

getMinTileY

int getMinTileY()

Возвращает минимальный индекс тайла в направлении Y.

Возвращает:: минимальный индекс тайла в направлении X.

getTileWidth

int getTileWidth()

Возвращает ширину тайла в пикселях. Ширина всех тайлов должна быть одинаковой.

Возвращает:: ширину тайла в пикселях.

getTileHeight

int getTileHeight()

Возвращает высоту тайла в пикселях. Высота всех тайлов должна быть одинаковой.

Возвращает:: высоту тайла в пикселях.

getTileGridXOffset

int getTileGridXOffset()

Возвращает смещение сетки тайлов по X относительно начала координат, то есть координату X пикселя в верхнем левом углу тайла (0, 0). (Обратите внимание, что тайл (0, 0) может фактически не существовать.)

Возвращает:: смещение сетки тайлов по X относительно начала координат.

getTileGridYOffset

int getTileGridYOffset()

Возвращает смещение сетки тайлов по Y относительно начала координат, то есть координату Y пикселя в верхнем левом углу тайла (0, 0). (Обратите внимание, что тайл (0, 0) может фактически не существовать.)

Возвращает:: смещение сетки тайлов по Y относительно начала координат.

getTile

Raster getTile(int tileX, int tileY)

Возвращает тайл (tileX, tileY). Обратите внимание, что tileX и tileY — это индексы в массиве тайлов, а не координаты пикселей. Возвращаемый Raster является действующим и будет обновлён при изменении изображения.

Параметры:: tileX — индекс X запрошенного тайла в массиве тайлов; tileY — индекс Y запрошенного тайла в массиве тайлов
Возвращает:: тайл, соответствующий указанным индексам.

getData

Raster getData()

Возвращает изображение в виде одного большого тайла (для изображений, основанных на тайлах, потребуется получить всё изображение и скопировать данные изображения). Возвращаемый Raster является копией данных изображения и не будет обновлён при изменении изображения.

Возвращает:: изображение в виде одного большого тайла.

getData

Raster getData(Rectangle rect)

Вычисляет и возвращает произвольную область RenderedImage. Возвращаемый Raster является копией данных изображения и не будет обновлён при изменении изображения.

Параметры:: rect — область RenderedImage, которую необходимо вернуть.
Возвращает:: область RenderedImage, указанную заданным Rectangle.

copyData

WritableRaster copyData(WritableRaster raster)

Вычисляет произвольную прямоугольную область RenderedImage и копирует её в предоставленный вызывающей стороной WritableRaster. Вычисляемая область определяется границами предоставленного WritableRaster. Предоставленный WritableRaster должен иметь SampleModel, совместимый с этим изображением. Если raster равен null, создаётся подходящий WritableRaster.

Параметры:: raster — WritableRaster для хранения возвращаемой части изображения или null.
Возвращает:: ссылку на предоставленный или созданный WritableRaster.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/image/RenderedImage.html