モジュール 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(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。

導入されたバージョン:

1.3

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。

導入されたバージョン:

1.3

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とヒントは複製されますが、処理対象範囲は参照でコピーされます。

オーバーライド:

clone、クラスObject

戻り値:

新しく複製されたRenderContext。

関連項目:

• Cloneable