net.richarddawkins.watchmaker.geom

Class Rect

java.lang.Object

net.richarddawkins.watchmaker.geom.Rect

All Implemented Interfaces:

java.lang.Cloneable

public class Rect
extends java.lang.Object
implements java.lang.Cloneable

Java class to simulate a QuickDraw Rect (rectangle) In Pascal, a QuickDraw Rect is defined this way: TYPE RECT = RECORD (left, top, right, bottom: INTEGER); The bounding box calculations in Classic Watchmaker use a Pascal Rect record, which is defined by left, top, right, and bottom coordinates. This is at variance with the Java way of doing things, where Rectangles are defined by their upper left corner (x,y) and (width,height). This class bridges the two. This implementation of Rect also includes convenience methods for determining the midpoint of the Rect, and for expanding the boundaries of the rectangle in response to supplied values.

Author:

alan

Field Summary

Fields

Modifier and Type	Field and Description
int	bottom
int	left
int	right
int	top

Constructor Summary

Constructors

Constructor and Description
Rect()
Rect(int left, int top, int right, int bottom) Construct a new Rect with specified left, top, right, and bottom.
Rect(Rect r)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone()
boolean	contains(Point p)
void	expandBottom(int bottom, int thick) Push the Rect's bottom boundary downward if necessary.
void	expandHorizontal(int h, int thick)
void	expandLeft(int left, int thick) Push the Rect's left boundary leftward if necessary.
void	expandPoint(Point point, int thick)
void	expandRight(int right, int thick) Push the Rect's righthand boundary rightward if necessary.
void	expandTop(int top, int thick) Push the Rect's top boundary upward if necessary.
void	expandVertical(int v, int thick)
int	getArea()
Dim	getDim()
int	getHeight()
Point	getMidPoint()
int	getWidth()
void	setRect(int newleft, int newtop, int newright, int newbottom)
java.lang.String	toString()
Rect	unionRect(Rect r) Expand this rectangle where necessary so that it encompasses the given rectangle.
void	zero()
void	zeroRect()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

left

public int left

right

public int right

top

public int top

bottom

public int bottom

Constructor Detail

Rect

public Rect()

Rect

public Rect(int left,
            int top,
            int right,
            int bottom)

Construct a new Rect with specified left, top, right, and bottom. This is the same order of parameters with which Quickdraw Rects are initialized using SetRect.

Parameters:

left - left edge of the rectangle.

top - top edge of the rectangle.

right - right edge of the rectangle.

bottom - bottom edge of the rectangle.

Rect

public Rect(Rect r)

Method Detail

clone

public java.lang.Object clone()

Overrides:

clone in class java.lang.Object

getArea

public int getArea()

zero

public void zero()

expandLeft

public void expandLeft(int left,
                       int thick)

Push the Rect's left boundary leftward if necessary. If the left value was null, set it to the new left value.

Parameters:

left - the potential new lefthand boundary

thick - the thickness of the drawing primitive

expandRight

public void expandRight(int right,
                        int thick)

Push the Rect's righthand boundary rightward if necessary. If the righthand value was null, set it to the new righthand value.

Parameters:

right - the potential new righthand boundary

thick - the thickness of the drawing primitive

expandTop

public void expandTop(int top,
                      int thick)

Push the Rect's top boundary upward if necessary. If the top value was null, set it to the new top value.

Parameters:

top - the potential new top boundary

thick - the thickness of the drawing primitive

expandBottom

public void expandBottom(int bottom,
                         int thick)

Push the Rect's bottom boundary downward if necessary. If the bottom value was null, set it to the new top value.

Parameters:

bottom - the potential new bottom boundary

thick - the thickness of the drawing primitive

expandPoint

public void expandPoint(Point point,
                        int thick)

expandHorizontal

public void expandHorizontal(int h,
                             int thick)

expandVertical

public void expandVertical(int v,
                           int thick)

getMidPoint

public Point getMidPoint()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

unionRect

public Rect unionRect(Rect r)

Expand this rectangle where necessary so that it encompasses the given rectangle.

Parameters:

r - the rectangle to be union'ed with this one.

Returns:

the union'ed rectangle

getWidth

public int getWidth()

getHeight

public int getHeight()

getDim

public Dim getDim()

setRect

public void setRect(int newleft,
                    int newtop,
                    int newright,
                    int newbottom)

zeroRect

public void zeroRect()

contains

public boolean contains(Point p)