org.cesiumjs.cs.core

Class IntersectionTests

java.lang.Object

org.cesiumjs.cs.core.IntersectionTests

@JsType(isNative=true,
        namespace="Cesium",
        name="IntersectionTests")
public class IntersectionTests
extends Object

Functions for computing the intersection between geometries such as rays, planes, triangles, and ellipsoids.

Author:

Serge Silaev aka iSergio

Method Summary

Modifier and Type	Method and Description
static Cartesian3	grazingAltitudeLocation(Ray ray, Ellipsoid ellipsoid) Provides the point along the ray which is nearest to the ellipsoid.
static Cartesian3	lineSegmentPlane(Cartesian3 endPoint0, Cartesian3 endPoint1, Plane plane) Computes the intersection of a line segment and a plane.
static Cartesian3	lineSegmentPlane(Cartesian3 endPoint0, Cartesian3 endPoint1, Plane plane, Cartesian3 result) Computes the intersection of a line segment and a plane.
static Interval	lineSegmentSphere(Cartesian3 p0, Cartesian3 p1, BoundingSphere sphere) Computes the intersection points of a line segment with a sphere.
static Interval	lineSegmentSphere(Cartesian3 p0, Cartesian3 p1, BoundingSphere sphere, Interval result) Computes the intersection points of a line segment with a sphere.
static Cartesian3	lineSegmentTriangle(Cartesian3 v0, Cartesian3 v1, Cartesian3 p0, Cartesian3 p1, Cartesian3 p2) Computes the intersection of a line segment and a triangle.
static Cartesian3	lineSegmentTriangle(Cartesian3 v0, Cartesian3 v1, Cartesian3 p0, Cartesian3 p1, Cartesian3 p2, boolean cullBackFaces) Computes the intersection of a line segment and a triangle.
static Cartesian3	lineSegmentTriangle(Cartesian3 v0, Cartesian3 v1, Cartesian3 p0, Cartesian3 p1, Cartesian3 p2, boolean cullBackFaces, Cartesian3 result) Computes the intersection of a line segment and a triangle.
static Interval	rayEllipsoid(Ray ray, Ellipsoid ellipsoid) Computes the intersection points of a ray with an ellipsoid.
static Cartesian3	rayPlane(Ray ray, Plane plane) Computes the intersection of a ray and a plane.
static Cartesian3	rayPlane(Ray ray, Plane plane, Cartesian3 result) Computes the intersection of a ray and a plane.
static Interval	raySphere(Ray ray, BoundingSphere sphere) Computes the intersection points of a ray with a sphere.
static Interval	raySphere(Ray ray, BoundingSphere sphere, Interval result) Computes the intersection points of a ray with a sphere.
static Cartesian3	rayTriangle(Ray ray, Cartesian3 p0, Cartesian3 p1, Cartesian3 p2) Computes the intersection of a ray and a triangle as a Cartesian3 coordinate.
static Cartesian3	rayTriangle(Ray ray, Cartesian3 p0, Cartesian3 p1, Cartesian3 p2, boolean cullBackFaces) Computes the intersection of a ray and a triangle as a Cartesian3 coordinate.
static Cartesian3	rayTriangle(Ray ray, Cartesian3 p0, Cartesian3 p1, Cartesian3 p2, boolean cullBackFaces, Cartesian3 result) Computes the intersection of a ray and a triangle as a Cartesian3 coordinate.
static double	rayTriangleParametric(Cartesian3 ray, Cartesian3 p0, Cartesian3 p1, Cartesian3 p2) Computes the intersection of a ray and a triangle as a parametric distance along the input ray.
static double	rayTriangleParametric(Cartesian3 ray, Cartesian3 p0, Cartesian3 p1, Cartesian3 p2, boolean cullBackFaces) Computes the intersection of a ray and a triangle as a parametric distance along the input ray.
static Object	trianglePlaneIntersection(Cartesian3 p0, Cartesian3 p1, Cartesian3 p2, Plane plane) Computes the intersection of a triangle and a plane

Methods inherited from class java.lang.Object

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

Method Detail

lineSegmentSphere

@JsMethod
public static Interval lineSegmentSphere(Cartesian3 p0,
                                                   Cartesian3 p1,
                                                   BoundingSphere sphere)

Computes the intersection points of a line segment with a sphere.

Parameters:

p0 - An end point of the line segment.

p1 - The other end point of the line segment.

sphere - The sphere.

Returns:

The interval containing scalar points along the ray or undefined if there are no intersections.

lineSegmentSphere

