Question

java.lang.Object
  └java.awt.image.renderable.RenderableImageOp

所有已实现的接口：

RenderableImage

---

public class RenderableImageOp

extends Object

implements RenderableImage

此类借助其相关的 ContextualRenderedImageFactory 实例处理某个操作的可呈现方面。

---

字段摘要

从接口 java.awt.image.renderable.RenderableImage 继承的字段
HINTS_OBSERVED

构造方法摘要
RenderableImageOp(ContextualRenderedImageFactoryCRIF, ParameterBlockparamBlock) 根据给定 ContextualRenderedImageFactory 对象以及一个包含 RenderableImage 源和其他参数的 ParameterBlock 构造 RenderedImageOp。

方法摘要
RenderedImage	createDefaultRendering() 获取此图像具有默认宽度和高度（以像素为单位）的一个 RenderedImage 实例。
RenderedImage	createRendering(RenderContextrenderContext) 创建一个表示根据给定 RenderContext 呈现的 RenderableImageOp（包括其 Renderable 源）的 RenderedImage。
RenderedImage	createScaledRendering(intw, inth, RenderingHintshints) 创建此图像具有宽度 w 和高度 h（以像素为单位）的一个 RenderedImage 实例。
float	getHeight() 获取用户坐标空间中的高度。
float	getMinX() 获取与呈现无关的图像数据的最小 X 坐标。
float	getMinY() 获取与呈现无关的图像数据的最小 Y 坐标。
ParameterBlock	getParameterBlock() 返回到对当前参数块的一个引用。
Object	getProperty(Stringname) 从此图像的属性集中获取某个属性。
String[]	getPropertyNames() 返回由 getProperty 识别的名称列表。
Vector<RenderableImage>	getSources() 返回作为此 RenderableImage 图像数据源的 RenderableImage 的向量。
float	getWidth() 获取用户坐标空间中的宽度。
boolean	isDynamic() 如果使用相同参数的后续呈现（即，调用 createRendering() 或 createScaledRendering()）可以生成不同结果，则返回 true。
ParameterBlock	setParameterBlock(ParameterBlockparamBlock) 更改操作的当前 ParameterBlock，允许编辑图像呈现链。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

RenderableImageOp

public RenderableImageOp(ContextualRenderedImageFactoryCRIF,
                         ParameterBlockparamBlock)

根据给定 ContextualRenderedImageFactory 对象以及一个包含 RenderableImage 源和其他参数的 ParameterBlock 构造 RenderedImageOp。由 ParameterBlock 引用的任何 RenderedImage 源都将被忽略。

参数：

CRIF - 一个 ContextualRenderedImageFactory 对象

paramBlock - 一个包含此操作的源图像和该操作运行所必须的其他参数的 ParameterBlock。

方法详细信息

getSources

public Vector<RenderableImage> getSources()

返回作为此 RenderableImage 图像数据源的 RenderableImage 的向量。注意，此方法可能返回空向量，指示该图像没有源，或者返回 null，指示没有可用信息。

指定者：

接口 RenderableImage 中的 getSources

返回：

RenderableImage 的 Vector（可能为空），或者 null。

---

getProperty

public Object getProperty(Stringname)

从此图像的属性集中获取某个属性。如果该属性名无法识别，将返回 java.awt.Image.UndefinedProperty。

指定者：

接口 RenderableImage 中的 getProperty

参数：

name - 要获取的属性的名称（以 String 形式）。

返回：

对属性 Object 的引用，或者值 java.awt.Image.UndefinedProperty。

---

getPropertyNames

public String[] getPropertyNames()

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

指定者：

接口 RenderableImage 中的 getPropertyNames

返回：

属性名称列表。

---

isDynamic

public boolean isDynamic()

如果使用相同参数的后续呈现（即，调用 createRendering() 或 createScaledRendering()）可以生成不同结果，则返回 true。此方法可用于确定是否可以缓存和重用现有呈现。将调用 CRIF 的 isDynamic 方法。

指定者：

接口 RenderableImage 中的 isDynamic

返回：

如果使用相同参数的后续呈现可以生成不同结果，则返回 true ；否则返回 false 。

---

getWidth

public float getWidth()

获取用户坐标空间中的宽度。按照惯例，RenderableImage 的常规宽度等于该图像的高宽比（宽度除以高度）。

指定者：

接口 RenderableImage 中的 getWidth

返回：

用户坐标中图像的宽度。

---

getHeight

