| java.lang.Object
 org.awt.geom.AffineTransform
| AffineTransform | | public class AffineTransform (Code) | | 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 ]
|
| Field Summary | |
| final static int | APPLY_IDENTITY
This constant is used for the internal state variable to indicate
that no calculations need to be performed and that the source
coordinates only need to be copied to their destinations to
complete the transformation equation of this transform. | | final static int | APPLY_SCALE
This constant is used for the internal state variable to indicate
that the scaling components of the matrix (m00 and m11) need
to be factored in to complete the transformation equation of
this transform. | | final static int | APPLY_SHEAR
This constant is used for the internal state variable to indicate
that the shearing components of the matrix (m01 and m10) need
to be factored in to complete the transformation equation of this
transform. | | final static int | APPLY_TRANSLATE
This constant is used for the internal state variable to indicate
that the translation components of the matrix (m02 and m12) need
to be added to complete the transformation equation of this transform. | | final public 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. | | final public 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. | | final public 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. | | final public static int | TYPE_GENERAL_TRANSFORM
This constant indicates that the transform defined by this object
performs an arbitrary conversion of the input coordinates. | | final public static int | TYPE_IDENTITY
This constant indicates that the transform defined by this object
is an identity transform. | | final public static int | TYPE_MASK_ROTATION
This constant is a bit mask for any of the rotation flag bits. | | final public static int | TYPE_MASK_SCALE
This constant is a bit mask for any of the scale flag bits. | | final public 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. | | final public 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. | | final public 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. | | double | m00
The X coordinate scaling element of the 3x3
affine transformation matrix. | | double | m01
The X coordinate shearing element of the 3x3
affine transformation matrix. | | double | m02
The X coordinate of the translation element of the
3x3 affine transformation matrix. | | double | m10
The Y coordinate shearing element of the 3x3
affine transformation matrix. | | double | m11
The Y coordinate scaling element of the 3x3
affine transformation matrix. | | double | m12
The Y coordinate of the translation element of the
3x3 affine transformation matrix. | | transient int | state
This field keeps track of which components of the matrix need to
be applied when performing a transformation. |
| Constructor Summary | |
| public | AffineTransform()
Constructs a new AffineTransform representing the
Identity transformation. | | public | AffineTransform(AffineTransform Tx)
Constructs a new AffineTransform that is a copy of
the specified AffineTransform object. | | public | 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. | | public | 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. | | public | 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. | | public | 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. |
| Method Summary | |
| public Object | clone()
| | 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. | | public AffineTransform | createInverse()
Returns an AffineTransform object representing the
inverse transformation. | | public Shape | createTransformedShape(Shape pSrc)
| | public Point2D | deltaTransform(Point2D ptSrc, Point2D ptDst)
Transforms the relative distance vector specified by
ptSrc and stores the result in ptDst. | | public void | deltaTransform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)
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.
Parameters:
dstPts - the array into which the transformed distance vectorsare returned. | | public boolean | equals(Object obj)
Returns true if this AffineTransform
represents the same affine coordinate transform as the specified
argument. | | public double | getDeterminant()
Returns the determinant of the matrix representation of the transform. | | 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. | | public static AffineTransform | getRotateInstance(double theta)
Returns a transform representing a rotation transformation. | | public static AffineTransform | getRotateInstance(double theta, double x, double y)
Returns a transform that rotates coordinates around an anchor point. | | public static AffineTransform | getScaleInstance(double sx, double sy)
Returns a transform representing a scaling transformation. | | 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. | | public static AffineTransform | getShearInstance(double shx, double shy)
Returns a transform representing a shearing transformation. | | 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. | | public static AffineTransform | getTranslateInstance(double tx, double ty)
Returns a transform representing a translation transformation. | | 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.
a double value that is the Y coordinate of the translationelement of the 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 Point2D | inverseTransform(Point2D ptSrc, Point2D ptDst)
Inverse transforms the specified ptSrc and stores the
result in ptDst. | | public void | inverseTransform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)
Inverse transforms an array of double precision coordinates by
this transform. | | public boolean | isIdentity()
Returns true if this AffineTransform is
an identity transform. | | 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. | | public void | rotate(double theta)
Concatenates this transform with a rotation transformation. | | public void | rotate(double theta, double x, double y)
Concatenates this transform with a transform that rotates
coordinates around an anchor point. | | public void | scale(double sx, double sy)
Concatenates this transform with a scaling transformation. | | public void | setToIdentity()
Resets this transform to the Identity transform. | | public void | setToRotation(double theta)
Sets this transform to a rotation transformation. | | public void | setToRotation(double theta, double x, double y)
Sets this transform to a translated rotation transformation. | | public void | setToScale(double sx, double sy)
Sets this transform to a scaling transformation. | | public void | setToShear(double shx, double shy)
Sets this transform to a shearing transformation. | | public void | setToTranslation(double tx, double ty)
Sets this transform to a translation transformation. | | public void | setTransform(AffineTransform Tx)
Sets this transform to a copy of the transform in the specified
AffineTransform object. | | 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. | | public String | toString()
Returns a String that represents the value of this
Object . | | public Point2D | transform(Point2D ptSrc, Point2D ptDst)
Transforms the specified ptSrc and stores the result
in ptDst. | | public void | transform(Point2D[] ptSrc, int srcOff, Point2D[] ptDst, int dstOff, int numPts)
Transforms an array of point objects by this transform. | | public void | transform(float[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts)
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.
Parameters:
dstPts - the array into which the transformed point coordinatesare returned. | | public void | transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)
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.
Parameters:
dstPts - the array into which the transformed pointcoordinates are returned. | | 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.
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.
Parameters:
dstPts - the array into which the transformed point coordinatesare returned. | | 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.
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.
Parameters:
dstPts - the array into which the transformed pointcoordinates are returned. | | public void | translate(double tx, double ty)
Concatenates this transform with a translation transformation. | | void | updateState()
Manually recalculates the state of the transform when the matrix
changes too much to predict the effects on the state. |
| APPLY_SCALE | | final static int APPLY_SCALE(Code) | | This constant is used for the internal state variable to indicate
that the scaling components of the matrix (m00 and m11) need
to be factored in to complete the transformation equation of
this transform. If the APPLY_SHEAR bit is also set then it
indicates that the scaling components are not both 0.0. If the
APPLY_SHEAR bit is not also set then it indicates that the
scaling components are not both 1.0. If neither the APPLY_SHEAR
nor the APPLY_SCALE bits are set then the scaling components
are both 1.0, which means that the x and y components contribute
to the transformed coordinate, but they are not multiplied by
any scaling factor.
See Also: AffineTransform.APPLY_IDENTITY
See Also: AffineTransform.APPLY_TRANSLATE
See Also: AffineTransform.APPLY_SHEAR
See Also: AffineTransform.state |
| m00 | | double m00(Code) | | The X coordinate scaling element of the 3x3
affine transformation matrix.
|
| m01 | | double m01(Code) | | The X coordinate shearing element of the 3x3
affine transformation matrix.
|
| m02 | | double m02(Code) | | The X coordinate of the translation element of the
3x3 affine transformation matrix.
|
| m10 | | double m10(Code) | | The Y coordinate shearing element of the 3x3
affine transformation matrix.
|
| m11 | | double m11(Code) | | The Y coordinate scaling element of the 3x3
affine transformation matrix.
|
| m12 | | double m12(Code) | | The Y coordinate of the translation element of the
3x3 affine transformation matrix.
|
| AffineTransform | | public AffineTransform()(Code) | | Constructs a new AffineTransform representing the
Identity transformation.
|
| AffineTransform | | public AffineTransform(AffineTransform Tx)(Code) | | Constructs a new AffineTransform that is a copy of
the specified AffineTransform object.
Parameters:
Tx - the AffineTransform object to copy |
| AffineTransform | | public AffineTransform(float m00, float m10, float m01, float m11, float m02, float m12)(Code) | | Constructs a new AffineTransform from 6 floating point
values representing the 6 specifiable entries of the 3x3
transformation matrix.
m00, m01, m02, m10, m11, m12 the 6 floating point values that compose the 3x3 transformation matrix |
| AffineTransform | | public AffineTransform(float[] flatmatrix)(Code) | | 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. The values are retrieved from the array as
{ m00 m10 m01 m11 [m02 m12]}.
Parameters:
flatmatrix - the float array containing the values to be setin the new AffineTransform object. The length of thearray is assumed to be at least 4. If the length of the array is less than 6, only the first 4 values are taken. If the length ofthe array is greater than 6, the first 6 values are taken. |
| AffineTransform | | public AffineTransform(double m00, double m10, double m01, double m11, double m02, double m12)(Code) | | Constructs a new AffineTransform from 6 double
precision values representing the 6 specifiable entries of the 3x3
transformation matrix.
m00, m01, m02, m10, m11, m12 the 6 floating point values that compose the 3x3 transformation matrix |
| AffineTransform | | public AffineTransform(double[] flatmatrix)(Code) | | 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. The values are retrieved from the array as
{ m00 m10 m01 m11 [m02 m12]}.
Parameters:
flatmatrix - the double array containing the values to be setin the new AffineTransform object. The length of thearray is assumed to be at least 4. If the length of the array is less than 6, only the first 4 values are taken. If the length ofthe array is greater than 6, the first 6 values are taken. |
| concatenate | | public void concatenate(AffineTransform Tx)(Code) | | 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 beconcatenated with this AffineTransform object.
See Also: AffineTransform.preConcatenate |
| createInverse | | public AffineTransform createInverse() throws NoninvertibleTransformException(Code) | | 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.
a new AffineTransform object representing theinverse transformation.
See Also: AffineTransform.getDeterminant
exception:
NoninvertibleTransformException - if the matrix cannot be inverted. |
| deltaTransform | | public Point2D deltaTransform(Point2D ptSrc, Point2D ptDst)(Code) | | 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.
Parameters:
ptSrc - the distance vector to be delta transformed
Parameters:
ptDst - the resulting transformed distance vector ptDst, which contains the result of thetransformation. |
| deltaTransform | | public void deltaTransform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)(Code) | | 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.
Parameters:
dstPts - the array into which the transformed distance vectorsare returned. Each vector is stored as a pair of relativex, y coordinates.
Parameters:
srcOff - the offset to the first vector to be transformedin the source array
Parameters:
dstOff - the offset to the location of the firsttransformed vector that is stored in the destination array
Parameters:
numPts - the number of vector coordinate pairs to betransformed |
| equals | | public boolean equals(Object obj)(Code) | | Returns true if this AffineTransform
represents the same affine coordinate transform as the specified
argument.
Parameters:
obj - the Object to test for equality with thisAffineTransform true if obj equals thisAffineTransform object; false otherwise. |
| getDeterminant | | public double getDeterminant()(Code) | | 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 |
the determinant of the matrix used to transform thecoordinates.
See Also: AffineTransform.getType
See Also: AffineTransform.createInverse
See Also: AffineTransform.inverseTransform
See Also: AffineTransform.TYPE_UNIFORM_SCALE |
| getRotateInstance | | public static AffineTransform getRotateInstance(double theta)(Code) | | 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 with a positive angle theta rotates points on the positive
x axis toward the positive y axis.
Parameters:
theta - the angle of rotation in radians an AffineTransform object that is a rotationtransformation, created with the specified angle of rotation. |
| getRotateInstance | | public static AffineTransform getRotateInstance(double theta, double x, double y)(Code) | | 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.setToTranslation(x, y); // S3: final translation
Tx.rotate(theta); // S2: rotate around anchor
Tx.translate(-x, -y); // 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 with a positive angle theta rotates points on the positive
x axis toward the positive y axis.
Parameters:
theta - the angle of rotation in radians x, y the coordinates of the anchor point of therotation an AffineTransform object that rotates coordinates around the specified point by the specified angle ofrotation. |
| getScaleInstance | | public static AffineTransform getScaleInstance(double sx, double sy)(Code) | | Returns a transform representing a scaling transformation.
The matrix representing the returned transform is:
[ sx 0 0 ]
[ 0 sy 0 ]
[ 0 0 1 ]
Parameters:
sx - the factor by which coordinates are scaled along theX axis direction
Parameters:
sy - the factor by which coordinates are scaled along theY axis direction an AffineTransform object that scales coordinates by the specified factors. |
| getScaleX | | public double getScaleX()(Code) | | Returns the X coordinate scaling element (m00) of the 3x3
affine transformation matrix.
a double value that is the X coordinate of the scalingelement of the affine transformation matrix.
See Also: AffineTransform.getMatrix |
| getScaleY | | public double getScaleY()(Code) | | Returns the Y coordinate scaling element (m11) of the 3x3
affine transformation matrix.
a double value that is the Y coordinate of the scalingelement of the affine transformation matrix.
See Also: AffineTransform.getMatrix |
| getShearInstance | | public static AffineTransform getShearInstance(double shx, double shy)(Code) | | Returns a transform representing a shearing transformation.
The matrix representing the returned transform is:
[ 1 shx 0 ]
[ shy 1 0 ]
[ 0 0 1 ]
Parameters:
shx - the multiplier by which coordinates are shifted in thedirection of the positive X axis as a factor of their Y coordinate
Parameters:
shy - the multiplier by which coordinates are shifted in thedirection of the positive Y axis as a factor of their X coordinate an AffineTransform object that shears coordinates by the specified multipliers. |
| getShearX | | public double getShearX()(Code) | | Returns the X coordinate shearing element (m01) of the 3x3
affine transformation matrix.
a double value that is the X coordinate of the shearingelement of the affine transformation matrix.
See Also: AffineTransform.getMatrix |
| getShearY | | public double getShearY()(Code) | | Returns the Y coordinate shearing element (m10) of the 3x3
affine transformation matrix.
a double value that is the Y coordinate of the shearingelement of the affine transformation matrix.
See Also: AffineTransform.getMatrix |
| getTranslateInstance | | public static AffineTransform getTranslateInstance(double tx, double ty)(Code) | | Returns a transform representing a translation transformation.
The matrix representing the returned transform is:
[ 1 0 tx ]
[ 0 1 ty ]
[ 0 0 1 ]
Parameters:
tx - the distance by which coordinates are translated in theX axis direction
Parameters:
ty - the distance by which coordinates are translated in theY axis direction an AffineTransform object that represents atranslation transformation, created with the specified vector. |
| getTranslateX | | public double getTranslateX()(Code) | | Returns the X coordinate of the translation element (m02) of the
3x3 affine transformation matrix.
a double value that is the X coordinate of the translationelement of the affine transformation matrix.
See Also: AffineTransform.getMatrix |
| getTranslateY | | public double getTranslateY()(Code) | | Returns the Y coordinate of the translation element (m12) of the
3x3 affine transformation matrix.
a double value that is the Y coordinate of the translationelement of the affine transformation matrix.
See Also: AffineTransform.getMatrix |
| hashCode | | public int hashCode()(Code) | | Returns the hashcode for this transform.
a hash code for this transform. |
| inverseTransform | | public Point2D inverseTransform(Point2D ptSrc, Point2D ptDst) throws NoninvertibleTransformException(Code) | | 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.
Parameters:
ptSrc - the point to be inverse transformed
Parameters:
ptDst - the resulting transformed point ptDst, which contains the result of the inverse transform.
exception:
NoninvertibleTransformException - if the matrix cannot beinverted. |
| inverseTransform | | public void inverseTransform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts) throws NoninvertibleTransformException(Code) | | 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.
Parameters:
dstPts - the array into which the transformed pointcoordinates are returned. Each point is stored as a pair of x, y coordinates.
Parameters:
srcOff - the offset to the first point to be transformedin the source array
Parameters:
dstOff - the offset to the location of the firsttransformed point that is stored in the destination array
Parameters:
numPts - the number of point objects to be transformed
exception:
NoninvertibleTransformException - if the matrix cannot beinverted. |
| isIdentity | | public boolean isIdentity()(Code) | | Returns true if this AffineTransform is
an identity transform.
true if this AffineTransform isan identity transform; false otherwise. |
| preConcatenate | | public void preConcatenate(AffineTransform Tx)(Code) | | 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 beconcatenated with this AffineTransform object.
See Also: AffineTransform.concatenate |
| rotate | | public void rotate(double theta)(Code) | | 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 with a positive angle theta rotates points on the positive
x axis toward the positive y axis.
Parameters:
theta - the angle of rotation in radians |
| rotate | | public void rotate(double theta, double x, double y)(Code) | | 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(x, y); // S3: final translation
rotate(theta); // S2: rotate around anchor
translate(-x, -y); // S1: translate anchor to origin
Rotating with a positive angle theta rotates points on the positive
x axis toward the positive y axis.
Parameters:
theta - the angle of rotation in radians x, y the coordinates of the anchor point of therotation |
| scale | | public void scale(double sx, double sy)(Code) | | 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
Parameters:
sy - the factor by which coordinates are scaled along theY axis direction |
| setToIdentity | | public void setToIdentity()(Code) | | Resets this transform to the Identity transform.
|
| setToRotation | | public void setToRotation(double theta)(Code) | | 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 with a positive angle theta rotates points on the positive
x axis toward the positive y axis.
Parameters:
theta - the angle of rotation in radians |
| setToRotation | | public void setToRotation(double theta, double x, double y)(Code) | | 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(x, y); // S3: final translation
rotate(theta); // S2: rotate around anchor
translate(-x, -y); // 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 with a positive angle theta rotates points on the positive
x axis toward the positive y axis.
Parameters:
theta - the angle of rotation in radians x, y the coordinates of the anchor point of therotation |
| setToScale | | public void setToScale(double sx, double sy)(Code) | | 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 theX axis direction
Parameters:
sy - the factor by which coordinates are scaled along theY axis direction |
| setToShear | | public void setToShear(double shx, double shy)(Code) | | 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 thedirection of the positive X axis as a factor of their Y coordinate
Parameters:
shy - the multiplier by which coordinates are shifted in thedirection of the positive Y axis as a factor of their X coordinate |
| setToTranslation | | public void setToTranslation(double tx, double ty)(Code) | | 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 theX axis direction
Parameters:
ty - the distance by which coordinates are translated in theY axis direction |
| setTransform | | public void setTransform(AffineTransform Tx)(Code) | | Sets this transform to a copy of the transform in the specified
AffineTransform object.
Parameters:
Tx - the AffineTransform object from which tocopy the transform |
| setTransform | | public void setTransform(double m00, double m10, double m01, double m11, double m02, double m12)(Code) | | Sets this transform to the matrix specified by the 6
double precision values.
m00, m01, m02, m10, m11, m12 the6 floating point values that compose the 3x3 transformation matrix |
| shear | | public void shear(double shx, double shy)(Code) | | 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 thedirection of the positive X axis as a factor of their Y coordinate
Parameters:
shy - the multiplier by which coordinates are shifted in thedirection of the positive Y axis as a factor of their X coordinate |
| toString | | public String toString()(Code) | | Returns a String that represents the value of this
Object .
a String representing the value of thisObject. |
| transform | | public Point2D transform(Point2D ptSrc, Point2D ptDst)(Code) | | 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.
Parameters:
ptSrc - the specified Point2D to be transformed
Parameters:
ptDst - the specified Point2D that stores theresult of transforming ptSrc the ptDst after transformingptSrc and stroring the result in ptDst. |
| transform | | public void transform(Point2D[] ptSrc, int srcOff, Point2D[] ptDst, int dstOff, int numPts)(Code) | | 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
Parameters:
ptDst - the array into which the transform point objects arereturned
Parameters:
srcOff - the offset to the first point object to betransformed in the source array
Parameters:
dstOff - the offset to the location of the firsttransformed point object that is stored in the destination array
Parameters:
numPts - the number of point objects to be transformed |
| transform | | public void transform(float[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts)(Code) | | 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.
Parameters:
dstPts - the array into which the transformed point coordinatesare returned. Each point is stored as a pair of x, ycoordinates.
Parameters:
srcOff - the offset to the first point to be transformedin the source array
Parameters:
dstOff - the offset to the location of the firsttransformed point that is stored in the destination array
Parameters:
numPts - the number of points to be transformed |
| transform | | public void transform(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)(Code) | | 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.
Parameters:
dstPts - the array into which the transformed pointcoordinates are returned. Each point is stored as a pair ofx, y coordinates.
Parameters:
srcOff - the offset to the first point to be transformedin the source array
Parameters:
dstOff - the offset to the location of the firsttransformed point that is stored in the destination array
Parameters:
numPts - the number of point objects to be transformed |
| transform | | public void transform(float[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)(Code) | | 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.
Parameters:
dstPts - the array into which the transformed point coordinatesare returned. Each point is stored as a pair of x, ycoordinates.
Parameters:
srcOff - the offset to the first point to be transformedin the source array
Parameters:
dstOff - the offset to the location of the firsttransformed point that is stored in the destination array
Parameters:
numPts - the number of points to be transformed |
| transform | | public void transform(double[] srcPts, int srcOff, float[] dstPts, int dstOff, int numPts)(Code) | | 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.
Parameters:
dstPts - the array into which the transformed pointcoordinates are returned. Each point is stored as a pair of x, y coordinates.
Parameters:
srcOff - the offset to the first point to be transformedin the source array
Parameters:
dstOff - the offset to the location of the firsttransformed point that is stored in the destination array
Parameters:
numPts - the number of point objects to be transformed |
| translate | | public void translate(double tx, double ty)(Code) | | 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 theX axis direction
Parameters:
ty - the distance by which coordinates are translated in theY axis direction |
| updateState | | void updateState()(Code) | | 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
|
|
|