モジュール java.desktop
パッケージ 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

      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オブジェクト。