JavaTM 2 Platform
Standard Ed. 5.0

java.awt.image.renderable
类 RenderContext

java.lang.Object
  继承者 java.awt.image.renderable.RenderContext
所有已实现的接口:
Cloneable

public class RenderContext
extends Object
implements Cloneable

RenderContext 封装从 enderableImage 生成特定呈现所需的信息。它包含与呈现无关的条件中指定的要呈现的区域、呈现执行的分辨率和用于控制呈现过程的提示。

用户创建 RenderContext 并通过 createRendering 方法将它们传递到 RenderableImage。RenderContext 的多数方法不是为了让应用程序直接使用,而是由它传递到的 RenderableImage 和操作符类直接使用。

传入此类和从此类传出的 AffineTransform 参数被克隆。RenderingHints 和 Shape 参数不一定是可克隆的,并因此仅复制引用。改变正在由 RenderContext 实例使用的 RenderingHints 或 Shape 实例可能产生不希望出现的负作用。


构造方法摘要
RenderContext(AffineTransform usr2dev)
          构造具有给定变换的 RenderContext。
RenderContext(AffineTransform usr2dev, RenderingHints hints)
          构造具有给定转换和呈现提示的 RenderContext。
RenderContext(AffineTransform usr2dev, Shape aoi)
          构造具有给定变换和感兴趣区域的 RenderContext。
RenderContext(AffineTransform usr2dev, Shape aoi, RenderingHints hints)
          构造具有给定转换的 RenderContext。
 
方法摘要
 Object clone()
          对 RenderContext 进行复制。
 void concatenateTransform(AffineTransform modTransform)
          通过追加另一变换修改当前的“用户到设备”变换。
 void concetenateTransform(AffineTransform modTransform)
          已过时。 concatenateTransform(AffineTransform) 所替代。
 Shape getAreaOfInterest()
          获取当前包含在 RenderContext 中的感兴趣区域。
 RenderingHints getRenderingHints()
          获取此 RenderContext 的呈现提示。
 AffineTransform getTransform()
          获取当前“用户到设备”的 AffineTransform。
 void preConcatenateTransform(AffineTransform modTransform)
          通过预先挂起另一变换修改当前的“用户到设备”变换。
 void preConcetenateTransform(AffineTransform modTransform)
          已过时。 preConcatenateTransform(AffineTransform) 所取代。
 void setAreaOfInterest(Shape newAoi)
          设置当前的感兴趣区域。
 void setRenderingHints(RenderingHints hints)
          设置此 RenderContext 的呈现提示。
 void setTransform(AffineTransform newTransform)
          将 RenderContext 中包含的当前“用户到设备”的 AffineTransform 设置为给定的变换。
 
从类 java.lang.Object 继承的方法
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

RenderContext

public RenderContext(AffineTransform usr2dev,
                     Shape aoi,
                     RenderingHints hints)
构造具有给定转换的 RenderContext。感兴趣的区域作为一个 Shape 提供,呈现提示作为一个 RenderingHints 对象提供。

参数:
usr2dev - 一个 AffineTransform。
aoi - 表示感兴趣区域的 Shape。
hints - 包含呈现提示的 RenderingHints 对象。

RenderContext

public RenderContext(AffineTransform usr2dev)
构造具有给定变换的 RenderContext。感兴趣的区域被用做整个可呈现区域。不使用呈现提示。

参数:
usr2dev - 一个 AffineTransform。

RenderContext

public RenderContext(AffineTransform usr2dev,
                     RenderingHints hints)
构造具有给定转换和呈现提示的 RenderContext。感兴趣的区域被用做整个可呈现区域。

参数:
usr2dev - 一个 AffineTransform。
hints - 包含呈现提示的 RenderingHints 对象。

RenderContext

public RenderContext(AffineTransform usr2dev,
                     Shape aoi)
构造具有给定变换和感兴趣区域的 RenderContext。感兴趣区域作为一个 Shape 提供。不使用呈现提示。

参数:
usr2dev - 一个 AffineTransform。
aoi - 表示感兴趣区域的 Shape。
方法详细信息

getRenderingHints

public RenderingHints getRenderingHints()
获取此 RenderContext 的呈现提示。

返回:
表示此 RenderContext 呈现提示的 RenderingHints 对象。
另请参见:
setRenderingHints(RenderingHints)

setRenderingHints

public void setRenderingHints(RenderingHints hints)
设置此 RenderContext 的呈现提示。

参数:
hints - 表示赋给此 RenderContext 的呈现提示的 RenderingHints 对象。
另请参见:
getRenderingHints()

setTransform

public void setTransform(AffineTransform newTransform)
将 RenderContext 中包含的当前“用户到设备”的 AffineTransform 设置为给定的变换。

参数:
newTransform - 新的 AffineTransform。
另请参见:
getTransform()

preConcatenateTransform

public void preConcatenateTransform(AffineTransform modTransform)
通过预先挂起另一变换修改当前的“用户到设备”变换。用矩阵表示该操作为:
 [this] = [modTransform] x [this]
 

参数:
modTransform - 预先挂起到当前 usr2dev 变换的 AffineTransform。

preConcetenateTransform

@Deprecated
public void preConcetenateTransform(AffineTransform modTransform)
已过时。 preConcatenateTransform(AffineTransform) 所取代。

通过预先挂起另一变换修改当前的“用户到设备”变换。用矩阵表示该操作为:
 [this] = [modTransform] x [this]
 
此方法与 preConcatenateTransform 方法的作用相同。保留此方法是为了与以前发布版本的向后兼容,以前版本中该方法的名称拼写错误。

参数:
modTransform - 预先挂起到当前 usr2dev 变换的 AffineTransform。

concatenateTransform

public void concatenateTransform(AffineTransform modTransform)
通过追加另一变换修改当前的“用户到设备”变换。用矩阵表示该操作为:
 [this] = [this] x [modTransform]
 

参数:
modTransform - 追加到当前 usr2dev 变换的 AffineTransform。

concetenateTransform

@Deprecated
public void concetenateTransform(AffineTransform modTransform)
已过时。 concatenateTransform(AffineTransform) 所替代。

通过追加另一变换修改当前的“用户到设备”转换。用矩阵表示该操作为:
 [this] = [this] x [modTransform]
 
此方法与 concatenateTransform 方法的作用相同。保留此方法是为了与以前发布版本的向后兼容,以前版本中该方法的名称拼写错误。

参数:
modTransform - 追加到当前 usr2dev 变换的 AffineTransform。

getTransform

public AffineTransform getTransform()
获取当前“用户到设备”的 AffineTransform。

返回:
当前 AffineTransform 的一个引用。
另请参见:
setTransform(AffineTransform)

setAreaOfInterest

public void setAreaOfInterest(Shape newAoi)
设置当前的感兴趣区域。丢弃旧区域。

参数:
newAoi - 新的感兴趣区域。
另请参见:
getAreaOfInterest()

getAreaOfInterest

public Shape getAreaOfInterest()
获取当前包含在 RenderContext 中的感兴趣区域。

返回:
对 RenderContext 的感兴趣区域的引用,如果未指定,则返回 null。
另请参见:
setAreaOfInterest(Shape)

clone

public Object clone()
对 RenderContext 进行复制。感兴趣区域由引用复制。克隆 usr2dev AffineTransform 和提示,而感兴趣区域由引用复制。

覆盖:
Object 中的 clone
返回:
新克隆的 RenderContext。
另请参见:
Cloneable

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策