モジュール 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()
      現在のパラメータ・ブロックへの参照を返します。
      戻り値:
      この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