com.alee.utils

Class GeometryUtils

java.lang.Object

com.alee.utils.GeometryUtils

public final class GeometryUtils
extends Object

This class provides a set of utilities to work with points and various shapes.

Author:

Mikle Garin

Method Summary

Modifier and Type	Method and Description
static int	distance(Point p1, Point p2) Returns distance between two points.
static Rectangle	expand(Rectangle rect, int expansion) Returns rectangle expanded in four directions for the specified value.
static Rectangle	expand(Rectangle rect, int top, int left, int bottom, int right) Returns rectangle expanded in four directions for the specified values.
static Point	findMiddleLineIntersection(Rectangle rect, Point outer) Returns intersection point of the rectangle and the line going from the middle of that rectangle to the outer point.
static double	getAngle(int x1, int y1, int x2, int y2) Returns angle between the line specified by points and y=0 line.
static double	getAngle(Point p1, Point p2) Returns angle between the line specified by points and y=0 line.
static Rectangle	getContainingRect(List<Point> points) Returns rectangle containing all specified points.
static Rectangle	getContainingRect(Point... points) Returns rectangle containing all specified points.
static Rectangle	getContainingRect(Rectangle... rectangles) Returns rectangle containing all specified rectangles.
static Rectangle	getContainingRect(Rectangle r1, Rectangle r2) Returns rectangle containing two others.
static Rectangle	getNonNullContainingRect(List<Point> points) Returns rectangle containing all specified points.
static Rectangle	getNonNullContainingRect(Point... points) Returns rectangle containing all specified points.
static Rectangle	getNonNullContainingRect(Rectangle... rectangles) Returns rectangle containing all specified rectangles.
static Rectangle	getNonNullContainingRect(Rectangle r1, Rectangle r2) Returns rectangle containing two others.
static Point	middle(int x1, int y1, int x2, int y2) Returns middle point between the specified points.
static Point	middle(Point p1, Point p2) Returns middle point between the specified points.
static Point	middle(Rectangle rectangle) Returns middle point for the specified rectangle.
static Point	modify(Point point, int xMod, int yMod) Returns modified point.
static double	toDegrees(double angle) Returns angle converted into degrees.
static double	toRadians(double angle) Returns angle converted into radians.

Methods inherited from class java.lang.Object

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

Method Detail

getContainingRect

@Nullable
public static Rectangle getContainingRect(@Nullable
                                                    List<Point> points)

Returns rectangle containing all specified points.

Parameters:

points - points to process

Returns:

rectangle containing all specified points

getContainingRect

@Nullable
public static Rectangle getContainingRect(@Nullable
                                                    Point... points)

Returns rectangle containing all specified points.

Parameters:

points - points to process

Returns:

rectangle containing all specified points

getContainingRect

@Nullable
public static Rectangle getContainingRect(@Nullable
                                                    Rectangle... rectangles)

Returns rectangle containing all specified rectangles.

Parameters:

rectangles - rectangles to process

Returns:

rectangle containing all specified rectangles

getContainingRect

@Nullable
public static Rectangle getContainingRect(@Nullable
                                                    Rectangle r1,
                                                    @Nullable
                                                    Rectangle r2)

Returns rectangle containing two others.

Parameters:

r1 - first rectangle

r2 - second rectangle

Returns:

rectangle containing two others or null if both rectangles are null

getNonNullContainingRect

@NotNull
public static Rectangle getNonNullContainingRect(@NotNull
                                                          List<Point> points)

Returns rectangle containing all specified points.

Parameters:

points - points to process

Returns:

rectangle containing all specified points

getNonNullContainingRect

@NotNull
public static Rectangle getNonNullContainingRect(@NotNull
                                                          Point... points)

Returns rectangle containing all specified points.

Parameters:

points - points to process

Returns:

rectangle containing all specified points

getNonNullContainingRect

@NotNull
public static Rectangle getNonNullContainingRect(@NotNull
                                                          Rectangle... rectangles)

Returns rectangle containing all specified rectangles.

Parameters:

rectangles - rectangles to process

Returns:

rectangle containing all specified rectangles

getNonNullContainingRect

@NotNull
public static Rectangle getNonNullContainingRect(@NotNull
                                                          Rectangle r1,
                                                          @NotNull
                                                          Rectangle r2)

Returns rectangle containing two others.

Parameters:

r1 - first rectangle

r2 - second rectangle

Returns:

rectangle containing two others or null if both rectangles are null

middle

@NotNull
public static Point middle(@NotNull
                                    Rectangle rectangle)

Returns middle point for the specified rectangle.

Parameters:

rectangle - rectangle to process

Returns:

middle point for the specified rectangle

middle

@NotNull
public static Point middle(@NotNull
                                    Point p1,
                                    @NotNull
                                    Point p2)

Returns middle point between the specified points.

Parameters:

p1 - first point

p2 - second point

Returns:

middle point between the specified points

middle

@NotNull
public static Point middle(int x1,
                                    int y1,
                                    int x2,
                                    int y2)

Returns middle point between the specified points.

Parameters:

x1 - first point X coordinate

y1 - first point Y coordinate

x2 - second point X coordinate

y2 - second point Y coordinate

Returns:

middle point between the specified points

expand

@NotNull
public static Rectangle expand(@NotNull
                                        Rectangle rect,
                                        int expansion)

Returns rectangle expanded in four directions for the specified value.

Parameters:

rect - rectangle to expand

expansion - expansion

Returns:

rectangle expanded in four directions for the specified values

expand

@NotNull
public static Rectangle expand(@NotNull
                                        Rectangle rect,
                                        int top,
                                        int left,
                                        int bottom,
                                        int right)

Returns rectangle expanded in four directions for the specified values.

Parameters:

rect - rectangle to expand

top - top expansion

left - left expansion

bottom - bottom expansion

right - right expansion

Returns:

rectangle expanded in four directions for the specified values

modify

@NotNull
public static Point modify(@NotNull
                                    Point point,
                                    int xMod,
                                    int yMod)

Returns modified point.

Parameters:

point - point to modify

xMod - X coordinate modifier

yMod - Y coordinate modifier

Returns:

modified point

getAngle

public static double getAngle(@NotNull
                              Point p1,
                              @NotNull
                              Point p2)

Returns angle between the line specified by points and y=0 line.

Parameters:

p1 - first line point

p2 - second line point

Returns:

angle between the line specified by points and y=0 line

getAngle

public static double getAngle(int x1,
                              int y1,
                              int x2,
                              int y2)

Returns angle between the line specified by points and y=0 line.

Parameters:

x1 - first point X coordinate

y1 - first point Y coordinate

x2 - second point X coordinate

y2 - second point Y coordinate

Returns:

angle between the line specified by points and y=0 line

findMiddleLineIntersection

@NotNull
public static Point findMiddleLineIntersection(@NotNull
                                                        Rectangle rect,
                                                        @NotNull
                                                        Point outer)

Returns intersection point of the rectangle and the line going from the middle of that rectangle to the outer point.

Parameters:

rect - rectangle to process

outer - outer point to process

Returns:

intersection point of the rectangle and the line going from the middle of that rectangle to the outer point

toRadians

public static double toRadians(double angle)

Returns angle converted into radians.

Parameters:

angle - angle to convert

Returns:

angle converted into radians

toDegrees

public static double toDegrees(double angle)

Returns angle converted into degrees.

Parameters:

angle - angle to convert

Returns:

angle converted into degrees

distance

public static int distance(@NotNull
                           Point p1,
                           @NotNull
                           Point p2)

Returns distance between two points.

Parameters:

p1 - first point

p2 - second point

Returns:

distance between two points