fr.cnes.sirius.patrius.math.geometry.euclidean.twod

Class Segment

java.lang.Object

fr.cnes.sirius.patrius.math.geometry.euclidean.twod.Segment

public class Segment
extends Object

Simple container for a two-points segment.

Since:

3.0

Version:

$Id: Segment.java 18108 2017-10-04 06:45:27Z bignon $

Constructor Summary

Constructors

Constructor and Description
Segment(Vector2D startIn, Vector2D endIn) Build a segment.
Segment(Vector2D startIn, Vector2D endIn, Line lineIn) Build a segment.

Method Summary

Modifier and Type	Method and Description
double	distance(Vector2D p) Calculates the shortest distance from a point to this line segment.
Vector2D	getClosestPoint(Vector2D p) Returns closest point of provided point belonging to segment.
Vector2D	getEnd() Get the end point of the segment.
Vector2D	getIntersection(Segment segment) Returns the intersection between two segments, null if there is no intersection.
Line	getLine() Get the line containing the segment.
Vector2D	getStart() Get the start point of the segment.

Methods inherited from class java.lang.Object

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

Constructor Detail

Segment

public Segment(Vector2D startIn,
               Vector2D endIn,
               Line lineIn)

Build a segment.

Parameters:

startIn - start point of the segment

endIn - end point of the segment

lineIn - line containing the segment

Segment

public Segment(Vector2D startIn,
               Vector2D endIn)

Build a segment.

Parameters:

startIn - start point of the segment

endIn - end point of the segment

Method Detail

getStart

public Vector2D getStart()

Get the start point of the segment.

Returns:

start point of the segment

getEnd

public Vector2D getEnd()

Get the end point of the segment.

Returns:

end point of the segment

getLine

public Line getLine()

Get the line containing the segment.

Returns:

line containing the segment

distance

public double distance(Vector2D p)

Calculates the shortest distance from a point to this line segment.

If the perpendicular extension from the point to the line does not cross in the bounds of the line segment, the shortest distance to the two end points will be returned.

Algorithm adapted from: Thread @ Codeguru

Parameters:

p - to check

Returns:

distance between the instance and the point

Since:

3.1

getClosestPoint

public Vector2D getClosestPoint(Vector2D p)

Returns closest point of provided point belonging to segment.

Parameters:

p - a point

Returns:

closest point of provided point belonging to segment

getIntersection

public Vector2D getIntersection(Segment segment)

Returns the intersection between two segments, null if there is no intersection.

Parameters:

segment - a segment

Returns:

the intersection between two segments, null if there is no intersection