モジュール java.desktop

パッケージ java.awt.image.renderable

クラスRenderableImageOp

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(ContextualRenderedImageFactory CRIF, ParameterBlock paramBlock)	ContextualRenderedImageFactoryオブジェクト、およびRenderableImageソースとその他のパラメータを格納するParameterBlockが指定されたRenderedImageOpを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
RenderedImage	createDefaultRendering()	このイメージのRenderedImageのインスタンスを、デフォルトの幅と高さ(ピクセル単位)で作成します。
RenderedImage	createRendering(RenderContext renderContext)	指定されたRenderContextによって描画された、このRenderableImageOp (Renderableソースを含む)を表すRenderedImageを作成します。
RenderedImage	createScaledRendering(int w, int h, RenderingHints hints)	このイメージのRenderedImageのインスタンスを、幅wピクセル、高さhピクセルで作成します。
float	getHeight()	ユーザー座標空間での高さを返します。
float	getMinX()	描画に依存しないイメージ・データの最小のX座標を返します。
float	getMinY()	描画に依存しないイメージ・データの最小のY座標を返します。
ParameterBlock	getParameterBlock()	現在のパラメータ・ブロックへの参照を返します。
Object	getProperty(String name)	このイメージのプロパティ・セットからプロパティを返します。
String[]	getPropertyNames()	getPropertyによって認識される名前のリストを返します。
Vector<RenderableImage>	getSources()	このRenderableImageのイメージ・データのソースであるRenderableImagesのベクターを返します。
float	getWidth()	ユーザー座標空間での幅を返します。
boolean	isDynamic()	同じ引数を使って行った連続した描画(つまり、createRendering()またはcreateScaledRendering()の呼び出し)が異なる結果になる場合はtrueを返します。
ParameterBlock	setParameterBlock(ParameterBlock paramBlock)	現在のオペレーションのParameterBlockを変更し、イメージ描画チェーンの編集を可能にします。

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

RenderableImageOp

public RenderableImageOp(ContextualRenderedImageFactory CRIF, ParameterBlock paramBlock)

ContextualRenderedImageFactoryオブジェクト、およびRenderableImageソースとその他のパラメータを格納するParameterBlockが指定されたRenderedImageOpを構築します。 ParameterBlockによって参照される任意のRenderedImageソースは無視されます。

パラメータ:

CRIF - ContextualRenderedImageFactoryオブジェクト

paramBlock - このオペレーションのソース・イメージとオペレーションの実行に必要なその他のパラメータを格納するParameterBlock。

メソッドの詳細

getSources

public Vector<RenderableImage> getSources()

このRenderableImageのイメージ・データのソースであるRenderableImagesのベクターを返します。 このメソッドは、イメージにソースがないことを示すために空のベクトルを返す場合もあります。または利用できる情報がないことを示すためにnullを返すこともあります。

定義:

getSources、インタフェースRenderableImage

戻り値:

RenderableImagesのVector (空の場合もある)、またはnull

getProperty

public Object getProperty(String name)

このイメージのプロパティ・セットからプロパティを返します。 プロパティ名が認識されない場合、java.awt.Image.UndefinedPropertyが返されます。

定義:

getProperty、インタフェースRenderableImage

パラメータ:

name - Stringとして取得するプロパティの名前。

戻り値:

プロパティObjectへの参照、または値java.awt.Image.UndefinedProperty

getPropertyNames

public String[] getPropertyNames()

getPropertyによって認識される名前のリストを返します。

定義:

getPropertyNames、インタフェースRenderableImage

戻り値:

プロパティ名のリスト。

isDynamic

public boolean isDynamic()

同じ引数を使って行った連続した描画(つまり、createRendering()またはcreateScaledRendering()の呼び出し)が異なる結果になる場合はtrueを返します。 このメソッドは、既存の描画がキャッシュに格納および再使用されるかどうかを判定するために使用されます。 CRIFのisDynamicメソッドが呼び出されます。

定義:

isDynamic、インタフェースRenderableImage

戻り値:

同じ引数を使って行った連続した描画の結果が異なる場合はtrue、そうでない場合はfalse。

getWidth

public float getWidth()

ユーザー座標空間での幅を返します。 通常は、RenderableImageの幅はイメージの縦横比(幅を高さで割った値)に等しくなります。

定義:

getWidth、インタフェースRenderableImage

戻り値:

ユーザー座標でのイメージの幅

getHeight

public float getHeight()

ユーザー座標空間での高さを返します。 通常は、RenderedImageの高さは、1.0Fに等しくなります。

定義:

getHeight、インタフェースRenderableImage

戻り値:

ユーザー座標でのイメージの高さ

getMinX

public float getMinX()

描画に依存しないイメージ・データの最小のX座標を返します。

