Package org.djutils.draw.line
Class Ray3d
java.lang.Object
org.djutils.draw.point.Point3d
org.djutils.draw.line.Ray3d
- All Implemented Interfaces:
Serializable
,Directed<Ray3d>
,Drawable<Point3d>
,Drawable3d
,Project<Point3d>
,Ray<Ray3d,
,Point3d> Point<Point3d>
Ray3d is a half-line; it has one end point with non-infinite coordinates; the other end point is infinitely far away.
Copyright (c) 2020-2024 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
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionfinal double
Phi; the angle from the positive X axis direction in radians.final double
Theta; the angle from the positive Z axis direction in radians. -
Constructor Summary
ConstructorDescriptionRay3d
(double x, double y, double z, double phi, double theta) Construct a new Ray3d.Ray3d
(double x, double y, double z, double throughX, double throughY, double throughZ) Construct a new Ray3d.Construct a new Ray3d.Construct a new Ray3d.Construct a new Ray3d.Construct a new Ray3d. -
Method Summary
Modifier and TypeMethodDescriptionclosestPointOnRay
(Point3d point) Project a Point on a Ray.boolean
epsilonEquals
(Ray3d other, double epsilonCoordinate, double epsilonRotation) Compare this Directed with another Directed with specified tolerances in the coordinates and the angles.boolean
flip()
Flip the direction of the Ray (creates and returns a new Ray instance).Retrieve the bounding box of the object.Get the finite end point of this Ray.getLocationExtended
(double position) Get the location at a position on the line, with its direction.final double
getPhi()
Retrieve the angle from the positive X axis direction in radians.Retrieve, or generate all points that make up the object.final double
getTheta()
Retrieve the angle from the positive Z axis direction in radians.int
hashCode()
neg()
Return a new Point with negated coordinate values.projectOrthogonal
(Point3d point) Project a point onto this object.projectOrthogonalExtended
(Point3d point) Project a point onto this object.double
Project a point onto this object.double
Project a point onto this object.int
size()
Retrieve the number of points that make up the object.toString()
Produce a string describing the Drawable using default conversion for the (double) coordinate values.Produce a String describing the Drawable.Methods inherited from class org.djutils.draw.point.Point3d
abs, closestPointOnLine, closestPointOnLine, closestPointOnLine, closestPointOnSegment, closestPointOnSegment, distance, distanceSquared, epsilonEquals, fractionalPositionOnLine, getX, getY, getZ, interpolate, normalize, project, scale, translate, translate
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.djutils.draw.Drawable
getPointList, toString, toString
Methods inherited from interface org.djutils.draw.Drawable3d
getDimensions, project
Methods inherited from interface org.djutils.draw.line.Ray
getLocation
-
Field Details
-
phi
public final double phiPhi; the angle from the positive X axis direction in radians. -
theta
public final double thetaTheta; the angle from the positive Z axis direction in radians.
-
-
Constructor Details
-
Ray3d
Construct a new Ray3d.- Parameters:
x
- double; the x coordinate of the finite end point of the rayy
- double; the y coordinate of the finite end point of the rayz
- double; the z coordinate of the finite end point of the rayphi
- double; the angle from the positive X axis direction in radians.theta
- double; the angle from the positive Z axis direction in radians- Throws:
DrawRuntimeException
- when phi is NaN
-
Ray3d
public Ray3d(Point3d point, double phi, double theta) throws NullPointerException, DrawRuntimeException Construct a new Ray3d.- Parameters:
point
- Point3d; the finite end point of the rayphi
- double; the angle from the positive X axis direction in radians.theta
- double; the angle from the positive Z axis direction in radians- Throws:
NullPointerException
- when point is nullDrawRuntimeException
- when phi is NaN, or theta is NaN
-
Ray3d
public Ray3d(double x, double y, double z, double throughX, double throughY, double throughZ) throws DrawRuntimeException Construct a new Ray3d.- Parameters:
x
- double; the x coordinate of the finite end point of the rayy
- double; the y coordinate of the finite end point of the rayz
- double; the z coordinate of the finite end point of the raythroughX
- double; the x coordinate of another point on the raythroughY
- double; the y coordinate of another point on the raythroughZ
- double; the z coordinate of another point on the ray- Throws:
DrawRuntimeException
- when throughX == x and throughY == y
-
Ray3d
public Ray3d(Point3d point, double throughX, double throughY, double throughZ) throws NullPointerException, DrawRuntimeException Construct a new Ray3d.- Parameters:
point
- Point3d; the finite end point of the raythroughX
- double; the x coordinate of another point on the raythroughY
- double; the y coordinate of another point on the raythroughZ
- double; the z coordinate of another point on the ray- Throws:
NullPointerException
- when point is nullDrawRuntimeException
- when throughX == point.x and throughY == point.y
-
Ray3d
public Ray3d(double x, double y, double z, Point3d throughPoint) throws NullPointerException, DrawRuntimeException Construct a new Ray3d.- Parameters:
x
- double; the x coordinate of the finite end point of the rayy
- double; the y coordinate of the finite end point of the rayz
- double; the z coordinate of the finite end point of the raythroughPoint
- Point3d; another point on the ray- Throws:
NullPointerException
- when throughPoint is nullDrawRuntimeException
- when throughPoint is exactly at (x, y)
-
Ray3d
Construct a new Ray3d.- Parameters:
point
- Point3d; the finite end point of the raythroughPoint
- Point3d; another point on the ray- Throws:
NullPointerException
- when point is null or throughPoint is nullDrawRuntimeException
- when throughPoint is exactly at point
-
-
Method Details
-
getPhi
public final double getPhi()Retrieve the angle from the positive X axis direction in radians. -
getTheta
public final double getTheta()Retrieve the angle from the positive Z axis direction in radians.- Returns:
- double; the angle from the positive Z axis direction in radians
-
getEndPoint
Get the finite end point of this Ray.- Specified by:
getEndPoint
in interfaceRay<Ray3d,
Point3d> - Returns:
- P; the finite end point of this Ray
-
size
public int size()Retrieve the number of points that make up the object. -
getPoints
Retrieve, or generate all points that make up the object. -
getBounds
Retrieve the bounding box of the object.- Specified by:
getBounds
in interfaceDrawable3d
- Overrides:
getBounds
in classPoint3d
- Returns:
- Bounds3d; the bounding box of the object
-
neg
Return a new Point with negated coordinate values. -
flip
Flip the direction of the Ray (creates and returns a new Ray instance). -
getLocationExtended
Get the location at a position on the line, with its direction. Position must be a positive, finite value- Specified by:
getLocationExtended
in interfaceRay<Ray3d,
Point3d> - Parameters:
position
- double; the position on the line for which to calculate the point on the line- Returns:
- R; a ray with the same direction as this ray
- Throws:
DrawRuntimeException
- when position infinite, or NaN.
-
closestPointOnRay
Project a Point on a Ray. If the the projected points lies outside the ray, the start point of the ray is returned. Otherwise the closest point on the ray is returned.
Adapted from example code provided by Paul Bourke.- Specified by:
closestPointOnRay
in interfaceRay<Ray3d,
Point3d> - Parameters:
point
- P; the point to project onto the segment- Returns:
- P; either the start point, or the end point of the segment or a Point2d that lies somewhere in between those two.
- Throws:
NullPointerException
- when point is null
-
projectOrthogonal
Project a point onto this object. For PolyLines, 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 interfaceProject<Point3d>
- Parameters:
point
- P; the point- Returns:
- P; 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.
- Throws:
NullPointerException
- when point is null;
-
projectOrthogonalExtended
Project a point onto this object. For PolyLines, there may be multiple valid solutions. In that case the solution that lies on the closest segment is returned.- Specified by:
projectOrthogonalExtended
in interfaceProject<Point3d>
- Parameters:
point
- P; the point- Returns:
- P; 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
Project a point onto this object. For PolyLines, 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:
projectOrthogonalFractional
in interfaceProject<Point3d>
- Parameters:
point
- P; the point- Returns:
- double; the fractional position of the projection of the point (may be NaN if no sensible projection is possible). If the result is not null; the result lies somewhere on this object.
- Throws:
NullPointerException
- when point is null;
-
projectOrthogonalFractionalExtended
Project a point onto this object. For PolyLines, there may be multiple valid solutions. In that case the solution that lies on the closest segment is returned.- Specified by:
projectOrthogonalFractionalExtended
in interfaceProject<Point3d>
- Parameters:
point
- P; the point- Returns:
- double; 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.
- Throws:
NullPointerException
- when point is null;
-
epsilonEquals
public boolean epsilonEquals(Ray3d other, double epsilonCoordinate, double epsilonRotation) throws NullPointerException, IllegalArgumentException Compare this Directed with another Directed with specified tolerances in the coordinates and the angles.- Specified by:
epsilonEquals
in interfaceDirected<Ray3d>
- Parameters:
other
- D; the point to compare withepsilonCoordinate
- double; the upper bound of difference for one of the coordinates; use Double.POSITIVE_INFINITY if you do not want to check the coordinatesepsilonRotation
- 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 nullIllegalArgumentException
- epsilonCoordinate or epsilonRotation is NaN or negative
-
toString
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. -
toString
Produce a String describing the Drawable.- Specified by:
toString
in interfaceDrawable<Point3d>
- Overrides:
toString
in classPoint3d
- 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
-
hashCode
public int hashCode() -
equals
-