Класс RenderableImageOp

public RenderableImageOp(ContextualRenderedImageFactory CRIF, ParameterBlock paramBlock)

Создаёт RenderedImageOp, используя объект ContextualRenderedImageFactory и ParameterBlock, содержащий источники RenderableImage и другие параметры. Любые источники RenderedImage, упомянутые в ParameterBlock, будут проигнорированы.

public Vector<RenderableImage> getSources()

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

public Object getProperty(String name)

Получает свойство из набора свойств этого изображения. Если имя свойства не распознаётся, возвращается java.awt.Image.UndefinedProperty.

public String[] getPropertyNames()

Возвращает список имён, распознаваемых методом getProperty.

public boolean isDynamic()

Возвращает true, если последующие рендеринги (то есть вызовы createRendering() или createScaledRendering()) с теми же аргументами могут давать разные результаты. Этот метод может использоваться для определения того, можно ли кэшировать и повторно использовать существующий рендеринг. Будет вызван метод isDynamic CRIF.

public float getWidth()

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

public float getHeight()

Получает высоту в пространстве пользовательских координат. По соглашению, обычная высота RenderedImage равна 1.0F.

public float getMinX()

Получает минимальную координату X данных изображения, независимых от рендеринга.

public float getMinY()

Получает минимальную координату Y данных изображения, независимых от рендеринга.

public ParameterBlock setParameterBlock(ParameterBlock paramBlock)

Изменяет текущий ParameterBlock операции, позволяя редактировать цепочки рендеринга изображений. Эффекты такого изменения будут видны при создании нового рендеринга из этого RenderableImageOp или любого зависимого RenderableImageOp.

public ParameterBlock getParameterBlock()

Возвращает ссылку на текущий блок параметров.

public 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, могут иметь такое свойство.

public RenderedImage createDefaultRendering()

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

public RenderedImage createRendering(RenderContext renderContext)

Создаёт RenderedImage, представляющий этот RenderableImageOp (включая его источники Renderable) с рендерингом в соответствии с данным RenderContext.

Этот метод поддерживает объединение операций Renderable или RenderedImage. Если источники в ParameterBlock, используемом для создания RenderableImageOp, являются RenderedImages, то выполняется трёхступенчатый процесс:

1. mapRenderContext() вызывается для каждого источника RenderableImage в связанном CRIF;
2. createRendering() вызывается для каждого из источников RenderableImage, используя обратные преобразования RenderContext, полученные на шаге 1, что приводит к рендерингу каждого источника;
3. ContextualRenderedImageFactory.create() вызывается с новым ParameterBlock, содержащим параметры RenderableImageOp и RenderedImages, которые были созданы вызовами createRendering().

Если элементы вектора источника ParameterBlock, используемого для построения RenderableImageOp, являются экземплярами RenderedImage, то метод CRIF.create() вызывается немедленно с исходным ParameterBlock. Это обеспечивает базовый случай для рекурсии.

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