Интерфейс ContextualRenderedImageFactory

Все суперинтерфейсы:: RenderedImageFactory

public interface ContextualRenderedImageFactory
extends RenderedImageFactory

ContextualRenderedImageFactory предоставляет интерфейс для функциональности, которая может отличаться между экземплярами RenderableImageOp. Таким образом, разные операции над RenderableImages могут выполняться одним классом, таким как RenderedImageOp, с помощью нескольких экземпляров ContextualRenderedImageFactory. Имя ContextualRenderedImageFactory обычно сокращается до «CRIF».

Все операции, которые должны использоваться в цепочке, независимой от рендеринга, должны реализовывать ContextualRenderedImageFactory.

Классы, реализующие этот интерфейс, должны содержать конструктор без аргументов.

Методы

Модификатор и тип	Метод	Описание
`RenderedImage`	`create(RenderContext renderContext, ParameterBlock paramBlock)`	Создаёт рендеринг, используя RenderContext и ParameterBlock, содержащий источники и параметры операции.
`Rectangle2D`	`getBounds2D(ParameterBlock paramBlock)`	Возвращает прямоугольник ограничивающей рамки для вывода операции, выполненной на заданном наборе источников, в пространстве, независимом от рендеринга.
`Object`	`getProperty(ParameterBlock paramBlock, String name)`	Получает соответствующий экземпляр свойства, указанного именем параметра.
`String[]`	`getPropertyNames()`	Возвращает список имён, распознаваемых методом getProperty.
`boolean`	`isDynamic()`	Возвращает true, если последовательные рендеринги (т.е. вызовы create(RenderContext, ParameterBlock)) с одинаковыми аргументами могут давать разные результаты.
`RenderContext`	`mapRenderContext(int i, RenderContext renderContext, ParameterBlock paramBlock, RenderableImage image)`	Преобразует выходной RenderContext операции в RenderContext для каждого из источников операции.

Методы, объявленные в интерфейсе java.awt.image.renderable.RenderedImageFactory

create

Методы

mapRenderContext

RenderContext mapRenderContext(int i,
                               RenderContext renderContext,
                               ParameterBlock paramBlock,
                               RenderableImage image)

Преобразует выходной RenderContext операции в RenderContext для каждого из источников операции. Это полезно для операций, которые могут быть выражены полностью или частично просто как изменения в RenderContext, такие как аффинное преобразование, или операций, которые хотят получить рендеринги источников с более низким качеством, чтобы сэкономить вычислительные ресурсы или пропускную способность канала передачи данных. Некоторые операции, такие как размытие, также могут использовать этот механизм, чтобы избежать получения источников с более высоким качеством, чем необходимо.

Параметры:: i - индекс изображения-источника.; renderContext - RenderContext, применяемый к операции.; paramBlock - ParameterBlock, содержащий источники и параметры операции.; image - RenderableImage, подлежащий рендерингу.
Возвращает:: RenderContext для источника по указанному индексу в векторе параметров, содержащемся в заданном ParameterBlock.

create

RenderedImage create(RenderContext renderContext,
                     ParameterBlock paramBlock)

Создаёт рендеринг, используя RenderContext и ParameterBlock, содержащий источники и параметры операции. Вывод — RenderedImage, который учитывает RenderContext, чтобы определить свои размеры и расположение на плоскости изображения. Этот метод содержит «интеллект», позволяющий операции, независимой от рендеринга, адаптироваться к конкретному RenderContext.

Параметры:: renderContext - RenderContext, задающий рендеринг; paramBlock - ParameterBlock, содержащий источники и параметры операции
Возвращает:: RenderedImage, полученный из источников и параметров в заданном ParameterBlock и в соответствии с инструкциями рендеринга в указанном RenderContext.

getBounds2D

Rectangle2D getBounds2D(ParameterBlock paramBlock)

Возвращает прямоугольник ограничивающей рамки для вывода операции, выполненной на заданном наборе источников, в пространстве, независимом от рендеринга. Границы возвращаются как Rectangle2D, т. е. прямоугольник с выровненными осями и координатами углов с плавающей точкой.

Параметры:: paramBlock - ParameterBlock, содержащий источники и параметры операции.
Возвращает:: Rectangle2D, определяющий прямоугольник ограничивающей рамки вывода в пространстве, независимом от рендеринга.

getProperty

Object getProperty(ParameterBlock paramBlock,
                   String name)

Получает соответствующий экземпляр свойства, указанного именем параметра. Этот метод должен определить, какой экземпляр свойства возвращать, когда существует несколько источников, каждый из которых указывает это свойство.

Параметры:: paramBlock - ParameterBlock, содержащий источники и параметры операции.; name - Строка, содержащая имя искомого свойства.
Возвращает:: Ссылка на объект, представляющий значение запрошенного свойства.

getPropertyNames

String[] getPropertyNames()

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

Возвращает:: Список имён свойств.

isDynamic

boolean isDynamic()

Возвращает true, если последовательные рендеринги (т.е. вызовы create(RenderContext, ParameterBlock)) с одинаковыми аргументами могут давать разные результаты. Этот метод может использоваться для определения того, может ли существующий рендеринг кэшироваться и повторно использоваться. Возвращать true всегда безопасно.

Возвращает:: true , если последовательные рендеринги с одинаковыми аргументами могут давать разные результаты; false в противном случае.