java.awt.image
クラス AffineTransformOp

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

public class AffineTransformOp

extends Object

implements BufferedImageOp, RasterOp

このクラスは、アフィン変換を使用して、ソースのイメージまたは Raster の 2 次元座標からデスティネーションのイメージまたは Raster の 2 次元座標への線形マッピングを実行します。使用される補間のタイプは、コンストラクタを介して、RenderingHints オブジェクトまたはこのクラスで定義されている整数型補間タイプのうちの 1 つによって指定されます。

RenderingHints オブジェクトがコンストラクタで指定される場合、補間ヒントおよび描画品質ヒントがこのオペレーションの補間タイプを設定するために使用されます。カラー描画ヒントおよびディザリングヒントは、色変換が必要な場合に使用されます。

次の制約に従ってください。

• ソースおよびデスティネーションは同じであってはならない
• Raster オブジェクトの場合、ソースのバンド数はデスティネーションのバンド数と同じでなければならない

関連項目:

AffineTransform, BufferedImageFilter, RenderingHints.KEY_INTERPOLATION, RenderingHints.KEY_RENDERING, RenderingHints.KEY_COLOR_RENDERING, RenderingHints.KEY_DITHERING

フィールドの概要

static int	TYPE_BILINEAR 双一次補間タイプです。
static int	TYPE_NEAREST_NEIGHBOR 最近傍補間 (Nearest Neighbor Interpolation) タイプです。

コンストラクタの概要

AffineTransformOp(AffineTransform xform, int interpolationType)
アフィン変換および補間タイプを指定して AffineTransformOp を構築します。

AffineTransformOp(AffineTransform xform, RenderingHints hints)
アフィン変換を指定して AffineTransformOp を構築します。

メソッドの概要

BufferedImage	createCompatibleDestImage(BufferedImage src, ColorModel destCM) 正しいサイズおよびバンド数で、ゼロ化されたデスティネーションのイメージを作成します。
WritableRaster	createCompatibleDestRaster(Raster src) 正しいサイズおよびバンド数で、ゼロ化された Raster を作成します。
BufferedImage	filter(BufferedImage src, BufferedImage dst) ソースの BufferedImage を変換し、その結果をデスティネーションの BufferedImage に格納します。
WritableRaster	filter(Raster src, WritableRaster dst) ソースの Raster を変換し、その結果をデスティネーションの Raster に格納します。
Rectangle2D	getBounds2D(BufferedImage src) 変換されたデスティネーションのバウンディングボックスを返します。
Rectangle2D	getBounds2D(Raster src) 変換されたデスティネーションのバウンディングボックスを返します。
int	getInterpolationType() このオペレーションに使用される補間タイプを返します。
Point2D	getPoint2D(Point2D srcPt, Point2D dstPt) 指定されたソースのポイントに対応するデスティネーションのポイントの位置を返します。
RenderingHints	getRenderingHints() この変換オペレーションに使用される描画ヒントを返します。
AffineTransform	getTransform() この変換オペレーションに使用されるアフィン変換を返します。

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

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

フィールドの詳細

TYPE_NEAREST_NEIGHBOR

public static final int TYPE_NEAREST_NEIGHBOR

最近傍補間 (Nearest Neighbor Interpolation) タイプです。

TYPE_BILINEAR

public static final int TYPE_BILINEAR

双一次補間タイプです。

コンストラクタの詳細

AffineTransformOp

public AffineTransformOp(AffineTransform xform,
                         RenderingHints hints)

アフィン変換を指定して AffineTransformOp を構築します。補間タイプは、RenderingHints オブジェクトから決まります。補間ヒントが定義されている場合は、それが使用されます。そうでない場合、描画品質ヒントが定義されていれば、補間タイプはその値から決まります。hints が指定されていない場合 (hints が null の場合) は、補間タイプは TYPE_NEAREST_NEIGHBOR です。

パラメータ:

xform - オペレーションに使用する AffineTransform

hints - オペレーションの補間タイプを指定するために使用される RenderingHints オブジェクト

関連項目:

RenderingHints.KEY_INTERPOLATION, RenderingHints.KEY_RENDERING

AffineTransformOp

public AffineTransformOp(AffineTransform xform,
                         int interpolationType)

アフィン変換および補間タイプを指定して AffineTransformOp を構築します。

パラメータ:

xform - オペレーションに使用する AffineTransform

interpolationType - 整数値。補間タイプはこのクラスで定義されている。TYPE_NEAREST_NEIGHBOR、TYPE_BILINEAR を参照

