org.apache.commons.geometry.euclidean.twod

Class ReverseRay

java.lang.Object

org.apache.commons.geometry.euclidean.twod.LineSubset

org.apache.commons.geometry.euclidean.twod.LineConvexSubset

org.apache.commons.geometry.euclidean.twod.ReverseRay

All Implemented Interfaces:

Embedding<Vector2D,Vector1D>, HyperplaneConvexSubset<Vector2D>, HyperplaneSubset<Vector2D>, Splittable<Vector2D,HyperplaneSubset<Vector2D>>, RegionEmbedding<Vector2D,Vector1D>, Sized

public final class ReverseRay
extends LineConvexSubset

Class representing a portion of a line in 2D Euclidean space that starts at infinity and continues in the direction of the line up to a single end point. This is equivalent to taking a Ray and reversing the line direction.

Instances of this class are guaranteed to be immutable.

See Also:

Ray, Lines

Method Summary

Modifier and Type	Method and Description
Bounds2D	getBounds() Get a Bounds2D object defining an axis-aligned bounding box containing all vertices for this subset.
Vector2D	getCentroid()
Vector2D	getEndPoint() Get the end point for the subset.
double	getSize()
Vector2D	getStartPoint() Get the start point for the subset.
double	getSubspaceEnd() Get the 1D end location of the subset or Double.POSITIVE_INFINITY if no end location exists.
double	getSubspaceStart() Get the 1D start location of the subset or Double.NEGATIVE_INFINITY if no start location exists.
boolean	isFinite()
boolean	isFull()
boolean	isInfinite()
Ray	reverse()
protected Split<LineConvexSubset>	splitOnIntersection(Line splitter, Vector2D intersection) Split this instance using the given splitter line and intersection point.
String	toString()
ReverseRay	transform(Transform<Vector2D> transform)

Methods inherited from class org.apache.commons.geometry.euclidean.twod.LineConvexSubset

closest, getInterval, getSubspaceRegion, isEmpty, split, toConvex

Methods inherited from class org.apache.commons.geometry.euclidean.twod.LineSubset

classify, getHyperplane, getLine, getPrecision, intersection, intersection, toSpace, toSubspace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.commons.geometry.core.partitioning.HyperplaneSubset

classify, contains, getHyperplane

Methods inherited from interface org.apache.commons.geometry.core.Embedding

toSpace, toSubspace

Method Detail

isFull

public boolean isFull()

This method always returns false.

isInfinite

public boolean isInfinite()

This method always returns true.

isFinite

public boolean isFinite()

This method always returns false.

getSize

public double getSize()

This method always returns Double.POSITIVE_INFINITY.

getCentroid

public Vector2D getCentroid()

This method always returns null.

getStartPoint

public Vector2D getStartPoint()

Get the start point for the subset.

This method always returns null.

Specified by:

getStartPoint in class LineConvexSubset

Returns:

the start point for the subset, or null if no start point exists

getSubspaceStart

public double getSubspaceStart()

Get the 1D start location of the subset or Double.NEGATIVE_INFINITY if no start location exists.

This method always returns Double.NEGATIVE_INFINITY.

Specified by:

getSubspaceStart in class LineConvexSubset

Returns:

the 1D start location of the subset or Double.NEGATIVE_INFINITY if no start location exists.

getEndPoint

public Vector2D getEndPoint()

Get the end point for the subset.

Specified by:

getEndPoint in class LineConvexSubset

Returns:

the end point for the subset, or null if no end point exists.

getSubspaceEnd

public double getSubspaceEnd()

Get the 1D end location of the subset or Double.POSITIVE_INFINITY if no end location exists.

Specified by:

getSubspaceEnd in class LineConvexSubset

Returns:

the 1D end location of the subset or Double.POSITIVE_INFINITY if no end location exists

getBounds

public Bounds2D getBounds()

Get a Bounds2D object defining an axis-aligned bounding box containing all vertices for this subset. Null is returned if the subset is infinite or does not contain any vertices.

This method always returns null.

Specified by:

getBounds in class LineSubset

Returns:

the bounding box for this instance or null if no valid bounds could be determined

transform

public ReverseRay transform(Transform<Vector2D> transform)

Specified by:

transform in interface HyperplaneConvexSubset<Vector2D>

Specified by:

transform in interface HyperplaneSubset<Vector2D>

Specified by:

transform in class LineConvexSubset

reverse

public Ray reverse()

Specified by:

reverse in interface HyperplaneConvexSubset<Vector2D>

Specified by:

reverse in class LineConvexSubset

toString

public String toString()

Overrides:

toString in class Object

splitOnIntersection

protected Split<LineConvexSubset> splitOnIntersection(Line splitter,
                                                      Vector2D intersection)

Split this instance using the given splitter line and intersection point.

Parameters:

splitter - splitter line

intersection - intersection point between the splitter line and the line for this instance

Returns:

the result of splitting this instance with the given splitter line and intersection point