Интерфейс RenderableImage

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

public interface RenderableImage

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

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

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

Все методы отрисовки могут возвращать ссылку на ранее созданную отрисовку.

Поля

Модификатор и тип	Поле	Описание
`static 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(java.lang.String)

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(int,int,java.awt.RenderingHints)

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(java.awt.image.renderable.RenderContext)

RenderedImage createRendering(RenderContext renderContext)

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

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

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