com.itextpdf.kernel.geom

Class AffineTransform

java.lang.Object

com.itextpdf.kernel.geom.AffineTransform

All Implemented Interfaces:

Serializable, Cloneable

public class AffineTransform
extends Object
implements Cloneable, Serializable

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	TYPE_FLIP The type of affine transformation.
static int	TYPE_GENERAL_ROTATION The type of affine transformation.
static int	TYPE_GENERAL_SCALE The type of affine transformation.
static int	TYPE_GENERAL_TRANSFORM The type of affine transformation.
static int	TYPE_IDENTITY The type of affine transformation.
static int	TYPE_MASK_ROTATION The type of affine transformation.
static int	TYPE_MASK_SCALE The type of affine transformation.
static int	TYPE_QUADRANT_ROTATION The type of affine transformation.
static int	TYPE_TRANSLATION The type of affine transformation.
static int	TYPE_UNIFORM_SCALE The type of affine transformation.

Constructor Summary

Constructors

Constructor and Description
AffineTransform()
AffineTransform(AffineTransform t)
AffineTransform(double[] matrix)
AffineTransform(double m00, double m10, double m01, double m11, double m02, double m12)
AffineTransform(float[] matrix)

Method Summary

Modifier and Type	Method and Description
AffineTransform	clone() Creates a "deep copy" of this AffineTransform, meaning the object returned by this method will be independent of the object being cloned.
void	concatenate(AffineTransform t)
AffineTransform	createInverse()
void	deltaTransform(double[] src, int srcOff, double[] dst, int dstOff, int length)
Point	deltaTransform(Point src, Point dst)
boolean	equals(Object o)
double	getDeterminant()
void	getMatrix(double[] matrix)
void	getMatrix(float[] matrix)
static AffineTransform	getRotateInstance(double angle) Get an affine transformation representing a counter-clockwise rotation over the passed angle
static AffineTransform	getRotateInstance(double angle, double x, double y) Get an affine transformation representing a counter-clockwise rotation over the passed angle, using the passed point as the center of rotation
static AffineTransform	getScaleInstance(double scx, double scY)
double	getScaleX()
double	getScaleY()
static AffineTransform	getShearInstance(double shx, double shy)
double	getShearX()
double	getShearY()
static AffineTransform	getTranslateInstance(double mx, double my)
double	getTranslateX()
double	getTranslateY()
int	getType() Method returns type of affine transformation.
int	hashCode()
void	inverseTransform(double[] src, int srcOff, double[] dst, int dstOff, int length)
void	inverseTransform(float[] src, int srcOff, float[] dst, int dstOff, int length)
Point	inverseTransform(Point src, Point dst)
boolean	isIdentity()
void	preConcatenate(AffineTransform t)
void	rotate(double angle) Add a counter-clockwise rotation to this transformation
void	rotate(double angle, double px, double py) Add a counter-clockwise rotation to this transformation, using the passed point as the center of rotation
void	scale(double scx, double scy)
void	setToIdentity()
void	setToRotation(double angle) Set this affine transformation to represent a rotation over the passed angle
void	setToRotation(double angle, double px, double py) Set this affine transformation to represent a rotation over the passed angle, using the passed point as the center of rotation
void	setToScale(double scx, double scy)
void	setToShear(double shx, double shy)
void	setToTranslation(double mx, double my)
void	setTransform(AffineTransform t)
void	setTransform(double m00, double m10, double m01, double m11, double m02, double m12)
void	setTransform(float m00, float m10, float m01, float m11, float m02, float m12)
void	shear(double shx, double shy)
void	transform(double[] src, int srcOff, double[] dst, int dstOff, int length)
void	transform(double[] src, int srcOff, float[] dst, int dstOff, int length)
void	transform(float[] src, int srcOff, double[] dst, int dstOff, int length)
void	transform(float[] src, int srcOff, float[] dst, int dstOff, int length)
void	transform(Point[] src, int srcOff, Point[] dst, int dstOff, int length)
Point	transform(Point src, Point dst)
void	translate(double mx, double my)

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

TYPE_IDENTITY

public static final int TYPE_IDENTITY

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_TRANSLATION

public static final int TYPE_TRANSLATION

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_UNIFORM_SCALE

public static final int TYPE_UNIFORM_SCALE

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_GENERAL_SCALE

public static final int TYPE_GENERAL_SCALE

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_QUADRANT_ROTATION

public static final int TYPE_QUADRANT_ROTATION

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_GENERAL_ROTATION

public static final int TYPE_GENERAL_ROTATION

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_GENERAL_TRANSFORM

public static final int TYPE_GENERAL_TRANSFORM

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_FLIP

public static final int TYPE_FLIP

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_MASK_SCALE

public static final int TYPE_MASK_SCALE

The type of affine transformation. See getType().

See Also:

Constant Field Values

TYPE_MASK_ROTATION

public static final int TYPE_MASK_ROTATION

The type of affine transformation. See getType().

See Also:

Constant Field Values

Constructor Detail

AffineTransform

public AffineTransform()

AffineTransform

public AffineTransform(AffineTransform t)

AffineTransform

public AffineTransform(double m00,
                       double m10,
                       double m01,
                       double m11,
                       double m02,
                       double m12)

AffineTransform

public AffineTransform(float[] matrix)

AffineTransform

public AffineTransform(double[] matrix)

Method Detail

getType

public int getType()

Method returns type of affine transformation.

Transform matrix is m00 m01 m02 m10 m11 m12

According analytic geometry new basis vectors are (m00, m01) and (m10, m11), translation vector is (m02, m12). Original basis vectors are (1, 0) and (0, 1). Type transformations classification:

