Интерфейс RenderableImage

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

public interface RenderableImage

RenderableImage — это общий интерфейс для изображений, не зависящих от способа визуализации (понятие, включающее независимость от разрешения). Иными словами, это изображения, которые описываются и обрабатываются независимо от конкретного способа их визуализации. Например, RenderableImage можно повернуть и обрезать независимо от разрешения. Затем его можно визуализировать для различных конкретных контекстов, например для предварительного просмотра черновика, высококачественного отображения на экране или печати, каждый раз оптимальным образом.

RenderedImage возвращается из RenderableImage методом createRendering(), принимающим RenderContext. RenderContext определяет, как следует создать RenderedImage. Обратите внимание, что извлечь пиксели непосредственно из RenderableImage невозможно.

Методы createDefaultRendering() и createScaledRendering() — это вспомогательные методы, которые автоматически создают подходящий RenderContext. Все методы визуализации могут возвращать ссылку на ранее созданную визуализацию.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`HINTS_OBSERVED`	Строковая константа, которую можно использовать для идентификации свойства в RenderedImage, полученном с помощью методов createRendering или createScaledRendering.

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

Модификатор и тип	Метод	Описание
`RenderedImage`	`createDefaultRendering()`	Возвращает экземпляр RenderedImage для этого изображения со стандартными шириной и высотой в пикселях.
`RenderedImage`	`createRendering(RenderContext renderContext)`	Создаёт RenderedImage, представляющий визуализацию этого изображения с использованием заданного RenderContext.
`RenderedImage`	`createScaledRendering(int w, int h, RenderingHints hints)`	Создаёт экземпляр RenderedImage для этого изображения шириной w и высотой h в пикселях.
`float`	`getHeight()`	Возвращает высоту в пользовательских координатах.
`float`	`getMinX()`	Возвращает минимальную координату X данных изображения, не зависящих от способа визуализации.
`float`	`getMinY()`	Возвращает минимальную координату Y данных изображения, не зависящих от способа визуализации.
`Object`	`getProperty(String name)`	Получает свойство из набора свойств этого изображения.
`String[]`	`getPropertyNames()`	Возвращает список имён, распознаваемых методом getProperty.
`Vector<RenderableImage>`	`getSources()`	Возвращает вектор объектов RenderableImage, являющихся источниками данных изображения для этого RenderableImage.
`float`	`getWidth()`	Возвращает ширину в пользовательских координатах.
`boolean`	`isDynamic()`	Возвращает true, если последовательные визуализации (то есть вызовы createRendering() или createScaledRendering()) с одинаковыми аргументами могут давать разные результаты.

Подробное описание полей

HINTS_OBSERVED

static final String HINTS_OBSERVED

Строковая константа, которую можно использовать для идентификации свойства в RenderedImage, полученном с помощью методов createRendering или createScaledRendering. Если такое свойство существует, его значением будет объект RenderingHints, указывающий, какие подсказки были учтены при создании визуализации.

См. также:

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

getSources

Vector<RenderableImage> getSources()

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

Возвращает:: вектор RenderableImage (возможно, пустой) или null.

getProperty

Object getProperty(String name)

Получает свойство из набора свойств этого изображения. Если имя свойства не распознано, возвращается java.awt.Image.UndefinedProperty.

Параметры:: name — имя свойства, которое нужно получить, в виде строки.
Возвращает:: ссылку на объект свойства или значение java.awt.Image.UndefinedProperty.

getPropertyNames

String[] getPropertyNames()

Возвращает список имён, распознаваемых методом getProperty.

Возвращает:: список имён свойств.

isDynamic

boolean isDynamic()

Возвращает true, если последовательные визуализации (то есть вызовы createRendering() или createScaledRendering()) с одинаковыми аргументами могут давать разные результаты. Этот метод можно использовать, чтобы определить, можно ли кэшировать существующую визуализацию и повторно использовать её. Возвращать true всегда безопасно.

Возвращает:: true, если последовательные визуализации с одинаковыми аргументами могут давать разные результаты; false в противном случае.

getWidth

float getWidth()

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

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

getHeight

float getHeight()

Возвращает высоту в пользовательских координатах. Согласно принятому соглашению, обычная высота RenderedImage равна 1.0F.

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

getMinX

float getMinX()

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

Возвращает:: минимальную координату X данных изображения, не зависящих от способа визуализации.

getMinY

float getMinY()

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

Возвращает:: минимальную координату Y данных изображения, не зависящих от способа визуализации.

createScaledRendering

RenderedImage createScaledRendering(int w, int h, RenderingHints hints)

Создаёт экземпляр RenderedImage для этого изображения шириной w и высотой h в пикселях. RenderContext автоматически формируется с подходящим преобразованием usr2dev и областью интереса, охватывающей всё изображение. Все подсказки визуализации берутся из переданных подсказок.

Если w == 0, его значение будет равно Math.round(h*(getWidth()/getHeight())). Аналогично, если h == 0, его значение будет равно Math.round(w*(getHeight()/getWidth())). Значение w или h должно быть ненулевым, иначе будет выброшено исключение IllegalArgumentException.

Созданный RenderedImage может иметь свойство, идентифицируемое строкой HINTS_OBSERVED, которое указывает, какие RenderingHints использовались для создания изображения. Кроме того, таким свойством могут обладать любые RenderedImage, полученные с помощью метода getSources() созданного RenderedImage.

Параметры:: w — ширина визуализированного изображения в пикселях или 0.; h — высота визуализированного изображения в пикселях или 0.; hints — объект RenderingHints, содержащий подсказки.
Возвращает:: RenderedImage, содержащий визуализированные данные.

createDefaultRendering

RenderedImage createDefaultRendering()

Возвращает экземпляр RenderedImage для этого изображения со стандартными шириной и высотой в пикселях. RenderContext автоматически формируется с подходящим преобразованием usr2dev и областью интереса, охватывающей всё изображение. Подсказки визуализации отсутствуют. Для ускорения createDefaultRendering может использовать сохранённую визуализацию.

Возвращает:: RenderedImage, содержащий визуализированные данные.

createRendering

RenderedImage createRendering(RenderContext renderContext)

Создаёт RenderedImage, представляющий визуализацию этого изображения с использованием заданного RenderContext. Это наиболее общий способ получить визуализацию RenderableImage.

Созданный RenderedImage может иметь свойство, идентифицируемое строкой HINTS_OBSERVED, которое указывает, какие RenderingHints (из RenderContext) использовались для создания изображения. Кроме того, таким свойством могут обладать любые RenderedImage, полученные с помощью метода getSources() созданного RenderedImage.

Параметры:: renderContext — RenderContext, используемый для создания визуализации.
Возвращает:: RenderedImage, содержащий визуализированные данные.

© 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/renderable/RenderableImage.html