org.mdiutil.geom

Class ShapeUtilities

java.lang.Object

org.mdiutil.geom.ShapeUtilities

public class ShapeUtilities
extends Object

This class contain several utilities about Shapes.

Method Summary

Modifier and Type	Method and Description
static Shape	createTransformedShape(Shape src, AffineTransform trans) Apply a transformation to a Shape, trying to keep the type of the Shape.
static ShapeUtilities	getInstance() Return the unique instance of this class.
static double	getRotationAngle(AffineTransform tr) Return the rotation angle for an AffineTransform.
static AffineTransform	getRotationTransform(AffineTransform tr) Return the rotation Component of an AffineTransform.
boolean	keepSimpleShape(Shape src, AffineTransform trans) Return false if the transform will be delegated to the AffineTransform.
static boolean	simpleShapeAsTransform(Shape src, AffineTransform trans) Return false if the transform will be delegated to the AffineTransform.
Shape	transform(Shape src, AffineTransform trans) Apply a transformation to a Shape, trying to keep the type of the Shape.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static ShapeUtilities getInstance()

Return the unique instance of this class.

Returns:

the unique instance

createTransformedShape

public static Shape createTransformedShape(Shape src,
                                           AffineTransform trans)

Apply a transformation to a Shape, trying to keep the type of the Shape.

Parameters:

src - the source Shape

trans - the AffineTransform

Returns:

the transformed Shape

See Also:

transform(Shape, AffineTransform)

getRotationAngle

public static double getRotationAngle(AffineTransform tr)

Return the rotation angle for an AffineTransform. It will return 0 if the AffineTransform has no rotation Component.

Parameters:

tr - the AffineTransform

Returns:

the rotation angle

getRotationTransform

public static AffineTransform getRotationTransform(AffineTransform tr)

Return the rotation Component of an AffineTransform. It will return an Identity transform if the AffineTransform has no rotation Component.

Parameters:

tr - the AffineTransform

Returns:

the rotation Component of an AffineTransform (or the Identity transform)

transform

public Shape transform(Shape src,
                       AffineTransform trans)

Apply a transformation to a Shape, trying to keep the type of the Shape. The transformation will be delegated to AffineTransform in the following cases:

• The transformation has a scale component, and the scale is not uniform
• The Shape is an Ellipse2D or a Rectangle2D, with different width and height values, the transformation is not a Quadrant rotation, and the scale is not uniform,
• The Shape is a RoundRectangle2D, with different width and height values, the transformation is not a Quadrant rotation, and the scale is not uniform,
• The Shape is an Arc2D with different width and height values
• The Shape is not one of the following: Ellipse2D, Rectangle2D, RoundRectangle2D, Line2D, Arc2D, Polygon2D, Polyline2D

Parameters:

src - the source Shape

trans - the AffineTransform

Returns:

the transformed Shape

simpleShapeAsTransform

public static boolean simpleShapeAsTransform(Shape src,
                                             AffineTransform trans)

Return false if the transform will be delegated to the AffineTransform. If true, the resulting Shape will be a simple Shape: Ellipse2D, Rectangle2D, RoundRectangle2D, Line2D, Arc2D, Polygon2D, Polyline2D.

Parameters:

src - the source Shape

trans - the AffineTransform

Returns:

false if the transform will be delegated to the AffineTransform

keepSimpleShape

public boolean keepSimpleShape(Shape src,
                               AffineTransform trans)

Return false if the transform will be delegated to the AffineTransform. If true, the resulting Shape will be a simple Shape: Ellipse2D, Rectangle2D, RoundRectangle2D, Line2D, Arc2D, Polygon2D, Polyline2D.

Parameters:

src - the source Shape

trans - the AffineTransform

Returns:

false if the transform will be delegated to the AffineTransform