java.awt.image.renderable

Interface ContextualRenderedImageFactory

All Superinterfaces:

RenderedImageFactory

public interface ContextualRenderedImageFactory
extends RenderedImageFactory

ContextualRenderedImageFactory为RenderableImageOp的实例之间的功能提供了一个接口。 因此，通过使用ContextualRenderedImageFactory的多个实例，RenderableImages上的不同操作可以由单个类（如RenderedImageOp）执行。 名称ContextualRenderedImageFactory通常缩写为“CRIF”。

要在独立渲染的链中使用的所有操作都必须实现ContextualRenderedImageFactory。

实现此接口的类必须提供一个没有参数的构造函数。

方法摘要

Modifier and Type	Method and Description
RenderedImage	create(RenderContext renderContext, ParameterBlock paramBlock) 给定一个渲染，给定一个RenderContext和一个ParameterBlock，其中包含操作的源和参数。
Rectangle2D	getBounds2D(ParameterBlock paramBlock) 在独立于渲染的空间中，返回在给定的一组源上执行的操作输出的边界框。
Object	getProperty(ParameterBlock paramBlock, String name) 获取由name参数指定的属性的适当实例。
String[]	getPropertyNames() 返回由getProperty识别的名称列表。
boolean	isDynamic() 如果使用相同参数的连续渲染（即，调用create（RenderContext，ParameterBlock）））可能会产生不同的结果，则返回true。
RenderContext	mapRenderContext(int i, RenderContext renderContext, ParameterBlock paramBlock, RenderableImage image) 将操作的输出RenderContext映射到每个操作源的RenderContext中。

Methods inherited from interface 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来自于指定 RenderedImage的源和参数，并根据指定的RenderContext中的渲染指令。

getBounds2D

Rectangle2D getBounds2D(ParameterBlock paramBlock)

在独立于渲染的空间中，返回在给定的一组源上执行的操作输出的边界框。 边界返回为Rectangle2D，即具有浮点角坐标的轴对齐矩形。

参数

paramBlock - 一个包含操作的源和参数的ParameterBlock。

结果

一个Rectangle2D指定输出的与渲染无关的边界框。

getProperty

Object getProperty(ParameterBlock paramBlock,
                   String name)

获取由name参数指定的属性的适当实例。 当有多个源指定属性时，此方法必须确定要返回的属性的哪个实例。

参数

paramBlock - 包含操作的源和参数的ParameterBlock。

name - 一个命名所需属性的字符串。

结果

一个对象引用的值所请求的属性。

getPropertyNames

String[] getPropertyNames()

返回由getProperty识别的名称列表。

结果

属性名称列表。

isDynamic

boolean isDynamic()

如果使用相同参数的连续渲染（即，调用create（RenderContext，ParameterBlock）））可能会产生不同的结果，则返回true。 该方法可用于确定现有渲染是否可被缓存和重用。 返回真实始终是安全的。

结果

true如果具有相同参数的连续渲染可能会产生不同的结果; false否则。