Интерфейс 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<RenderedImage> |
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, связанный с этим изображением. Все 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, 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/RenderedImage.html