java.awt.image
クラス ColorConvertOp

java.lang.Object
  |
  +--java.awt.image.ColorConvertOp

public class ColorConvertOp

extends Object

implements BufferedImageOp, RasterOp

このクラスは、ソースイメージのデータの色変換をピクセル単位で実行します。結果のカラー値は、デスティネーションイメージの精度に合わせてスケーリングされます。色変換は、ColorSpace オブジェクトの配列または ICC_Profile オブジェクトの配列を介して指定できます。

あらかじめアルファが乗算されている BufferedImage がソースである場合、色成分は色変換の前にアルファ成分で除算されます。デスティネーションがあらかじめアルファが乗算された BufferedImage の場合、色成分は変換のあとにアルファ成分によって乗算されます。Raster は、アルファチャネルを持たないものとして処理されます。つまり、すべてのバンドがカラーバンドです。

RenderingHints オブジェクトがコンストラクタで指定されている場合は、カラー描画ヒントおよびディザリングヒントを使用して色変換を制御できます。

ソースとデスティネーションには、同じオブジェクトを指定できます。

関連項目:

RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

コンストラクタの概要

ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)
2 つの ColorSpace オブジェクトから新しい ColorConvertOp を構築します。

ColorConvertOp(ColorSpace cspace, RenderingHints hints)
ColorSpace オブジェクトから新しい ColorConvertOp を構築します。

ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)
ICC_Profile の配列から新しい ColorConvertOp を構築します。

ColorConvertOp(RenderingHints hints)
ソースカラースペースからデスティネーションカラースペースに変換する新しい ColorConvertOp を構築します。

メソッドの概要

BufferedImage	createCompatibleDestImage(BufferedImage src, ColorModel destCM) このソースを指定して、適切なサイズおよびバンド数で、ゼロ化されたデスティネーションイメージを作成します。
WritableRaster	createCompatibleDestRaster(Raster src) このソースを指定して、適切なサイズおよびバンド数で、ゼロ化されたデスティネーション Raster を作成します。
BufferedImage	filter(BufferedImage src, BufferedImage dest) ソース BufferedImage で ColorConvert を実行します。
WritableRaster	filter(Raster src, WritableRaster dest) ソース Raster のイメージデータで ColorConvert を実行します。
Rectangle2D	getBounds2D(BufferedImage src) このソースを指定して、デスティネーションのバウンディングボックスを返します。
Rectangle2D	getBounds2D(Raster src) このソースを指定して、デスティネーションのバウンディングボックスを返します。
ICC_Profile[]	getICC_Profiles() この ColorConvertOp を構築するために使用される ICC_Profile の配列を返します。
Point2D	getPoint2D(Point2D srcPt, Point2D dstPt) ソースのポイントを指定して、デスティネーションのポイントの位置を返します。
RenderingHints	getRenderingHints() このオペレーションで使用される描画ヒントを返します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ColorConvertOp

public ColorConvertOp(RenderingHints hints)

ソースカラースペースからデスティネーションカラースペースに変換する新しい ColorConvertOp を構築します。RenderingHints 引数には null も指定できます。このオペレーションは、BufferedImage とだけ使用することができ、ソースイメージの ColorSpace からデスティネーションの ColorSpace に直接変換します。フィルタメソッドのデスティネーション引数には null を指定できません。

ColorConvertOp

public ColorConvertOp(ColorSpace cspace,
                      RenderingHints hints)

ColorSpace オブジェクトから新しい ColorConvertOp を構築します。RenderingHints 引数には null も指定できます。このオペレーションは BufferedImage とだけ使用でき、主にデスティネーション引数が null でフィルタメソッドが呼び出されたときに有効です。その場合、ColorSpace はフィルタメソッドによって作成されるデスティネーションのデスティネーションカラースペースを定義します。そうでない場合、ColorSpace は、デスティネーション領域に変換される前にソースが変換される中間領域を定義します。

ColorConvertOp

public ColorConvertOp(ColorSpace srcCspace,
                      ColorSpace dstCspace,
                      RenderingHints hints)

2 つの ColorSpace オブジェクトから新しい ColorConvertOp を構築します。RenderingHints 引数には null も指定できます。このオペレーションは、主に Raster でフィルタメソッドを呼び出すときに有効です。その場合、2 つの ColorSpace が Raster で実行されるオペレーションを定義します。その場合、ソース Raster のバンド数は、srcCspace の成分数と一致する必要があり、デスティネーション Raster のバンド数は dstCspace の成分数と一致する必要があります。BufferedImage の場合、2 つの ColorSpace は、デスティネーション領域に変換される前にソースが変換される中間領域を定義します。

