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

Class Ray3D

java.lang.Object

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

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

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

All Implemented Interfaces:

Embedding<Vector3D,Vector1D>, RegionEmbedding<Vector3D,Vector1D>, Sized

public final class Ray3D
extends LineConvexSubset3D

Class representing a ray in 3D Euclidean space. A ray is a portion of a line consisting of a single start point and extending to infinity along the direction of the line.

Instances of this class are guaranteed to be immutable.

See Also:

ReverseRay3D, Lines3D, Ray

Method Summary

Modifier and Type	Method and Description
Bounds3D	getBounds() Get the 3D bounding box of the line subset or null if the subset is empty or infinite.
Vector3D	getCentroid() Get the centroid, or geometric center, of the line subset or null if the subset is empty or infinite.
Vector3D	getDirection() Get the direction of the ray.
Vector3D	getEndPoint() Get the end point for the line subset.
double	getSize()
Vector3D	getStartPoint() Get the start point for the line subset.
double	getSubspaceEnd() Get the 1D end location of the line subset or Double.POSITIVE_INFINITY if no end location exists.
double	getSubspaceStart() Get the 1D start location of the line subset or Double.NEGATIVE_INFINITY if no start location exists.
boolean	isFinite()
boolean	isInfinite()
String	toString()
Ray3D	transform(Transform<Vector3D> transform) Transform this instance.

Methods inherited from class org.apache.commons.geometry.euclidean.threed.line.LineConvexSubset3D

contains, getInterval, getSubspaceRegion

Methods inherited from class org.apache.commons.geometry.euclidean.threed.line.LineSubset3D

getLine, 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.Embedding

toSpace, toSubspace

Method Detail

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.

getStartPoint

public Vector3D getStartPoint()

Description copied from class: LineConvexSubset3D

Get the start point for the line subset.

Specified by:

getStartPoint in class LineConvexSubset3D

Returns:

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

getSubspaceStart

public double getSubspaceStart()

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

Specified by:

getSubspaceStart in class LineConvexSubset3D

Returns:

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

getEndPoint

public Vector3D getEndPoint()

Get the end point for the line subset.

This method always returns null.

Specified by:

getEndPoint in class LineConvexSubset3D

Returns:

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

getSubspaceEnd

public double getSubspaceEnd()

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

This method always returns Double.POSITIVE_INFINITY.

Specified by:

getSubspaceEnd in class LineConvexSubset3D

Returns:

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

getCentroid

public Vector3D getCentroid()

Get the centroid, or geometric center, of the line subset or null if the subset is empty or infinite.

This method always returns null.

Specified by:

getCentroid in class LineSubset3D

Returns:

the centroid of the line subset, or null if the subset is empty or infinite

getBounds

public Bounds3D getBounds()

Get the 3D bounding box of the line subset or null if the subset is empty or infinite.

This method always returns null.

Specified by:

getBounds in class LineSubset3D

Returns:

the 3D bounding box the line subset or null if the subset is empty or infinite

getDirection

public Vector3D getDirection()

Get the direction of the ray. This is a convenience method for ray.getLine().getDirection().

Returns:

the direction of the ray

transform

public Ray3D transform(Transform<Vector3D> transform)

Transform this instance.

Specified by:

transform in class LineConvexSubset3D

Parameters:

transform - the transform to apply

Returns:

a new, transformed instance

toString

public String toString()

Overrides:

toString in class Object