Polyline

java.lang.Object
- com.partnersoft.geometry.Polyline

All Implemented Interfaces:

java.io.Serializable
```
public class Polyline
extends java.lang.Object
implements java.io.Serializable
```
A single, DoubleBuffer-based polyline.

Author:

Paul Reavis Copyright 2002 Partner Software, Inc.

See Also:
Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

DoubleBuffer coords

Fields
Modifier and Type	Field and Description
`DoubleBuffer`	`coords`

Constructor Summary

Constructors
Constructor and Description
`Polyline()`
`Polyline(double... coords)`
`Polyline(DoubleBuffer buffy)`
`Polyline(int size)`
`Polyline(XyPoint... points)`
`Polyline(XyPolyline polyline)`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addPoint(double x, double y)`
`void`	`clear()`
`PolylineArray`	`clipOutRectangle(double x, double y, double width, double height)` Clips a rectangle out of the polyline to a rectangle, producing zero or more resultant polylines that are outside the rectangle.
`PolylineArray`	`clipOutRectangle(Rectangle rectangle)`
`void`	`clipOutRectangle(Rectangle rectangle, PolylineArray results)` This is the fastest public clipOutRectangle variation - passing a reuseable PolylineArray can reduce allocation overhead.
`PolylineArray`	`clipOutRectangles(Rectangle[] rectangles)` Cuts a collection of rectangular holes out.
`java.lang.Object`	`clone()`
`static boolean`	`containsDegenerateSegments(DoubleBuffer coords)`
`void`	`flip()`
`Point`	`getCentroid()`
`Point`	`getEndPoint()`
`Rectangle`	`getExtents()`
`double`	`getLength()`
`int`	`getNumberOfPoints()`
`Point`	`getStartPoint()`
`boolean`	`isDegenerate()`
`static boolean`	`isDegenerate(DoubleBuffer coords)`
`void`	`reduceDetail(double granularity)`
`static void`	`reduceDetail(DoubleBuffer coords, double granularity)` Attempts to reduce the complexity of the line by eliminating points which add nothing to the detail at a certain granularity.
`java.lang.String`	`toString()`
`XyPolyline`	`toXyPolyline()`

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail
- coords
```
public DoubleBuffer coords
```

Constructor Detail

Polyline
```
public Polyline()
```

Polyline
```
public Polyline(int size)
```

Polyline
```
public Polyline(DoubleBuffer buffy)
```

Polyline
```
public Polyline(double... coords)
```

Polyline
```
public Polyline(XyPoint... points)
```

Polyline
```
public Polyline(XyPolyline polyline)
```

Method Detail

addPoint

public void addPoint(double x,
            double y)

reduceDetail

public final void reduceDetail(double granularity)

getNumberOfPoints
```
public int getNumberOfPoints()
```

clear
```
public void clear()
```

reduceDetail
```
public static final void reduceDetail(DoubleBuffer coords,
                double granularity)
```
Attempts to reduce the complexity of the line by eliminating points which add nothing to the detail at a certain granularity. Granularity is defined as a discretizing parameter - it sets up a grid of that cell size and points which fall into the same grid cell are regarded as identical. May reduce it to a single point, so watch out.

isDegenerate
```
public final boolean isDegenerate()
```

isDegenerate

public static final boolean isDegenerate(DoubleBuffer coords)

containsDegenerateSegments

public static final boolean containsDegenerateSegments(DoubleBuffer coords)

getCentroid
```
public final Point getCentroid()
```

getStartPoint
```
public final Point getStartPoint()
```

getEndPoint
```
public final Point getEndPoint()
```

getLength
```
public final double getLength()
```

getExtents
```
public final Rectangle getExtents()
```

flip
```
public void flip()
```

clipOutRectangle

public final PolylineArray clipOutRectangle(double x,
                             double y,
                             double width,
                             double height)

Clips a rectangle out of the polyline to a rectangle, producing zero or more resultant polylines that are outside the rectangle.

clipOutRectangle

public final PolylineArray clipOutRectangle(Rectangle rectangle)

clipOutRectangle
```
public final void clipOutRectangle(Rectangle rectangle,
                    PolylineArray results)
```
This is the fastest public clipOutRectangle variation - passing a reuseable PolylineArray can reduce allocation overhead. The others eventually call this.

clipOutRectangles

public final PolylineArray clipOutRectangles(Rectangle[] rectangles)

Cuts a collection of rectangular holes out.

clone
```
public java.lang.Object clone()
```
Overrides:

clone in class java.lang.Object

toString
```
public java.lang.String toString()
```
Overrides:

toString in class java.lang.Object

toXyPolyline
```
public XyPolyline toXyPolyline()
```

Class Polyline

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

coords

Constructor Detail

Polyline

Polyline

Polyline

Polyline

Polyline

Polyline

Method Detail

addPoint

reduceDetail

getNumberOfPoints

clear

reduceDetail

isDegenerate

isDegenerate

containsDegenerateSegments

getCentroid

getStartPoint

getEndPoint

getLength

getExtents

flip

clipOutRectangle

clipOutRectangle

clipOutRectangle

clipOutRectangles

clone

toString

toXyPolyline