@JsMethod
public static Interval lineSegmentSphere(Cartesian3 p0,
                                                   Cartesian3 p1,
                                                   BoundingSphere sphere,
                                                   Interval result)

Computes the intersection points of a line segment with a sphere.

Parameters:

p0 - An end point of the line segment.

p1 - The other end point of the line segment.

sphere - The sphere.

result - The result onto which to store the result.

Returns:

The interval containing scalar points along the ray or undefined if there are no intersections.

lineSegmentTriangle

@JsMethod
public static Cartesian3 lineSegmentTriangle(Cartesian3 v0,
                                                       Cartesian3 v1,
                                                       Cartesian3 p0,
                                                       Cartesian3 p1,
                                                       Cartesian3 p2)

Computes the intersection of a line segment and a triangle.

Parameters:

v0 - The an end point of the line segment.

v1 - The other end point of the line segment.

p0 - The first vertex of the triangle.

p1 - The second vertex of the triangle.

p2 - The third vertex of the triangle.

Returns:

The intersection point or undefined if there is no intersections.

lineSegmentTriangle

@JsMethod
public static Cartesian3 lineSegmentTriangle(Cartesian3 v0,
                                                       Cartesian3 v1,
                                                       Cartesian3 p0,
                                                       Cartesian3 p1,
                                                       Cartesian3 p2,
                                                       boolean cullBackFaces)

Computes the intersection of a line segment and a triangle.

Parameters:

v0 - The an end point of the line segment.

v1 - The other end point of the line segment.

p0 - The first vertex of the triangle.

p1 - The second vertex of the triangle.

p2 - The third vertex of the triangle.

cullBackFaces - If true, will only compute an intersection with the front face of the triangle and return undefined for intersections with the back face.

Returns:

The intersection point or undefined if there is no intersections.

lineSegmentTriangle

@JsMethod
public static Cartesian3 lineSegmentTriangle(Cartesian3 v0,
                                                       Cartesian3 v1,
                                                       Cartesian3 p0,
                                                       Cartesian3 p1,
                                                       Cartesian3 p2,
                                                       boolean cullBackFaces,
                                                       Cartesian3 result)

Computes the intersection of a line segment and a triangle.

Parameters:

v0 - The an end point of the line segment.

v1 - The other end point of the line segment.

p0 - The first vertex of the triangle.

p1 - The second vertex of the triangle.

p2 - The third vertex of the triangle.

cullBackFaces - If true, will only compute an intersection with the front face of the triangle and return undefined for intersections with the back face.

result - The Cartesian3 onto which to store the result.

Returns:

The intersection point or undefined if there is no intersections.

raySphere

@JsMethod
public static Interval raySphere(Ray ray,
                                           BoundingSphere sphere)

Computes the intersection points of a ray with a sphere.

Parameters:

ray - The ray.

sphere - The sphere.

Returns:

The interval containing scalar points along the ray or undefined if there are no intersections.

raySphere

@JsMethod
public static Interval raySphere(Ray ray,
                                           BoundingSphere sphere,
                                           Interval result)

Computes the intersection points of a ray with a sphere.

Parameters:

ray - The ray.

sphere - The sphere.

result - The result onto which to store the result.

Returns:

The interval containing scalar points along the ray or undefined if there are no intersections.

rayTriangle

@JsMethod
public static Cartesian3 rayTriangle(Ray ray,
                                               Cartesian3 p0,
                                               Cartesian3 p1,
                                               Cartesian3 p2)

Computes the intersection of a ray and a triangle as a Cartesian3 coordinate. Implements Parameters:

ray - The ray.

p0 - The first vertex of the triangle.

p1 - The second vertex of the triangle.

p2 - The third vertex of the triangle.

Returns:

The intersection point or undefined if there is no intersections.

rayTriangle

@JsMethod
public static Cartesian3 rayTriangle(Ray ray,
                                               Cartesian3 p0,
                                               Cartesian3 p1,
                                               Cartesian3 p2,
                                               boolean cullBackFaces)

Computes the intersection of a ray and a triangle as a Cartesian3 coordinate. Implements Parameters:

ray - The ray.

p0 - The first vertex of the triangle.

p1 - The second vertex of the triangle.

p2 - The third vertex of the triangle.

cullBackFaces - If true, will only compute an intersection with the front face of the triangle and return undefined for intersections with the back face.

Returns:

The intersection point or undefined if there is no intersections.

rayTriangle

@JsMethod
public static Cartesian3 rayTriangle(Ray ray,
                                               Cartesian3 p0,
                                               Cartesian3 p1,
                                               Cartesian3 p2,
                                               boolean cullBackFaces,
                                               Cartesian3 result)

