Module  java.desktop
软件包  java.awt.image.renderable

Interface ContextualRenderedImageFactory

  • All Superinterfaces:
    RenderedImageFactory 

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

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

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

    • 方法详细信息

      • mapRenderContext

        RenderContext mapRenderContext​(int i,
                               RenderContext renderContext,
                               ParameterBlock paramBlock,
                               RenderableImage image)
        将操作的输出RenderContext映射到每个操作源的RenderContext中。 这对于可以全部或部分地简单地表示为RenderContext中的改变（例如仿射映射）或希望获得其源的较低质量渲染以便节省处理工作量或传输带宽的操作是有用的。 一些操作，如模糊，也可以使用这种机制来避免获得比必要的更高质量的来源。
        参数
        i - 源图像的索引。
        renderContext - 应用于操作的RenderContext。
        paramBlock - 包含操作的源和参数的ParameterBlock。
        image - 渲染的RenderableImage。
        结果
        一个 RenderContext的源代码在指定的参数Vector中指定的索引包含在指定的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)
        获取由name参数指定的属性的适当实例。 当有多个源指定属性时，此方法必须确定要返回的属性的哪个实例。
        参数
        paramBlock - 一个包含操作的源和参数的ParameterBlock。
        name - 一个命名所需属性的字符串。
        结果
        一个对象引用的值所请求的属性。

      • getPropertyNames

        String[] getPropertyNames​()
        返回由getProperty识别的名称列表。
        结果
        属性名称列表。

      • isDynamic

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