- 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オブジェクトが指定された場合、色変換が必要なときに、カラー描画ヒントおよびディザリング・ヒントを使用できます。
このクラスでは転送元と転送先に同じオブジェクトを指定できます。
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 LookupOp(LookupTable lookup, RenderingHints hints)
指定されたルックアップ表とRenderingHints
オブジェクトでLookupOp
オブジェクトを構築します。RenderingHintsオブジェクトはnull
の場合もあります。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 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
を返します。
-
-
-
コンストラクタの詳細
-
LookupOp
public LookupOp(LookupTable lookup, RenderingHints hints)
指定されたルックアップ表とRenderingHints
オブジェクトでLookupOp
オブジェクトを構築します。RenderingHintsオブジェクトはnull
の場合もあります。- パラメータ:
lookup
- 指定されたLookupTable
hints
- 指定されたRenderingHints
、またはnull
-
-
メソッドの詳細
-
getTable
public final LookupTable getTable()
LookupTable
を返します。- 戻り値:
- この
LookupOp
のLookupTable
。
-
filter
public final BufferedImage filter(BufferedImage src, BufferedImage dst)
BufferedImage
に対するルックアップ操作を行います。 転送元イメージのカラー・モデルが転送先イメージのカラー・モデルと異なる場合、転送先でピクセルが変換されます。 転送先イメージがnull
の場合、BufferedImage
は適切なColorModel
で作成されます。LookupTable
の配列数が、上記のクラス・コメントの要件を満たさない場合、または転送元イメージがIndexColorModel
を持つ場合、IllegalArgumentException
がスローされます。- 定義:
filter
、インタフェースBufferedImageOp
- パラメータ:
src
- フィルタ処理されるBufferedImage
。dst
- フィルタ処理の結果を格納するBufferedImage
- 戻り値:
- フィルタ処理された
BufferedImage
。 - 例外:
IllegalArgumentException
-LookupTable
の配列数がクラスのクラス・コメントの要件を満たさない場合、または転送元のイメージがIndexColorModel
を持つ場合。
-
filter
public final WritableRaster filter(Raster src, WritableRaster dst)
Raster
に対するルックアップ操作を行います。 転送先Raster
がnull
の場合、新しいRaster
が生成されます。 転送元のRaster
と転送先のRaster
バンド数が一致しない場合、あるいはLookupTable
の配列数が上記のクラス・コメントの要件を満たさない場合、IllegalArgumentException
がスローされます。- 定義:
filter
、インタフェースRasterOp
- パラメータ:
src
- フィルタ処理対象の転送元のRaster
dst
- フィルタ処理対象のsrc
の転送先のWritableRaster
- 戻り値:
- フィルタ処理された
WritableRaster
。 - 例外:
IllegalArgumentException
- 転送元と転送先のRasterのバンド数が異なる場合、あるいはLookupTable
の配列数がクラス・コメントの要件を満たさない場合。
-
getBounds2D
public final Rectangle2D getBounds2D(BufferedImage src)
フィルタ処理された転送先イメージのバウンディング・ボックスを返します。 これは幾何学的な操作ではないので、バウンディング・ボックスは変化しません。- 定義:
getBounds2D
、インタフェースBufferedImageOp
- パラメータ:
src
- フィルタ処理されるBufferedImage
。- 戻り値:
- フィルタ処理された定義イメージの境界
-
getBounds2D
public final Rectangle2D getBounds2D(Raster src)
フィルタ処理された転送先Rasterのバウンディング・ボックスを返します。 これは幾何学的な操作ではないので、バウンディング・ボックスは変化しません。- 定義:
getBounds2D
、インタフェースRasterOp
- パラメータ:
src
- フィルタ処理されるRaster
。- 戻り値:
- フィルタ処理された定義
Raster
の境界。
-
createCompatibleDestImage
public BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)
適切なサイズおよびバンド数で、ゼロ化された転送先イメージを生成します。 destCMがnull
の場合は、適切なColorModel
が使用されます。- 定義:
createCompatibleDestImage
、インタフェースBufferedImageOp
- パラメータ:
src
- フィルタ・オペレーションのソース・イメージ。destCM
- 転送先のColorModel
。null
も可。- 戻り値:
- フィルタ処理された転送先
BufferedImage
。
-
createCompatibleDestRaster
public WritableRaster createCompatibleDestRaster(Raster src)
指定されたソースで、適切なサイズ、適切な数のバンドを持つゼロ化された転送先Raster
を生成します。- 定義:
createCompatibleDestRaster
、インタフェースRasterOp
- パラメータ:
src
- 変換対象のRaster
- 戻り値:
- ゼロ化された転送先
Raster
。
-
getPoint2D
public final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)
指定された転送元のポイントに対応する、転送先のポイントの位置を返します。dstPt
がnull
でない場合、戻り値の格納先として使用されます。 幾何学的な操作ではないため、srcPt
はdstPt
と等しくなります。- 定義:
getPoint2D
、インタフェースBufferedImageOp
- 定義:
getPoint2D
、インタフェースRasterOp
- パラメータ:
srcPt
- 転送元イメージのポイントを表すPoint2D
dstPt
- 転送先の位置を表すPoint2D
- 戻り値:
- 指定された転送元のポイントに対応する転送先の
Point2D
。
-
getRenderingHints
public final RenderingHints getRenderingHints()
この操作の描画ヒントを返します。- 定義:
getRenderingHints
、インタフェースBufferedImageOp
- 定義:
getRenderingHints
、インタフェースRasterOp
- 戻り値:
- この操作に関連付けられた
RenderingHints
オブジェクト。
-
-