Интерфейс RenderedImage
- Все известные подинтерфейсы:
WritableRenderedImage
- Все известные реализующие классы:
BufferedImage
public interface RenderedImage
RenderedImage — это общий интерфейс для объектов, которые содержат или могут генерировать данные изображения в виде растровых изображений. Данные изображения могут храниться/генерироваться как одна плитка или как регулярный массив плиток.
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
WritableRaster |
copyData |
Вычисляет произвольную прямоугольную область RenderedImage и копирует её в предоставленный вызывающим объектом WritableRaster. |
ColorModel |
getColorModel() |
Возвращает ColorModel, связанный с этим изображением. |
Raster |
getData() |
Возвращает изображение как одну большую плитку (для изображений, основанных на плитках, это потребует извлечения всего изображения и копирования данных изображения). |
Raster |
getData |
Вычисляет и возвращает произвольную область 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[] |
getPropertyNames() |
Возвращает массив имен, распознаваемых getProperty(String) или null, если имена свойств не распознаются. |
SampleModel |
getSampleModel() |
Возвращает SampleModel, связанный с этим изображением. |
Vector |
getSources() |
Возвращает вектор RenderedImages, которые являются непосредственными источниками данных изображения для этого RenderedImage. |
Raster |
getTile |
Возвращает плитку (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()
Возвращает вектор RenderedImages, являющихся непосредственными источниками данных изображения для этого RenderedImage. Этот метод возвращает null, если объект RenderedImage не содержит информации о своих непосредственных источниках. Возвращает пустой вектор, если у объекта RenderedImage нет непосредственных источников.
- Возвращает:
- вектор объектов
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, связанный с этим изображением. Все Rasters, возвращаемые этим изображением, будут иметь этот ColorModel. Может вернуть null.
- Возвращает:
ColorModelэтого изображения.
getSampleModel
SampleModel getSampleModel()
Возвращает SampleModel, связанный с этим изображением. Все Rasters, возвращаемые этим изображением, будут иметь этот 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, 2023, 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/21/docs/api/java.desktop/java/awt/image/RenderedImage.html