de.javagl.geom

Class Shapes

java.lang.Object

de.javagl.geom.Shapes

public class Shapes
extends Object

Utility methods related to Shapes

Method Summary

Modifier and Type	Method and Description
static double	computeLength(Shape shape, double flatness) Computes the length of the given shape (i.e. its border)
static List<Line2D>	computeLineSegments(Shape shape, double flatness) Create a list containing line segments that approximate the given shape.
static List<Point2D>	computePoints(Shape shape, double flatness, boolean storeOnClose) Create a list containing line points that approximate the given shape.
static double	computeSignedArea(Shape shape, double flatness) Compute the (signed) area that is covered by the given shape.
static List<Shape>	computeSubShapes(Shape shape) Computes the list of sub-shapes of the given shape.
static Shape	interpolate(Shape shape0, Shape shape1, double alpha) Create a shape that is created from interpolating between the given shapes, according to the given interpolation value

Methods inherited from class java.lang.Object

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

Method Detail

computeLineSegments

public static List<Line2D> computeLineSegments(Shape shape,
                                               double flatness)

Create a list containing line segments that approximate the given shape.

Parameters:

shape - The shape

flatness - The allowed flatness

Returns:

The list of line segments

computePoints

public static List<Point2D> computePoints(Shape shape,
                                          double flatness,
                                          boolean storeOnClose)

Create a list containing line points that approximate the given shape.

Parameters:

shape - The shape

flatness - The allowed flatness

storeOnClose - Whether a point should be stored when the shape is closed. (This will result in points being stored twice in the returned list).

Returns:

The list of points

interpolate

public static Shape interpolate(Shape shape0,
                                Shape shape1,
                                double alpha)

Create a shape that is created from interpolating between the given shapes, according to the given interpolation value

Parameters:

shape0 - The first shape

shape1 - The second shape

alpha - The interpolation value, usually between 0.0 and 1.0

Returns:

The interpolated shape

Throws:

IllegalArgumentException - If the given shapes do not consist of the same segments (that is, when they are not structurally equal)

computeSignedArea

public static double computeSignedArea(Shape shape,
                                       double flatness)

Compute the (signed) area that is covered by the given shape.

The area will be positive for regions where the points are ordered counterclockwise, and and negative for regions where the points are ordered clockwise.

Parameters:

shape - The shape

flatness - The flatness for the path iterator

Returns:

The signed area

computeLength

public static double computeLength(Shape shape,
                                   double flatness)

Computes the length of the given shape (i.e. its border)

Parameters:

shape - The shape

flatness - The flatness for the iteration

Returns:

The length of the given shape

computeSubShapes

public static List<Shape> computeSubShapes(Shape shape)

Computes the list of sub-shapes of the given shape. These are the shapes that are separated in the given shape via SEG_MOVETO or SEG_CLOSE operations

Parameters:

shape - The input shape

Returns:

The sub-shapes