Класс 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-источников, используя полученные в шаге 1 RenderContexts, результатом чего является рендеринг каждого источника;
3. ContextualRenderedImageFactory.create() вызывается с новым ParameterBlock, содержащим параметры RenderableImageOp и RenderedImages, созданные вызовами createRendering().

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

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