public float getHeight()

获取用户坐标空间中的高度。按照惯例，RenderedImage 的常规高度等于 1.0F。

指定者：

接口 RenderableImage 中的 getHeight

返回：

用户坐标中图像的高度。

---

getMinX

public float getMinX()

获取与呈现无关的图像数据的最小 X 坐标。

指定者：

接口 RenderableImage 中的 getMinX

返回：

与呈现无关的图像数据的最小 X 坐标。

---

getMinY

public float getMinY()

获取与呈现无关的图像数据的最小 Y 坐标。

指定者：

接口 RenderableImage 中的 getMinY

返回：

与呈现无关的图像数据的最小 Y 坐标。

---

setParameterBlock

public ParameterBlock setParameterBlock(ParameterBlockparamBlock)

更改操作的当前 ParameterBlock，允许编辑图像呈现链。当根据此 RenderableImageOp 或任何相关 RenderableImageOp 创建新呈现时，此更改的效果将是可见的。

参数：

paramBlock - 新的 ParameterBlock。

返回：

旧的 ParameterBlock。

另请参见：

getParameterBlock()

---

getParameterBlock

public ParameterBlock getParameterBlock()

返回到对当前参数块的一个引用。

返回：

此 RenderableImageOp 的 ParameterBlock 。

另请参见：

setParameterBlock(ParameterBlock)

---

createScaledRendering

public RenderedImage createScaledRendering(intw,
                                           inth,
                                           RenderingHintshints)

创建此图像具有宽度 w 和高度 h（以像素为单位）的一个 RenderedImage 实例。使用适当的 usr2dev 变换和完整图像感兴趣的区域自动构建 RenderContext。所有呈现提示均来自传入的提示。

如果 w == 0，则该值将等于 Math.round(h*(getWidth()/getHeight()))。类似地，如果 h == 0，则该值将等于 Math.round(w*(getHeight()/getWidth()))。w 和 h 中必须有一个不为零，否则将抛出 IllegalArgumentException。

创建的 RenderedImage 可能有一个由字符串 HINTS_OBSERVED 标识的属性，以指示使用了哪些 RenderingHints 创建该图像。此外，通过创建的 RenderedImage 上的 getSources() 方法获取的任何 RenderedImage 都可能具有该属性。

指定者：

接口 RenderableImage 中的 createScaledRendering

参数：

w - 所呈现图像的宽度（以像素为单位），或者为 0。

h - 所呈现图像的高度（以像素为单位），或者为 0。

hints - 包含提示的 RenderingHints 对象。

返回：

包含所呈现数据的 RenderedImage。

---

createDefaultRendering

public RenderedImage createDefaultRendering()

获取此图像具有默认宽度和高度（以像素为单位）的一个 RenderedImage 实例。使用适当的 usr2dev 变换和完整图像感兴趣的区域自动构建 RenderContext。所有呈现提示均来自传入的提示。此接口的实现者必须保证存在已定义的默认宽度和高度。

指定者：

接口 RenderableImage 中的 createDefaultRendering

返回：

包含所呈现数据的 RenderedImage。

---

createRendering

public RenderedImage createRendering(RenderContextrenderContext)

创建一个表示根据给定 RenderContext 呈现的 RenderableImageOp（包括其 Renderable 源）的 RenderedImage。

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

1. 对每个 RenderableImage 源在相关的 CRIF 上调用 mapRenderContext()；
2. 使用在第 1 步中获取的向后映射的 RenderContext 在每个 RenderableImage 源上调用 createRendering()，得到每个源的呈现；
3. 调用 ContextualRenderedImageFactory.create()，使用一个新 ParameterBlock，其包含通过调用 createRendering() 创建的 RenderedImage 和 RenderableImageOp 的参数。

如果用于构造 RenderableImageOp 的 ParameterBlock 源 Vector 的元素是 RenderedImage 实例，则立即使用初始 ParameterBlock 调用 CRIF.create() 方法。这为递归提供了一个基本方案。

创建的 RenderedImage 可能有一个由字符串 HINTS_OBSERVED 标识的属性，以指示使用了哪些 RenderingHints（来自 RenderContext）创建该图像。此外，通过创建的 RenderedImage 上的 getSources() 方法获取的任何 RenderedImages 都可能具有该属性。

指定者：

接口 RenderableImage 中的 createRendering

参数：

renderContext - 用于执行呈现的 RenderContext。

返回：

包含所需输出图像的 RenderedImage。