Package org.djutils.draw.point

Class DirectedPoint2d

java.lang.Object
org.djutils.draw.point.Point2d
org.djutils.draw.point.DirectedPoint2d
All Implemented Interfaces:
Serializable, Directed<DirectedPoint2d>, Directed2d<DirectedPoint2d>, Drawable<Point2d>, Drawable2d, Point<Point2d>
Direct Known Subclasses:
Ray2d
public class DirectedPoint2d extends Point2d implements Directed2d<DirectedPoint2d>
DirectedPoint2d.java.

Copyright (c) 2023-2024 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information https://djutils.org. The DJUTILS project is distributed under a three-clause BSD-style license, which can be found at https://djutils.org/docs/license.html.

Author:
Alexander Verbraeck, Peter Knoppers
See Also:

  • Field Details

    • dirZ

      public final double dirZ
      The counter-clockwise rotation around the point in radians.

  • Constructor Details

    • DirectedPoint2d

      public DirectedPoint2d(double x, double y, double dirZ) throws IllegalArgumentException
      Construct a new DirectedPoint2d with an x and y coordinate and a direction.
      Parameters:
      x - double; the x coordinate
      y - double; the y coordinate
      dirZ - double; the counter-clockwise rotation around the point in radians
      Throws:
      IllegalArgumentException - when any coordinate or dirZ is NaN

    • DirectedPoint2d

      public DirectedPoint2d(double[] xy, double dirZ) throws IllegalArgumentException
      Construct a new DirectedPoint2d from an x and y coordinates in a double[] and a direction.
      Parameters:
      xy - double[]; the x and y coordinates in that order
      dirZ - double; the counter-clockwise rotation around the point in radians
      Throws:
      NullPointerException - when xy is null
      IllegalArgumentException - when the dimension of xy is not 2 or any value in xy is NaN or rotZ is NaN

    • DirectedPoint2d

      public DirectedPoint2d(Point2D point, double dirZ) throws IllegalArgumentException
      Construct a new DirectedPoint2d from an AWT Point2D and a direction.
      Parameters:
      point - Point2D; an AWT Point2D
      dirZ - double; the counter-clockwise rotation around the point in radians
      Throws:
      IllegalArgumentException - when any coordinate in point is NaN, or rotZ is NaN

    • DirectedPoint2d

      public DirectedPoint2d(Point2d point, double dirZ) throws IllegalArgumentException
      Construct a new DirectedPoint2d from a Point2d and a direction.
      Parameters:
      point - Point2d; a point (with or without orientation)
      dirZ - double; the counter-clockwise rotation around the point in radians
      Throws:
      IllegalArgumentException - when rotZ is NaN

    • DirectedPoint2d

      public DirectedPoint2d(double x, double y, double throughX, double throughY) throws DrawRuntimeException
      Construct a new DirectedPoint2d from two coordinates and the coordinates of a point that the direction goes through.
      Parameters:
      x - double; the x coordinate of the of the new DirectedPoint
      y - double; the y coordinate of the of the new DirectedPoint
      throughX - double; the x-coordinate of a point that the direction goes through
      throughY - double; the y-coordinate of a point that the direction goes through
      Throws:
      DrawRuntimeException - when throughX == x and throughY == y, or any through-value is NaN

    • DirectedPoint2d

      public DirectedPoint2d(Point2d point, double throughX, double throughY) throws NullPointerException, DrawRuntimeException
      Construct a new DirectedPoint2d from a Point2d and the coordinates of a point that the direction goes through.
      Parameters:
      point - Point2d; the point
      throughX - double; the x coordinate of a point that the direction goes through
      throughY - double; the y coordinate of a point that the direction goes through
      Throws:
      NullPointerException - when point is null
      DrawRuntimeException - when throughX == point.x and throughY == point.y, or any through-value is NaN

  • Method Details

    • translate

      public DirectedPoint2d translate(double dx, double dy) throws IllegalArgumentException
      Description copied from class: Point2d
      Return a new Point2d with a translation by the provided dx and dy.
      Overrides:
      translate in class Point2d
      Parameters:
      dx - double; the x translation
      dy - double; the y translation
      Returns:
      P; a new point with the translated coordinates
      Throws:
      IllegalArgumentException - when dx, or dy is NaN

    • translate

      public DirectedPoint3d translate(double dx, double dy, double z) throws IllegalArgumentException
      Description copied from class: Point2d
      Return a new Point3d with a translation by the provided dx, dy and dz. If this is an OrientedPoint2d, then the result is an OrientedPoint3d with rotX copied from this and rotY and rotZ are set to 0.0.
      Overrides:
      translate in class Point2d
      Parameters:
      dx - double; the x translation
      dy - double; the y translation
      z - double; the z translation
      Returns:
      Point2d; a new point with the translated coordinates
      Throws:
      IllegalArgumentException - when dx, dy, or dz is NaN

    • scale

      public DirectedPoint2d scale(double factor) throws IllegalArgumentException
      Description copied from interface: Point
      Return a new Point with the coordinates of this point scaled by the provided factor.
      Specified by:
      scale in interface Point<Point2d>
      Overrides:
      scale in class Point2d
      Parameters:
      factor - double; the scale factor
      Returns:
      Point; a new point with the coordinates of this point scaled by the provided factor
      Throws:
      IllegalArgumentException - when factor is NaN

    • neg

      public DirectedPoint2d neg()
      Description copied from interface: Point
      Return a new Point with negated coordinate values. If this is a DirectedPoint, dirY and dirZ are negated.
      Specified by:
      neg in interface Directed<DirectedPoint2d>
      Specified by:
      neg in interface Point<Point2d>
      Overrides:
      neg in class Point2d
      Returns:
      Point; a new point with negated coordinate values

    • abs

      public DirectedPoint2d abs()
      Description copied from interface: Point
      Return a new Point with absolute coordinate values. If this is a DirectedPoint, dirY and dirZ are copied unchanged.
      Specified by:
      abs in interface Point<Point2d>
      Overrides:
      abs in class Point2d
      Returns:
      Point; a new point with absolute coordinate values

    • normalize

      public DirectedPoint2d normalize()
      Description copied from interface: Point
      Return a new Point with a distance of 1 to the origin.
      Specified by:
      normalize in interface Point<Point2d>
      Overrides:
      normalize in class Point2d
      Returns:
      Point; the normalized point

    • interpolate

      public DirectedPoint2d interpolate(DirectedPoint2d otherPoint, double fraction) throws NullPointerException, IllegalArgumentException
      Interpolate towards another DirectedPoint2d with a fraction. It is allowed for fraction to be less than zero or larger than 1. In that case the interpolation turns into an extrapolation. DirZ is interpolated using the AngleUtil.interpolateShortest method.
      Parameters:
      otherPoint - DirectedPoint2d; the other point
      fraction - double; the factor for interpolation towards the other point. When <code>fraction</code> is between 0 and 1, it is an interpolation, otherwise an extrapolation. If fraction is 0; this Point is returned; if fraction is 1, the otherPoint is returned
      Returns:
      DirectedPoint2d; a new OrientedPoint2d at the requested fraction
      Throws:
      NullPointerException - when otherPoint is null
      IllegalArgumentException - when fraction is NaN

    • rotate

      public DirectedPoint2d rotate(double rotateZ) throws IllegalArgumentException
      Return a new DirectedPoint2d with an in-place rotation around the z-axis by the provided rotateZ. The resulting rotation is normalized between -π and π.
      Parameters:
      rotateZ - double; the rotation around the z-axis
      Returns:
      DirectedPoint2d; a new point with the same coordinates and applied rotation
      Throws:
      IllegalArgumentException - when deltaRotZ is NaN

    • getDirZ

      public double getDirZ()
      Description copied from interface: Directed2d
      Retrieve the angle from the positive x-axis. Positive rotates towards the positive y-axis (and beyond).
      Specified by:
      getDirZ in interface Directed2d<DirectedPoint2d>
      Returns:
      double; dirZ

    • getPoints

      public Iterator<? extends DirectedPoint2d> getPoints()
      Description copied from interface: Drawable
      Retrieve, or generate all points that make up the object.
      Specified by:
      getPoints in interface Drawable<Point2d>
      Overrides:
      getPoints in class Point2d
      Returns:
      Iterable<Point2d>; an iterator that generates all points that make up the object

    • 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 Point2d
      Returns:
      String; 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>
      Overrides:
      toString in class Point2d
      Parameters:
      doubleFormat - String; a format string (something like "%6.3f") which will be used to render every coordinate value)
      doNotIncludeClassName - boolean; 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:
      String; textual representation of the Drawable

    • epsilonEquals

      public boolean epsilonEquals(DirectedPoint2d other, double epsilonCoordinate, double epsilonRotation) throws NullPointerException, IllegalArgumentException
      Description copied from interface: Directed
      Compare this Directed with another Directed with specified tolerances in the coordinates and the angles.
      Specified by:
      epsilonEquals in interface Directed<DirectedPoint2d>
      Parameters:
      other - D; the Directed to compare to
      epsilonCoordinate - double; the upper bound of difference for one of the coordinates; use Double.POSITIVE_INFINITY if you do not want to check the coordinates
      epsilonRotation - double; the upper bound of difference for the direction(s); use Double.POSITIVE_INFINITY if you do not want to check the angles
      Returns:
      boolean; true if x, y, and z are less than epsilonCoordinate apart, and rotX, rotY and rotZ are less than epsilonRotation apart, otherwise false
      Throws:
      NullPointerException - when point is null
      IllegalArgumentException - epsilonCoordinate or epsilonRotation is NaN or negative

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Point2d

    • equals

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