JavaTM 2 Platform
Standard Ed. 5.0

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 を返すこともあります。

定義:
インタフェース 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
戻り値:
同じ引数を使って行なった連続した描画の結果が異なる場合は true、そうでない場合は false

getWidth

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

定義:
インタフェース RenderableImage 内の getWidth
戻り値:
ユーザ座標でのイメージの幅

getHeight

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

定義:
インタフェース RenderableImage 内の getHeight
戻り値:
ユーザ座標でのイメージの高さ

getMinX

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

定義:
インタフェース RenderableImage 内の getMinX
戻り値:
描画に依存しないイメージデータの最小の X 座標

getMinY

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

定義:
インタフェース RenderableImage 内の getMinY
戻り値:
描画に依存しないイメージデータの最小の 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() メソッドを介して取得される任意の 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 のインスタンスの場合は、CRIF.create() メソッドが元の ParameterBlock を使ってすぐに呼び出されます。これは再帰の基礎的なケースを提供します。

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

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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。