Computes the intersection of a ray and a triangle as a Cartesian3 coordinate. Implements Parameters:

ray - The ray.

p0 - The first vertex of the triangle.

p1 - The second vertex of the triangle.

p2 - The third vertex of the triangle.

cullBackFaces - If true, will only compute an intersection with the front face of the triangle and return undefined for intersections with the back face.

result - The Cartesian3 onto which to store the result.

Returns:

The intersection point or undefined if there is no intersections.

rayTriangleParametric

@JsMethod
public static double rayTriangleParametric(Cartesian3 ray,
                                                     Cartesian3 p0,
                                                     Cartesian3 p1,
                                                     Cartesian3 p2)

Computes the intersection of a ray and a triangle as a parametric distance along the input ray. Implements Fast Minimum Storage Ray/Triangle Intersection by Tomas Moller and Ben Trumbore.

Parameters:

ray - The ray.

p0 - The first vertex of the triangle.

p1 - The second vertex of the triangle.

p2 - The third vertex of the triangle.

Returns:

The intersection as a parametric distance along the ray, or undefined if there is no intersection.

rayTriangleParametric

@JsMethod
public static double rayTriangleParametric(Cartesian3 ray,
                                                     Cartesian3 p0,
                                                     Cartesian3 p1,
                                                     Cartesian3 p2,
                                                     boolean cullBackFaces)

Computes the intersection of a ray and a triangle as a parametric distance along the input ray. Implements Fast Minimum Storage Ray/Triangle Intersection by Tomas Moller and Ben Trumbore.

Parameters:

ray - The ray.

p0 - The first vertex of the triangle.

p1 - The second vertex of the triangle.

p2 - The third vertex of the triangle.

cullBackFaces - If true, will only compute an intersection with the front face of the triangle and return undefined for intersections with the back face.

Returns:

The intersection as a parametric distance along the ray, or undefined if there is no intersection.

grazingAltitudeLocation

@JsMethod
public static Cartesian3 grazingAltitudeLocation(Ray ray,
                                                           Ellipsoid ellipsoid)

Provides the point along the ray which is nearest to the ellipsoid.

Parameters:

ray - The ray.

ellipsoid - The ellipsoid.

Returns:

The nearest planetodetic point on the ray.

lineSegmentPlane

@JsMethod
public static Cartesian3 lineSegmentPlane(Cartesian3 endPoint0,
                                                    Cartesian3 endPoint1,
                                                    Plane plane)

Computes the intersection of a line segment and a plane.

Parameters:

endPoint0 - An end point of the line segment.

endPoint1 - The other end point of the line segment.

plane - The plane.

Returns:

The intersection point or undefined if there is no intersection.

lineSegmentPlane

@JsMethod
public static Cartesian3 lineSegmentPlane(Cartesian3 endPoint0,
                                                    Cartesian3 endPoint1,
                                                    Plane plane,
                                                    Cartesian3 result)

Computes the intersection of a line segment and a plane.

Parameters:

endPoint0 - An end point of the line segment.

endPoint1 - The other end point of the line segment.

plane - The plane.

result - The object onto which to store the result.

Returns:

The intersection point or undefined if there is no intersection.

rayEllipsoid

@JsMethod
public static Interval rayEllipsoid(Ray ray,
                                              Ellipsoid ellipsoid)

Computes the intersection points of a ray with an ellipsoid.

Parameters:

ray - The ray.

ellipsoid - The ellipsoid.

Returns:

The interval containing scalar points along the ray or undefined if there are no intersections.

rayPlane

@JsMethod
public static Cartesian3 rayPlane(Ray ray,
                                            Plane plane)

Computes the intersection of a ray and a plane.

Parameters:

ray - The ray.

plane - The plane.

Returns:

The intersection point or undefined if there is no intersections.

rayPlane

@JsMethod
public static Cartesian3 rayPlane(Ray ray,
                                            Plane plane,
                                            Cartesian3 result)

Computes the intersection of a ray and a plane.

Parameters:

ray - The ray.

plane - The plane.

result - The object onto which to store the result.

Returns:

The intersection point or undefined if there is no intersections.

trianglePlaneIntersection

@JsMethod
public static Object trianglePlaneIntersection(Cartesian3 p0,
                                                         Cartesian3 p1,
                                                         Cartesian3 p2,
                                                         Plane plane)

Computes the intersection of a triangle and a plane

Parameters:

p0 - First point of the triangle

p1 - Second point of the triangle

p2 - Third point of the triangle

plane - Intersection plane

Returns:

An object with properties positions and indices, which are arrays that represent three triangles that do not cross the plane. (Undefined if no intersection exists)