AffineTransform

Overview

Package

Class

Tree

Deprecated

Index

Help

Codase Click

search sample or example code,

search definition,

search google

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

java.awt.geom
Class AffineTransform

java.lang.Object   
  java.awt.geom.AffineTransform

All Implemented Interfaces:: Serializable , Cloneable

public class AffineTransform
extends Object
implements Cloneable , Serializable
extends Object
implements Cloneable , Serializable

The AffineTransform class represents a 2D affine transform that performs a linear mapping from 2D coordinates to other 2D coordinates that preserves the "straightness" and "parallelness" of lines. Affine transformations can be constructed using sequences of translations, scales, flips, rotations, and shears.

Such a coordinate transformation can be represented by a 3 row by 3 column matrix with an implied last row of [ 0 0 1 ]. This matrix transforms source coordinates (x, y) into destination coordinates (x', y') by considering them to be a column vector and multiplying the coordinate vector by the matrix according to the following process:

        [ x']   [  m00  m01  m02  ] [ x ]   [ m00x + m01y + m02 ]
        [ y'] = [  m10  m11  m12  ] [ y ] = [ m10x + m11y + m12 ]
        [ 1 ]   [   0    0    1   ] [ 1 ]   [         1         ]

See Also:: Serialized Form

Field Summary
`static int`	`TYPE_FLIP` This flag bit indicates that the transform defined by this object performs a mirror image flip about some axis which changes the normally right handed coordinate system into a left handed system in addition to the conversions indicated by other flag bits.
`static int`	`TYPE_GENERAL_ROTATION` This flag bit indicates that the transform defined by this object performs a rotation by an arbitrary angle in addition to the conversions indicated by other flag bits.
`static int`	`TYPE_GENERAL_SCALE` This flag bit indicates that the transform defined by this object performs a general scale in addition to the conversions indicated by other flag bits.
`static int`	`TYPE_GENERAL_TRANSFORM` This constant indicates that the transform defined by this object performs an arbitrary conversion of the input coordinates.
`static int`	`TYPE_IDENTITY` This constant indicates that the transform defined by this object is an identity transform.
`static int`	`TYPE_MASK_ROTATION` This constant is a bit mask for any of the rotation flag bits.
`static int`	`TYPE_MASK_SCALE` This constant is a bit mask for any of the scale flag bits.
`static int`	`TYPE_QUADRANT_ROTATION` This flag bit indicates that the transform defined by this object performs a quadrant rotation by some multiple of 90 degrees in addition to the conversions indicated by other flag bits.
`static int`	`TYPE_TRANSLATION` This flag bit indicates that the transform defined by this object performs a translation in addition to the conversions indicated by other flag bits.
`static int`	`TYPE_UNIFORM_SCALE` This flag bit indicates that the transform defined by this object performs a uniform scale in addition to the conversions indicated by other flag bits.

Constructor Summary
`AffineTransform ()` Constructs a new `AffineTransform` representing the Identity transformation.
`AffineTransform (AffineTransform Tx)` Constructs a new `AffineTransform` that is a copy of the specified `AffineTransform` object.
`AffineTransform (double[] flatmatrix)` Constructs a new `AffineTransform` from an array of double precision values representing either the 4 non-translation entries or the 6 specifiable entries of the 3x3 transformation matrix.
`AffineTransform (double m00, double m10, double m01, double m11, double m02, double m12)` Constructs a new `AffineTransform` from 6 double precision values representing the 6 specifiable entries of the 3x3 transformation matrix.
`AffineTransform (float[] flatmatrix)` Constructs a new `AffineTransform` from an array of floating point values representing either the 4 non-translation enries or the 6 specifiable entries of the 3x3 transformation matrix.
`AffineTransform (float m00, float m10, float m01, float m11, float m02, float m12)` Constructs a new `AffineTransform` from 6 floating point values representing the 6 specifiable entries of the 3x3 transformation matrix.

Method Summary
`Object`	`clone ()` Returns a copy of this `AffineTransform` object.
`void`	`concatenate (AffineTransform Tx)` Concatenates an `AffineTransform` `Tx` to this `AffineTransform` Cx in the most commonly useful way to provide a new user space that is mapped to the former user space by `Tx`.
`AffineTransform`	`createInverse ()` Returns an `AffineTransform` object representing the inverse transformation.
`Shape`	`createTransformedShape (Shape pSrc)` Returns a new `Shape` object defined by the geometry of the specified `Shape` after it has been transformed by this transform.
`void`	`deltaTransform (double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Transforms an array of relative distance vectors by this transform.
`Point2D`	`deltaTransform (Point2D ptSrc, Point2D ptDst)` Transforms the relative distance vector specified by `ptSrc` and stores the result in `ptDst`.
`boolean`	`equals (Object obj)` Returns `true` if this `AffineTransform` represents the same affine coordinate transform as the specified argument.
`double`	`getDeterminant ()` Returns the determinant of the matrix representation of the transform.
`void`	`getMatrix (double[] flatmatrix)` Retrieves the 6 specifiable values in the 3x3 affine transformation matrix and places them into an array of double precisions values.
`static AffineTransform`	`getRotateInstance (double theta)` Returns a transform representing a rotation transformation.
`static AffineTransform`	`getRotateInstance (double theta, double x, double y)` Returns a transform that rotates coordinates around an anchor point.
`static AffineTransform`	`getScaleInstance (double sx, double sy)` Returns a transform representing a scaling transformation.
`double`	`getScaleX ()` Returns the X coordinate scaling element (m00) of the 3x3 affine transformation matrix.
`double`	`getScaleY ()` Returns the Y coordinate scaling element (m11) of the 3x3 affine transformation matrix.
`static AffineTransform`	`getShearInstance (double shx, double shy)` Returns a transform representing a shearing transformation.
`double`	`getShearX ()` Returns the X coordinate shearing element (m01) of the 3x3 affine transformation matrix.
`double`	`getShearY ()` Returns the Y coordinate shearing element (m10) of the 3x3 affine transformation matrix.
`static AffineTransform`	`getTranslateInstance (double tx, double ty)` Returns a transform representing a translation transformation.
`double`	`getTranslateX ()` Returns the X coordinate of the translation element (m02) of the 3x3 affine transformation matrix.
`double`	`getTranslateY ()` Returns the Y coordinate of the translation element (m12) of the 3x3 affine transformation matrix.
`int`	`getType ()` Retrieves the flag bits describing the conversion properties of this transform.
`int`	`hashCode ()` Returns the hashcode for this transform.
`void`	`inverseTransform (double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Inverse transforms an array of double precision coordinates by this transform.
`Point2D`	`inverseTransform (Point2D ptSrc, Point2D ptDst)` Inverse transforms the specified `ptSrc` and stores the result in `ptDst`.
`boolean`	`isIdentity ()` Returns `true` if this `AffineTransform` is an identity transform.
`void`	`preConcatenate (AffineTransform Tx)` Concatenates an `AffineTransform` `Tx` to this `AffineTransform` Cx in a less commonly used way such that `Tx` modifies the coordinate transformation relative to the absolute pixel space rather than relative to the existing user space.
`void`	`rotate (double theta)` Concatenates this transform with a rotation transformation.
`void`	`rotate (double theta, double x, double y)` Concatenates this transform with a transform that rotates coordinates around an anchor point.
`void`	`scale (double sx, double sy)` Concatenates this transform with a scaling transformation.
`void`	`setToIdentity ()` Resets this transform to the Identity transform.
`void`	`setToRotation (double theta)` Sets this transform to a rotation transformation.
`void`	`setToRotation (double theta, double x, double y)` Sets this transform to a translated rotation transformation.
`void`	`setToScale (double sx, double sy)` Sets this transform to a scaling transformation.
`void`	`setToShear (double shx, double shy)` Sets this transform to a shearing transformation.
`void`	`setToTranslation (double tx, double ty)` Sets this transform to a translation transformation.
`void`	`setTransform (AffineTransform Tx)` Sets this transform to a copy of the transform in the specified `AffineTransform` object.
`void`	`setTransform (double m00, double m10, double m01, double m11, double m02, double m12)` Sets this transform to the matrix specified by the 6 double precision values.
`void`	`shear (double shx, double shy)` Concatenates this transform with a shearing transformation.
`String`	`toString ()` Returns a `String` that represents the value of this `Object` .
`void`	`transform (double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Transforms an array of double precision coordinates by this transform.
`void`	`transform (double[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts)` Transforms an array of double precision coordinates by this transform and stores the results into an array of floats.
`void`	`transform (float[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Transforms an array of floating point coordinates by this transform and stores the results into an array of doubles.
`void`	`transform (float[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts)` Transforms an array of floating point coordinates by this transform.
`void`	`transform (Point2D [] ptSrc, int srcOff, Point2D [] ptDst, int dstOff, int numPts)` Transforms an array of point objects by this transform.
`Point2D`	`transform (Point2D ptSrc, Point2D ptDst)` Transforms the specified `ptSrc` and stores the result in `ptDst`.
`void`	`translate (double tx, double ty)` Concatenates this transform with a translation transformation.

Methods inherited from class java.lang.Object
`finalize , getClass , notify , notifyAll , wait , wait , wait`

Field Detail

TYPE_IDENTITY

public static final int TYPE_IDENTITY

This constant indicates that the transform defined by this object is an identity transform. An identity transform is one in which the output coordinates are always the same as the input coordinates. If this transform is anything other than the identity transform, the type will either be the constant GENERAL_TRANSFORM or a combination of the appropriate flag bits for the various coordinate conversions that this transform performs.

See Also:: TYPE_TRANSLATION , TYPE_UNIFORM_SCALE , TYPE_GENERAL_SCALE , TYPE_FLIP , TYPE_QUADRANT_ROTATION , TYPE_GENERAL_ROTATION , TYPE_GENERAL_TRANSFORM , getType() , Constant Field Values

TYPE_TRANSLATION

public static final int TYPE_TRANSLATION

This flag bit indicates that the transform defined by this object performs a translation in addition to the conversions indicated by other flag bits. A translation moves the coordinates by a constant amount in x and y without changing the length or angle of vectors.

See Also:: TYPE_IDENTITY , TYPE_UNIFORM_SCALE , TYPE_GENERAL_SCALE , TYPE_FLIP , TYPE_QUADRANT_ROTATION , TYPE_GENERAL_ROTATION , TYPE_GENERAL_TRANSFORM , getType() , Constant Field Values

TYPE_UNIFORM_SCALE

public static final int TYPE_UNIFORM_SCALE

This flag bit indicates that the transform defined by this object performs a uniform scale in addition to the conversions indicated by other flag bits. A uniform scale multiplies the length of vectors by the same amount in both the x and y directions without changing the angle between vectors. This flag bit is mutually exclusive with the TYPE_GENERAL_SCALE flag.

See Also:: TYPE_IDENTITY , TYPE_TRANSLATION , TYPE_GENERAL_SCALE , TYPE_FLIP , TYPE_QUADRANT_ROTATION , TYPE_GENERAL_ROTATION , TYPE_GENERAL_TRANSFORM , getType() , Constant Field Values

TYPE_GENERAL_SCALE

public static final int TYPE_GENERAL_SCALE

This flag bit indicates that the transform defined by this object performs a general scale in addition to the conversions indicated by other flag bits. A general scale multiplies the length of vectors by different amounts in the x and y directions without changing the angle between perpendicular vectors. This flag bit is mutually exclusive with the TYPE_UNIFORM_SCALE flag.

See Also:: TYPE_IDENTITY , TYPE_TRANSLATION , TYPE_UNIFORM_SCALE , TYPE_FLIP ,

java.awt.geom Class AffineTransform

TYPE_IDENTITY

TYPE_TRANSLATION

TYPE_UNIFORM_SCALE

TYPE_GENERAL_SCALE

java.awt.geom
Class AffineTransform