• TYPE_IDENTITY - new basis equals original one and zero translation
• TYPE_TRANSLATION - translation vector isn't zero
• TYPE_UNIFORM_SCALE - vectors length of new basis equals
• TYPE_GENERAL_SCALE - vectors length of new basis doesn't equal
• TYPE_FLIP - new basis vector orientation differ from original one
• TYPE_QUADRANT_ROTATION - new basis is rotated by 90, 180, 270, or 360 degrees
• TYPE_GENERAL_ROTATION - new basis is rotated by arbitrary angle
• TYPE_GENERAL_TRANSFORM - transformation can't be inversed

Returns:

the type of this AffineTransform

getScaleX

public double getScaleX()

getScaleY

public double getScaleY()

getShearX

public double getShearX()

getShearY

public double getShearY()

getTranslateX

public double getTranslateX()

getTranslateY

public double getTranslateY()

isIdentity

public boolean isIdentity()

getMatrix

public void getMatrix(float[] matrix)

getMatrix

public void getMatrix(double[] matrix)

getDeterminant

public double getDeterminant()

setTransform

public void setTransform(float m00,
                         float m10,
                         float m01,
                         float m11,
                         float m02,
                         float m12)

setTransform

public void setTransform(double m00,
                         double m10,
                         double m01,
                         double m11,
                         double m02,
                         double m12)

setTransform

public void setTransform(AffineTransform t)

setToIdentity

public void setToIdentity()

setToTranslation

public void setToTranslation(double mx,
                             double my)

setToScale

public void setToScale(double scx,
                       double scy)

setToShear

public void setToShear(double shx,
                       double shy)

setToRotation

public void setToRotation(double angle)

Set this affine transformation to represent a rotation over the passed angle

Parameters:

angle - angle to rotate over in radians

setToRotation

public void setToRotation(double angle,
                          double px,
                          double py)

Set this affine transformation to represent a rotation over the passed angle, using the passed point as the center of rotation

Parameters:

angle - angle to rotate over in radians

px - x-coordinate of center of rotation

py - y-coordinate of center of rotation

getTranslateInstance

public static AffineTransform getTranslateInstance(double mx,
                                                   double my)

getScaleInstance

public static AffineTransform getScaleInstance(double scx,
                                               double scY)

getShearInstance

public static AffineTransform getShearInstance(double shx,
                                               double shy)

getRotateInstance

public static AffineTransform getRotateInstance(double angle)

Get an affine transformation representing a counter-clockwise rotation over the passed angle

Parameters:

angle - angle in radians to rotate over

Returns:

AffineTransform representing the rotation

getRotateInstance

public static AffineTransform getRotateInstance(double angle,
                                                double x,
                                                double y)

Get an affine transformation representing a counter-clockwise rotation over the passed angle, using the passed point as the center of rotation

Parameters:

angle - angle in radians to rotate over

x - x-coordinate of center of rotation

y - y-coordinate of center of rotation

Returns:

AffineTransform representing the rotation

translate

public void translate(double mx,
                      double my)

scale

public void scale(double scx,
                  double scy)

shear

public void shear(double shx,
                  double shy)

rotate

public void rotate(double angle)

Add a counter-clockwise rotation to this transformation

Parameters:

angle - angle in radians to rotate over

rotate

public void rotate(double angle,
                   double px,
                   double py)

Add a counter-clockwise rotation to this transformation, using the passed point as the center of rotation

Parameters:

angle - angle in radians to rotate over

px - x-coordinate of center of rotation

py - y-coordinate of center of rotation

concatenate

public void concatenate(AffineTransform t)

preConcatenate

public void preConcatenate(AffineTransform t)

createInverse

public AffineTransform createInverse()
                              throws NoninvertibleTransformException

Throws:

NoninvertibleTransformException

transform

public Point transform(Point src,
                       Point dst)

transform

public void transform(Point[] src,
                      int srcOff,
                      Point[] dst,
                      int dstOff,
                      int length)

transform

public void transform(double[] src,
                      int srcOff,
                      double[] dst,
                      int dstOff,
                      int length)

transform

public void transform(float[] src,
                      int srcOff,
                      float[] dst,
                      int dstOff,
                      int length)

transform

public void transform(float[] src,
                      int srcOff,
                      double[] dst,
                      int dstOff,
                      int length)

transform

public void transform(double[] src,
                      int srcOff,
                      float[] dst,
                      int dstOff,
                      int length)

deltaTransform

public Point deltaTransform(Point src,
                            Point dst)

deltaTransform

public void deltaTransform(double[] src,
                           int srcOff,
                           double[] dst,
                           int dstOff,
                           int length)

inverseTransform

public Point inverseTransform(Point src,
                              Point dst)
                       throws NoninvertibleTransformException

Throws:

NoninvertibleTransformException

inverseTransform

public void inverseTransform(double[] src,
                             int srcOff,
                             double[] dst,
                             int dstOff,
                             int length)
                      throws NoninvertibleTransformException

Throws:

NoninvertibleTransformException

inverseTransform

public void inverseTransform(float[] src,
                             int srcOff,
                             float[] dst,
                             int dstOff,
                             int length)
                      throws NoninvertibleTransformException

Throws:

NoninvertibleTransformException

clone

public AffineTransform clone()
                      throws CloneNotSupportedException

Creates a "deep copy" of this AffineTransform, meaning the object returned by this method will be independent of the object being cloned.

Overrides:

clone in class Object

Returns:

the copied AffineTransform.

Throws:

CloneNotSupportedException

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object