Module java.desktop
Package java.awt.image.renderable

Class RenderContext

java.lang.Object
java.awt.image.renderable.RenderContext
所有已实现的接口:
Cloneable
public class RenderContext extends Object implements Cloneable
RenderContext封装了从RenderableImage生成特定渲染所需的信息。它包含以与渲染无关的方式指定的要渲染的区域，要执行渲染的分辨率以及用于控制渲染过程的提示。

用户创建RenderContext并通过createRendering方法将其传递给RenderableImage。RenderContext的大多数方法不是直接由应用程序使用的，而是由RenderableImage和传递给它的操作类使用。

传入和传出此类的AffineTransform参数是克隆的。RenderingHints和Shape参数不一定是可克隆的，因此只是引用复制。修改RenderContext实例中正在使用的RenderingHints或Shape实例可能会产生不良副作用。

  • Constructor Details

    • 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。

  • Method Details

    • getRenderingHints

      public RenderingHints getRenderingHints()
      获取此RenderContext的渲染提示。
      返回:
      代表此RenderContext的渲染提示的RenderingHints对象。
      另请参阅:

    • setRenderingHints

      public void setRenderingHints(RenderingHints hints)
      设置此RenderContext的渲染提示。
      参数:
      hints - 代表要分配给此RenderContext的渲染提示的RenderingHints对象。
      另请参阅:

    • setTransform

      public void setTransform(AffineTransform newTransform)
      将RenderContext中包含的当前用户到设备AffineTransform设置为给定的变换。
      参数:
      newTransform - 新的AffineTransform。
      另请参阅:

    • preConcatenateTransform

      public void preConcatenateTransform(AffineTransform modTransform)
      通过在另一个变换之前添加修改当前用户到设备变换。在矩阵表示中，操作为： 
       [this] = [modTransform] x [this]
      参数:
      modTransform - 要在当前usr2dev变换之前添加的AffineTransform。
      自1.3起:
      1.3

    • preConcetenateTransform

      @Deprecated public void preConcetenateTransform(AffineTransform modTransform)
      Deprecated.
      replaced by preConcatenateTransform(AffineTransform).
      通过在另一个变换之前添加修改当前用户到设备变换。在矩阵表示中，操作为： 
       [this] = [modTransform] x [this]
      此方法与preConcatenateTransform方法执行相同的操作。这是为了向后兼容以前拼写错误方法名称的先前版本而存在的。
      参数:
      modTransform - 要在当前usr2dev变换之前添加的AffineTransform。

    • concatenateTransform

      public void concatenateTransform(AffineTransform modTransform)
      通过附加另一个变换修改当前用户到设备变换。在矩阵表示中，操作为： 
       [this] = [this] x [modTransform]
      参数:
      modTransform - 要附加到当前usr2dev变换的AffineTransform。
      自1.3起:
      1.3

    • concetenateTransform

      @Deprecated public void concetenateTransform(AffineTransform modTransform)
      Deprecated.
      replaced by concatenateTransform(AffineTransform).
      通过附加另一个变换修改当前用户到设备变换。在矩阵表示中，操作为： 
       [this] = [this] x [modTransform]
      此方法与concatenateTransform方法执行相同的操作。这是为了向后兼容以前拼写错误方法名称的先前版本而存在的。
      参数:
      modTransform - 要附加到当前usr2dev变换的AffineTransform。

    • getTransform

      public AffineTransform getTransform()
      获取当前用户到设备AffineTransform。
      返回:
      对当前AffineTransform的引用。
      另请参阅:

    • setAreaOfInterest

      public void setAreaOfInterest(Shape newAoi)
      设置当前感兴趣的区域。旧区域将被丢弃。
      参数:
      newAoi - 新的感兴趣区域。
      另请参阅:

    • getAreaOfInterest

      public Shape getAreaOfInterest()
      获取当前包含在RenderContext中的感兴趣的区域。
      返回:
      对RenderContext的感兴趣区域的引用，如果未指定则为null。
      另请参阅:

    • clone

      public Object clone()
      复制RenderContext。感兴趣的区域通过引用复制。usr2dev AffineTransform和hints被克隆，而感兴趣的区域通过引用复制。
      覆盖:
      clone 在类 Object
      返回:
      新克隆的RenderContext。
      另请参阅: