de.javagl.geom

Class Rectangles

java.lang.Object

de.javagl.geom.Rectangles

public class Rectangles
extends Object

Utility methods related to rectangles

Method Summary

Modifier and Type	Method and Description
static Point2D	center(Rectangle2D r, Point2D result) Store the center of the given rectangle in the given point, and return it.
static Rectangle2D	computeBounds(AffineTransform at, Rectangle2D rSrc, Rectangle2D rDst) Compute the bounding rectangle of the given rectangle after it has been transformed with the given transform, and stores it in the given destination.
static Rectangle2D	copy(Rectangle2D r) Return a copy of the given rectangle
static Point2D	getCorner(Rectangle2D rectangle, int index, Point2D pDst) Computes the specified corner of the given rectangle, and stores it in the given destination point.
static Rectangle2D	moveCenterTo(Rectangle2D r, double x, double y, Rectangle2D result) Move the center of the given rectangle to the given position, and store the result in the given result rectangle.
static Rectangle2D	scale(Rectangle2D r, double factor, Rectangle2D result) Scale the given rectangle by the given factor, about its center, and store the result in the given result rectangle.
static Rectangle2D	translate(Rectangle2D r, double dx, double dy, Rectangle2D result) Translate the given rectangle by the specified amount, and store the result in the given result rectangle.
static Rectangle2D	union(Iterable<? extends Rectangle2D> rectangles, Rectangle2D result) Compute the union of the given rectangles, and store it in the given result rectangle.

Methods inherited from class java.lang.Object

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

Method Detail

union

public static Rectangle2D union(Iterable<? extends Rectangle2D> rectangles,
                                Rectangle2D result)

Compute the union of the given rectangles, and store it in the given result rectangle.

If the given result rectangle is null, then a new rectangle will be created and returned.

Parameters:

rectangles - The rectangles

result - The rectangle that will store the result

Returns:

The result. If the given sequence of rectangles is empty, then a rectangle at (0,0) with size (0,0) will be returned.

copy

public static Rectangle2D copy(Rectangle2D r)

Return a copy of the given rectangle

Parameters:

r - The rectangle

Returns:

The copy of the given rectangle

moveCenterTo

public static Rectangle2D moveCenterTo(Rectangle2D r,
                                       double x,
                                       double y,
                                       Rectangle2D result)

Move the center of the given rectangle to the given position, and store the result in the given result rectangle.

If the given result rectangle is null, then a new rectangle will be created and returned.

Parameters:

r - The rectangle

x - The x-coordinate

y - The y-coordinate

result - The rectangle that will store the result

Returns:

The result rectangle

translate

public static Rectangle2D translate(Rectangle2D r,
                                    double dx,
                                    double dy,
                                    Rectangle2D result)

Translate the given rectangle by the specified amount, and store the result in the given result rectangle.

If the given result rectangle is null, then a new rectangle will be created and returned.

Parameters:

r - The rectangle

dx - The movement in x-direction

dy - The movement in y-direction

result - The rectangle that will store the result

Returns:

The result rectangle

scale

public static Rectangle2D scale(Rectangle2D r,
                                double factor,
                                Rectangle2D result)

Scale the given rectangle by the given factor, about its center, and store the result in the given result rectangle.

If the given result rectangle is null, then a new rectangle will be created and returned.

Parameters:

r - The rectangle

factor - The scaling factor

result - The rectangle that will store the result

Returns:

The result rectangle

center

public static Point2D center(Rectangle2D r,
                             Point2D result)

Store the center of the given rectangle in the given point, and return it.

If the given point is null, then a new point will be created and returned

Parameters:

r - The rectangle

result - The point that will store the result

Returns:

The result

computeBounds

public static Rectangle2D computeBounds(AffineTransform at,
                                        Rectangle2D rSrc,
                                        Rectangle2D rDst)

Compute the bounding rectangle of the given rectangle after it has been transformed with the given transform, and stores it in the given destination. If the given destination is null then a new rectangle will be created and returned

Parameters:

at - The transform

rSrc - The source rectangle

rDst - The destination rectangle

Returns:

The destination rectangle

getCorner

public static Point2D getCorner(Rectangle2D rectangle,
                                int index,
                                Point2D pDst)

Computes the specified corner of the given rectangle, and stores it in the given destination point. If the given destination point is null, then a new point will be created and returned.

Parameters:

rectangle - The rectangle

index - The index. This may be an arbitrary value, and will be wrapped to be in the range [0,3].

pDst - The destination point

Returns:

The destination point.