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 バンド数と同じである必要があります。

BufferedImages では、ルックアップは色成分とアルファ成分に作用します。ルックアップ配列の数が 1 つの場合は、同じ配列がアルファ以外のすべての色成分に適用されます。そうでない場合、ルックアップ配列の数はソースの色成分の数と同じになり、アルファ成分のルックアップは実行されません。どちらにも該当しない場合、ルックアップ配列の数はソースの色成分にアルファ成分を加えた数になり、ルックアップは色成分とアルファ成分のすべてに対して実行されます。これにより、マルチバンドの BufferedImages に対して画一的でない再スケーリングを行うことができます。

ルックアップオペレーションでは、あらかじめ乗算されたアルファデータを持つソースの BufferedImage は、あらかじめ乗算されていないイメージと同じ方式で取り扱われます。つまり、ルックアップは、データがあらかじめ乗算済みであるかどうかにかかわりなく、ソースの BufferedImage の raw データに対してバンドごとに処理されます。デスティネーションの ColorModel に色変換が必要な場合、このステップでは、ソースとデスティネーションの両方であらかじめ乗算された状態が考慮されます。

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

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

このクラスでは、ソートとデスティネーションは同じでもかまいません。

関連項目:

LookupTable, RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

コンストラクタの概要

LookupOp(LookupTable lookup, RenderingHints hints)
ルックアップテーブルと RenderingHints オブジェクト (null も可) が指定された 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 オブジェクト (null も可) が指定された LookupOp オブジェクトを構築します。

メソッドの詳細

getTable

public final LookupTable getTable()

LookupTable を返します。

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)

BufferedImage に対してルックアップオペレーションを実行します。ソースイメージのカラーモデルがデスティネーションのカラーモデルと同じでない場合、ピクセルはデスティネーションで変換されます。デスティネーションイメージが null の場合、適切な ColorModel を持つ BufferedImage が作成されます。LookupTable の配列の数が上記のクラス説明に記載されている制限を満たさない場合や、ソースイメージが IndexColorModel を持つ場合は、IllegalArgumentException がスローされます。

定義:

インタフェース BufferedImageOp 内の filter

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)

Raster に対してルックアップオペレーションを実行します。デスティネーションの Raster が null の場合は、新しい Raster が作成されます。ソースとデスティネーションの Raster のバンド数が異なる場合や、LookupTable 内の配列数が上記のクラス説明に記載されている制限を満たさない場合は、IllegalArgumentException がスローされます。

定義:

インタフェース RasterOp 内の filter

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

フィルタ処理されたデスティネーションイメージのバウンディングボックスを返します。これは幾何学的な操作ではないので、バウンディングボックスは変化しません。

定義:

インタフェース BufferedImageOp 内の getBounds2D

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

フィルタ処理されたデスティネーションの Raster のバウンディングボックスを返します。これは幾何学的な操作ではないので、バウンディングボックスは変化しません。

定義:

インタフェース RasterOp 内の getBounds2D

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

適切なサイズと数のバンドを持つゼロ化されたデスティネーションイメージを作成します。destCM が null の場合は、適切な ColorModel が使用されます。

定義:

インタフェース BufferedImageOp 内の createCompatibleDestImage

パラメータ:

src - フィルタ処理の対象となるソースイメージ

destCM - デスティネーションの ColorModel。null も可

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

指定されたソースについて、適切なサイズと数のバンドを持つゼロ化されたデスティネーション Raster を作成します。

定義:

インタフェース RasterOp 内の createCompatibleDestRaster

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

指定されたソースのポイントについて、デスティネーションのポイントの位置を返します。dstPt が null でない場合、戻り値の格納先として dstPt が使用されます。これは幾何学的な操作ではないので、srcPt は dstPt と同じになります。

定義:

インタフェース BufferedImageOp 内の getPoint2D

getRenderingHints

public final RenderingHints getRenderingHints()

このオペレーションの描画ヒントを返します。

定義:

インタフェース BufferedImageOp 内の getRenderingHints