Интерфейс RenderableImage

public interface RenderableImage

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

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

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

Поля

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)

Параметры:

w - ширина изображения рендеринга в пикселях или 0.

h - высота изображения рендеринга в пикселях или 0.

hints - объект RenderingHints, содержащий подсказки.

Возвращает:

RenderedImage, содержащий рендеренные данные.

createDefaultRendering

RenderedImage createDefaultRendering()

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

Возвращает:

RenderedImage, содержащий рендеренные данные.

createRendering

RenderedImage createRendering(RenderContext renderContext)

Параметры:

renderContext - RenderContext, используемый для создания рендеринга.

Возвращает:

RenderedImage, содержащий рендеренные данные.