acm.graphics

Class GPoint

java.lang.Object

acm.graphics.GPoint

All Implemented Interfaces:

java.io.Serializable

public class GPoint
extends java.lang.Object
implements java.io.Serializable

This class is a double-precision version of the Point class in java.awt.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GPoint() Constructs a new GPoint at the origin (0, 0).
GPoint(double x, double y) Constructs a new GPoint with the specified coordinates.
GPoint(GPoint p) Constructs a new GPoint from an existing one.
GPoint(java.awt.Point p) Constructs a new GPoint from an existing AWT Point.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Tests whether two GPoint objects are equal.
GPoint	getLocation() Returns a new GPoint whose coordinates are the same as this one.
double	getX() Returns the x coordinate of this GPoint.
double	getY() Returns the y coordinate of this GPoint.
int	hashCode() Returns an integer hash code for the point.
void	setLocation(double x, double y) Sets the location of the GPoint to the specified x and y values.
void	setLocation(GPoint p) Sets the location of the GPoint to that of an existing one.
java.awt.Point	toPoint() Converts this GPoint to the nearest integer-based Point.
java.lang.String	toString() Converts this GPoint to its string representation.
void	translate(double dx, double dy) Adjusts the coordinates of a point by the specified dx and dy offsets.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

GPoint

public GPoint()

Constructs a new GPoint at the origin (0, 0).

GPoint

public GPoint(double x,
              double y)

Constructs a new GPoint with the specified coordinates.

Parameters:

x - The x-coordinate of the point

y - The y-coordinate of the point

GPoint

public GPoint(GPoint p)

Constructs a new GPoint from an existing one.

Parameters:

p - The original point

GPoint

public GPoint(java.awt.Point p)

Constructs a new GPoint from an existing AWT Point.

Parameters:

p - An AWT Point

Method Detail

getX

public double getX()

Returns the x coordinate of this GPoint.

Returns:

The x coordinate of this GPoint

getY

public double getY()

Returns the y coordinate of this GPoint.

Returns:

The y coordinate of this GPoint

setLocation

public void setLocation(double x,
                        double y)

Sets the location of the GPoint to the specified x and y values.

Parameters:

x - The new x-coordinate for the point

y - The new y-coordinate for the point

setLocation

public void setLocation(GPoint p)

Sets the location of the GPoint to that of an existing one.

Parameters:

p - An existing GPoint specifying the new location

getLocation

public GPoint getLocation()

Returns a new GPoint whose coordinates are the same as this one.

Returns:

A new point with the same coordinates

translate

public void translate(double dx,
                      double dy)

Adjusts the coordinates of a point by the specified dx and dy offsets.

Parameters:

dx - The change in the x direction (positive is rightward)

dy - The change in the y direction (positive is downward)

toPoint

public java.awt.Point toPoint()

Converts this GPoint to the nearest integer-based Point.

Returns:

The closest integer-based Point

hashCode

public int hashCode()

Returns an integer hash code for the point. The hash code for a GPoint is constructed from the hash codes from the float values of the coordinates, which are the ones used in the equals method.

Overrides:

hashCode in class java.lang.Object

Returns:

The hash code for this pt

equals

public boolean equals(java.lang.Object obj)

Tests whether two GPoint objects are equal. Because floating-point values are inexact, this method checks for equality by comparing the float values (rather than the double values) of the coordinates.

Overrides:

equals in class java.lang.Object

Parameters:

obj - Any object

Returns:

true if the obj is a GPoint equal to this one, and false otherwise

toString

public java.lang.String toString()

Converts this GPoint to its string representation.

Overrides:

toString in class java.lang.Object

Returns:

A string representation of this point