public class ColorConvertOp extends Object implements BufferedImageOp, RasterOp
あらかじめアルファが乗算されているBufferedImageが転送元である場合、色成分は色変換の前にアルファ成分で除算されます。 転送先があらかじめアルファが乗算されたBufferedImageの場合、色成分は変換のあとにアルファ成分によって乗算されます。 Rasterは、アルファ・チャネルを持たないものとして処理されます。つまり、すべてのバンドがカラー・バンドです。
RenderingHintsオブジェクトがコンストラクタで指定されている場合は、カラー描画ヒントおよびディザリング・ヒントを使用して色変換を制御できます。
転送元と転送先には、同じオブジェクトを指定できます。
コンストラクタ | 説明 |
---|---|
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() |
この操作で使用される描画ヒントを返します。
|
public ColorConvertOp(RenderingHints hints)
hints
- 色変換の制御に使用するRenderingHints
オブジェクト、またはnull
public ColorConvertOp(ColorSpace cspace, RenderingHints hints)
filter
メソッドが呼び出されたときに有効です。 その場合、ColorSpaceはフィルタ・メソッドによって作成される転送先の転送先カラー・スペースを定義します。 そうでない場合、ColorSpaceは、転送先領域に変換される前に転送元が変換される中間領域を定義します。 cspace
- 転送先のColorSpace
、または中間ColorSpace
を定義するhints
- 色変換の制御に使用するRenderingHints
オブジェクト、またはnull
NullPointerException
- cspaceがnullの場合public ColorConvertOp(ColorSpace srcCspace, ColorSpace dstCspace, RenderingHints hints)
srcCspace
- 転送元ColorSpace
dstCspace
- 転送先ColorSpace
hints
- 色変換の制御に使用するRenderingHints
オブジェクト、またはnull
NullPointerException
- srcCspaceまたはdstCspaceがnullの場合public ColorConvertOp(ICC_Profile[] profiles, RenderingHints hints)
BufferedImageの場合、転送元BufferedImageのColorSpaceが配列の最初のプロファイルの要件と一致しない場合には、最初の変換は適切なColorSpaceに対して行われます。 配列の最後のプロファイルの要件が転送先BufferedImageのColorSpaceと一致しない場合、最後の変換は転送先のColorSpaceに対して行われます。
Rasterの場合、転送元Rasterのバンド数は配列の最初のプロファイルの要件と一致する必要があり、転送先Rasterのバンド数は配列の最後のプロファイルの要件と一致する必要があります。 配列は、2つ以上の要素を持つ必要があり、そうでない場合、Rasterに対してフィルタ・メソッドを呼び出すとIllegalArgumentExceptionがスローされます。
profiles
- ICC_Profile
オブジェクトの配列hints
- 色変換の制御に使用するRenderingHints
オブジェクト、またはnull
IllegalArgumentException
- 一連のプロファイルによって明確な色変換が指定されていない場合NullPointerException
- プロファイルがnullの場合public final ICC_Profile[] getICC_Profiles()
ColorConvertOp
のICC_Profile
オブジェクトの配列、またはこのColorConvertOp
がICC_Profile
オブジェクトの配列で構築されなかった場合はnull
。public final BufferedImage filter(BufferedImage src, BufferedImage dest)
filter
、インタフェースBufferedImageOp
src
- 変換される転送元BufferedImage
dest
- 転送先のBufferedImage
、またはnull
src
から変換されたdest
の色、またはdest
がnull
の場合は変換された、新しいBufferedImage
IllegalArgumentException
- destがnullであり、この操作がRenderingHints引数だけをとるコンストラクタを使用して構築された場合(操作の定義が不適切であるため)。public final WritableRaster filter(Raster src, WritableRaster dest)
filter
、インタフェースRasterOp
src
- 変換される転送元Raster
dest
- 転送先のWritableRaster
、またはnull
src
から変換されたdest
の色、またはdest
がnull
の場合は変換された、新しいWritableRaster
IllegalArgumentException
- 転送元または転送先のバンド数が正しくない場合、転送元または転送先のカラー・スペースが未定義の場合、またはこの操作がBufferedImageでの操作にだけ適用されるコンストラクタのいずれかで構築された場合。public final Rectangle2D getBounds2D(BufferedImage src)
getBounds2D
、インタフェースBufferedImageOp
src
- 転送元BufferedImage
src
を持ち、転送先のバウンディング・ボックスを表すRectangle2D
public final Rectangle2D getBounds2D(Raster src)
getBounds2D
、インタフェースRasterOp
src
- 転送元Raster
src
を持ち、転送先のバウンディング・ボックスを表すRectangle2D
public BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)
createCompatibleDestImage
、インタフェースBufferedImageOp
src
- フィルタ・オペレーションのソース・イメージ。destCM
- 転送先のColorModel。 nullの場合、適切なColorModelが使用される src
からの適切なサイズおよびバンド数を持つBufferedImage
。IllegalArgumentException
- destCM
がnull
で、かつこのColorConvertOp
が転送先に定義された任意のICC_Profile
またはColorSpace
を使用しないで作成された場合public WritableRaster createCompatibleDestRaster(Raster src)
createCompatibleDestRaster
、インタフェースRasterOp
src
- 指定されたRaster
src
からの適切なサイズおよびバンド数を持つWritableRaster
IllegalArgumentException
- このColorConvertOp
がdst
およびsrc
のカラー・スペースを定義するための十分な情報なしで作成された場合public final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)
dstPt
がnullでない場合は、戻り値の格納先として使用されます。 このクラスでは、転送先のポイントは転送元のポイントと同じになります。 getPoint2D
、インタフェースBufferedImageOp
getPoint2D
、インタフェースRasterOp
srcPt
- 指定された転送元のPoint2D
dstPt
- 転送先Point2D
srcPt
と同じ場所に設定したあとのdstPt
public final RenderingHints getRenderingHints()
getRenderingHints
、インタフェースBufferedImageOp
getRenderingHints
、インタフェースRasterOp
ColorConvertOp
のRenderingHints
オブジェクト バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。