math.geom2d.circulinear
Class BoundaryPolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>

java.lang.Object
  extended by math.geom2d.curve.CurveArray2D<T>
      extended by math.geom2d.curve.PolyCurve2D<T>
          extended by math.geom2d.domain.PolyOrientedCurve2D<T>
              extended by math.geom2d.circulinear.PolyCirculinearCurve2D<T>
                  extended by math.geom2d.circulinear.BoundaryPolyCirculinearCurve2D<T>
All Implemented Interfaces:
java.lang.Cloneable, java.lang.Iterable<T>, CirculinearBoundary2D, CirculinearContinuousCurve2D, CirculinearContour2D, CirculinearCurve2D, CirculinearShape2D, ContinuousCurve2D, Curve2D, CurveSet2D<T>, Boundary2D, ContinuousOrientedCurve2D, Contour2D, OrientedCurve2D, GeometricObject2D, Shape2D, ShapeSet2D<T>

public class BoundaryPolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
extends PolyCirculinearCurve2D<T>
implements CirculinearContinuousCurve2D, CirculinearContour2D

A continuous boundary which is composed of several continuous circulinear curves. Instances of this class can be circulinear rings (composed of several continuous and finite circulinear curves that form a loop), or an open curve with two infinite circulinear curve at each extremity.

Author:
dlegland

Constructor Summary
BoundaryPolyCirculinearCurve2D()
           
BoundaryPolyCirculinearCurve2D(java.util.Collection<? extends T> curves)
           
BoundaryPolyCirculinearCurve2D(java.util.Collection<? extends T> curves, boolean closed)
           
BoundaryPolyCirculinearCurve2D(int size)
           
BoundaryPolyCirculinearCurve2D(T[] curves)
           
BoundaryPolyCirculinearCurve2D(T[] curves, boolean closed)
           
 
Method Summary
 CirculinearCurveSet2D<? extends CirculinearContinuousCurve2D> clip(Box2D box)
          Clips the PolyCurve2D by a box.
 java.util.Collection<? extends BoundaryPolyCirculinearCurve2D<?>> continuousCurves()
          Returns a collection of PolyCurve2D that contains only this instance.
static
<T extends CirculinearContinuousCurve2D>
BoundaryPolyCirculinearCurve2D<T>
create(java.util.Collection<T> curves)
          Static factory for creating a new BoundaryPolyCirculinearCurve2D from a collection of curves.
static
<T extends CirculinearContinuousCurve2D>
BoundaryPolyCirculinearCurve2D<T>
create(java.util.Collection<T> curves, boolean closed)
          Static factory for creating a new BoundaryPolyCirculinearCurve2D from a collection of curves.
static
<T extends CirculinearContinuousCurve2D>
BoundaryPolyCirculinearCurve2D<T>
create(T... curves)
          Static factory for creating a new BoundaryPolyCirculinearCurve2D from an array of curves.
static
<T extends CirculinearContinuousCurve2D>
BoundaryPolyCirculinearCurve2D<T>
create(T[] curves, boolean closed)
          Static factory for creating a new BoundaryPolyCirculinearCurve2D from an array of curves.
static
<T extends CirculinearContinuousCurve2D>
BoundaryPolyCirculinearCurve2D<T>
createClosed(T... curves)
          Static factory for creating a new BoundaryPolyCirculinearCurve2D from an array of curves.
 CirculinearDomain2D domain()
          Returns the domain delimited by this boundary.
 void fill(java.awt.Graphics2D g2)
          Fills the interior of the boundary, using the Graphics current Paint.
 double length()
           
 double length(double pos)
           
 CirculinearRing2D parallel(double dist)
          Creates a new curve, formed by the points with parameterization: p(t) = c(t) + d*n(t)/|n(t)|, with p(t) being a point of the original curve, n(t) the normal of the curve, and |n| being the norm of n.
 double position(double length)
           
 BoundaryPolyCirculinearCurve2D<? extends CirculinearContinuousCurve2D> reverse()
          Returns the reverse curve of this PolyCurve2D.
 java.util.Collection<? extends CirculinearElement2D> smoothPieces()
          Returns a collection containing only instances of SmoothCurve2D.
 PolyCirculinearCurve2D<? extends CirculinearContinuousCurve2D> subCurve(double t0, double t1)
          Returns a portion of this curve as an instance of PolyOrientedCurve2D.
 BoundaryPolyCurve2D<? extends ContinuousOrientedCurve2D> transform(AffineTransform2D trans)
          Transforms each smooth piece in this PolyCurve2D and returns a new instance of PolyCurve2D.
 BoundaryPolyCirculinearCurve2D<? extends CirculinearContinuousCurve2D> transform(CircleInversion2D inv)
          Transforms the shape by a circle inversion.
 
Methods inherited from class math.geom2d.circulinear.PolyCirculinearCurve2D
buffer
 
Methods inherited from class math.geom2d.domain.PolyOrientedCurve2D
equals, isInside, signedDistance, signedDistance, windingAngle
 
