Package org.djutils.draw.line

Interface LineSegment<P extends Point<P>,D extends Directed<D>>

Type Parameters:
P - The point type (2d or 3d)
D - The directed type (2d or 3d)
All Superinterfaces:
Drawable<P>, Iterable<P>, Project<P>, Serializable
All Known Implementing Classes:
LineSegment2d, LineSegment3d
public interface LineSegment<P extends Point<P>,D extends Directed<D>> extends Drawable<P>, Serializable, Project<P>
LineSegment is the interface for a line segment bound by 2 end points. A line segment stores the order in which it has been created, so the end points are known as 'start' and 'end'.

Copyright (c) 2020-2025 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See DJUTILS License.

Author:
Alexander Verbraeck, Peter Knoppers, Wouter Schakel

  • Method Details

    • getStartPoint

      P getStartPoint()
      Get the start point of this LineSegment.
      Returns:
      the start point of this LineSegment

    • getEndPoint

      P getEndPoint()
      Get the end point of this LineSegment.
      Returns:
      the end point of this LineSegment

    • getLength

      double getLength()
      Get the length (distance from start point to end point) of this LineSegment.
      Returns:
      (distance from start point to end point) of this LineSegment

    • closestPointOnSegment

      P closestPointOnSegment(P point)
      Project a Point on this LineSegment. If the the projected points lies outside the line segment, the nearest end point of the line segment is returned. Otherwise the returned point lies between the end points of the line segment.
      Adapted from example code provided by Paul Bourke.
      Parameters:
      point - the point to project onto this segment
      Returns:
      either the start point, or the end point of this segment or a Point that lies somewhere in between those two.
      Throws:
      NullPointerException - when point is null

    • reverse

      LineSegment<P,D> reverse()
      Construct a new LineSegment with the points of this LineSegment in reverse order.
      Returns:
      the new LineSegment

    • getLocation

      default D getLocation(double position)
      Create a DirectedPoint at the specified position along this LineSegment.
      Parameters:
      position - the distance from the start point of this LineSegment.
      Returns:
      a DirectedPoint beginning at the specified position
      Throws:
      ArithmeticException - when position is NaN
      IllegalArgumentException - when position < 0, or position > length of this LineSegment

    • getLocationExtended

      D getLocationExtended(double position)
      Create a DirectedPoint at the specified position along this LineSegment.
      Parameters:
      position - the distance from the start point of this LineSegment.
      Returns:
      a DirectedPoint at the specified position
      Throws:
      ArithmeticException - when position is NaN
      IllegalArgumentException - when position is infinite