Интерфейс 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()`	Возвращает вектор RenderableImages, являющихся источниками данных изображения для данного RenderableImage.
`float`	`getWidth()`	Возвращает ширину в пространстве координат пользователя.
`boolean`	`isDynamic()`	Возвращает true, если последовательные рендеринги (то есть вызовы createRendering() или createScaledRendering()) с одинаковыми аргументами могут давать разные результаты.

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

HINTS_OBSERVED

static final String HINTS_OBSERVED

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

См. также:

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

getSources

Vector<RenderableImage> getSources()

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

Возвращает:: вектор (возможно, пустой) RenderableImages или 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 были использованы для создания изображения. Кроме того, любые RenderedImages, полученные через метод 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) были использованы для создания изображения. Кроме того, любые RenderedImages, полученные через метод 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/renderable/RenderableImage.html