EE324StandardProjectClasses

Class Point2D

java.lang.Object

EE324StandardProjectClasses.Point2D

public class Point2D
extends java.lang.Object

A simple 2D point class with drawing methods.

NOTE: This class requires Sedgewick's and Wayne's StdDraw library.

Author:

Conor McArdle (conor.mcardle@dcu.ie)

Constructor Summary

Constructors

Constructor and Description
Point2D(double x, double y) Construct a point with given x and y coordinate values.
Point2D(Point2D p) Copy constructor - makes a copy of the specified point.

Method Summary

Modifier and Type	Method and Description
static int	collinearMid(Point2D[] pts, int i, int j, int k) If the three points at the specified indices in pts are collinear, return index of 'middle' point, otherwise return -1
static int	collinearMid(Point2D[] pts, int i, int j, int k, double delta) If the three points at the specified indices in pts are collinear (within a given precision error), return index of 'middle' point, otherwise return -1
double	distanceTo(Point2D p) Distance from this point to another point p.
void	draw() Draw this point using the current StdDraw color and pen width.
void	draw(java.awt.Color clr) Draw this point with a specified color.
void	draw(java.awt.Color clr, double penWidth) Draw this point with a specified color and pen width.
void	drawTo(Point2D p) Draw a line from this point to anther point p using the current StdDraw color and pen width.
void	drawTo(Point2D p, java.awt.Color clr) Draw a line from this point to anther point p using a specified color.
void	drawTo(Point2D p, java.awt.Color clr, double penWidth) Draw a line from this point to anther point p using a specified color and pen width.
boolean	isEqual(Point2D p) Test if this point is coincident with another point p.
Point2D	midPoint(Point2D p) Get mid-point of this point and another point p.
static void	polyDemo(int numSides) Demonstrator for the Point2D class.
java.lang.String	toString() Get string representation of this point in the form "(x,y)".
double	X() Get x-coordinate of this point.
double	Y() Get y-coordinate of this point.

Methods inherited from class java.lang.Object

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

Constructor Detail

Point2D

public Point2D(double x,
               double y)

Construct a point with given x and y coordinate values.

Parameters:

x - coordinate of point

y - coordinate of point

Point2D

public Point2D(Point2D p)

Copy constructor - makes a copy of the specified point.

Parameters:

p - point to copy

Method Detail

collinearMid

public static int collinearMid(Point2D[] pts,
                               int i,
                               int j,
                               int k)

If the three points at the specified indices in pts are collinear,
return index of 'middle' point, otherwise return -1

Parameters:

pts - array of Point2D

i - index of first point

j - index of second point

k - index of third point

Returns:

index of middle collinear point, -1 if points are not collinear

collinearMid

public static int collinearMid(Point2D[] pts,
                               int i,
                               int j,
                               int k,
                               double delta)

If the three points at the specified indices in pts are collinear (within a given precision error),
return index of 'middle' point, otherwise return -1

Parameters:

pts - array of Point2D

i - index of first point

j - index of second point

k - index of third point

delta - allowable precision error

Returns:

index of middle collinear point, -1 if points are not collinear

distanceTo

public double distanceTo(Point2D p)

Distance from this point to another point p.

Parameters:

p - other point

Returns:

distance from this point to other point

draw

public void draw()

Draw this point using the current StdDraw color and pen width. Uses the StdDraw library.

draw

public void draw(java.awt.Color clr)

Draw this point with a specified color. Uses the StdDraw library.

Parameters:

clr - the pen color to use

draw

public void draw(java.awt.Color clr,
                 double penWidth)

Draw this point with a specified color and pen width. Uses the StdDraw library.

Parameters:

clr - the pen color to use

penWidth - width of the pen to use

drawTo

public void drawTo(Point2D p)

Draw a line from this point to anther point p using the current StdDraw color and pen width. Uses the StdDraw library.

Parameters:

p - other point

drawTo

public void drawTo(Point2D p,
                   java.awt.Color clr)

Draw a line from this point to anther point p using a specified color. Uses the StdDraw library.

Parameters:

p - the point to draw

clr - the pen color to use

drawTo

public void drawTo(Point2D p,
                   java.awt.Color clr,
                   double penWidth)

Draw a line from this point to anther point p using a specified color and pen width. Uses the StdDraw library.

Parameters:

p - the point to draw

clr - the pen color to use

penWidth - width of the pen to use

isEqual

public boolean isEqual(Point2D p)

Test if this point is coincident with another point p.

Parameters:

p - point to compare this point to

Returns:

true if points have same coordinates, false otherwise

midPoint

public Point2D midPoint(Point2D p)

Get mid-point of this point and another point p.

Parameters:

p - other point

Returns:

new point which is mid-point between this point and p

polyDemo

public static void polyDemo(int numSides)

Demonstrator for the Point2D class. Constructs and draws a regular polygon.

Parameters:

numSides - number of sides of polygon

Throws:

java.lang.IllegalArgumentException - if numSides is less than 3

toString

public java.lang.String toString()

Get string representation of this point in the form "(x,y)".

Overrides:

toString in class java.lang.Object

Returns:

string representation of this point

X

public double X()

Get x-coordinate of this point.

Returns:

x coordinate of point

Y

public double Y()

Get y-coordinate of this point.

Returns:

y coordinate of point