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