AffineTransform JDK 1.6)

public Object clone ()

Returns a copy of this AffineTransform object.

Returns a copy of this AffineTransform object.
Returns: an Object that is a copy of this AffineTransform object.
Since: 1.2

public 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.

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.
Cx is updated to perform the combined transformation.
Transforming a point p by the updated transform Cx' is
equivalent to first transforming p by Tx and then
transforming the result by the original transform Cx like this:
Cx'(p) = Cx(Tx(p))
In matrix notation, if this transform Cx is
represented by the matrix [this] and Tx is represented
by the matrix [Tx] then this method does the following:


                [this] = [this] x [Tx]

Parameters:
- Tx - the AffineTransform object to be concatenated with this AffineTransform object.
Since: 1.2
See Also: AffineTransform.preConcatenate(java.awt.geom.AffineTransform),

public AffineTransform createInverse () throws NoninvertibleTransformException

Returns an AffineTransform object representing the inverse transformation.

Returns an AffineTransform object representing the inverse transformation. The inverse transform Tx' of this transform Tx maps coordinates transformed by Tx back to their original coordinates. In other words, Tx'(Tx(p)) = p = Tx(Tx'(p)).

If this transform maps all coordinates onto a point or a line then it will not have an inverse, since coordinates that do not lie on the destination point or line will not have an inverse mapping. The getDeterminant method can be used to determine if this transform has no inverse, in which case an exception will be thrown if the createInverse method is called.
Returns: a new AffineTransform object representing the inverse transformation.
Throws:
- NoninvertibleTransformException - if the matrix cannot be inverted.
Since: 1.2
See Also: AffineTransform.getDeterminant(),

public 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.

Returns a new Shape object defined by the geometry of the
specified Shape after it has been transformed by
this transform.
Returns: a new Shape object that defines the geometry of the transformed Shape, or null if {@code pSrc} is null.
Parameters:
- pSrc - the specified Shape object to be transformed by this transform.
Since: 1.2

public void deltaTransform (double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)

Transforms an array of relative distance vectors by this transform.

Transforms an array of relative distance vectors by this
transform.
A relative distance vector is transformed without applying the
translation components of the affine transformation matrix
using the following equations:


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

The two coordinate array sections can be exactly the same or
can be overlapping sections of the same array without affecting the
validity of the results.
This method ensures that no source coordinates are
overwritten by a previous operation before they can be transformed.
The coordinates are stored in the arrays starting at the indicated
offset in the order [x0, y0, x1, y1, ..., xn, yn].
Parameters:
- srcPts - the array containing the source distance vectors. Each vector is stored as a pair of relative x, y coordinates.
- dstPts - the array into which the transformed distance vectors are returned. Each vector is stored as a pair of relative x, y coordinates.
- srcOff - the offset to the first vector to be transformed in the source array
- dstOff - the offset to the location of the first transformed vector that is stored in the destination array
- numPts - the number of vector coordinate pairs to be transformed
Since: 1.2

public Point2D deltaTransform (Point2D ptSrc, Point2D ptDst)

Transforms the relative distance vector specified by ptSrc and stores the result in ptDst.

Transforms the relative distance vector specified by
ptSrc and stores the result in ptDst.
A relative distance vector is transformed without applying the
translation components of the affine transformation matrix
using the following equations:


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

If ptDst is null, a new
Point2D object is allocated and then the result of the
transform is stored in this object.
In either case, ptDst, which contains the
transformed point, is returned for convenience.
If ptSrc and ptDst are the same object,
the input point is correctly overwritten with the transformed
point.
Returns: ptDst, which contains the result of the transformation.
Parameters:
- ptSrc - the distance vector to be delta transformed
- ptDst - the resulting transformed distance vector
Since: 1.2

public boolean equals (Object obj)

Returns true if this AffineTransform represents the same affine coordinate transform as the specified argument.

Returns true if this AffineTransform
represents the same affine coordinate transform as the specified
argument.
Returns: true if obj equals this AffineTransform object; false otherwise.
Parameters:
- obj - the Object to test for equality with this AffineTransform
Since: 1.2

public double getDeterminant ()

Returns the determinant of the matrix representation of the transform.

Returns the determinant of the matrix representation of the transform. The determinant is useful both to determine if the transform can be inverted and to get a single value representing the combined X and Y scaling of the transform.

If the determinant is non-zero, then this transform is invertible and the various methods that depend on the inverse transform do not need to throw a NoninvertibleTransformException. If the determinant is zero then this transform can not be inverted since the transform maps all input coordinates onto a line or a point. If the determinant is near enough to zero then inverse transform operations might not carry enough precision to produce meaningful results.

If this transform represents a uniform scale, as indicated by the getType method then the determinant also represents the square of the uniform scale factor by which all of the points are expanded from or contracted towards the origin. If this transform represents a non-uniform scale or more general transform then the determinant is not likely to represent a value useful for any purpose other than determining if inverse transforms are possible.

Mathematically, the determinant is calculated using the formula:

                |  m00  m01  m02  |
                |  m10  m11  m12  |  =  m00 * m11 - m01 * m10
                |   0    0    1   |

Returns: the determinant of the matrix used to transform the coordinates.
Since: 1.2
See Also: AffineTransform.getType(), AffineTransform.createInverse(), AffineTransform.inverseTransform(java.awt.geom.Point2D, java.awt.geom.Point2D), AffineTransform.TYPE_UNIFORM_SCALE,

public 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.

publicstatic AffineTransform getQuadrantRotateInstance (int numquadrants)

Returns a transform that rotates coordinates by the specified number of quadrants.

Returns a transform that rotates coordinates by the specified
number of quadrants.
This operation is equivalent to calling:


     AffineTransform.getRotateInstance(numquadrants * Math.PI / 2.0);

Rotating by a positive number of quadrants rotates points on
the positive X axis toward the positive Y axis.
Returns: an AffineTransform object that rotates coordinates by the specified number of quadrants.
Parameters:
- numquadrants - the number of 90 degree arcs to rotate by
Since: 1.6

publicstatic AffineTransform getQuadrantRotateInstance (int numquadrants, double anchorx, double anchory)

Returns a transform that rotates coordinates by the specified number of quadrants around the specified anchor point.

Returns a transform that rotates coordinates by the specified
number of quadrants around the specified anchor point.
This operation is equivalent to calling:


     AffineTransform.getRotateInstance(numquadrants * Math.PI / 2.0,
                                       anchorx, anchory);

Rotating by a positive number of quadrants rotates points on
the positive X axis toward the positive Y axis.
Returns: an AffineTransform object that rotates coordinates by the specified number of quadrants around the specified anchor point.
Parameters:
- numquadrants - the number of 90 degree arcs to rotate by
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.6

publicstatic AffineTransform getRotateInstance (double theta)

Returns a transform representing a rotation transformation.

Returns a transform representing a rotation transformation.
The matrix representing the returned transform is:


                [   cos(theta)    -sin(theta)    0   ]
                [   sin(theta)     cos(theta)    0   ]
                [       0              0         1   ]

Rotating by a positive angle theta rotates points on the positive
X axis toward the positive Y axis.
Note also the discussion of
Handling 90-Degree Rotations
above.
Returns: an AffineTransform object that is a rotation transformation, created with the specified angle of rotation.
Parameters:
- theta - the angle of rotation measured in radians
Since: 1.2

publicstatic AffineTransform getRotateInstance (double vecx, double vecy)

Returns a transform that rotates coordinates according to a rotation vector.

Returns a transform that rotates coordinates according to
a rotation vector.
All coordinates rotate about the origin by the same amount.
The amount of rotation is such that coordinates along the former
positive X axis will subsequently align with the vector pointing
from the origin to the specified vector coordinates.
If both vecx and vecy are 0.0,
an identity transform is returned.
This operation is equivalent to calling:


     AffineTransform.getRotateInstance(Math.atan2(vecy, vecx));

Returns: an AffineTransform object that rotates coordinates according to the specified rotation vector.
Parameters:
- vecx - the X coordinate of the rotation vector
- vecy - the Y coordinate of the rotation vector
Since: 1.6

publicstatic AffineTransform getRotateInstance (double theta, double anchorx, double anchory)

Returns a transform that rotates coordinates around an anchor point.

Returns a transform that rotates coordinates around an anchor point. This operation is equivalent to translating the coordinates so that the anchor point is at the origin (S1), then rotating them about the new origin (S2), and finally translating so that the intermediate origin is restored to the coordinates of the original anchor point (S3).

This operation is equivalent to the following sequence of calls:

     AffineTransform Tx = new AffineTransform();
     Tx.translate(anchorx, anchory);    // S3: final translation
     Tx.rotate(theta);                // S2: rotate around anchor
     Tx.translate(-anchorx, -anchory);  // S1: translate anchor to origin

The matrix representing the returned transform is:

                [   cos(theta)    -sin(theta)    x-x*cos+y*sin  ]
                [   sin(theta)     cos(theta)    y-x*sin-y*cos  ]
                [       0              0               1        ]

Rotating by a positive angle theta rotates points on the positive X axis toward the positive Y axis. Note also the discussion of Handling 90-Degree Rotations above.
Returns: an AffineTransform object that rotates coordinates around the specified point by the specified angle of rotation.
Parameters:
- theta - the angle of rotation measured in radians
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.2

publicstatic AffineTransform getRotateInstance (double vecx, double vecy, double anchorx, double anchory)

Returns a transform that rotates coordinates around an anchor point accordinate to a rotation vector.

Returns a transform that rotates coordinates around an anchor
point accordinate to a rotation vector.
All coordinates rotate about the specified anchor coordinates
by the same amount.
The amount of rotation is such that coordinates along the former
positive X axis will subsequently align with the vector pointing
from the origin to the specified vector coordinates.
If both vecx and vecy are 0.0,
an identity transform is returned.
This operation is equivalent to calling:


     AffineTransform.getRotateInstance(Math.atan2(vecy, vecx),
                                       anchorx, anchory);

Returns: an AffineTransform object that rotates coordinates around the specified point according to the specified rotation vector.
Parameters:
- vecx - the X coordinate of the rotation vector
- vecy - the Y coordinate of the rotation vector
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.6

publicstatic AffineTransform getScaleInstance (double sx, double sy)

Returns a transform representing a scaling transformation.

Returns a transform representing a scaling transformation.
The matrix representing the returned transform is:


                [   sx   0    0   ]
                [   0    sy   0   ]
                [   0    0    1   ]

Returns: an AffineTransform object that scales coordinates by the specified factors.
Parameters:
- sx - the factor by which coordinates are scaled along the X axis direction
- sy - the factor by which coordinates are scaled along the Y axis direction
Since: 1.2

public double getScaleX ()

Returns the X coordinate scaling element (m00) of the 3x3 affine transformation matrix.

public double getScaleY ()

Returns the Y coordinate scaling element (m11) of the 3x3 affine transformation matrix.

publicstatic AffineTransform getShearInstance (double shx, double shy)

Returns a transform representing a shearing transformation.

Returns a transform representing a shearing transformation.
The matrix representing the returned transform is:


                [   1   shx   0   ]
                [  shy   1    0   ]
                [   0    0    1   ]

Returns: an AffineTransform object that shears coordinates by the specified multipliers.
Parameters:
- shx - the multiplier by which coordinates are shifted in the direction of the positive X axis as a factor of their Y coordinate
- shy - the multiplier by which coordinates are shifted in the direction of the positive Y axis as a factor of their X coordinate
Since: 1.2

public double getShearX ()

Returns the X coordinate shearing element (m01) of the 3x3 affine transformation matrix.

public double getShearY ()

Returns the Y coordinate shearing element (m10) of the 3x3 affine transformation matrix.

publicstatic AffineTransform getTranslateInstance (double tx, double ty)

Returns a transform representing a translation transformation.

Returns a transform representing a translation transformation.
The matrix representing the returned transform is:


                [   1    0    tx  ]
                [   0    1    ty  ]
                [   0    0    1   ]

Returns: an AffineTransform object that represents a translation transformation, created with the specified vector.
Parameters:
- tx - the distance by which coordinates are translated in the X axis direction
- ty - the distance by which coordinates are translated in the Y axis direction
Since: 1.2

public double getTranslateX ()

Returns the X coordinate of the translation element (m02) of the 3x3 affine transformation matrix.

public double getTranslateY ()

Returns the Y coordinate of the translation element (m12) of the 3x3 affine transformation matrix.

public int getType ()

Retrieves the flag bits describing the conversion properties of this transform.

public int hashCode ()

Returns the hashcode for this transform.

public void inverseTransform (double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts) throws NoninvertibleTransformException

Inverse transforms an array of double precision coordinates by this transform.

Inverse transforms an array of double precision coordinates by
this transform.
The two coordinate array sections can be exactly the same or
can be overlapping sections of the same array without affecting the
validity of the results.
This method ensures that no source coordinates are
overwritten by a previous operation before they can be transformed.
The coordinates are stored in the arrays starting at the specified
offset in the order [x0, y0, x1, y1, ..., xn, yn].
Parameters:
- srcPts - the array containing the source point coordinates. Each point is stored as a pair of x, y coordinates.
- dstPts - the array into which the transformed point coordinates are returned. Each point is stored as a pair of x, y coordinates.
- srcOff - the offset to the first point to be transformed in the source array
- dstOff - the offset to the location of the first transformed point that is stored in the destination array
- numPts - the number of point objects to be transformed
Throws:
- NoninvertibleTransformException - if the matrix cannot be inverted.
Since: 1.2

public Point2D inverseTransform (Point2D ptSrc, Point2D ptDst) throws NoninvertibleTransformException

Inverse transforms the specified ptSrc and stores the result in ptDst.

Inverse transforms the specified ptSrc and stores the
result in ptDst.
If ptDst is null, a new
Point2D object is allocated and then the result of the
transform is stored in this object.
In either case, ptDst, which contains the transformed
point, is returned for convenience.
If ptSrc and ptDst are the same
object, the input point is correctly overwritten with the
transformed point.
Returns: ptDst, which contains the result of the inverse transform.
Parameters:
- ptSrc - the point to be inverse transformed
- ptDst - the resulting transformed point
Throws:
- NoninvertibleTransformException - if the matrix cannot be inverted.
Since: 1.2

public void invert () throws NoninvertibleTransformException

Sets this transform to the inverse of itself.

public boolean isIdentity ()

Returns true if this AffineTransform is an identity transform.

Returns true if this AffineTransform is
an identity transform.
Returns: true if this AffineTransform is an identity transform; false otherwise.
Since: 1.2

public 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.

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.
Cx is updated to perform the combined transformation.
Transforming a point p by the updated transform Cx' is
equivalent to first transforming p by the original transform
Cx and then transforming the result by
Tx like this:
Cx'(p) = Tx(Cx(p))
In matrix notation, if this transform Cx
is represented by the matrix [this] and Tx is
represented by the matrix [Tx] then this method does the
following:


                [this] = [Tx] x [this]

Parameters:
- Tx - the AffineTransform object to be concatenated with this AffineTransform object.
Since: 1.2
See Also: AffineTransform.concatenate(java.awt.geom.AffineTransform),

public void quadrantRotate (int numquadrants)

Concatenates this transform with a transform that rotates coordinates by the specified number of quadrants.

Concatenates this transform with a transform that rotates
coordinates by the specified number of quadrants.
This is equivalent to calling:


     rotate(numquadrants * Math.PI / 2.0);

Rotating by a positive number of quadrants rotates points on
the positive X axis toward the positive Y axis.
Parameters:
- numquadrants - the number of 90 degree arcs to rotate by
Since: 1.6

public void quadrantRotate (int numquadrants, double anchorx, double anchory)

Concatenates this transform with a transform that rotates coordinates by the specified number of quadrants around the specified anchor point.

Concatenates this transform with a transform that rotates
coordinates by the specified number of quadrants around
the specified anchor point.
This method is equivalent to calling:


     rotate(numquadrants * Math.PI / 2.0, anchorx, anchory);

Rotating by a positive number of quadrants rotates points on
the positive X axis toward the positive Y axis.
Parameters:
- numquadrants - the number of 90 degree arcs to rotate by
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.6

public void rotate (double theta)

Concatenates this transform with a rotation transformation.

Concatenates this transform with a rotation transformation.
This is equivalent to calling concatenate(R), where R is an
AffineTransform represented by the following matrix:


                [   cos(theta)    -sin(theta)    0   ]
                [   sin(theta)     cos(theta)    0   ]
                [       0              0         1   ]

Rotating by a positive angle theta rotates points on the positive
X axis toward the positive Y axis.
Note also the discussion of
Handling 90-Degree Rotations
above.
Parameters:
- theta - the angle of rotation measured in radians
Since: 1.2

public void rotate (double vecx, double vecy)

Concatenates this transform with a transform that rotates coordinates according to a rotation vector.

Concatenates this transform with a transform that rotates
coordinates according to a rotation vector.
All coordinates rotate about the origin by the same amount.
The amount of rotation is such that coordinates along the former
positive X axis will subsequently align with the vector pointing
from the origin to the specified vector coordinates.
If both vecx and vecy are 0.0,
no additional rotation is added to this transform.
This operation is equivalent to calling:


          rotate(Math.atan2(vecy, vecx));

Parameters:
- vecx - the X coordinate of the rotation vector
- vecy - the Y coordinate of the rotation vector
Since: 1.6

public void rotate (double theta, double anchorx, double anchory)

Concatenates this transform with a transform that rotates coordinates around an anchor point.

Concatenates this transform with a transform that rotates coordinates around an anchor point. This operation is equivalent to translating the coordinates so that the anchor point is at the origin (S1), then rotating them about the new origin (S2), and finally translating so that the intermediate origin is restored to the coordinates of the original anchor point (S3).

This operation is equivalent to the following sequence of calls:

     translate(anchorx, anchory);      // S3: final translation
     rotate(theta);                    // S2: rotate around anchor
     translate(-anchorx, -anchory);    // S1: translate anchor to origin

Rotating by a positive angle theta rotates points on the positive X axis toward the positive Y axis. Note also the discussion of Handling 90-Degree Rotations above.
Parameters:
- theta - the angle of rotation measured in radians
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.2

public void rotate (double vecx, double vecy, double anchorx, double anchory)

Concatenates this transform with a transform that rotates coordinates around an anchor point according to a rotation vector.

Concatenates this transform with a transform that rotates
coordinates around an anchor point according to a rotation
vector.
All coordinates rotate about the specified anchor coordinates
by the same amount.
The amount of rotation is such that coordinates along the former
positive X axis will subsequently align with the vector pointing
from the origin to the specified vector coordinates.
If both vecx and vecy are 0.0,
the transform is not modified in any way.
This method is equivalent to calling:


     rotate(Math.atan2(vecy, vecx), anchorx, anchory);

Parameters:
- vecx - the X coordinate of the rotation vector
- vecy - the Y coordinate of the rotation vector
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.6

public void scale (double sx, double sy)

Concatenates this transform with a scaling transformation.

Concatenates this transform with a scaling transformation.
This is equivalent to calling concatenate(S), where S is an
AffineTransform represented by the following matrix:


                [   sx   0    0   ]
                [   0    sy   0   ]
                [   0    0    1   ]

Parameters:
- sx - the factor by which coordinates are scaled along the X axis direction
- sy - the factor by which coordinates are scaled along the Y axis direction
Since: 1.2

public void setToIdentity ()

Resets this transform to the Identity transform.

public void setToQuadrantRotation (int numquadrants)

Sets this transform to a rotation transformation that rotates coordinates by the specified number of quadrants.

Sets this transform to a rotation transformation that rotates
coordinates by the specified number of quadrants.
This operation is equivalent to calling:


     setToRotation(numquadrants * Math.PI / 2.0);

Rotating by a positive number of quadrants rotates points on
the positive X axis toward the positive Y axis.
Parameters:
- numquadrants - the number of 90 degree arcs to rotate by
Since: 1.6

public void setToQuadrantRotation (int numquadrants, double anchorx, double anchory)

Sets this transform to a translated rotation transformation that rotates coordinates by the specified number of quadrants around the specified anchor point.

Sets this transform to a translated rotation transformation
that rotates coordinates by the specified number of quadrants
around the specified anchor point.
This operation is equivalent to calling:


     setToRotation(numquadrants * Math.PI / 2.0, anchorx, anchory);

Rotating by a positive number of quadrants rotates points on
the positive X axis toward the positive Y axis.
Parameters:
- numquadrants - the number of 90 degree arcs to rotate by
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.6

public void setToRotation (double theta)

Sets this transform to a rotation transformation.

Sets this transform to a rotation transformation.
The matrix representing this transform becomes:


                [   cos(theta)    -sin(theta)    0   ]
                [   sin(theta)     cos(theta)    0   ]
                [       0              0         1   ]

Rotating by a positive angle theta rotates points on the positive
X axis toward the positive Y axis.
Note also the discussion of
Handling 90-Degree Rotations
above.
Parameters:
- theta - the angle of rotation measured in radians
Since: 1.2

public void setToRotation (double vecx, double vecy)

Sets this transform to a rotation transformation that rotates coordinates according to a rotation vector.

Sets this transform to a rotation transformation that rotates
coordinates according to a rotation vector.
All coordinates rotate about the origin by the same amount.
The amount of rotation is such that coordinates along the former
positive X axis will subsequently align with the vector pointing
from the origin to the specified vector coordinates.
If both vecx and vecy are 0.0,
the transform is set to an identity transform.
This operation is equivalent to calling:


     setToRotation(Math.atan2(vecy, vecx));

Parameters:
- vecx - the X coordinate of the rotation vector
- vecy - the Y coordinate of the rotation vector
Since: 1.6

public void setToRotation (double theta, double anchorx, double anchory)

Sets this transform to a translated rotation transformation.

Sets this transform to a translated rotation transformation. This operation is equivalent to translating the coordinates so that the anchor point is at the origin (S1), then rotating them about the new origin (S2), and finally translating so that the intermediate origin is restored to the coordinates of the original anchor point (S3).

This operation is equivalent to the following sequence of calls:

     setToTranslation(anchorx, anchory); // S3: final translation
     rotate(theta);                      // S2: rotate around anchor
     translate(-anchorx, -anchory);      // S1: translate anchor to origin

The matrix representing this transform becomes:

                [   cos(theta)    -sin(theta)    x-x*cos+y*sin  ]
                [   sin(theta)     cos(theta)    y-x*sin-y*cos  ]
                [       0              0               1        ]

Rotating by a positive angle theta rotates points on the positive X axis toward the positive Y axis. Note also the discussion of Handling 90-Degree Rotations above.
Parameters:
- theta - the angle of rotation measured in radians
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.2

public void setToRotation (double vecx, double vecy, double anchorx, double anchory)

Sets this transform to a rotation transformation that rotates coordinates around an anchor point according to a rotation vector.

Sets this transform to a rotation transformation that rotates
coordinates around an anchor point according to a rotation
vector.
All coordinates rotate about the specified anchor coordinates
by the same amount.
The amount of rotation is such that coordinates along the former
positive X axis will subsequently align with the vector pointing
from the origin to the specified vector coordinates.
If both vecx and vecy are 0.0,
the transform is set to an identity transform.
This operation is equivalent to calling:


     setToTranslation(Math.atan2(vecy, vecx), anchorx, anchory);

Parameters:
- vecx - the X coordinate of the rotation vector
- vecy - the Y coordinate of the rotation vector
- anchorx - the X coordinate of the rotation anchor point
- anchory - the Y coordinate of the rotation anchor point
Since: 1.6

public void setToScale (double sx, double sy)

Sets this transform to a scaling transformation.

Sets this transform to a scaling transformation.
The matrix representing this transform becomes:


                [   sx   0    0   ]
                [   0    sy   0   ]
                [   0    0    1   ]

Parameters:
- sx - the factor by which coordinates are scaled along the X axis direction
- sy - the factor by which coordinates are scaled along the Y axis direction
Since: 1.2

public void setToShear (double shx, double shy)

Sets this transform to a shearing transformation.

Sets this transform to a shearing transformation.
The matrix representing this transform becomes:


                [   1   shx   0   ]
                [  shy   1    0   ]
                [   0    0    1   ]

Parameters:
- shx - the multiplier by which coordinates are shifted in the direction of the positive X axis as a factor of their Y coordinate
- shy - the multiplier by which coordinates are shifted in the direction of the positive Y axis as a factor of their X coordinate
Since: 1.2

public void setToTranslation (double tx, double ty)

Sets this transform to a translation transformation.

Sets this transform to a translation transformation.
The matrix representing this transform becomes:


                [   1    0    tx  ]
                [   0    1    ty  ]
                [   0    0    1   ]

Parameters:
- tx - the distance by which coordinates are translated in the X axis direction
- ty - the distance by which coordinates are translated in the Y axis direction
Since: 1.2

public void setTransform (AffineTransform Tx)

Sets this transform to a copy of the transform in the specified AffineTransform object.

Sets this transform to a copy of the transform in the specified
AffineTransform object.
Parameters:
- Tx - the AffineTransform object from which to copy the transform
Since: 1.2

public 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.

public void shear (double shx, double shy)

Concatenates this transform with a shearing transformation.

Concatenates this transform with a shearing transformation.
This is equivalent to calling concatenate(SH), where SH is an
AffineTransform represented by the following matrix:


                [   1   shx   0   ]
                [  shy   1    0   ]
                [   0    0    1   ]

Parameters:
- shx - the multiplier by which coordinates are shifted in the direction of the positive X axis as a factor of their Y coordinate
- shy - the multiplier by which coordinates are shifted in the direction of the positive Y axis as a factor of their X coordinate
Since: 1.2

public String toString ()

Returns a String that represents the value of this Object.

Returns a String that represents the value of this
Object.
Returns: a String representing the value of this Object.
Since: 1.2

public void transform (double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)

Transforms an array of double precision coordinates by this transform.

Transforms an array of double precision coordinates by this transform.
The two coordinate array sections can be exactly the same or
can be overlapping sections of the same array without affecting the
validity of the results.
This method ensures that no source coordinates are
overwritten by a previous operation before they can be transformed.
The coordinates are stored in the arrays starting at the indicated
offset in the order [x0, y0, x1, y1, ..., xn, yn].
Parameters:
- srcPts - the array containing the source point coordinates. Each point is stored as a pair of x, y coordinates.
- dstPts - the array into which the transformed point coordinates are returned. Each point is stored as a pair of x, y coordinates.
- srcOff - the offset to the first point to be transformed in the source array
- dstOff - the offset to the location of the first transformed point that is stored in the destination array
- numPts - the number of point objects to be transformed
Since: 1.2

public 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.

Transforms an array of double precision coordinates by this transform
and stores the results into an array of floats.
The coordinates are stored in the arrays starting at the specified
offset in the order [x0, y0, x1, y1, ..., xn, yn].
Parameters:
- srcPts - the array containing the source point coordinates. Each point is stored as a pair of x, y coordinates.
- dstPts - the array into which the transformed point coordinates are returned. Each point is stored as a pair of x, y coordinates.
- srcOff - the offset to the first point to be transformed in the source array
- dstOff - the offset to the location of the first transformed point that is stored in the destination array
- numPts - the number of point objects to be transformed
Since: 1.2

public 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.

Transforms an array of floating point coordinates by this transform
and stores the results into an array of doubles.
The coordinates are stored in the arrays starting at the specified
offset in the order [x0, y0, x1, y1, ..., xn, yn].
Parameters:
- srcPts - the array containing the source point coordinates. Each point is stored as a pair of x, y coordinates.
- dstPts - the array into which the transformed point coordinates are returned. Each point is stored as a pair of x, y coordinates.
- srcOff - the offset to the first point to be transformed in the source array
- dstOff - the offset to the location of the first transformed point that is stored in the destination array
- numPts - the number of points to be transformed
Since: 1.2

public void transform (float[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts)

Transforms an array of floating point coordinates by this transform.

Transforms an array of floating point coordinates by this transform.
The two coordinate array sections can be exactly the same or
can be overlapping sections of the same array without affecting the
validity of the results.
This method ensures that no source coordinates are overwritten by a
previous operation before they can be transformed.
The coordinates are stored in the arrays starting at the specified
offset in the order [x0, y0, x1, y1, ..., xn, yn].
Parameters:
- srcPts - the array containing the source point coordinates. Each point is stored as a pair of x, y coordinates.
- dstPts - the array into which the transformed point coordinates are returned. Each point is stored as a pair of x, y coordinates.
- srcOff - the offset to the first point to be transformed in the source array
- dstOff - the offset to the location of the first transformed point that is stored in the destination array
- numPts - the number of points to be transformed
Since: 1.2

public void transform (Point2D ptSrc, int srcOff, Point2D ptDst, int dstOff, int numPts)

Transforms an array of point objects by this transform.

Transforms an array of point objects by this transform. If any element of the ptDst array is null, a new Point2D object is allocated and stored into that element before storing the results of the transformation.

Note that this method does not take any precautions to avoid problems caused by storing results into Point2D objects that will be used as the source for calculations further down the source array. This method does guarantee that if a specified Point2D object is both the source and destination for the same single point transform operation then the results will not be stored until the calculations are complete to avoid storing the results on top of the operands. If, however, the destination Point2D object for one operation is the same object as the source Point2D object for another operation further down the source array then the original coordinates in that point are overwritten before they can be converted.
Parameters:
- ptSrc - the array containing the source point objects
- ptDst - the array into which the transform point objects are returned
- srcOff - the offset to the first point object to be transformed in the source array
- dstOff - the offset to the location of the first transformed point object that is stored in the destination array
- numPts - the number of point objects to be transformed
Since: 1.2

public Point2D transform (Point2D ptSrc, Point2D ptDst)

Transforms the specified ptSrc and stores the result in ptDst.

Transforms the specified ptSrc and stores the result
in ptDst.
If ptDst is null, a new Point2D
object is allocated and then the result of the transformation is
stored in this object.
In either case, ptDst, which contains the
transformed point, is returned for convenience.
If ptSrc and ptDst are the same
object, the input point is correctly overwritten with
the transformed point.
Returns: the ptDst after transforming ptSrc and stroring the result in ptDst.
Parameters:
- ptSrc - the specified Point2D to be transformed
- ptDst - the specified Point2D that stores the result of transforming ptSrc
Since: 1.2

public void translate (double tx, double ty)

Concatenates this transform with a translation transformation.

Concatenates this transform with a translation transformation.
This is equivalent to calling concatenate(T), where T is an
AffineTransform represented by the following matrix:


                [   1    0    tx  ]
                [   0    1    ty  ]
                [   0    0    1   ]

Parameters:
- tx - the distance by which coordinates are translated in the X axis direction
- ty - the distance by which coordinates are translated in the Y axis direction
Since: 1.2

pack-private void updateState ()

Manually recalculates the state of the transform when the matrix changes too much to predict the effects on the state.

Manually recalculates the state of the transform when the matrix
changes too much to predict the effects on the state.
The following table specifies what the various settings of the
state field say about the values of the corresponding matrix
element fields.
Note that the rules governing the SCALE fields are slightly
different depending on whether the SHEAR flag is also set.


                     SCALE            SHEAR          TRANSLATE
                    m00/m11          m01/m10          m02/m12

 IDENTITY             1.0              0.0              0.0
 TRANSLATE (TR)       1.0              0.0          not both 0.0
 SCALE (SC)       not both 1.0         0.0              0.0
 TR | SC          not both 1.0         0.0          not both 0.0
 SHEAR (SH)           0.0          not both 0.0         0.0
 TR | SH              0.0          not both 0.0     not both 0.0
 SC | SH          not both 0.0     not both 0.0         0.0
 TR | SC | SH     not both 0.0     not both 0.0     not both 0.0