Methods inherited from class math.geom2d.curve.PolyCurve2D
appendPath, asPolyline, curvature, draw, getGeneralPath, isClosed, leftTangent, rightTangent, setClosed
 
Methods inherited from class math.geom2d.curve.CurveArray2D
add, add, almostEquals, asAwtShape, boundingBox, childCurve, clear, clone, contains, contains, contains, curveIndex, curves, distance, distance, firstCurve, firstPoint, get, getT0, getT1, globalPosition, indexOf, intersections, isBounded, isEmpty, isSingular, iterator, lastCurve, lastPoint, localPosition, point, position, project, remove, remove, singularPoints, size, t0, t1, vertices
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface math.geom2d.curve.ContinuousCurve2D
appendPath, asPolyline, curvature, isClosed, leftTangent, rightTangent
 
Methods inherited from interface math.geom2d.circulinear.CirculinearShape2D
buffer
 
Methods inherited from interface math.geom2d.domain.Boundary2D
isInside
 
Methods inherited from interface math.geom2d.domain.OrientedCurve2D
signedDistance, signedDistance, windingAngle
 

Constructor Detail

BoundaryPolyCirculinearCurve2D

public BoundaryPolyCirculinearCurve2D()

BoundaryPolyCirculinearCurve2D

public BoundaryPolyCirculinearCurve2D(int size)

BoundaryPolyCirculinearCurve2D

public BoundaryPolyCirculinearCurve2D(T[] curves)

BoundaryPolyCirculinearCurve2D

public BoundaryPolyCirculinearCurve2D(T[] curves,
                                      boolean closed)

BoundaryPolyCirculinearCurve2D

public BoundaryPolyCirculinearCurve2D(java.util.Collection<? extends T> curves)

BoundaryPolyCirculinearCurve2D

public BoundaryPolyCirculinearCurve2D(java.util.Collection<? extends T> curves,
                                      boolean closed)
Method Detail

create

public static <T extends CirculinearContinuousCurve2D> BoundaryPolyCirculinearCurve2D<T> create(java.util.Collection<T> curves)
Static factory for creating a new BoundaryPolyCirculinearCurve2D from a collection of curves.

Since:
0.8.1

create

public static <T extends CirculinearContinuousCurve2D> BoundaryPolyCirculinearCurve2D<T> create(java.util.Collection<T> curves,
                                                                                                boolean closed)
Static factory for creating a new BoundaryPolyCirculinearCurve2D from a collection of curves.

Since:
0.8.1

create

public static <T extends CirculinearContinuousCurve2D> BoundaryPolyCirculinearCurve2D<T> create(T... curves)
Static factory for creating a new BoundaryPolyCirculinearCurve2D from an array of curves.

Since:
0.8.1

create

public static <T extends CirculinearContinuousCurve2D> BoundaryPolyCirculinearCurve2D<T> create(T[] curves,
                                                                                                boolean closed)
Static factory for creating a new BoundaryPolyCirculinearCurve2D from an array of curves.

Since:
0.8.1

createClosed

public static <T extends CirculinearContinuousCurve2D> BoundaryPolyCirculinearCurve2D<T> createClosed(T... curves)
Static factory for creating a new BoundaryPolyCirculinearCurve2D from an array of curves.

Since:
0.8.1

length

public double length()
Specified by:
length in interface CirculinearCurve2D
Overrides:
length in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Returns:
the length of the curve

length

public double length(double pos)
Specified by:
length in interface CirculinearCurve2D
Overrides:
length in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Returns:
the length from the beginning to the position given by pos

position

public double position(double length)
Specified by:
position in interface CirculinearCurve2D
Overrides:
position in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Returns:
the position located at a given geodesic distance from the origin

parallel

public CirculinearRing2D parallel(double dist)
Description copied from interface: CirculinearCurve2D
Creates a new curve, formed by the points with parameterization: p(t) = c(t) + d*n(t)/|n(t)|, with p(t) being a point of the original curve, n(t) the normal of the curve, and |n| being the norm of n.
In the case of a continuous curve formed by several smooth circulinear elements, the parallels of contiguous elements are joined by a circle arc.

Specified by:
parallel in interface CirculinearBoundary2D
Specified by:
parallel in interface CirculinearContinuousCurve2D
Specified by:
parallel in interface CirculinearContour2D
Specified by:
parallel in interface CirculinearCurve2D
Overrides:
parallel in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Parameters:
dist - the distance between the original curve and he parallel curve.
Returns:
the parallel curve

transform

public BoundaryPolyCirculinearCurve2D<? extends CirculinearContinuousCurve2D> transform(CircleInversion2D inv)
Description copied from interface: CirculinearShape2D
Transforms the shape by a circle inversion. The result is still an instance a CirculinearShape2D.

Specified by:
transform in interface CirculinearBoundary2D
Specified by:
transform in interface CirculinearContinuousCurve2D
Specified by:
transform in interface CirculinearContour2D
Specified by:
transform in interface CirculinearCurve2D
Specified by:
transform in interface CirculinearShape2D
Overrides:
transform in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Parameters:
inv - the circle inversion
Returns:
the transformed shape

