JavaTM 2 Platform
Std. Ed. v1.3

java.awt.image
クラス AffineTransformOp

java.lang.Object
  |
  +--java.awt.image.AffineTransformOp
すべての実装インタフェース:
BufferedImageOp, RasterOp

public class AffineTransformOp
extends Object
implements BufferedImageOp, RasterOp

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

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

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

関連項目:
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 - このクラスで定義されている整数値補間タイプ定数の 1 つ。TYPE_NEAREST_NEIGHBORTYPE_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 が作成されます。

getBounds2D(BufferedImage) が返す矩形の座標と、このメソッドが返す BufferedImage の座標は必ず一致するとは限りません。矩形の左上隅の座標が負の場合、矩形のこの部分は描画されません。矩形の左上隅の座標が正の場合、フィルタを通したイメージはデスティネーション BufferedImage のその位置に描画されます。

ソースがデスティネーションと同じ場合は、IllegalArgumentException をスローします。

定義:
インタフェース BufferedImageOp 内の filter
パラメータ:
src - 変換対象の BufferedImage
dst - 変換の結果を格納する BufferedImage
戻り値:
フィルタされた BufferedImage
例外:
IllegalArgumentException - srcdst が同じ場合
ImagingOpException - 無効なイメージ形式、タイル形式、イメージ処理操作によって起こるデータ処理エラー、またはその他のサポートされていない操作のためイメージを変換できない場合

filter

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

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

getBounds2D(Raster) が返す矩形の座標と、このメソッドが返す WritableRaster の座標は必ず一致するとは限りません。矩形の左上隅の座標が負の場合、矩形のこの部分は描画されません。矩形の座標が正の場合、フィルタを通したイメージはデスティネーション Raster のその位置に描画されます。

定義:
インタフェース RasterOp 内の filter
パラメータ:
src - 変換対象の Raster
dst - 変換の結果を格納する Raster
戻り値:
変換された Raster
例外:
ImagingOpException - 無効なイメージ形式、タイル形式、イメージ処理操作により起こるデータ処理エラー、または、その他サポートされていない操作のためラスタを変換できない場合

getBounds2D

public final Rectangle2D getBounds2D(BufferedImage src)
変換されたデスティネーションのバウンディングボックスを返します。返される矩形は、変換されたポイントの実際のバウンディングボックスです。返される矩形の左上隅の座標は (0, 0) でない可能性があります。
定義:
インタフェース BufferedImageOp 内の getBounds2D
パラメータ:
src - 変換対象の BufferedImage
戻り値:
デスティネーションのバウンディングボックスを表す Rectangle2D

getBounds2D

public final Rectangle2D getBounds2D(Raster src)
変換されたデスティネーションのバウンディングボックスを返します。返される矩形は、変換されたポイントの実際のバウンディングボックスです。返される矩形の左上隅の座標は (0, 0) でない可能性があります。
定義:
インタフェース 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 オブジェクト

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.