org.apache.commons.geometry.euclidean.threed.line

Class LinecastPoint3D

java.lang.Object

org.apache.commons.geometry.euclidean.AbstractLinecastPoint<Vector3D,Vector3D.Unit,Line3D>

org.apache.commons.geometry.euclidean.threed.line.LinecastPoint3D

public class LinecastPoint3D
extends AbstractLinecastPoint<Vector3D,Vector3D.Unit,Line3D>

Class representing intersections resulting from linecast operations in Euclidean 3D space. This class contains the intersection point along with the boundary normal of the target at the point of intersection.

See Also:

Linecastable3D

Field Summary

Fields

Modifier and Type	Field and Description
static Comparator<LinecastPoint3D>	ABSCISSA_ORDER Comparator that sorts intersection instances by increasing abscissa order.

Constructor Summary

Constructors

Constructor and Description
LinecastPoint3D(Vector3D point, Vector3D normal, Line3D line) Construct a new instance from its components.

Method Summary

Modifier and Type	Method and Description
boolean	eq(LinecastPoint3D other, Precision.DoubleEquivalence precision) Return true if this instance should be considered equivalent to the argument, using the given precision context for comparison.
static void	sortAndFilter(List<LinecastPoint3D> pts) Sort the given list of linecast points by increasing abscissa value and filter to remove duplicate entries (as determined by the eq(LinecastPoint3D, Precision.DoubleEquivalence) method).

Methods inherited from class org.apache.commons.geometry.euclidean.AbstractLinecastPoint

equals, getAbscissa, getLine, getNormal, getPoint, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

ABSCISSA_ORDER

public static final Comparator<LinecastPoint3D> ABSCISSA_ORDER

Comparator that sorts intersection instances by increasing abscissa order. If two abscissa values are equal, the comparison uses Vector3D.COORDINATE_ASCENDING_ORDER with the intersection normals.

Constructor Detail

LinecastPoint3D

public LinecastPoint3D(Vector3D point,
                       Vector3D normal,
                       Line3D line)

Construct a new instance from its components.

Parameters:

point - intersection point

normal - normal of the target boundary at the intersection point

line - intersecting line

Method Detail

eq

public boolean eq(LinecastPoint3D other,
                  Precision.DoubleEquivalence precision)

Return true if this instance should be considered equivalent to the argument, using the given precision context for comparison. Instances are considered equivalent if they have equivalent points, normals, and lines.

Parameters:

other - other point to compare with

precision - context to use for the comparison

Returns:

true if this instance should be considered equivalent to the argument

sortAndFilter

public static void sortAndFilter(List<LinecastPoint3D> pts)

Sort the given list of linecast points by increasing abscissa value and filter to remove duplicate entries (as determined by the eq(LinecastPoint3D, Precision.DoubleEquivalence) method). The argument is modified.

Parameters:

pts - list of points to sort and filter