モジュール java.desktop
パッケージ java.awt.image.renderable

クラスRenderContext

java.lang.Object
java.awt.image.renderable.RenderContext
すべての実装されたインタフェース:
Cloneable
public class RenderContext
extends Object
implements Cloneable
RenderContextは、RenderableImageから特定の描画を作成するために必要な情報をカプセル化します。 これには、描画に依存せずに指定される描画領域、描画が実行される解像度、および描画プロセスを制御するために使用されるヒントが格納されます。

ユーザーはRenderContextを生成し、createRenderingメソッドを使用してRenderContextをRenderableImageに渡します。 ほとんどのRenderContextのメソッドは、アプリケーションによって直接使用されることはなく、渡されるRenderableImageおよび演算子クラスによって使用されます。

このクラスに渡されたか、またはこのクラスから渡されたAffineTransformパラメータは複製されます。 RenderingHintsおよびShapeパラメータは必ずしも複製可能ではありません。またそのため、参照しかコピーされません。 RenderContextのインスタンスが使用しているRenderingHintsまたはShapeのインスタンスを変更すると、予期しない副作用が生じることがあります。

  • コンストラクタの詳細

    • 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。
      導入されたバージョン:
      1.3

    • preConcetenateTransform

      @Deprecatedpublic 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。
      導入されたバージョン:
      1.3

    • concetenateTransform

      @Deprecatedpublic 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とヒントは複製されますが、処理対象範囲は参照でコピーされます。
      オーバーライド:
      clone、クラス: Object
      戻り値:
      新しく複製されたRenderContext。
      関連項目:
      Cloneable