JavaTM Platform
Standard Ed. 6

java.awt.image
クラス LookupOp

java.lang.Object
  上位を拡張 java.awt.image.LookupOp
すべての実装されたインタフェース:
BufferedImageOp, RasterOp

public class LookupOp
extends Object
implements BufferedImageOp, RasterOp

このクラスは転送元から転送先へのルックアップ操作を実装します。LookupTable オブジェクトは 1 つの配列、または複数の配列を格納することができます。 どちらが格納されるかは以下のように決定されます。  

Raster の場合、ルックアップはバンドを操作します。ルックアップ配列数が 1 つの場合は同じ配列がすべてのバンドに適用されます。 ルックアップ配列が複数の場合、その数は転送元 Raster のバンド数と一致しなければなりません。  

BufferedImage の場合、ルックアップは色とアルファ成分を操作します。ルックアップ配列数が 1 つの場合は同じ配列がすべての色成分に適用されますが、アルファ成分には適用されません。ルックアップ配列が複数あり、その数が転送元の色成分数と一致する場合、アルファ成分が存在してもルックアップは実行されません。ルックアップ配列が複数あり、その数が転送元の色成分数とアルファ成分数の合計と一致する場合、ルックアップはすべての色成分およびアルファ成分に対して実行されます。複数バンドの BufferedImage に対して、画一的でない再スケーリングが可能になります。  

ルックアップでは、あらかじめ乗算されたアルファデータを持つ BufferedImage ソースは、あらかじめ乗算されていないイメージと同様に扱われます。つまり、データがあらかじめ乗算されていることを考慮せずに、BufferedImage ソースの raw データについて、バンドごとにルックアップが実行されます。転送先の ColorModel で色の変換が必要な場合、このステップでは、あらかじめ乗算されていることが転送元と転送先の両方で考慮されます。  

IndexColorModel を持つイメージは使用できません。  

コンストラクタで RenderingHints オブジェクトが指定された場合、色変換が必要なときに、カラー描画ヒントおよびディザリングヒントを使用できます。  

このクラスでは転送元と転送先に同じオブジェクトを指定できます。

関連項目:
LookupTable, RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

コンストラクタの概要
LookupOp(LookupTable lookup, RenderingHints hints)
          指定されたルックアップテーブルと RenderingHints オブジェクトで LookupOp オブジェクトを構築します。
 
メソッドの概要
 BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)
          適切なサイズおよびバンド数で、ゼロ化された転送先イメージを生成します。
 WritableRaster createCompatibleDestRaster(Raster src)
          指定されたソースで、適切なサイズ、適切な数のバンドを持つゼロ化された転送先 Raster を生成します。
 BufferedImage filter(BufferedImage src, BufferedImage dst)
          BufferedImage に対するルックアップ操作を行います。
 WritableRaster filter(Raster src, WritableRaster dst)
          Raster に対するルックアップ操作を行います。
 Rectangle2D getBounds2D(BufferedImage src)
          フィルタ処理された転送先イメージのバウンディングボックスを返します。
 Rectangle2D getBounds2D(Raster src)
          フィルタ処理された転送先 Raster のバウンディングボックスを返します。
 Point2D getPoint2D(Point2D srcPt, Point2D dstPt)
          指定された転送元のポイントに対応する、転送先のポイントの位置を返します。
 RenderingHints getRenderingHints()
          この操作の描画ヒントを返します。
 LookupTable getTable()
          LookupTable を返します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

LookupOp

public LookupOp(LookupTable lookup,
                RenderingHints hints)
指定されたルックアップテーブルと RenderingHints オブジェクトで LookupOp オブジェクトを構築します。RenderingHints オブジェクトは null の場合もあります。

パラメータ:
lookup - 指定された LookupTable
hints - 指定された RenderingHints、 または null
メソッドの詳細

getTable

public final LookupTable getTable()
LookupTable を返します。

