JavaTM 2 Platform
Std. Ed. v1.3

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 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 getSources()
この RenderableImage のイメージデータのソースである RenderableImages のベクタを返します。このメソッドは、イメージにソースがないことを示すために空のベクタを返す場合もあります。または利用できる情報がないことを示すために null を返すこともあります。
定義:
インタフェース RenderableImage 内の getSources
戻り値:
RenderableImages の Vector (空の場合もある)、または null

getProperty

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

getPropertyNames

public String[] getPropertyNames()
getProperty によって認識される名前のリストを返します。
定義:
インタフェース RenderableImage 内の getPropertyNames

isDynamic

public boolean isDynamic()
同じ引数を使って行なった連続した描画 (つまり、createRendering() または createScaledRendering() の呼び出し) の結果が異なる場合は true を返します。このメソッドは、既存の描画がキャッシュに格納および再使用されるかどうかを判定するのに使用されます。CRIF の isDynamic メソッドが呼び出されます。
定義:
インタフェース RenderableImage 内の isDynamic

getWidth

public float getWidth()
ユーザ座標空間での幅を取得します。通常は、RenderableImage の幅はイメージの縦横比 (幅を高さで割った値) に等しくなります。
定義:
インタフェース RenderableImage 内の getWidth
戻り値:
ユーザ座標でのイメージの幅

getHeight

public float getHeight()
ユーザ座標空間での高さを取得します。通常は、RenderableImage の高さは、1.0F に等しくなります。
定義:
インタフェース RenderableImage 内の getHeight
戻り値:
ユーザ座標でのイメージの高さ

getMinX

public float getMinX()
描画に依存しないイメージデータの最小の X 座標を取得します。
定義:
インタフェース RenderableImage 内の getMinX

getMinY

public float getMinY()
描画に依存しないイメージデータの最小の Y 座標を取得します。
定義:
インタフェース RenderableImage 内の getMinY

setParameterBlock

public ParameterBlock setParameterBlock(ParameterBlock paramBlock)
オペレーションの現在の ParameterBlock を変更し、イメージ描画チェーンを編集できるようにします。そのような変更の結果は、この RenderableImageOp または依存している任意の RenderableImageOp から新しい描画が作成されたときに可視になります。
パラメータ:
paramBlock - 新しい ParameterBlock
戻り値:
以前の ParameterBlock

getParameterBlock

public ParameterBlock getParameterBlock()
現在のパラメータブロックへの参照を返します。

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() メソッドを介して取得される任意の RenderedImages は、そのようなプロパティを持つことがあります。

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

createDefaultRendering

public RenderedImage createDefaultRendering()
デフォルトの幅および高さ (ピクセル数) を使って、このイメージの RenderedImage のインスタンスを取得します。RenderContext は、適切な usr2dev 変換およびイメージ全体の中の処理対象範囲を使って自動的に作成されます。すべての描画ヒントは渡された hints からのものです。このインタフェースを実装する場合は、定義されているデフォルトの幅と高さがあることを確認する必要があります。
定義:
インタフェース RenderableImage 内の createDefaultRendering
戻り値:
描画されるデータが格納されている 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 のインスタンスである場合、元の ParameterBlock を使って CRIF.create() メソッドがただちに呼び出されます。これは再帰の基本ケースを提供します。

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

定義:
インタフェース RenderableImage 内の createRendering
パラメータ:
renderContext - 描画の実行に使用する RenderContext
戻り値:
所望の出力イメージが格納されている RenderedImage

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.