定義:

getMinX、インタフェースRenderableImage

戻り値:

描画に依存しないイメージ・データの最小のX座標

getMinY

public float getMinY()

描画に依存しないイメージ・データの最小のY座標を返します。

定義:

getMinY、インタフェースRenderableImage

戻り値:

描画に依存しないイメージ・データの最小のY座標

setParameterBlock

public ParameterBlock setParameterBlock(ParameterBlock paramBlock)

現在のオペレーションのParameterBlockを変更し、イメージ描画チェーンの編集を可能にします。 このような変更の効果は、このRenderableImageOpまたは依存する任意のRenderableImageOpから新規の描画が作成されると可視になります。

パラメータ:

paramBlock - 新規のParameterBlock。

戻り値:

以前のParameterBlock。

関連項目:

• getParameterBlock()

getParameterBlock

public ParameterBlock getParameterBlock()

現在のパラメータ・ブロックへの参照を返します。

戻り値:

このRenderableImageOpのParameterBlock。

関連項目:

• setParameterBlock(ParameterBlock)

createScaledRendering

public RenderedImage createScaledRendering(int w, int h, RenderingHints hints)

このイメージのRenderedImageのインスタンスを、幅wピクセル、高さhピクセルで作成します。 RenderContextは、適切なusr2dev変換およびイメージ全体の中の処理対象範囲を使って自動的に作成されます。 すべての描画ヒントは渡されたhintsからのものです。

w == 0の場合は、Math.round(h*(getWidth()/getHeight()))と同じになります。 同様にh == 0の場合は、Math.round(w*(getHeight()/getWidth()))と同じになります。 wまたはhのどちらかがゼロ以外である必要があり、両方がゼロの場合はIllegalArgumentExceptionがスローされます。

作成されたRenderedImageは、イメージを作成するのにどのRenderingHintsが使用されたかを示すString HINTS_OBSERVEDによって識別されるプロパティを持つ場合があります。 また、作成されたRenderedImageでのgetSources()メソッドを介して取得された任意のRenderedImageは、そのようなプロパティを持つ場合があります。

定義:

createScaledRendering、インタフェースRenderableImage

パラメータ:

w - 描画されるイメージの幅(ピクセル数)、または0。

h - 描画されるイメージの高さ(ピクセル数)、または0。

hints - ヒントが格納されているRenderingHintsオブジェクト。

戻り値:

描画されるデータが格納されているRenderedImage

createDefaultRendering

public RenderedImage createDefaultRendering()

このイメージのRenderedImageのインスタンスを、デフォルトの幅と高さ(ピクセル単位)で作成します。 RenderContextは、適切なusr2dev変換およびイメージ全体の中の処理対象範囲を使って自動的に作成されます。 すべての描画ヒントは渡されたhintsからのものです。 このインタフェースを実装する場合は、デフォルトの幅と高さが定義されている必要があります。

定義:

createDefaultRendering、インタフェースRenderableImage

戻り値:

描画されるデータが格納されているRenderedImage

createRendering

public RenderedImage createRendering(RenderContext renderContext)

指定されたRenderContextによって描画された、このRenderableImageOp (Renderableソースを含む)を表すRenderedImageを作成します。

このメソッドは、RenderableオペレーションまたはRenderedImageオペレーションのどちらかのチェーンをサポートします。 RenderableImageOpの構築のために使用されたParameterBlockのソースがRenderableImagesの場合、次の3つのステップのプロセスが続いて行われます。

1. 各RenderableImageソースに関連するCRIFにmapRenderContext()が呼び出される
2. ステップ1で取得されたRenderContextsの元に戻るマッピングを使って、各RenderableImageにcreateRendering()を呼び出して、各ソースを描画する
3. createRendering()呼出しによって作成されたRenderableImageOpおよびRenderedImagesのパラメータを格納する新規ParameterBlockで、ContextualRenderedImageFactory.create()が呼び出される

RenderableImageOpを作成するために使用されたParameterBlockのソースVectorの要素がRenderedImageのインスタンスの場合は、CRIF.create()メソッドが元のParameterBlockを使ってすぐに呼び出されます。 これは再帰の基礎的なケースを提供します。

作成されたRenderedImageは、イメージを作成するためにどのRenderingHints (RenderContextからの)を使用したかを示すString HINTS_OBSERVEDによって識別されるプロパティを持つ場合があります。 また、作成されたRenderedImageでのgetSources()メソッドを介して取得された任意のRenderedImageは、そのようなプロパティを持つ場合があります。

定義:

createRendering、インタフェースRenderableImage

パラメータ:

renderContext - 描画作成に使用するRenderContext。

戻り値:

目的の出力イメージが格納されているRenderedImage