Package org.djutils.draw.line

Class LineSegment2d

java.lang.Object
org.djutils.draw.line.LineSegment2d
All Implemented Interfaces:
Serializable, Iterable<Point2d>, Drawable<Point2d>, Drawable2d, LineSegment<Point2d,DirectedPoint2d>, Project<Point2d>
public class LineSegment2d extends Object implements Drawable2d, LineSegment<Point2d,DirectedPoint2d>
LineSegment2d is a line segment bound by 2 end points in 2D-space. 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
See Also:

  • Field Details

    • startX

      public final double startX
      The start x-coordinate.

    • startY

      public final double startY
      The start y-coordinate.

    • endX

      public final double endX
      The end x-coordinate.

    • endY

      public final double endY
      The end y-coordinate.

  • Constructor Details

    • LineSegment2d

      public LineSegment2d(double startX, double startY, double endX, double endY)
      Construct a new LineSegment2d from four coordinates.
      Parameters:
      startX - the x-coordinate of the start point
      startY - the y-coordinate of the start point
      endX - the x-coordinate of the end point
      endY - the y-coordinate of the end point
      Throws:
      IllegalArgumentException - when (startX,startY) is the same as(endX,endY)

    • LineSegment2d

      public LineSegment2d(Point2d start, double endX, double endY)
      Construct a new LineSegment2d from a Point2d and two coordinates.
      Parameters:
      start - the start point
      endX - the x-coordinate of the end point
      endY - the y-coordinate of the end point
      Throws:
      NullPointerException - when start is null
      IllegalArgumentException - when start has the exact coordinates (endX,endY)

    • LineSegment2d

      public LineSegment2d(double startX, double startY, Point2d end) throws NullPointerException, IllegalArgumentException
      Construct a new LineSegment2d from two coordinates and a Point2d.
      Parameters:
      startX - the x-coordinate of the start point
      startY - the y-coordinate of the start point
      end - the end point
      Throws:
      NullPointerException - when end is null
      IllegalArgumentException - when end has the exact coordinates (startX,startY)

    • LineSegment2d

      public LineSegment2d(Point2d start, Point2d end)
      Construct a new LineSegment2d from two Point2d objects.
      Parameters:
      start - the start point
      end - the end point
      Throws:
      NullPointerException - when start, or end is null
      IllegalArgumentException - when start has the same coordinates as end

  • Method Details

    • getStartPoint

      public Point2d getStartPoint()
      Description copied from interface: LineSegment
      Get the start point of this LineSegment.
      Specified by:
      getStartPoint in interface LineSegment<Point2d,DirectedPoint2d>
      Returns:
      the start point of this LineSegment

    • getEndPoint

      public Point2d getEndPoint()
      Description copied from interface: LineSegment
      Get the end point of this LineSegment.
      Specified by:
      getEndPoint in interface LineSegment<Point2d,DirectedPoint2d>
      Returns:
      the end point of this LineSegment

    • getLength

      public double getLength()
      Description copied from interface: LineSegment
      Get the length (distance from start point to end point) of this LineSegment.
      Specified by:
      getLength in interface LineSegment<Point2d,DirectedPoint2d>
      Returns:
      (distance from start point to end point) of this LineSegment

    • iterator

      public Iterator<Point2d> iterator()
      Specified by:
      iterator in interface Iterable<Point2d>

    • size

      public int size()
      Description copied from interface: Drawable
      Retrieve the number of points that make up the object.
      Specified by:
      size in interface Drawable<Point2d>
      Returns:
      the number of points that make up the object

    • getAbsoluteBounds

      public Bounds2d getAbsoluteBounds()
      Description copied from interface: Drawable2d
      Retrieve the bounding rectangle of the object in absolute coordinates.
      Specified by:
      getAbsoluteBounds in interface Drawable2d
      Returns:
      the bounding box of the object in absolute coordinates

    • getLocationExtended

      public DirectedPoint2d getLocationExtended(double position)
      Description copied from interface: LineSegment
      Create a DirectedPoint at the specified position along this LineSegment.
      Specified by:
      getLocationExtended in interface LineSegment<Point2d,DirectedPoint2d>
      Parameters:
      position - the distance from the start point of this LineSegment.
      Returns:
      a DirectedPoint at the specified position

    • closestPointOnSegment

      public Point2d closestPointOnSegment(Point2d point)
      Description copied from interface: LineSegment
      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.
      Specified by:
      closestPointOnSegment in interface LineSegment<Point2d,DirectedPoint2d>
      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.

    • reverse

      public LineSegment2d reverse()
      Description copied from interface: LineSegment
      Construct a new LineSegment with the points of this LineSegment in reverse order.
      Specified by:
      reverse in interface LineSegment<Point2d,DirectedPoint2d>
      Returns:
      the new LineSegment

    • projectOrthogonal

      public Point2d projectOrthogonal(Point2d point)
      Description copied from interface: Project
      Project a point onto this object. For PolyLines and Polygons, there may be multiple valid solutions. In that case the solution that lies on the closest segment is returned. If there is no valid solution on the closest segment, null is returned.
      Specified by:
      projectOrthogonal in interface Project<Point2d>
      Parameters:
      point - the point
      Returns:
      the projection of the point (may be null if no sensible projection is possible). If the result is not null; the result lies somewhere on this object.

    • projectOrthogonalExtended

      public Point2d projectOrthogonalExtended(Point2d point)
      Description copied from interface: Project
      Project a point onto this object. For PolyLines and Polygons, there may be multiple valid solutions. In that case the solution that lies on the closest segment is returned.
      Specified by:
      projectOrthogonalExtended in interface Project<Point2d>
      Parameters:
      point - the point
      Returns:
      the projection of the point. This result cannot be null, but it may not lie on this object, but, in stead, lie on a line, or plane that extends this object

    • projectOrthogonalFractional

      public double projectOrthogonalFractional(Point2d point)
      Description copied from interface: Project
      Project a point onto this object. For PolyLines and Polygons, there may be multiple valid solutions. In that case the solution that lies on the closest segment is returned. If there is no valid solution on the closest segment, NaN is returned.
      Specified by:
      projectOrthogonalFractional in interface Project<Point2d>
      Parameters:
      point - the point
      Returns:
      the fractional position of the projection of the point (may be NaN if no sensible projection is possible). If the result is not NaN; the result lies somewhere on this object.

    • projectOrthogonalFractionalExtended

      public double projectOrthogonalFractionalExtended(Point2d point)
      Description copied from interface: Project
      Project a point onto this object. For PolyLines and Polygons, there may be multiple valid solutions. In that case the solution that lies on the closest segment is returned.
      Specified by:
      projectOrthogonalFractionalExtended in interface Project<Point2d>
      Parameters:
      point - the point
      Returns:
      the fractional position of the projection of the point. This result cannot be NaN, but it may be outside the range 0.0 .. 1.0.

    • toString

      public String toString()
      Description copied from interface: Drawable
      Produce a string describing the Drawable using default conversion for the (double) coordinate values. Regrettably, it is not allowed to provide a default implementation here.
      Specified by:
      toString in interface Drawable<Point2d>
      Overrides:
      toString in class Object
      Returns:
      a string describing the Drawable

    • toString

      public String toString(String doubleFormat, boolean doNotIncludeClassName)
      Description copied from interface: Drawable
      Produce a String describing the Drawable.
      Specified by:
      toString in interface Drawable<Point2d>
      Parameters:
      doubleFormat - a format string (something like "%6.3f") which will be used to render every coordinate value)
      doNotIncludeClassName - if true; the output of toString is not prefixed by the class name. This is useful for concatenating the textual representation of lots of Drawables (e.g. an array, or a List).
      Returns:
      textual representation of the Drawable

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object