ColorConvertOp

public ColorConvertOp(ICC_Profile[] profiles,
                      RenderingHints hints)

ICC_Profile の配列から新しい ColorConvertOp を構築します。RenderingHints 引数には null も指定できます。一連のプロファイルには、カラースペースを表すプロファイル、効果を表すプロファイルなども含めることができます。この一連のプロファイル全体が色変換を適切に定義しない場合は、例外がスローされます。

BufferedImage の場合、ソース BufferedImage の ColorSpace が配列の最初のプロファイルの要件と一致しない場合には、最初の変換は適切な ColorSpace に対して行われます。配列の最後のプロファイルの要件がデスティネーション BufferedImage の ColorSpace と一致しない場合、最後の変換はデスティネーションの ColorSpace に対して行われます。

Raster の場合、ソース Raster のバンド数は配列の最初のプロファイルの要件と一致する必要があり、デスティネーション Raster のバンド数は配列の最後のプロファイルの要件と一致する必要があります。配列は、2 つ以上の要素を持つ必要があり、そうでない場合、Raster に対してフィルタメソッドを呼び出すと IllegalArgumentException がスローされます。

例外:

IllegalArgumentException - 一連のプロファイルによって明確な色変換が指定されていない場合

メソッドの詳細

getICC_Profiles

public final ICC_Profile[] getICC_Profiles()

この ColorConvertOp を構築するために使用される ICC_Profile の配列を返します。ColorConvertOp がそのような配列で構築されなかった場合は null を返します。

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dest)

ソース BufferedImage で ColorConvert を実行します。デスティネーションイメージが null の場合、BufferedImage は適切な ColorModel で作成されます。

定義:

インタフェース BufferedImageOp 内の filter

例外:

IllegalArgumentException - dest が null であり、このオペレーションが RenderingHints 引数だけをとるコンストラクタを使用して構築された場合 (オペレーションの定義が不適切であるため)

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dest)

ソース Raster のイメージデータで ColorConvert を実行します。デスティネーション Raster が null の場合は、新しい Raster が作成されます。ソースとデスティネーションの Raster のバンド数は、上述のように要件と一致する必要があります。この ColorConvertOp を作成するために使用されるコンストラクタは、ソースとデスティネーションのカラースペースを定義するのに十分な情報を提供する必要があります。上述を参照してください。そうでない場合は例外がスローされます。

定義:

インタフェース RasterOp 内の filter

例外:

IllegalArgumentException - ソースの数またはデスティネーションのバンド数が正しくない場合、ソースまたはデスティネーションのカラースペースが未定義の場合、またはこのオペレーションが BufferedImage でのオペレーションにだけ適用されるコンストラクタのどれかで構築された場合

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

このソースを指定して、デスティネーションのバウンディングボックスを返します。これは、ソースのバウンディングボックスと同じになります。

定義:

インタフェース BufferedImageOp 内の getBounds2D

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

このソースを指定して、デスティネーションのバウンディングボックスを返します。これは、ソースのバウンディングボックスと同じになります。

定義:

インタフェース RasterOp 内の getBounds2D

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

このソースを指定して、適切なサイズおよびバンド数で、ゼロ化されたデスティネーションイメージを作成します。

定義:

インタフェース BufferedImageOp 内の createCompatibleDestImage

パラメータ:

src - フィルタオペレーションのソースイメージ

destCM - デスティネーションの ColorModel。null の場合、適切な ColorModel が使用される

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

このソースを指定して、適切なサイズおよびバンド数で、ゼロ化されたデスティネーション Raster を作成します。

定義:

インタフェース RasterOp 内の createCompatibleDestRaster

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

ソースのポイントを指定して、デスティネーションのポイントの位置を返します。dstPt は null ではない場合、戻り値を格納するために使用されます。このクラスでは、デスティネーションのポイントはソースのポイントと同じになります。

定義:

インタフェース BufferedImageOp 内の getPoint2D

getRenderingHints

public final RenderingHints getRenderingHints()

このオペレーションで使用される描画ヒントを返します。

定義:

インタフェース BufferedImageOp 内の getRenderingHints