Интерфейс 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, 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/renderable/RenderableImage.html