fill

public void fill(java.awt.Graphics2D g2)
Description copied from interface: Boundary2D
Fills the interior of the boundary, using the Graphics current Paint.

Specified by:
fill in interface Boundary2D
Parameters:
g2 - the Graphics to fill on

domain

public CirculinearDomain2D domain()
Description copied from interface: Boundary2D
Returns the domain delimited by this boundary.

Specified by:
domain in interface CirculinearBoundary2D
Specified by:
domain in interface Boundary2D
Returns:
the domain delimited by this boundary

smoothPieces

public java.util.Collection<? extends CirculinearElement2D> smoothPieces()
Description copied from class: PolyCurve2D
Returns a collection containing only instances of SmoothCurve2D.

Specified by:
smoothPieces in interface CirculinearContinuousCurve2D
Specified by:
smoothPieces in interface ContinuousCurve2D
Overrides:
smoothPieces in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Returns:
a collection of SmoothCurve2D

continuousCurves

public java.util.Collection<? extends BoundaryPolyCirculinearCurve2D<?>> continuousCurves()
Description copied from class: PolyCurve2D
Returns a collection of PolyCurve2D that contains only this instance.

Specified by:
continuousCurves in interface CirculinearBoundary2D
Specified by:
continuousCurves in interface CirculinearCurve2D
Specified by:
continuousCurves in interface Curve2D
Specified by:
continuousCurves in interface Boundary2D
Overrides:
continuousCurves in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Returns:
a collection of continuous curves.

reverse

public BoundaryPolyCirculinearCurve2D<? extends CirculinearContinuousCurve2D> reverse()
Description copied from class: PolyCurve2D
Returns the reverse curve of this PolyCurve2D.

Specified by:
reverse in interface CirculinearBoundary2D
Specified by:
reverse in interface CirculinearContinuousCurve2D
Specified by:
reverse in interface CirculinearContour2D
Specified by:
reverse in interface CirculinearCurve2D
Specified by:
reverse in interface ContinuousCurve2D
Specified by:
reverse in interface Curve2D
Specified by:
reverse in interface Boundary2D
Specified by:
reverse in interface ContinuousOrientedCurve2D
Specified by:
reverse in interface Contour2D
Specified by:
reverse in interface OrientedCurve2D
Overrides:
reverse in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>

subCurve

public PolyCirculinearCurve2D<? extends CirculinearContinuousCurve2D> subCurve(double t0,
                                                                               double t1)
Description copied from class: PolyOrientedCurve2D
Returns a portion of this curve as an instance of PolyOrientedCurve2D.

Specified by:
subCurve in interface CirculinearContinuousCurve2D
Specified by:
subCurve in interface CirculinearCurve2D
Specified by:
subCurve in interface ContinuousCurve2D
Specified by:
subCurve in interface Curve2D
Specified by:
subCurve in interface ContinuousOrientedCurve2D
Overrides:
subCurve in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Parameters:
t0 - position of the start of the sub-curve
t1 - position of the end of the sub-curve
Returns:
the portion of original curve comprised between t0 and t1.

clip

public CirculinearCurveSet2D<? extends CirculinearContinuousCurve2D> clip(Box2D box)
Description copied from class: PolyOrientedCurve2D
Clips the PolyCurve2D by a box. The result is an instance of CurveSet2D, which contains only instances of ContinuousOrientedCurve2D. If the PolyCurve2D is not clipped, the result is an instance of CurveSet2D which contains 0 curves.

Specified by:
clip in interface CirculinearBoundary2D
Specified by:
clip in interface CirculinearContinuousCurve2D
Specified by:
clip in interface CirculinearCurve2D
Specified by:
clip in interface ContinuousCurve2D
Specified by:
clip in interface Curve2D
Specified by:
clip in interface ContinuousOrientedCurve2D
Specified by:
clip in interface OrientedCurve2D
Specified by:
clip in interface Shape2D
Overrides:
clip in class PolyCirculinearCurve2D<T extends CirculinearContinuousCurve2D>
Parameters:
box - the clipping box
Returns:
the clipped shape

transform

public BoundaryPolyCurve2D<? extends ContinuousOrientedCurve2D> transform(AffineTransform2D trans)
Description copied from class: PolyCurve2D
Transforms each smooth piece in this PolyCurve2D and returns a new instance of PolyCurve2D.

Specified by:
transform in interface ContinuousCurve2D
Specified by:
transform in interface Curve2D
Specified by:
transform in interface CurveSet2D<T extends CirculinearContinuousCurve2D>
Specified by:
transform in interface Boundary2D
Specified by:
transform in interface ContinuousOrientedCurve2D
Specified by:
transform in interface Contour2D
Specified by:
transform in interface OrientedCurve2D
Specified by:
transform in interface Shape2D
Overrides:
transform in class PolyOrientedCurve2D<T extends CirculinearContinuousCurve2D>
Parameters:
trans - an affine transform
Returns:
the transformed shape