com.yworks.yfiles.geometry

Class GeomUtilities

java.lang.Object

com.yworks.yfiles.geometry.GeomUtilities

public final class GeomUtilities
extends Object

Utility class that performs all kind of geometric operations.

Also it serves as a factory for various implementations of geometric primitives.

Method Summary

Modifier and Type	Method and Description
static boolean	ellipseContains(RectD bounds, PointD point, double eps) Checks whether an ellipse contains the given point.
static PointD	findEllipseLineIntersection(RectD bounds, PointD inner, PointD outer) Returns the ellipse/line intersection point for the given point pair.
static double	findRayIntersection(PointD start, PointD end, PointD anchor, PointD rayDirection) Finds the intersection between a line segment and an infinite ray.

Methods inherited from class java.lang.Object

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

Method Detail

ellipseContains

public static final boolean ellipseContains(RectD bounds,
                                            PointD point,
                                            double eps)

Checks whether an ellipse contains the given point.

Parameters:

bounds - The coordinates of the bounds of the ellipse's enclosing rectangle.

point - The coordinates of the point to test.

eps - A positive value allows for fuzzy hit testing. If the point lies outside the given object but it's distance is less than or equal to that value, it will be considered a hit.

Returns:

Whether the point lies within the ellipse

findEllipseLineIntersection

public static final PointD findEllipseLineIntersection(RectD bounds,
                                                       PointD inner,
                                                       PointD outer)

Returns the ellipse/line intersection point for the given point pair.

This will always return the intersection point that lies in the direction from inner to outer.

Parameters:

bounds - The coordinates of the bounds of the ellipse's enclosing rectangle.

inner - The coordinates of a point lying inside the ellipse.

outer - The coordinates of a point lying outside the ellipse.

Returns:

The intersection point iff the inner point lies inside the ellipse and an intersection point has been found, otherwise null.

findRayIntersection

public static final double findRayIntersection(PointD start,
                                               PointD end,
                                               PointD anchor,
                                               PointD rayDirection)

Finds the intersection between a line segment and an infinite ray.

The ray is described using an anchor point and a ray direction. The direction vector does not need to be normalized. In order to obtain the intersection point do the following:

Parameters:

start - The coordinates of the first end point of the line segment.

end - The coordinates of the second end point of the line segment.

anchor - The coordinates of the starting point of the ray.

rayDirection - The direction vector of the ray.

Returns:

The distance factor or Double.POSITIVE_INFINITY if the ray does not intersect the line.