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

次の制約に従う必要があります。

  • 転送元と転送先は同じにはしない
  • Rasterオブジェクトの場合、転送元のバンド数は転送先のバンド数と同じにする。

関連項目:

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final int
    TYPE_BICUBIC
    バイキュービック補間型です。
    static final int
    TYPE_BILINEAR
    双一次補間型です。
    static final 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を作成します。
    final BufferedImage
    filter(BufferedImage src, BufferedImage dst)
    転送元のBufferedImageを変換し、その結果を転送先のBufferedImageに格納します。
    final WritableRaster
    filter(Raster src, WritableRaster dst)
    転送元のRasterを変換し、その結果を転送先のRasterに格納します。
    final Rectangle2D
    getBounds2D(BufferedImage src)
    変換された転送先のバウンディング・ボックスを返します。
    final Rectangle2D
    getBounds2D(Raster src)
    変換された転送先のバウンディング・ボックスを返します。
    final int
    getInterpolationType()
    このオペレーションに使用される補間型を返します。
    final Point2D
    getPoint2D(Point2D srcPt, Point2D dstPt)
    指定された転送元のポイントに対応する転送先のポイントの位置を返します。
    final RenderingHints
    getRenderingHints()
    この変換オペレーションに使用される描画ヒントを返します。
    final AffineTransform
    getTransform()
    この変換オペレーションに使用されるアフィン変換を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

  • コンストラクタの詳細

    • AffineTransformOp

      public AffineTransformOp(AffineTransform xform, RenderingHints hints)
      アフィン変換を指定してAffineTransformOpを構築します。 補間型は、RenderingHintsオブジェクトにより決まります。 補間ヒントが定義されている場合は、それを使用します。 補間ヒントが定義されていない場合、描画品質ヒントが定義されていれば、補間型はその値から決まります。 hintsが指定されていない場合(hintsがnullの場合)、補間型はTYPE_NEAREST_NEIGHBORです。
      パラメータ:
      xform - オペレーションに使用するAffineTransform。
      hints - オペレーションの補間型を指定するために使用されるRenderingHintsオブジェクト。
      スロー:
      ImagingOpException - 変換を逆変換できない場合。
      関連項目:

    • 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()
      このオペレーションに使用される補間型を返します。
      戻り値:
      補間型
      関連項目:

    • filter

      public final BufferedImage filter(BufferedImage src, BufferedImage dst)
      転送元のBufferedImageを変換し、その結果を転送先のBufferedImageに格納します。 2つのイメージのカラー・モデルが一致しない場合は、転送先のカラー・モデルへの変換が実行されます。 転送先のイメージがnullの場合、転送元のColorModelによりBufferedImageが作成されます。

      getBounds2D(BufferedImage)が返す矩形の座標と、このメソッドが返すBufferedImageの座標は必ず一致するとは限りません。 アプリケーションが常に返されるdstを提供する場合。 dstがnullで、変換されたディメンションを含む宛先{code BufferedImage}を作成できない場合、srcディメンションが置換されます。

      矩形の左上隅の座標が負の場合、矩形のこの部分は描画されません。 矩形の左上隅の座標が正の場合、フィルタを通したイメージは転送先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の座標は必ず一致するとは限りません。 アプリケーションが常に返されるdstを提供する場合。 dstがnullで、変換されたディメンションを含む宛先{code Raster}を作成できない場合、srcディメンションが置換されます。

      矩形の左上隅の座標が負の場合、矩形のこの部分は描画されません。 矩形の座標が正の場合、フィルタを通したイメージは転送先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

      public final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)
      指定された転送元のポイントに対応する転送先のポイントの位置を返します。 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オブジェクト。