java.lang.Object
java.awt.image.AffineTransformOp
- すべての実装されたインタフェース:
BufferedImageOp
,RasterOp
public class AffineTransformOp extends Object implements BufferedImageOp, RasterOp
このクラスは、アフィン変換を使用して、転送元のイメージまたは
Raster
の2次元座標から転送先のイメージまたはRaster
の2次元座標への線形マッピングを実行します。 使用される補間の型は、コンストラクタを介して、RenderingHints
オブジェクトまたはこのクラスで定義されている整数型補間型のうちの1つによって指定されます。
RenderingHints
オブジェクトがコンストラクタで指定される場合、補間ヒントおよび描画品質ヒントがこのオペレーションの補間型を設定するために使用されます。 カラー描画ヒントおよびディザリング・ヒントは、色変換が必要な場合に使用されます。
次の制約に従う必要があります。
- 転送元と転送先は同じにはしない
Raster
オブジェクトの場合、転送元のバンド数は転送先のバンド数と同じにする。
-
フィールドのサマリー
修飾子と型フィールド説明static int
バイキュービック補間型です。static int
双一次補間型です。static int
最近傍補間(Nearest Neighbor Interpolation)型です。 -
コンストラクタのサマリー
コンストラクタ説明AffineTransformOp(AffineTransform xform, int interpolationType)
アフィン変換および補間型を指定してAffineTransformOp
を構築します。AffineTransformOp(AffineTransform xform, RenderingHints hints)
アフィン変換を指定してAffineTransformOp
を構築します。 -
メソッドのサマリー
修飾子と型メソッド説明createCompatibleDestImage(BufferedImage src, ColorModel destCM)
適切なサイズおよびバンド数で、ゼロ化された転送先イメージを生成します。適切なサイズと数のバンドを持つゼロ化された転送先Raster
を作成します。filter(BufferedImage src, BufferedImage dst)
転送元のBufferedImage
を変換し、その結果を転送先のBufferedImage
に格納します。filter(Raster src, WritableRaster dst)
転送元のRaster
を変換し、その結果を転送先のRaster
に格納します。getBounds2D(BufferedImage src)
変換された転送先のバウンディング・ボックスを返します。getBounds2D(Raster src)
変換された転送先のバウンディング・ボックスを返します。int
このオペレーションに使用される補間型を返します。getPoint2D(Point2D srcPt, Point2D dstPt)
指定された転送元のポイントに対応する転送先のポイントの位置を返します。この変換オペレーションに使用される描画ヒントを返します。この変換オペレーションに使用されるアフィン変換を返します。
-
フィールド詳細
-
TYPE_NEAREST_NEIGHBOR
@Native public static final int TYPE_NEAREST_NEIGHBOR最近傍補間(Nearest Neighbor Interpolation)型です。- 関連項目:
- 定数フィールド値
-
TYPE_BILINEAR
@Native public static final int TYPE_BILINEAR双一次補間型です。- 関連項目:
- 定数フィールド値
-
TYPE_BICUBIC
@Native public static final int TYPE_BICUBICバイキュービック補間型です。- 関連項目:
- 定数フィールド値
-
-
コンストラクタの詳細
-
AffineTransformOp
public AffineTransformOp(AffineTransform xform, RenderingHints hints)アフィン変換を指定してAffineTransformOp
を構築します。 補間型は、RenderingHints
オブジェクトにより決まります。 補間ヒントが定義されている場合は、それを使用します。 補間ヒントが定義されていない場合、描画品質ヒントが定義されていれば、補間型はその値から決まります。 hintsが指定されていない場合(hints
がnullの場合)、補間型はTYPE_NEAREST_NEIGHBOR
です。- パラメータ:
xform
- オペレーションに使用するAffineTransform
。hints
- オペレーションの補間型を指定するために使用されるRenderingHints
オブジェクト。- 例外:
ImagingOpException
- 変換を逆変換できない場合。- 関連項目:
RenderingHints.KEY_INTERPOLATION
,RenderingHints.KEY_RENDERING
-
AffineTransformOp
public AffineTransformOp(AffineTransform xform, int interpolationType)アフィン変換および補間型を指定してAffineTransformOp
を構築します。- パラメータ:
xform
- オペレーションに使用するAffineTransform
。interpolationType
- このクラスで定義されている整数値補間型定数の1つ。TYPE_NEAREST_NEIGHBOR
、TYPE_BILINEAR
、TYPE_BICUBIC
。- 例外:
ImagingOpException
- 変換を逆変換できない場合。
-
-
メソッドの詳細
-
getInterpolationType
public final int getInterpolationType()このオペレーションに使用される補間型を返します。- 戻り値:
- 補間型
- 関連項目:
TYPE_NEAREST_NEIGHBOR
,TYPE_BILINEAR
,TYPE_BICUBIC
-
filter
public final BufferedImage filter(BufferedImage src, BufferedImage dst)転送元のBufferedImage
を変換し、その結果を転送先のBufferedImage
に格納します。 2つのイメージのカラー・モデルが一致しない場合は、転送先のカラー・モデルへの変換が実行されます。 転送先のイメージがnullの場合、転送元のColorModel
によりBufferedImage
が作成されます。getBounds2D(BufferedImage)
が返す矩形の座標と、このメソッドが返すBufferedImage
の座標は必ず一致するとは限りません。 矩形の左上隅の座標が負の場合、矩形のこの部分は描画されません。 矩形の左上隅の座標が正の場合、フィルタを通したイメージは転送先BufferedImage
のその位置に描画されます。転送元が転送先と同じ場合は、
IllegalArgumentException
をスローします。- 定義:
filter
、インタフェース:BufferedImageOp
- パラメータ:
src
- 変換対象のBufferedImage
。dst
- 変換の結果を格納するBufferedImage
。- 戻り値:
- フィルタ処理された
BufferedImage
。 - 例外:
IllegalArgumentException
-src
とdst
が等しい場合ImagingOpException
- 無効なイメージ形式、タイル形式、またはイメージ処理操作によって起こるデータ処理エラー、あるいはその他のサポートされていない操作のためにイメージを変換できない場合。
-
filter
public final WritableRaster filter(Raster src, WritableRaster dst)転送元のRaster
を変換し、その結果を転送先のRaster
に格納します。 このオペレーションは、バンドごとの変換を実行します。転送先の
Raster
がnullの場合は、新しいRaster
が作成されます。 転送元が転送先と同一の場合、または転送元のバンド数と転送先のバンド数が等しくない場合には、IllegalArgumentException
がスローされます。getBounds2D(Raster)
が返す矩形の座標と、このメソッドが返すWritableRaster
の座標は必ず一致するとは限りません。 矩形の左上隅の座標が負の場合、矩形のこの部分は描画されません。 矩形の座標が正の場合、フィルタを通したイメージは転送先Raster
のその位置に描画されます。- 定義:
filter
、インタフェース:RasterOp
- パラメータ:
src
- 変換対象のRaster
。dst
- 変換の結果を格納するRaster
。- 戻り値:
- 変換された
Raster
。 - 例外:
ImagingOpException
- 無効なイメージ形式、タイル形式、またはイメージ処理操作によって起こるデータ処理エラー、あるいはその他のサポートされていない操作のためにラスターを変換できない場合。
-
getBounds2D
public final Rectangle2D getBounds2D(BufferedImage src)変換された転送先のバウンディング・ボックスを返します。 返される矩形は、変換されたポイントの実際のバウンディング・ボックスです。 返される矩形の左上隅の座標は(0, 0)でない可能性があります。- 定義:
getBounds2D
、インタフェース:BufferedImageOp
- パラメータ:
src
- 変換対象のBufferedImage
。- 戻り値:
- 転送先のバウンディング・ボックスを表す
Rectangle2D
。
-
getBounds2D
public final Rectangle2D getBounds2D(Raster src)変換された転送先のバウンディング・ボックスを返します。 返される矩形は、変換されたポイントの実際のバウンディング・ボックスです。 返される矩形の左上隅の座標は(0, 0)でない可能性があります。- 定義:
getBounds2D
、インタフェース:RasterOp
- パラメータ:
src
- 変換対象のRaster
。- 戻り値:
- 転送先のバウンディング・ボックスを表す
Rectangle2D
。
-
createCompatibleDestImage
public BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)適切なサイズおよびバンド数で、ゼロ化された転送先イメージを生成します。 変換された幅または高さが0に等しい場合は、RasterFormatException
がスローされます。destCM
がnullの場合は、適切なColorModel
が使用されます。使用されるColorModel
は、転送元のColorModel
が不透明な場合にも、アルファ・チャネルを持つ場合があります。- 定義:
createCompatibleDestImage
、インタフェース:BufferedImageOp
- パラメータ:
src
- 変換対象のBufferedImage
。destCM
- 転送先のColorModel
。 nullの場合、適切なColorModel
が使用される。- 戻り値:
- ゼロ化された転送先イメージ
-
createCompatibleDestRaster
public WritableRaster createCompatibleDestRaster(Raster src)適切なサイズと数のバンドを持つゼロ化された転送先Raster
を作成します。 変換された幅または高さが0に等しい場合は、RasterFormatException
がスローされます。- 定義:
createCompatibleDestRaster
、インタフェース:RasterOp
- パラメータ:
src
- 変換対象のRaster
。- 戻り値:
- ゼロ化された転送先
Raster
。
-
getPoint2D
指定された転送元のポイントに対応する転送先のポイントの位置を返します。dstPt
が指定されている場合、そのdstPtが戻り値を保持します。- 定義:
getPoint2D
、インタフェース:BufferedImageOp
- 定義:
getPoint2D
、インタフェース:RasterOp
- パラメータ:
srcPt
- 転送元のポイントを表すPoint2D
。dstPt
- 結果が格納されるPoint2D
。- 戻り値:
- 指定された転送元のポイントに対応する転送先の
Point2D
。
-
getTransform
public final AffineTransform getTransform()この変換オペレーションに使用されるアフィン変換を返します。- 戻り値:
- このオペレーションに関連した
AffineTransform
-
getRenderingHints
public final RenderingHints getRenderingHints()この変換オペレーションに使用される描画ヒントを返します。- 定義:
getRenderingHints
、インタフェース:BufferedImageOp
- 定義:
getRenderingHints
、インタフェース:RasterOp
- 戻り値:
- この操作に関連付けられた
RenderingHints
オブジェクト。
-