メソッドの詳細

getInterpolationType

public final int getInterpolationType()

このオペレーションに使用される補間タイプを返します。

関連項目:

TYPE_NEAREST_NEIGHBOR, TYPE_BILINEAR

filter

public final BufferedImage filter(BufferedImage src,
                                  BufferedImage dst)

ソースの BufferedImage を変換し、その結果をデスティネーションの BufferedImage に格納します。2 つのイメージのカラーモデルが一致しない場合は、デスティネーションのカラーモデルへの変換が実行されます。デスティネーションのイメージが null の場合、ソースの ColorModel により BufferedImage が作成されます。ソースがデスティネーションと同一の場合は、IllegalArgumentException がスローされます。

定義:

インタフェース BufferedImageOp 内の filter

パラメータ:

src - 変換対象の BufferedImage

dst - 変換の結果を格納する BufferedImage

戻り値:

フィルタされた BufferedImage

例外:

ImagingOpException - イメージを変換できない場合

filter

public final WritableRaster filter(Raster src,
                                   WritableRaster dst)

ソースの Raster を変換し、その結果をデスティネーションの Raster に格納します。このオペレーションは、バンドごとの変換を実行します。

デスティネーションの Raster が null の場合は、新しい Raster が作成されます。ソースがデスティネーションと同一の場合、またはソースのバンド数とデスティネーションのバンド数が等しくない場合には、IllegalArgumentException がスローされます。

定義:

インタフェース RasterOp 内の filter

パラメータ:

src - 変換対象の Raster

dst - 変換の結果を格納する Raster

戻り値:

変換されたRaster

例外:

ImagingOpException - Raster を変換できない場合

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)

変換されたデスティネーションのバウンディングボックスを返します。返される矩形は、変換されたポイントの実際のバウンディングボックスです。

定義:

インタフェース BufferedImageOp 内の getBounds2D

パラメータ:

src - 変換対象の BufferedImage

戻り値:

デスティネーションのバウンディングボックスを表現する Rectangle2D

getBounds2D

public final Rectangle2D getBounds2D(Raster src)

変換されたデスティネーションのバウンディングボックスを返します。返される矩形は、変換されたポイントの実際のバウンディングボックスです。

定義:

インタフェース RasterOp 内の getBounds2D

パラメータ:

src - 変換対象の Raster

戻り値:

デスティネーションのバウンディングボックスを表現する Rectangle2D

createCompatibleDestImage

public BufferedImage createCompatibleDestImage(BufferedImage src,
                                               ColorModel destCM)

正しいサイズおよびバンド数で、ゼロ化されたデスティネーションのイメージを作成します。変換された幅または高さが 0 に等しい場合は、RasterFormatException がスローされます。

destCM が null の場合は、適切な ColorModel が使用されます。使用される ColorModel は、ソースの ColorModel が不透明な場合にも、アルファチャネルを持つ場合があります。

定義:

インタフェース BufferedImageOp 内の createCompatibleDestImage

パラメータ:

src - 変換対象の BufferedImage

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

戻り値:

ゼロ化されたデスティネーションのイメージ

createCompatibleDestRaster

public WritableRaster createCompatibleDestRaster(Raster src)

正しいサイズおよびバンド数で、ゼロ化された Raster を作成します。変換された幅または高さが 0 に等しい場合は、RasterFormatException がスローされます。

定義:

インタフェース RasterOp 内の createCompatibleDestRaster

パラメータ:

src - 変換対象の Raster

戻り値:

ゼロ化されたデスティネーションの Raster

getPoint2D

public final Point2D getPoint2D(Point2D srcPt,
                                Point2D dstPt)

指定されたソースのポイントに対応するデスティネーションのポイントの位置を返します。dstPt が指定されている場合、その dstPt が戻り値を保持します。

定義:

インタフェース BufferedImageOp 内の getPoint2D

パラメータ:

dstPt - 結果が格納される Point2D

戻り値:

指定されたソースのポイントに対応するデスティネーションの Point2D

getTransform

public final AffineTransform getTransform()

この変換オペレーションに使用されるアフィン変換を返します。

戻り値:

このオペレーションに関連付けられた AffineTransform

getRenderingHints

public final RenderingHints getRenderingHints()

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

定義:

インタフェース BufferedImageOp 内の getRenderingHints

戻り値:

このオペレーションに関連付けられた RenderingHints オブジェクト