Java プラットフォーム 1.2

java.awt.image.renderable
クラス RenderableImageOp

java.lang.Object
  |
  +--java.awt.image.renderable.RenderableImageOp

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

Java プラットフォーム 1.2

バグや機能要求の報告
新しい javadoc の表示についてのコメントやご提案
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.