org.geolatte.geom

Class LineString

java.lang.Object

org.geolatte.geom.Geometry

org.geolatte.geom.LineString

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

LinearRing

public class LineString
extends Geometry

A LineString is a 1-dimensional Geometry consisting of the LineSegments defined by consecutive pairs of Points of a PointSequence.

Author:

Karel Maesen, Geovise BVBA, 2011

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LineString(LineString base) This constructor has been added to speed up object creation of LinearRings
	LineString(PointSequence points) Constructs a LineString from the specified PointSequence and coordinate reference system
	LineString(PointSequence points, GeometryOperations geometryOperations) Constructs a LineString from the specified PointSequence, coordinate reference system and GeometryOperations implementation.

Method Summary

Modifier and Type	Method and Description
void	accept(GeometryVisitor visitor) Accepts a GeometryVisitor.
static LineString	createEmpty() Constructs an empty LineString.
int	getDimension() Returns the topological dimension of this instance.
Point	getEndPoint() Returns the last Point of this LineString.
GeometryType	getGeometryType() Returns the type of this Geometry.
double	getLength() Returns the length of this LineString in its coordinate reference system.
PointSequence	getPoints() Returns the PointCollection that is associated with this instance
Point	getStartPoint() Returns the first Point of this LineString.
boolean	isClosed() Checks whether this LineString is closed, i.e.
boolean	isRing() Checks whether this LineString is a ring, i.e.

Methods inherited from class org.geolatte.geom.Geometry

asBinary, asText, buffer, collectPointSets, contains, convexHull, crosses, difference, disjoint, distance, equals, getBoundary, getCoordinateDimension, getCrsId, getCrsId, getDimensionalFlag, getEnvelope, getGeometryOperations, getGeometryOperations, getNumPoints, getPointN, getSRID, hashCode, intersection, intersects, is3D, isEmpty, isMeasured, isSimple, locateAlong, locateBetween, overlaps, relate, symDifference, toString, touches, union, within

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

LineString

protected LineString(LineString base)

This constructor has been added to speed up object creation of LinearRings

Parameters:

base -

LineString

public LineString(PointSequence points,
                  GeometryOperations geometryOperations)

Constructs a LineString from the specified PointSequence, coordinate reference system and GeometryOperations implementation.

Parameters:

points - the PointSequence

geometryOperations - the GeometryOperations implementation

Throws:

IllegalArgumentException - if the passed PointSequence is non-empty and of size < 2

LineString

public LineString(PointSequence points)

Constructs a LineString from the specified PointSequence and coordinate reference system

Parameters:

points - the PointSequence

Method Detail

createEmpty

public static LineString createEmpty()

Constructs an empty LineString.

Returns:

getPoints

public PointSequence getPoints()

Description copied from class: Geometry

Returns the PointCollection that is associated with this instance

Specified by:

getPoints in class Geometry

Returns:

getLength

public double getLength()

Returns the length of this LineString in its coordinate reference system.

Returns:

the length of this LineString in its coordinate reference system.

getStartPoint

public Point getStartPoint()

Returns the first Point of this LineString.

Returns:

the first Point of this LineString.

getEndPoint

public Point getEndPoint()

Returns the last Point of this LineString.

Returns:

the last Point of this LineString.

isClosed

public boolean isClosed()

Checks whether this LineString is closed, i.e. the first Point equals the last.

Returns:

true if this LineString is closed.

isRing

public boolean isRing()

Checks whether this LineString is a ring, i.e. is closed and simple.

Returns:

true if this LineString is a ring.

getDimension

public int getDimension()

Description copied from class: Geometry

Returns the topological dimension of this instance. In non-homogenous collections, this will return the largest topological dimension of the contained Geometries.

Specified by:

getDimension in class Geometry

Returns:

getGeometryType

public GeometryType getGeometryType()

Description copied from class: Geometry

Returns the type of this Geometry.

Specified by:

getGeometryType in class Geometry

Returns:

the GeometryType of this instance.

accept

public void accept(GeometryVisitor visitor)

Description copied from class: Geometry

Accepts a GeometryVisitor.

If this Geometry instance is a GeometryCollection then it will pass the visitor to its contained Geometries.

Specified by:

accept in class Geometry