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

クラスRenderableImageOp

  • すべての実装されたインタフェース:
    RenderableImage

    public class RenderableImageOp
    extends Object
    implements RenderableImage
    このクラスは、関連するContextualRenderedImageFactoryのインスタンスによって、オペレーションの描画特性を処理します。
    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      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を変更し、イメージ描画チェーンの編集を可能にします。
    • コンストラクタの詳細

      • 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()
        現在のパラメータ・ブロックへの参照を返します。
        戻り値:
        このRenderableImageOpParameterBlock
        関連項目:
        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