戻り値:
この LookupOpLookupTable

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)
BufferedImage に対するルックアップ操作を行います。転送元イメージのカラーモデルが転送先イメージのカラーモデルと異なる場合、転送先でピクセルが変換されます。転送先のイメージが null の場合、適切な ColorModel を使用して BufferedImage が生成されます。LookupTable の配列数が、上記のクラス説明の要件を満たさない場合、または転送元イメージがIndexColorModel を持つ場合、IllegalArgumentException がスローされます。

定義:
インタフェース BufferedImageOp 内の filter
パラメータ:
src - フィルタ処理される BufferedImage
dst - フィルタ処理の結果を格納する BufferedImage
戻り値:
フィルタ処理された BufferedImage
例外:
IllegalArgumentException - LookupTable の配列数が クラスの説明の要件を満たさない場合、 または転送元のイメージが IndexColorModel を持つ場合

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)
Raster に対するルックアップ操作を行います。転送先の Rasternull の場合、新しい Raster が登録されます。転送元の Raster と転送先の Raster バンド数が一致しない場合、あるいは LookupTable の配列数が上記のクラス説明の要件を満たさない場合、IllegalArgumentException がスローされます。

定義:
インタフェース RasterOp 内の filter
パラメータ:
src - フィルタ処理対象の、転送元の Raster
dst - フィルタをかけられた src の 転送先 WritableRaster
戻り値:
フィルタ処理された WritableRaster
例外:
IllegalArgumentException - 転送元と転送先の Raster の バンド数が異なる場合、 あるいは LookupTable の配列数が クラス説明の要件を満たさない場合

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)
フィルタ処理された転送先イメージのバウンディングボックスを返します。これは幾何学的な操作ではないので、バウンディングボックスは変化しません。

定義:
インタフェース BufferedImageOp 内の getBounds2D
パラメータ:
src - フィルタ処理される BufferedImage
戻り値:
フィルタ処理された定義イメージの境界

getBounds2D

public final Rectangle2D getBounds2D(Raster src)
フィルタ処理された転送先 Raster のバウンディングボックスを返します。これは幾何学的な操作ではないので、バウンディングボックスは変化しません。

定義:
インタフェース RasterOp 内の getBounds2D
パラメータ:
src - フィルタ処理される Raster
戻り値:
フィルタ処理された定義 Raster の境界

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)
適切なサイズおよびバンド数で、ゼロ化された転送先イメージを生成します。destCM が null の場合は、適切な ColorModel が使用されます。

定義:
インタフェース BufferedImageOp 内の createCompatibleDestImage
パラメータ:
src - フィルタオペレーションのソースイメージ
destCM - 転送先の ColorModelnull も可
戻り値:
フィルタ処理された転送先 BufferedImage

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)
指定されたソースで、適切なサイズ、適切な数のバンドを持つゼロ化された転送先 Raster を生成します。

定義:
インタフェース RasterOp 内の createCompatibleDestRaster
パラメータ:
src - 変換対象の Raster
戻り値:
ゼロ化された転送先の Raster

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)
指定された転送元のポイントに対応する、転送先のポイントの位置を返します。dstPtnull でない場合、戻り値の格納先として使用されます。これは幾何学的な操作ではないため、srcPtdstPt と等しくなります。

定義:
インタフェース BufferedImageOp 内の getPoint2D
定義:
インタフェース RasterOp 内の getPoint2D
パラメータ:
srcPt - 転送元イメージのポイントを表す Point2D
dstPt - 転送先の位置を表す Point2D
戻り値:
指定された転送元のポイントに対応する 転送先の Point2D

getRenderingHints

public final RenderingHints getRenderingHints()
この操作の描画ヒントを返します。

定義:
インタフェース BufferedImageOp 内の getRenderingHints
定義:
インタフェース RasterOp 内の getRenderingHints
戻り値:
この操作に関連付けられた RenderingHints

JavaTM Platform
Standard Ed. 6

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

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