Интерфейс 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 в противном случае.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/image/renderable/ContextualRenderedImageFactory.html