< prev index next >
src/java.desktop/share/classes/java/awt/image/AffineTransformOp.java
Print this page
@@ -37,25 +37,25 @@
import java.lang.annotation.Native;
import sun.awt.image.ImagingLib;
/**
* This class uses an affine transform to perform a linear mapping from
- * 2D coordinates in the source image or <CODE>Raster</CODE> to 2D coordinates
- * in the destination image or <CODE>Raster</CODE>.
+ * 2D coordinates in the source image or {@code Raster} to 2D coordinates
+ * in the destination image or {@code Raster}.
* The type of interpolation that is used is specified through a constructor,
- * either by a <CODE>RenderingHints</CODE> object or by one of the integer
+ * either by a {@code RenderingHints} object or by one of the integer
* interpolation types defined in this class.
* <p>
- * If a <CODE>RenderingHints</CODE> object is specified in the constructor, the
+ * If a {@code 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.
* <p>
* Note that the following constraints have to be met:
* <ul>
* <li>The source and destination must be different.
- * <li>For <CODE>Raster</CODE> objects, the number of bands in the source must
+ * <li>For {@code Raster} objects, the number of bands in the source must
* be equal to the number of bands in the destination.
* </ul>
* @see AffineTransform
* @see BufferedImageFilter
* @see java.awt.RenderingHints#KEY_INTERPOLATION
@@ -83,23 +83,23 @@
@Native public static final int TYPE_BICUBIC = 3;
int interpolationType = TYPE_NEAREST_NEIGHBOR;
/**
- * Constructs an <CODE>AffineTransformOp</CODE> given an affine transform.
+ * Constructs an {@code AffineTransformOp} given an affine transform.
* The interpolation type is determined from the
- * <CODE>RenderingHints</CODE> object. If the interpolation hint is
+ * {@code 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 (<CODE>hints</CODE> is null),
+ * hints are specified ({@code hints} is null),
* the interpolation type is {@link #TYPE_NEAREST_NEIGHBOR
* TYPE_NEAREST_NEIGHBOR}.
*
- * @param xform The <CODE>AffineTransform</CODE> to use for the
+ * @param xform The {@code AffineTransform} to use for the
* operation.
*
- * @param hints The <CODE>RenderingHints</CODE> object used to specify
+ * @param hints The {@code RenderingHints} object used to specify
* the interpolation type for the operation.
*
* @throws ImagingOpException if the transform is non-invertible.
* @see java.awt.RenderingHints#KEY_INTERPOLATION
* @see java.awt.RenderingHints#KEY_RENDERING
@@ -134,14 +134,14 @@
interpolationType = TYPE_NEAREST_NEIGHBOR;
}
}
/**
- * Constructs an <CODE>AffineTransformOp</CODE> given an affine transform
+ * Constructs an {@code AffineTransformOp} given an affine transform
* and the interpolation type.
*
- * @param xform The <CODE>AffineTransform</CODE> to use for the operation.
+ * @param xform The {@code AffineTransform} to use for the operation.
* @param interpolationType One of the integer
* interpolation type constants defined by this class:
* {@link #TYPE_NEAREST_NEIGHBOR TYPE_NEAREST_NEIGHBOR},
* {@link #TYPE_BILINEAR TYPE_BILINEAR},
* {@link #TYPE_BICUBIC TYPE_BICUBIC}.
@@ -172,38 +172,38 @@
public final int getInterpolationType() {
return interpolationType;
}
/**
- * Transforms the source <CODE>BufferedImage</CODE> and stores the results
- * in the destination <CODE>BufferedImage</CODE>.
+ * Transforms the source {@code BufferedImage} and stores the results
+ * in the destination {@code 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 <CODE>BufferedImage</CODE> is created with the source
- * <CODE>ColorModel</CODE>.
+ * a {@code BufferedImage} is created with the source
+ * {@code ColorModel}.
* <p>
* The coordinates of the rectangle returned by
- * <code>getBounds2D(BufferedImage)</code>
+ * {@code getBounds2D(BufferedImage)}
* are not necessarily the same as the coordinates of the
- * <code>BufferedImage</code> returned by this method. If the
+ * {@code 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 <code>BufferedImage</code>.
+ * destination {@code BufferedImage}.
* <p>
- * An <CODE>IllegalArgumentException</CODE> is thrown if the source is
+ * An {@code IllegalArgumentException} is thrown if the source is
* the same as the destination.
*
- * @param src The <CODE>BufferedImage</CODE> to transform.
- * @param dst The <CODE>BufferedImage</CODE> in which to store the results
+ * @param src The {@code BufferedImage} to transform.
+ * @param dst The {@code BufferedImage} in which to store the results
* of the transformation.
*
- * @return The filtered <CODE>BufferedImage</CODE>.
- * @throws IllegalArgumentException if <code>src</code> and
- * <code>dst</code> are the same
+ * @return The filtered {@code BufferedImage}.
+ * @throws IllegalArgumentException if {@code src} and
+ * {@code dst} are the same
* @throws 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.
@@ -303,35 +303,35 @@
return origDst;
}
/**
- * Transforms the source <CODE>Raster</CODE> and stores the results in
- * the destination <CODE>Raster</CODE>. This operation performs the
+ * Transforms the source {@code Raster} and stores the results in
+ * the destination {@code Raster}. This operation performs the
* transform band by band.
* <p>
- * If the destination <CODE>Raster</CODE> is null, a new
- * <CODE>Raster</CODE> is created.
- * An <CODE>IllegalArgumentException</CODE> may be thrown if the source is
+ * If the destination {@code Raster} is null, a new
+ * {@code Raster} is created.
+ * An {@code 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.
* <p>
* The coordinates of the rectangle returned by
- * <code>getBounds2D(Raster)</code>
+ * {@code getBounds2D(Raster)}
* are not necessarily the same as the coordinates of the
- * <code>WritableRaster</code> returned by this method. If the
+ * {@code 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 <code>Raster</code>.
+ * that position in the destination {@code Raster}.
*
- * @param src The <CODE>Raster</CODE> to transform.
- * @param dst The <CODE>Raster</CODE> in which to store the results of the
+ * @param src The {@code Raster} to transform.
+ * @param dst The {@code Raster} in which to store the results of the
* transformation.
*
- * @return The transformed <CODE>Raster</CODE>.
+ * @return The transformed {@code Raster}.
*
* @throws 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
@@ -366,13 +366,13 @@
* 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).
*
- * @param src The <CODE>BufferedImage</CODE> to be transformed.
+ * @param src The {@code BufferedImage} to be transformed.
*
- * @return The <CODE>Rectangle2D</CODE> representing the destination's
+ * @return The {@code Rectangle2D} representing the destination's
* bounding box.
*/
public final Rectangle2D getBounds2D (BufferedImage src) {
return getBounds2D(src.getRaster());
}
@@ -381,13 +381,13 @@
* 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).
*
- * @param src The <CODE>Raster</CODE> to be transformed.
+ * @param src The {@code Raster} to be transformed.
*
- * @return The <CODE>Rectangle2D</CODE> representing the destination's
+ * @return The {@code Rectangle2D} representing the destination's
* bounding box.
*/
public final Rectangle2D getBounds2D (Raster src) {
int w = src.getWidth();
int h = src.getHeight();
@@ -419,21 +419,21 @@
return new Rectangle2D.Float(fminX, fminY, fmaxX-fminX, fmaxY-fminY);
}
/**
* Creates a zeroed destination image with the correct size and number of
- * bands. A <CODE>RasterFormatException</CODE> may be thrown if the
+ * bands. A {@code RasterFormatException} may be thrown if the
* transformed width or height is equal to 0.
* <p>
- * If <CODE>destCM</CODE> is null,
- * an appropriate <CODE>ColorModel</CODE> is used; this
- * <CODE>ColorModel</CODE> may have
- * an alpha channel even if the source <CODE>ColorModel</CODE> is opaque.
- *
- * @param src The <CODE>BufferedImage</CODE> to be transformed.
- * @param destCM <CODE>ColorModel</CODE> of the destination. If null,
- * an appropriate <CODE>ColorModel</CODE> is used.
+ * If {@code destCM} is null,
+ * an appropriate {@code ColorModel} is used; this
+ * {@code ColorModel} may have
+ * an alpha channel even if the source {@code ColorModel} is opaque.
+ *
+ * @param src The {@code BufferedImage} to be transformed.
+ * @param destCM {@code ColorModel} of the destination. If null,
+ * an appropriate {@code ColorModel} is used.
*
* @return The zeroed destination image.
*/
public BufferedImage createCompatibleDestImage (BufferedImage src,
ColorModel destCM) {
@@ -478,17 +478,17 @@
return image;
}
/**
- * Creates a zeroed destination <CODE>Raster</CODE> with the correct size
- * and number of bands. A <CODE>RasterFormatException</CODE> may be thrown
+ * Creates a zeroed destination {@code Raster} with the correct size
+ * and number of bands. A {@code RasterFormatException} may be thrown
* if the transformed width or height is equal to 0.
*
- * @param src The <CODE>Raster</CODE> to be transformed.
+ * @param src The {@code Raster} to be transformed.
*
- * @return The zeroed destination <CODE>Raster</CODE>.
+ * @return The zeroed destination {@code Raster}.
*/
public WritableRaster createCompatibleDestRaster (Raster src) {
Rectangle2D r = getBounds2D(src);
return src.createCompatibleWritableRaster((int)r.getX(),
@@ -497,37 +497,37 @@
(int)r.getHeight());
}
/**
* Returns the location of the corresponding destination point given a
- * point in the source. If <CODE>dstPt</CODE> is specified, it
+ * point in the source. If {@code dstPt} is specified, it
* is used to hold the return value.
*
- * @param srcPt The <code>Point2D</code> that represents the source
+ * @param srcPt The {@code Point2D} that represents the source
* point.
- * @param dstPt The <CODE>Point2D</CODE> in which to store the result.
+ * @param dstPt The {@code Point2D} in which to store the result.
*
- * @return The <CODE>Point2D</CODE> in the destination that corresponds to
+ * @return The {@code Point2D} in the destination that corresponds to
* the specified point in the source.
*/
public final Point2D getPoint2D (Point2D srcPt, Point2D dstPt) {
return xform.transform (srcPt, dstPt);
}
/**
* Returns the affine transform used by this transform operation.
*
- * @return The <CODE>AffineTransform</CODE> associated with this op.
+ * @return The {@code AffineTransform} associated with this op.
*/
public final AffineTransform getTransform() {
return (AffineTransform) xform.clone();
}
/**
* Returns the rendering hints used by this transform operation.
*
- * @return The <CODE>RenderingHints</CODE> object associated with this op.
+ * @return The {@code RenderingHints} object associated with this op.
*/
public final RenderingHints getRenderingHints() {
if (hints == null) {
Object val;
switch(interpolationType) {
< prev index next >