Package org.apache.sis.internal.referencing.j2d

Class ImmutableAffineTransform

java.lang.Object

java.awt.geom.AffineTransform

org.apache.sis.internal.referencing.j2d.ImmutableAffineTransform

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

AffineTransform2D

public class ImmutableAffineTransform
extends AffineTransform

Overrides all mutable AffineTransform methods in order to check for permission before changing the transform state. If checkPermission() is defined to always throw an exception (which is the default), then AffineTransform is immutable.

Since:

0.5

Version:

1.2

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private static final long	serialVersionUID	Serial number for inter-operability with different versions.

Fields inherited from class java.awt.geom.AffineTransform

TYPE_FLIP, TYPE_GENERAL_ROTATION, TYPE_GENERAL_SCALE, TYPE_GENERAL_TRANSFORM, TYPE_IDENTITY, TYPE_MASK_ROTATION, TYPE_MASK_SCALE, TYPE_QUADRANT_ROTATION, TYPE_TRANSLATION, TYPE_UNIFORM_SCALE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ImmutableAffineTransform()	Constructs an identity affine transform.
	ImmutableAffineTransform(double[] elements)	Constructs a new transform from an array of values representing either the 4 non-translation entries or the 6 specifiable entries of the 3×3 matrix.
	ImmutableAffineTransform(double m00, double m10, double m01, double m11, double m02, double m12)	Constructs a new transform from 6 values representing the 6 specifiable entries of the 3×3 transformation matrix.
	ImmutableAffineTransform(AffineTransform tr)	Constructs a new transform that is a copy of the specified AffineTransform object.

Method Summary

Modifier and Type	Method	Description
protected void	checkPermission()	Checks if the caller is allowed to change this AffineTransform state.
final void	concatenate(AffineTransform Tx)	Checks for permission before concatenating this transform.
final void	invert()	Checks for permission before inverting this transform.
final void	preConcatenate(AffineTransform Tx)	Checks for permission before concatenating this transform.
final void	quadrantRotate(int numquadrants)	Checks for permission before rotating this transform.
final void	quadrantRotate(int numquadrants, double anchorx, double anchory)	Checks for permission before rotating this transform.
final void	rotate(double theta)	Checks for permission before rotating this transform.
final void	rotate(double vecx, double vecy)	Checks for permission before rotating this transform.
final void	rotate(double theta, double anchorx, double anchory)	Checks for permission before rotating this transform.
final void	rotate(double vecx, double vecy, double anchorx, double anchory)	Checks for permission before rotating this transform.
final void	scale(double sx, double sy)	Checks for permission before scaling this transform.
final void	setToIdentity()	Checks for permission before setting this transform.
final void	setToQuadrantRotation(int numquadrants)	Checks for permission before setting this transform.
final void	setToQuadrantRotation(int numquadrants, double anchorx, double anchory)	Checks for permission before setting this transform.
final void	setToRotation(double theta)	Checks for permission before setting this transform.
final void	setToRotation(double vecx, double vecy)	Checks for permission before setting this transform.
final void	setToRotation(double theta, double anchorx, double anchory)	Checks for permission before setting this transform.
final void	setToRotation(double vecx, double vecy, double anchorx, double anchory)	Checks for permission before setting this transform.
final void	setToScale(double sx, double sy)	Checks for permission before setting this transform.
final void	setToShear(double shx, double shy)	Checks for permission before setting this transform.
final void	setToTranslation(double tx, double ty)	Checks for permission before setting this transform.
final void	setTransform(double m00, double m10, double m01, double m11, double m02, double m12)	Checks for permission before setting this transform.
final void	setTransform(AffineTransform Tx)	Checks for permission before setting this transform.
final void	shear(double shx, double shy)	Checks for permission before shearing this transform.
final void	translate(double tx, double ty)	Checks for permission before translating this transform.

Methods inherited from class java.awt.geom.AffineTransform

clone, createInverse, createTransformedShape, deltaTransform, deltaTransform, equals, getDeterminant, getMatrix, getQuadrantRotateInstance, getQuadrantRotateInstance, getRotateInstance, getRotateInstance, getRotateInstance, getRotateInstance, getScaleInstance, getScaleX, getScaleY, getShearInstance, getShearX, getShearY, getTranslateInstance, getTranslateX, getTranslateY, getType, hashCode, inverseTransform, inverseTransform, isIdentity, toString, transform, transform, transform, transform, transform, transform

Methods inherited from class java.lang.Object

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

Field Details

serialVersionUID

private static final long serialVersionUID

Serial number for inter-operability with different versions.

See Also:

• Constant Field Values

Constructor Details

ImmutableAffineTransform

protected ImmutableAffineTransform()

