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

インタフェースRenderableImage

既知のすべての実装クラス:
RenderableImageOp
public interface RenderableImage
RenderableImageは、描画に依存しないイメージ(その結果、解像度に依存しません)のための共通インタフェースです。 つまり、特定のイメージの描画とは無関係に記述され、オペレーションが適用されるイメージです。 たとえば、RenderableImageは、解像度に依存することなく回転させたり切り取ったりしておいて、 ドラフト・プレビュー、画面での高画質表示、またはプリンタなど、さまざまなコンテキストにおいてそれぞれ最適な方法で描画できます。

RenderedImageはRenderContextを引数に取るcreateRendering()メソッドを介してRenderableImageから返されます。 RenderContextはRenderedImageを作成する方法を指定します。 RenderableImageから直接ピクセルを取り出すことはできません。

createDefaultRendering()メソッドおよびcreateScaledRendering()メソッドは、適切なRenderContextを内部に作成する簡易メソッドです。 すべての描画メソッドは、以前に作成した描画への参照を返すこともあります。

  • フィールドのサマリー

    フィールド
    修飾子と型 フィールド 説明
    static String HINTS_OBSERVED
    createRenderingメソッドまたはcreateScaledRenderingメソッドを使って取得したRenderedImageのプロパティを識別するために使用される文字列定数です。

  • メソッドのサマリー

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

  • フィールド詳細

    • HINTS_OBSERVED

      static final String HINTS_OBSERVED
      createRenderingメソッドまたはcreateScaledRenderingメソッドを使って取得したRenderedImageのプロパティを識別するために使用される文字列定数です。 そのようなプロパティが存在する場合、プロパティの値はRenderingHintsオブジェクトで、描画の作成時に認められたヒントを指定します。
      関連項目:
      定数フィールド値

  • メソッドの詳細

    • getSources

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

    • getProperty

      Object getProperty​(String name)
      このイメージのプロパティ・セットからプロパティを返します。 プロパティ名が認識されない場合、java.awt.Image.UndefinedPropertyが返されます。
      パラメータ:
      name - Stringとして取得するプロパティの名前。
      戻り値:
      プロパティObjectへの参照、または値java.awt.Image.UndefinedProperty

    • getPropertyNames

      String[] getPropertyNames()
      getPropertyによって認識される名前のリストを返します。
      戻り値:
      プロパティ名のリスト。

    • isDynamic

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

    • getWidth

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

    • getHeight

      float getHeight()
      ユーザー座標空間での高さを返します。 通常は、RenderedImageの高さは、1.0Fに等しくなります。
      戻り値:
      ユーザー座標でのイメージの高さ

    • getMinX

      float getMinX()
      描画に依存しないイメージ・データの最小のX座標を返します。
      戻り値:
      描画に依存しないイメージ・データの最小のX座標

    • getMinY

      float getMinY()
      描画に依存しないイメージ・データの最小のY座標を返します。
      戻り値:
      描画に依存しないイメージ・データの最小のY座標

    • createScaledRendering

      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は、そのようなプロパティを持つ場合があります。

      パラメータ:
      w - 描画されるイメージの幅(ピクセル数)、または0。
      h - 描画されるイメージの高さ(ピクセル数)、または0。
      hints - ヒントが格納されているRenderingHintsオブジェクト。
      戻り値:
      描画されるデータが格納されているRenderedImage

    • createDefaultRendering

      RenderedImage createDefaultRendering()
      このイメージのRenderedImageインスタンスを、デフォルトの幅と高さ(ピクセル単位)で返します。 RenderContextは、適切なusr2dev変換およびイメージ全体の中の処理対象範囲を使って自動的に作成されます。 描画ヒントは空になります。createDefaultRenderingは処理速度の向上のために格納されている描画を使用する場合もあります。
      戻り値:
      描画されるデータが格納されているRenderedImage

    • createRendering

      RenderedImage createRendering​(RenderContext renderContext)
      指定されたRenderContextを使用してこのイメージの描画を表すRenderedImageを作成します。 これは、RenderableImageの描画を取得するもっとも一般的な方法です。

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

      パラメータ:
      renderContext - 描画の生成に使用するRenderContext。
      戻り値:
      描画されるデータが格納されているRenderedImage