java.lang.Object | |
↳ | java.awt.image.AffineTransformOp |
This class uses an affine transform to perform a linear mapping from
2D coordinates in the source image or 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.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | TYPE_BICUBIC | Bicubic interpolation type. | |||||||||
int | TYPE_BILINEAR | Bilinear interpolation type. | |||||||||
int | TYPE_NEAREST_NEIGHBOR | Nearest-neighbor interpolation type. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs an
AffineTransformOp given an affine transform. | |||||||||||
Constructs an
AffineTransformOp given an affine transform
and the interpolation type. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a zeroed destination image with the correct size and number of
bands.
| |||||||||||
Creates a zeroed destination
Raster with the correct size
and number of bands. | |||||||||||
Transforms the source
BufferedImage and stores the results
in the destination BufferedImage . | |||||||||||
Transforms the source
Raster and stores the results in
the destination Raster . | |||||||||||
Returns the bounding box of the transformed destination.
| |||||||||||
Returns the bounding box of the transformed destination.
| |||||||||||
Returns the interpolation type used by this op.
| |||||||||||
Returns the location of the corresponding destination point given a
point in the source.
| |||||||||||
Returns the rendering hints used by this transform operation.
| |||||||||||
Returns the affine transform used by this transform operation.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
java.awt.image.BufferedImageOp
| |||||||||||
From interface
java.awt.image.RasterOp
|
Bicubic interpolation type.
Bilinear interpolation type.
Nearest-neighbor interpolation type.
Constructs an 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. |
---|
Constructs an 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. |
---|
Creates a zeroed destination image with the correct size and number of
bands. A 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.
src | The BufferedImage to be transformed. |
---|---|
destCM | ColorModel of the destination. If null,
an appropriate ColorModel is used. |
Creates a zeroed destination Raster
with the correct size
and number of bands. A RasterFormatException
may be thrown
if the transformed width or height is equal to 0.
src | The Raster to be transformed. |
---|
Raster
.
Transforms the source 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.
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 same |
---|---|
ImagingOpException | 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. |
Transforms the source 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
.
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. |
---|
Returns the bounding box of the transformed destination. The rectangle returned is the actual bounding box of the transformed points. The coordinates of the upper-left corner of the returned rectangle might not be (0, 0).
src | The BufferedImage to be transformed. |
---|
Rectangle2D
representing the destination's
bounding box.
Returns the bounding box of the transformed destination. The rectangle returned will be the actual bounding box of the transformed points. The coordinates of the upper-left corner of the returned rectangle might not be (0, 0).
src | The Raster to be transformed. |
---|
Rectangle2D
representing the destination's
bounding box.
Returns the interpolation type used by this op.
Returns the location of the corresponding destination point given a
point in the source. If dstPt
is specified, it
is used to hold the return value.
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.
Returns the rendering hints used by this transform operation.
RenderingHints
object associated with this op.
Returns the affine transform used by this transform operation.
AffineTransform
associated with this op.