Constructs an identity affine transform. This is for subclasses usage only, for subclasses that override the checkPermission() method.

ImmutableAffineTransform

public ImmutableAffineTransform(AffineTransform tr)

Constructs a new transform that is a copy of the specified AffineTransform object.

Parameters:

tr - the affine transform to copy.

ImmutableAffineTransform

public ImmutableAffineTransform(double[] elements)

Constructs a new transform from an array of values representing either the 4 non-translation entries or the 6 specifiable entries of the 3×3 matrix.

Parameters:

elements - the matrix elements in an array of length 4 or 6.

ImmutableAffineTransform

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

Constructs a new transform from 6 values representing the 6 specifiable entries of the 3×3 transformation matrix. Those values are given unchanged to the super class constructor.

Parameters:

m00 - the X coordinate scaling.

m10 - the Y coordinate shearing.

m01 - the X coordinate shearing.

m11 - the Y coordinate scaling.

m02 - the X coordinate translation.

m12 - the Y coordinate translation.

Method Details

checkPermission

protected void checkPermission()
                        throws UnsupportedOperationException

Checks if the caller is allowed to change this AffineTransform state. If this method is defined to thrown an exception in all case (which is the default), then this AffineTransform is immutable.

An ImmutableAffineTransform may be temporary mutable at construction time, but shall be back to immutable state before the instance is given to the user.

Throws:

UnsupportedOperationException - if this affine transform is immutable.

translate

public final void translate(double tx,
 double ty)

Checks for permission before translating this transform.

Overrides:

translate in class AffineTransform

rotate

public final void rotate(double theta)

Checks for permission before rotating this transform.

Overrides:

rotate in class AffineTransform

rotate

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

Checks for permission before rotating this transform.

Overrides:

rotate in class AffineTransform

rotate

public final void rotate(double vecx,
 double vecy)

Checks for permission before rotating this transform.

Overrides:

rotate in class AffineTransform

rotate

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

Checks for permission before rotating this transform.

Overrides:

rotate in class AffineTransform

quadrantRotate

public final void quadrantRotate(int numquadrants)

Checks for permission before rotating this transform.

Overrides:

quadrantRotate in class AffineTransform

quadrantRotate

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

Checks for permission before rotating this transform.

Overrides:

quadrantRotate in class AffineTransform

scale

public final void scale(double sx,
 double sy)

Checks for permission before scaling this transform.

Overrides:

scale in class AffineTransform

shear

public final void shear(double shx,
 double shy)

Checks for permission before shearing this transform.

Overrides:

shear in class AffineTransform

setToIdentity

public final void setToIdentity()

Checks for permission before setting this transform.

Overrides:

setToIdentity in class AffineTransform

setToTranslation

public final void setToTranslation(double tx,
 double ty)

Checks for permission before setting this transform.

Overrides:

setToTranslation in class AffineTransform

setToRotation

public final void setToRotation(double theta)

Checks for permission before setting this transform.

Overrides:

setToRotation in class AffineTransform

setToRotation

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

Checks for permission before setting this transform.

Overrides:

setToRotation in class AffineTransform

setToRotation

public final void setToRotation(double vecx,
 double vecy)

Checks for permission before setting this transform.

Overrides:

setToRotation in class AffineTransform

setToRotation

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

Checks for permission before setting this transform.

Overrides:

setToRotation in class AffineTransform

setToQuadrantRotation

public final void setToQuadrantRotation(int numquadrants)

Checks for permission before setting this transform.

Overrides:

setToQuadrantRotation in class AffineTransform

setToQuadrantRotation

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

Checks for permission before setting this transform.

Overrides:

setToQuadrantRotation in class AffineTransform

setToScale

public final void setToScale(double sx,
 double sy)

Checks for permission before setting this transform.

Overrides:

setToScale in class AffineTransform

setToShear

public final void setToShear(double shx,
 double shy)

Checks for permission before setting this transform.

Overrides:

setToShear in class AffineTransform

setTransform

public final void setTransform(AffineTransform Tx)

Checks for permission before setting this transform.

Overrides:

setTransform in class AffineTransform

setTransform

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

Checks for permission before setting this transform.

Overrides:

setTransform in class AffineTransform

concatenate

public final void concatenate(AffineTransform Tx)

Checks for permission before concatenating this transform.

Overrides:

concatenate in class AffineTransform

preConcatenate

public final void preConcatenate(AffineTransform Tx)

Checks for permission before concatenating this transform.

Overrides:

preConcatenate in class AffineTransform

invert

public final void invert()
                  throws NoninvertibleTransformException

Checks for permission before inverting this transform.

Overrides:

invert in class AffineTransform

Throws:

NoninvertibleTransformException - if the matrix cannot be inverted.