|
JTS Topology Suite version 1.12 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.vividsolutions.jts.geom.LineSegment
public class LineSegment
Represents a line segment defined by two Coordinate
s.
Provides methods to compute various geometric properties
and relationships of line segments.
This class is designed to be easily mutable (to the extent of
having its contained points public).
This supports a common pattern of reusing a single LineSegment
object as a way of computing segment properties on the
segments defined by arrays or lists of Coordinate
s.
Field Summary | |
---|---|
Coordinate |
p0
|
Coordinate |
p1
|
Constructor Summary | |
---|---|
LineSegment()
|
|
LineSegment(Coordinate p0,
Coordinate p1)
|
|
LineSegment(double x0,
double y0,
double x1,
double y1)
|
|
LineSegment(LineSegment ls)
|
Method Summary | |
---|---|
double |
angle()
Computes the angle that the vector defined by this segment makes with the X-axis. |
Coordinate |
closestPoint(Coordinate p)
Computes the closest point on this line segment to another point. |
Coordinate[] |
closestPoints(LineSegment line)
Computes the closest points on two line segments. |
int |
compareTo(java.lang.Object o)
Compares this object with the specified object for order. |
double |
distance(Coordinate p)
Computes the distance between this line segment and a given point. |
double |
distance(LineSegment ls)
Computes the distance between this line segment and another segment. |
double |
distancePerpendicular(Coordinate p)
Computes the perpendicular distance between the (infinite) line defined by this line segment and a point. |
boolean |
equals(java.lang.Object o)
Returns true if other has the same values for
its points. |
boolean |
equalsTopo(LineSegment other)
Returns true if other is
topologically equal to this LineSegment (e.g. |
Coordinate |
getCoordinate(int i)
|
double |
getLength()
Computes the length of the line segment. |
int |
hashCode()
Gets a hashcode for this object. |
Coordinate |
intersection(LineSegment line)
Computes an intersection point between two line segments, if there is one. |
boolean |
isHorizontal()
Tests whether the segment is horizontal. |
boolean |
isVertical()
Tests whether the segment is vertical. |
Coordinate |
lineIntersection(LineSegment line)
Computes the intersection point of the lines of infinite extent defined by two line segments (if there is one). |
Coordinate |
midPoint()
Computes the midpoint of the segment |
static Coordinate |
midPoint(Coordinate p0,
Coordinate p1)
Computes the midpoint of a segment |
void |
normalize()
Puts the line segment into a normalized form. |
int |
orientationIndex(Coordinate p)
Determines the orientation index of a Coordinate relative to this segment. |
int |
orientationIndex(LineSegment seg)
Determines the orientation of a LineSegment relative to this segment. |
Coordinate |
pointAlong(double segmentLengthFraction)
Computes the Coordinate that lies a given
fraction along the line defined by this segment. |
Coordinate |
pointAlongOffset(double segmentLengthFraction,
double offsetDistance)
Computes the Coordinate that lies a given
fraction along the line defined by this segment and offset from
the segment by a given distance. |
Coordinate |
project(Coordinate p)
Compute the projection of a point onto the line determined by this line segment. |
LineSegment |
project(LineSegment seg)
Project a line segment onto this line segment and return the resulting line segment. |
double |
projectionFactor(Coordinate p)
Computes the Projection Factor for the projection of the point p onto this LineSegment. |
void |
reverse()
Reverses the direction of the line segment. |
double |
segmentFraction(Coordinate inputPt)
Computes the fraction of distance (in [0.0, 1.0]) that the projection of a point occurs along this line segment. |
void |
setCoordinates(Coordinate p0,
Coordinate p1)
|
void |
setCoordinates(LineSegment ls)
|
LineString |
toGeometry(GeometryFactory geomFactory)
Creates a LineString with the same coordinates as this segment |
java.lang.String |
toString()
|
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public Coordinate p0
public Coordinate p1
Constructor Detail |
---|
public LineSegment(Coordinate p0, Coordinate p1)
public LineSegment(double x0, double y0, double x1, double y1)
public LineSegment(LineSegment ls)
public LineSegment()
Method Detail |
---|
public Coordinate getCoordinate(int i)
public void setCoordinates(LineSegment ls)
public void setCoordinates(Coordinate p0, Coordinate p1)
public double getLength()
public boolean isHorizontal()
true
if the segment is horizontalpublic boolean isVertical()
true
if the segment is verticalpublic int orientationIndex(LineSegment seg)
seg
- the LineSegment to compare
seg
is to the left of this segmentpublic int orientationIndex(Coordinate p)
Coordinate
relative to this segment.
The orientation index is as defined in CGAlgorithms.computeOrientation(com.vividsolutions.jts.geom.Coordinate, com.vividsolutions.jts.geom.Coordinate, com.vividsolutions.jts.geom.Coordinate)
.
p
- the coordinate to compare
p
is to the left of this segmentCGAlgorithms.computeOrientation(Coordinate, Coordinate, Coordinate)
public void reverse()
public void normalize()
Coordinate
).
public double angle()
public Coordinate midPoint()
public static Coordinate midPoint(Coordinate p0, Coordinate p1)
public double distance(LineSegment ls)
public double distance(Coordinate p)
public double distancePerpendicular(Coordinate p)
public Coordinate pointAlong(double segmentLengthFraction)
Coordinate
that lies a given
fraction along the line defined by this segment.
A fraction of 0.0
returns the start point of the segment;
a fraction of 1.0
returns the end point of the segment.
If the fraction is < 0.0 or > 1.0 the point returned
will lie before the start or beyond the end of the segment.
segmentLengthFraction
- the fraction of the segment length along the line
public Coordinate pointAlongOffset(double segmentLengthFraction, double offsetDistance)
Coordinate
that lies a given
fraction along the line defined by this segment and offset from
the segment by a given distance.
A fraction of 0.0
offsets from the start point of the segment;
a fraction of 1.0
offsets from the end point of the segment.
The computed point is offset to the left of the line if the offset distance is
positive, to the right if negative.
segmentLengthFraction
- the fraction of the segment length along the lineoffsetDistance
- the distance the point is offset from the segment
(positive is to the left, negative is to the right)
java.lang.IllegalStateException
- if the segment has zero lengthpublic double projectionFactor(Coordinate p)
The projection factor returned will be in the range (-inf, +inf).
p
- the point to compute the factor for
public double segmentFraction(Coordinate inputPt)
Essentially, this is the projectionFactor(com.vividsolutions.jts.geom.Coordinate)
clamped to
the range [0.0, 1.0].
inputPt
- the point
public Coordinate project(Coordinate p)
Note that the projected point may lie outside the line segment. If this is the case, the projection factor will lie outside the range [0.0, 1.0].
public LineSegment project(LineSegment seg)
Note that the returned line may have zero length (i.e. the same endpoints). This can happen for instance if the lines are perpendicular to one another.
seg
- the line segment to project
null
if there is no overlappublic Coordinate closestPoint(Coordinate p)
p
- the point to find the closest point to
public Coordinate[] closestPoints(LineSegment line)
line
- the segment to find the closest point to
public Coordinate intersection(LineSegment line)
RobustLineIntersector
class should be used.
line
- a line segment
null
if there is noneRobustLineIntersector
public Coordinate lineIntersection(LineSegment line)
RobustLineIntersector
class should be used.
line
- a line segment defining an straight line with infinite extent
null
if there is no point of intersection
or an infinite number of intersection pointsRobustLineIntersector
public LineString toGeometry(GeometryFactory geomFactory)
geomFactory
- the geometery factory to use
public boolean equals(java.lang.Object o)
true
if other
has the same values for
its points.
equals
in class java.lang.Object
o
- a LineSegment
with which to do the comparison.
true
if other
is a LineSegment
with the same values for the x and y ordinates.public int hashCode()
hashCode
in class java.lang.Object
public int compareTo(java.lang.Object o)
compareTo
in interface java.lang.Comparable
o
- the LineSegment
with which this LineSegment
is being compared
LineSegment
is less than, equal to, or greater than the specified LineSegment
public boolean equalsTopo(LineSegment other)
true
if other
is
topologically equal to this LineSegment (e.g. irrespective
of orientation).
other
- a LineSegment
with which to do the comparison.
true
if other
is a LineSegment
with the same values for the x and y ordinates.public java.lang.String toString()
toString
in class java.lang.Object
|
JTS Topology Suite version 1.12 | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |