org.mdiutil.geom

Class ShapeNormalizer

java.lang.Object

org.mdiutil.geom.ShapeNormalizer

public class ShapeNormalizer
extends Object

This class converts a Shape in an Array of Elementary Shapes. The transformation algorithm follows these rules:

• CubicCurves and QuadCurves are transformed into Arcs or Circles (depending if this normalizer allows to convert to circles)
• Segments are transformed into Polygon2D, Polyline2D, or Lines

The algorithm try to concatenate as much Arcs or lines as possible. Remark: this class uses internally a CurveConverter.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ShapeNormalizer.ConnectedShape This class wraps a Shape with a boolean indicating if the Shape is connected to the previous Shape.

Field Summary

Fields

Modifier and Type	Field and Description
static double	ASSUME_ZERO

Constructor Summary

Constructors

Constructor and Description
ShapeNormalizer() Creates a new normalizer.
ShapeNormalizer(boolean allowCircles) Creates a new normalizer.

Method Summary

Modifier and Type	Method and Description
void	allowCircles(boolean allowCircles) Set if circles are allowed in the result
List<ShapeNormalizer.ConnectedShape>	convertConnectedPath(PathIterator pathiterator) Convert any PathIterator in a Vector of elementary Arcs, Polygons, Polylines, or Lines.
List<ShapeNormalizer.ConnectedShape>	convertConnectedPath(Shape shape) Convert any Shape in a Vector of elementary Arcs, Polygons, or Lines.
List<ShapeNormalizer.ConnectedShape>	convertConnectedPath(Shape shape, AffineTransform affine) Convert any Shape in a Vector of elementary Arcs, Polygons, Polylines, or Lines.
List<Shape>	convertPath(PathIterator pathiterator) Convert any PathIterator in a Vector of elementary Arcs, Polygons, Polylines, or Lines.
List<Shape>	convertPath(Shape shape) Convert any Shape in a Vector of elementary Arcs, Polygons, , Polylines, or Lines.
List<Shape>	convertPath(Shape shape, AffineTransform affine) Convert any Shape in a Vector of elementary Arcs, Polygons, Polylines, or Lines.
List<Shape>	convertPath(Shape shape, AffineTransform affine, boolean flatnessProp, double flatness) Convert any Shape in a Vector of elementary Arcs, Ellipse, Polygons, Polylines, or Lines.
boolean	getSurfaceMode() Return true if the surface filling mode of this normalizer is active.
boolean	isAllowingCircles() Return true if circles are allowed in the result.
void	setSurfaceMode(boolean mode) Set the surface filling mode of this normalizer.

Methods inherited from class java.lang.Object

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

Field Detail

ASSUME_ZERO

public static final double ASSUME_ZERO

See Also:

Constant Field Values

Constructor Detail

ShapeNormalizer

public ShapeNormalizer()

Creates a new normalizer. The default surface mode is false setSurfaceMode(boolean).

ShapeNormalizer

public ShapeNormalizer(boolean allowCircles)

Creates a new normalizer. The default surface mode is false setSurfaceMode(boolean).

Parameters:

allowCircles - true if circles are allowed in the result

Method Detail

setSurfaceMode

public void setSurfaceMode(boolean mode)

Set the surface filling mode of this normalizer.

• If mode is true, the normalizer will add the associated enclosed Polygon2D to the shapes Vector for each encountered Path that has at least one CubicCurve2D or QuadCurve2D
• If not, it will add no added shape to the surface

This ensures that the interior of any Area will be filled, even if this area is constituted of curves.

Parameters:

mode - true if the surface filling mode is active

getSurfaceMode

public boolean getSurfaceMode()

Return true if the surface filling mode of this normalizer is active.

Returns:

true if the surface filling mode of this normalizer is active

See Also:

setSurfaceMode(boolean)

isAllowingCircles

public boolean isAllowingCircles()

Return true if circles are allowed in the result.

Returns:

true if circles are allowed in the result

allowCircles

public void allowCircles(boolean allowCircles)

Set if circles are allowed in the result

Parameters:

allowCircles - true if circles are allowed in the result

convertConnectedPath

public List<ShapeNormalizer.ConnectedShape> convertConnectedPath(Shape shape)

Convert any Shape in a Vector of elementary Arcs, Polygons, or Lines.

Parameters:

shape - the input Shape

Returns:

the resulting connected Shapes list

convertConnectedPath

public List<ShapeNormalizer.ConnectedShape> convertConnectedPath(Shape shape,
                                                                 AffineTransform affine)

Convert any Shape in a Vector of elementary Arcs, Polygons, Polylines, or Lines.

Parameters:

shape - the input Shape

affine - the AffineTransform

Returns:

the resulting connected Shapes list

convertPath

public List<Shape> convertPath(Shape shape)

Convert any Shape in a Vector of elementary Arcs, Polygons, , Polylines, or Lines. Note that the possible connection of segments in the input Shape is lost in the conversion. To keep the connection between the Shapes, you should use the convertConnectedPath(java.awt.Shape) method.

Parameters:

shape - the input Shape

Returns:

the resulting Shape list

convertPath

public List<Shape> convertPath(Shape shape,
                               AffineTransform affine)

Convert any Shape in a Vector of elementary Arcs, Polygons, Polylines, or Lines. Note that the possible connection of segments in the input Shape is lost in the conversion. To keep the connection between the Shapes, you should use the convertConnectedPath(java.awt.Shape, java.awt.geom.AffineTransform) method.

Parameters:

shape - the input Shape

affine - the AffineTransform

Returns:

the resulting Shape list

convertPath

public List<Shape> convertPath(Shape shape,
                               AffineTransform affine,
                               boolean flatnessProp,
                               double flatness)

Convert any Shape in a Vector of elementary Arcs, Ellipse, Polygons, Polylines, or Lines.

The Shape is converted to its associated PathIterator :

• with the flatness value if the flatnessProp property is true
• else without flatness value

If the Shape is already an Arc, Ellipse, Polygon, Polyline, or Line, and if it is possible, we keep a simple Shape and we don't use a PathIterator to transform the Shape.

Parameters:

shape - the input Shape

affine - the AffineTransform

flatnessProp - true if Shapes will be flattened

flatness - the flatness value

Returns:

the resulting Shape list

convertPath

public List<Shape> convertPath(PathIterator pathiterator)

Convert any PathIterator in a Vector of elementary Arcs, Polygons, Polylines, or Lines. Note that the possible connection of segments in the input PathIterator is lost in the conversion. To keep the connection between the Shapes, you should use the convertConnectedPath(java.awt.geom.PathIterator) method.

Parameters:

pathiterator - the PathIterator

Returns:

the resulting Shape list

convertConnectedPath

public List<ShapeNormalizer.ConnectedShape> convertConnectedPath(PathIterator pathiterator)

Convert any PathIterator in a Vector of elementary Arcs, Polygons, Polylines, or Lines.

Parameters:

pathiterator - the PathIterator

Returns:

the resulting connected Shapes list