モジュール java.desktop

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

インタフェースContextualRenderedImageFactory

すべてのスーパー・インタフェース:

RenderedImageFactory

public interface ContextualRenderedImageFactory extends RenderedImageFactory

ContextualRenderedImageFactoryは、RenderableImageOpのインスタンス間で異なる機能のためのインタフェースを提供します。 これにより、RenderableImageに対するさまざまな操作は、複数のContextualRenderedImageFactoryのインスタンスを使用してRenderedImageOpなどの単一のクラスによって実行できるようになります。 ContextualRenderedImageFactoryは「CRIF」と略されます。

描画に依存しないチェーンで使用されるすべての操作は、ContextualRenderedImageFactoryを実装する必要があります。

このインタフェースを実装するクラスは、引数なしのコンストラクタを提供する必要があります。

メソッドのサマリー

修飾子と型	メソッド	説明
RenderedImage	create(RenderContext renderContext, ParameterBlock paramBlock)	RenderContextと、操作のソースとパラメータが格納されているParameterBlockを指定して、描画を作成します。
Rectangle2D	getBounds2D(ParameterBlock paramBlock)	レンダリングに依存しないスペースでの、指定されたソースのセットに対して実行される操作の出力のためのバウンディング・ボックスを返します。
Object	getProperty(ParameterBlock paramBlock, String name)	名前パラメータで指定されたプロパティの対応するインスタンスを返します。
String[]	getPropertyNames()	getPropertyによって認識される名前のリストを返します。
boolean	isDynamic()	同じ引数を使って行った連続した描画(つまり、create(RenderContext, ParameterBlock)の呼び出し)の結果が異なる場合にtrueを返します。
RenderContext	mapRenderContext(int i, RenderContext renderContext, ParameterBlock paramBlock, RenderableImage image)	操作の出力RenderContextを、各操作のソースのRenderContextにマッピングします。

インタフェースjava.awt.image.renderable.RenderedImageFactoryで宣言されたメソッド

create

メソッドの詳細

mapRenderContext

RenderContext mapRenderContext(int i, RenderContext renderContext, ParameterBlock paramBlock, RenderableImage image)

操作の出力RenderContextを、各操作のソースのRenderContextにマッピングします。 これは、処理作業や伝送帯域幅を節約するために、RenderContextでの変更(アフィン・マッピングなど)として全体または一部で表すことができる操作や、ソースのより低品質のレンダリングを取得する操作に役立ちます。 たとえば、ぼかしなどの操作では、このメカニズムを使って、必要以上に高画質のソースを取得しないようにします。

パラメータ:

i - ソース・イメージのインデックス。

renderContext - 操作に適用されるRenderContext。

paramBlock - 操作のソースおよびパラメータが格納されているParameterBlock。

image - 描画されるRenderableImage。

戻り値:

指定されたParameterBlockに格納されているパラメータVectorの指定されたインデックスにあるソースのRenderContext。

create

RenderedImage create(RenderContext renderContext, ParameterBlock paramBlock)

RenderContextと、操作のソースとパラメータが格納されているParameterBlockを指定して、描画を作成します。 出力はRenderedImageで、RenderContextを基にしてイメージ・プレーンでの寸法と配置を判定します。 このメソッドは、描画に依存しない操作が特定のRenderContextに適合できるようにする「能力」を与えます。

パラメータ:

renderContext - 描画を指定するRenderContext

paramBlock - 操作のソースおよびパラメータが格納されているParameterBlock

戻り値:

指定されたRenderContextのソースおよびパラメータと、指定されたRenderContextの描画命令によるRenderedImage。

getBounds2D

Rectangle2D getBounds2D(ParameterBlock paramBlock)

レンダリングに依存しないスペースでの、指定されたソースのセットに対して実行される操作の出力のためのバウンディング・ボックスを返します。 境界はRectangle2D、つまり両軸に沿った2辺を持ち、コーナーを浮動小数点座標で持つ矩形として返されます。

パラメータ:

paramBlock - 操作のソースおよびパラメータが格納されているParameterBlock。

戻り値:

出力の描画に依存しないバウンディング・ボックスを指定するRectangle2D

getProperty

Object getProperty(ParameterBlock paramBlock, String name)

名前パラメータで指定されたプロパティの対応するインスタンスを返します。 このメソッドは、そのプロパティを指定するソースが複数あるときには、プロパティのどのインスタンスを返すかを指定する必要があります。

パラメータ:

paramBlock - 操作のソースおよびパラメータが格納されているParameterBlock。

name - 目的のプロパティを指定するString。

戻り値:

要求されたプロパティの値へのオブジェクト参照

getPropertyNames

String[] getPropertyNames()

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

戻り値:

プロパティ名のリスト。

isDynamic

boolean isDynamic()

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

戻り値:

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