模块  java.desktop
软件包  java.awt.image.renderable

Class RenderableImageOp

  • 实现的所有接口
    RenderableImage 
    public class RenderableImageOp
extends Object
implements RenderableImage
    此类在其关联的ContextualRenderedImageFactory实例的帮助下处理操作的可渲染方面。

    • 构造方法详细信息

      • RenderableImageOp

        public RenderableImageOp​(ContextualRenderedImageFactory CRIF,
                         ParameterBlock paramBlock)
        在给定ContextualRenderedImageFactory对象的情况下构造RenderedImageOp，并使用包含RenderableImage源和其他参数的ParameterBlock构造RenderedImageOp。 ParameterBlock引用的任何RenderedImage源都将被忽略。
        参数
        CRIF - ContextualRenderedImageFactory对象
        paramBlock - 一个ParameterBlock，包含此操作的源映像和运行操作所需的其他参数。

    • 方法详细信息

      • getSources

        public Vector<RenderableImage> getSources()
        返回RenderableImages的矢量，RenderableImages是此RenderableImage的图像数据源。 请注意，此方法可能返回空向量，以指示图像没有源或null，以指示没有可用信息。
        Specified by:
        getSources接口 RenderableImage
        结果
        一个（可能是空的）RenderableImages矢量，或者为null。

      • getProperty

        public Object getProperty​(String name)
        从此图像的属性集中获取属性。 如果无法识别属性名称，则将返回java.awt.Image.UndefinedProperty。
        Specified by:
        getProperty接口 RenderableImage
        参数
        name - 要获取的属性的名称，作为String。
        结果
        对Object属性的引用，或java.awt.Image.UndefinedProperty的值。

      • isDynamic

        public boolean isDynamic()
        如果使用相同参数的连续渲染（即，调用createRendering（）或createScaledRendering（））可能产生不同的结果，则返回true。 该方法可用于确定是否可以高速缓存和重用现有的渲染。 将调用CRIF的isDynamic方法。
        Specified by:
        isDynamic接口 RenderableImage
        结果
        true如果具有相同参数的连续渲染可能产生不同的结果; 否则为false 。

      • getWidth

        public float getWidth()
        获取用户坐标空间中的宽度。 按照惯例，RenderableImage的通常宽度等于图像的宽高比（宽度除以高度）。
        Specified by:
        getWidth ，界面 RenderableImage
        结果
        用户坐标中图像的宽度。

      • getHeight

        public float getHeight()
        获取用户坐标空间中的高度。 按照惯例，RenderedImage的通常高度等于1.0F。
        Specified by:
        getHeight接口 RenderableImage
        结果
        用户坐标中图像的高度。

      • getMinX

        public float getMinX()
        获取与渲染无关的图像数据的最小X坐标。
        Specified by:
        getMinX ，界面 RenderableImage
        结果
        与渲染无关的图像数据的最小X坐标。

      • getMinY

        public float getMinY()
        获取与渲染无关的图像数据的最小Y坐标。
        Specified by:
        getMinY在界面 RenderableImage
        结果
        与渲染无关的图像数据的最小Y坐标。

      • setParameterBlock

        public ParameterBlock setParameterBlock​(ParameterBlock paramBlock)
        更改操作的当前ParameterBlock，允许编辑图像渲染链。 当从此RenderableImageOp或任何相关RenderableImageOp创建新渲染时，此类更改的效果将可见。
        参数
        paramBlock - 新的ParameterBlock。
        结果
        旧的ParameterBlock。
        另请参见：
        getParameterBlock()

      • createScaledRendering

        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可能具有由String HINTS_OBSERVED标识的属性，以指示用于创建图像的RenderingHints。 此外，通过创建的RenderedImage上的getSources（）方法获得的任何RenderedImages可能具有此类属性。

        Specified by:
        createScaledRendering接口 RenderableImage
        参数
        w - 渲染图像的宽度（以像素为单位）或0。
        h - 渲染图像的高度（以像素为单位）或0。
        hints - 包含提示的RenderingHints对象。
        结果
        包含渲染数据的RenderedImage。

      • createDefaultRendering

        public RenderedImage createDefaultRendering()
        获取此图像的RenderedImage实例，其默认宽度和高度（以像素为单位）。 RenderContext是使用适当的usr2dev变换和完整图像的感兴趣区域自动构建的。 所有渲染提示都来自传入的提示。此接口的实现者必须确保存在已定义的默认宽度和高度。
        Specified by:
        createDefaultRendering在界面 RenderableImage
        结果
        包含渲染数据的RenderedImage。

      • createRendering

        public RenderedImage createRendering​(RenderContext renderContext)
        创建一个RenderedImage，它表示根据给定的RenderContext呈现的RenderableImageOp（包括其Renderable源）。

        此方法支持链接Renderable或RenderedImage操作。 如果用于构造RenderableImageOp的ParameterBlock中的源是RenderableImages，则遵循三步过程：

        1. 在每个RenderableImage源的关联CRIF上调用mapRenderContext（）;
        2. 使用在步骤1中获得的向后映射的RenderContexts在每个RenderableImage源上调用createRendering（），从而生成每个源的渲染;
        3. ContextualRenderedImageFactory.create（）使用新的ParameterBlock调用，该ParameterBlock包含由createRendering（）调用创建的RenderableImageOp和RenderedImages的参数。

        如果用于构造RenderableImageOp的ParameterBlock的源Vector的元素是RenderedImage的实例，则使用原始ParameterBlock立即调用CRIF.create（）方法。 这为递归提供了基础案例。

        创建的RenderedImage可能具有由String HINTS_OBSERVED标识的属性，以指示使用哪些RenderingHints（来自RenderContext）来创建图像。 此外，通过创建的RenderedImage上的getSources（）方法获得的任何RenderedImages可能具有此类属性。

        Specified by:
        createRendering接口 RenderableImage
        参数
        renderContext - 用于执行呈现的RenderContext。
        结果
        包含所需输出图像的RenderedImage。