BufferedImageOp
, RasterOp
public class AffineTransformOp extends Object implements BufferedImageOp, RasterOp
Raster
to 2D coordinates in the destination image or Raster
. The type of interpolation that is used is specified through a constructor, either by a RenderingHints
object or by one of the integer interpolation types defined in this class. If a RenderingHints
object is specified in the constructor, the interpolation hint and the rendering quality hint are used to set the interpolation type for this operation. The color rendering hint and the dithering hint can be used when color conversion is required.
Note that the following constraints have to be met:
Raster
objects, the number of bands in the source must be equal to the number of bands in the destination. Modifier and Type | Field | Description |
---|---|---|
static final int |
TYPE_BICUBIC |
Bicubic interpolation type. |
static final int |
TYPE_BILINEAR |
Bilinear interpolation type. |
static final int |
TYPE_NEAREST_NEIGHBOR |
Nearest-neighbor interpolation type. |
Constructor | Description |
---|---|
AffineTransformOp |
Constructs an AffineTransformOp given an affine transform and the interpolation type. |
AffineTransformOp |
Constructs an AffineTransformOp given an affine transform. |
Modifier and Type | Method | Description |
---|---|---|
BufferedImage |
createCompatibleDestImage |
Creates a zeroed destination image with the correct size and number of bands. |
WritableRaster |
createCompatibleDestRaster |
Creates a zeroed destination Raster with the correct size and number of bands. |
final BufferedImage |
filter |
Transforms the source BufferedImage and stores the results in the destination BufferedImage . |
final WritableRaster |
filter |
Transforms the source Raster and stores the results in the destination Raster . |
final Rectangle2D |
getBounds2D |
Returns the bounding box of the transformed destination. |
final Rectangle2D |
getBounds2D |
Returns the bounding box of the transformed destination. |
final int |
getInterpolationType() |
Returns the interpolation type used by this op. |
final Point2D |
getPoint2D |
Returns the location of the corresponding destination point given a point in the source. |
final RenderingHints |
getRenderingHints() |
Returns the rendering hints used by this transform operation. |
final AffineTransform |
getTransform() |
Returns the affine transform used by this transform operation. |
@Native public static final int TYPE_NEAREST_NEIGHBOR
@Native public static final int TYPE_BILINEAR
@Native public static final int TYPE_BICUBIC
public AffineTransformOp(AffineTransform xform, RenderingHints hints)
AffineTransformOp
given an affine transform. The interpolation type is determined from the RenderingHints
object. If the interpolation hint is defined, it will be used. Otherwise, if the rendering quality hint is defined, the interpolation type is determined from its value. If no hints are specified (hints
is null), the interpolation type is TYPE_NEAREST_NEIGHBOR
.xform
- The AffineTransform
to use for the operation.hints
- The RenderingHints
object used to specify the interpolation type for the operation.ImagingOpException
- if the transform is non-invertible.public AffineTransformOp(AffineTransform xform, int interpolationType)
AffineTransformOp
given an affine transform and the interpolation type.xform
- The AffineTransform
to use for the operation.interpolationType
- One of the integer interpolation type constants defined by this class: TYPE_NEAREST_NEIGHBOR
, TYPE_BILINEAR
, TYPE_BICUBIC
.ImagingOpException
- if the transform is non-invertible.public final int getInterpolationType()
public final BufferedImage filter(BufferedImage src, BufferedImage dst)
BufferedImage
and stores the results in the destination BufferedImage
. If the color models for the two images do not match, a color conversion into the destination color model is performed. If the destination image is null, a BufferedImage
is created with the source ColorModel
. The coordinates of the rectangle returned by getBounds2D(BufferedImage)
are not necessarily the same as the coordinates of the BufferedImage
returned by this method. If the upper-left corner coordinates of the rectangle are negative then this part of the rectangle is not drawn. If the upper-left corner coordinates of the rectangle are positive then the filtered image is drawn at that position in the destination BufferedImage
.
An IllegalArgumentException
is thrown if the source is the same as the destination.
filter
in interface BufferedImageOp
src
- The BufferedImage
to transform.dst
- The BufferedImage
in which to store the results of the transformation.BufferedImage
.IllegalArgumentException
- if src
and dst
are the sameImagingOpException
- if the image cannot be transformed because of a data-processing error that might be caused by an invalid image format, tile format, or image-processing operation, or any other unsupported operation.public final WritableRaster filter(Raster src, WritableRaster dst)
Raster
and stores the results in the destination Raster
. This operation performs the transform band by band. If the destination Raster
is null, a new Raster
is created. An IllegalArgumentException
may be thrown if the source is the same as the destination or if the number of bands in the source is not equal to the number of bands in the destination.
The coordinates of the rectangle returned by getBounds2D(Raster)
are not necessarily the same as the coordinates of the WritableRaster
returned by this method. If the upper-left corner coordinates of rectangle are negative then this part of the rectangle is not drawn. If the coordinates of the rectangle are positive then the filtered image is drawn at that position in the destination Raster
.
filter
in interface RasterOp
src
- The Raster
to transform.dst
- The Raster
in which to store the results of the transformation.Raster
.ImagingOpException
- if the raster cannot be transformed because of a data-processing error that might be caused by an invalid image format, tile format, or image-processing operation, or any other unsupported operation.public final Rectangle2D getBounds2D(BufferedImage src)
getBounds2D
in interface BufferedImageOp
src
- The BufferedImage
to be transformed.Rectangle2D
representing the destination's bounding box.public final Rectangle2D getBounds2D(Raster src)
getBounds2D
in interface RasterOp
src
- The Raster
to be transformed.Rectangle2D
representing the destination's bounding box.public BufferedImage createCompatibleDestImage(BufferedImage src, ColorModel destCM)
RasterFormatException
may be thrown if the transformed width or height is equal to 0. If destCM
is null, an appropriate ColorModel
is used; this ColorModel
may have an alpha channel even if the source ColorModel
is opaque.
createCompatibleDestImage
in interface BufferedImageOp
src
- The BufferedImage
to be transformed.destCM
- ColorModel
of the destination. If null, an appropriate ColorModel
is used.public WritableRaster createCompatibleDestRaster(Raster src)
Raster
with the correct size and number of bands. A RasterFormatException
may be thrown if the transformed width or height is equal to 0.createCompatibleDestRaster
in interface RasterOp
src
- The Raster
to be transformed.Raster
.public final Point2D getPoint2D(Point2D srcPt, Point2D dstPt)
dstPt
is specified, it is used to hold the return value.getPoint2D
in interface BufferedImageOp
getPoint2D
in interface RasterOp
srcPt
- The Point2D
that represents the source point.dstPt
- The Point2D
in which to store the result.Point2D
in the destination that corresponds to the specified point in the source.public final AffineTransform getTransform()
AffineTransform
associated with this op.public final RenderingHints getRenderingHints()
getRenderingHints
in interface BufferedImageOp
getRenderingHints
in interface RasterOp
RenderingHints
object associated with this op.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/image/AffineTransformOp.html