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

インタフェースContextualRenderedImageFactory

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

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

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

    • メソッドの詳細

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