- java.lang.Object
-
- java.awt.geom.Point2D
-
- All Implemented Interfaces:
Cloneable
- Direct Known Subclasses:
Point,Point2D.Double,Point2D.Float
public abstract class Point2D extends Object implements Cloneable
ThePoint2Dclass defines a point representing a location in(x,y)coordinate space.This class is only the abstract superclass for all objects that store a 2D coordinate. The actual storage representation of the coordinates is left to the subclass.
- Since:
- 1.2
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classPoint2D.DoubleTheDoubleclass defines a point specified indoubleprecision.static classPoint2D.FloatTheFloatclass defines a point specified in float precision.
-
Constructor Summary
Constructors Modifier Constructor Description protectedPoint2D()This is an abstract class that cannot be instantiated directly.
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description Objectclone()Creates a new object of the same class and with the same contents as this object.doubledistance(double px, double py)Returns the distance from thisPoint2Dto a specified point.static doubledistance(double x1, double y1, double x2, double y2)Returns the distance between two points.doubledistance(Point2D pt)Returns the distance from thisPoint2Dto a specifiedPoint2D.doubledistanceSq(double px, double py)Returns the square of the distance from thisPoint2Dto a specified point.static doubledistanceSq(double x1, double y1, double x2, double y2)Returns the square of the distance between two points.doubledistanceSq(Point2D pt)Returns the square of the distance from thisPoint2Dto a specifiedPoint2D.booleanequals(Object obj)Determines whether or not two points are equal.abstract doublegetX()Returns the X coordinate of thisPoint2Dindoubleprecision.abstract doublegetY()Returns the Y coordinate of thisPoint2Dindoubleprecision.inthashCode()Returns the hashcode for thisPoint2D.abstract voidsetLocation(double x, double y)Sets the location of thisPoint2Dto the specifieddoublecoordinates.voidsetLocation(Point2D p)Sets the location of thisPoint2Dto the same coordinates as the specifiedPoint2Dobject.
-
-
-
Constructor Detail
-
Point2D
protected Point2D()
This is an abstract class that cannot be instantiated directly. Type-specific implementation subclasses are available for instantiation and provide a number of formats for storing the information necessary to satisfy the various accessor methods below.- Since:
- 1.2
- See Also:
Point2D.Float,Point2D.Double,Point
-
-
Method Detail
-
getX
public abstract double getX()
Returns the X coordinate of thisPoint2Dindoubleprecision.- Returns:
- the X coordinate of this
Point2D. - Since:
- 1.2
-
getY
public abstract double getY()
Returns the Y coordinate of thisPoint2Dindoubleprecision.- Returns:
- the Y coordinate of this
Point2D. - Since:
- 1.2
-
setLocation
public abstract void setLocation(double x, double y)Sets the location of thisPoint2Dto the specifieddoublecoordinates.- Parameters:
x- the new X coordinate of thisPoint2Dy- the new Y coordinate of thisPoint2D- Since:
- 1.2
-
setLocation
public void setLocation(Point2D p)
Sets the location of thisPoint2Dto the same coordinates as the specifiedPoint2Dobject.- Parameters:
p- the specifiedPoint2Dto which to set thisPoint2D- Since:
- 1.2
-
distanceSq
public static double distanceSq(double x1, double y1, double x2, double y2)Returns the square of the distance between two points.- Parameters:
x1- the X coordinate of the first specified pointy1- the Y coordinate of the first specified pointx2- the X coordinate of the second specified pointy2- the Y coordinate of the second specified point- Returns:
- the square of the distance between the two sets of specified coordinates.
- Since:
- 1.2
-
distance
public static double distance(double x1, double y1, double x2, double y2)Returns the distance between two points.- Parameters:
x1- the X coordinate of the first specified pointy1- the Y coordinate of the first specified pointx2- the X coordinate of the second specified pointy2- the Y coordinate of the second specified point- Returns:
- the distance between the two sets of specified coordinates.
- Since:
- 1.2
-
distanceSq
public double distanceSq(double px, double py)Returns the square of the distance from thisPoint2Dto a specified point.- Parameters:
px- the X coordinate of the specified point to be measured against thisPoint2Dpy- the Y coordinate of the specified point to be measured against thisPoint2D- Returns:
- the square of the distance between this
Point2Dand the specified point. - Since:
- 1.2
-
distanceSq
public double distanceSq(Point2D pt)
Returns the square of the distance from thisPoint2Dto a specifiedPoint2D.- Parameters:
pt- the specified point to be measured against thisPoint2D- Returns:
- the square of the distance between this
Point2Dto a specifiedPoint2D. - Since:
- 1.2
-
distance
public double distance(double px, double py)Returns the distance from thisPoint2Dto a specified point.- Parameters:
px- the X coordinate of the specified point to be measured against thisPoint2Dpy- the Y coordinate of the specified point to be measured against thisPoint2D- Returns:
- the distance between this
Point2Dand a specified point. - Since:
- 1.2
-
distance
public double distance(Point2D pt)
Returns the distance from thisPoint2Dto a specifiedPoint2D.- Parameters:
pt- the specified point to be measured against thisPoint2D- Returns:
- the distance between this
Point2Dand the specifiedPoint2D. - Since:
- 1.2
-
clone
public Object clone()
Creates a new object of the same class and with the same contents as this object.- Overrides:
clonein classObject- Returns:
- a clone of this instance.
- Throws:
OutOfMemoryError- if there is not enough memory.- Since:
- 1.2
- See Also:
Cloneable
-
hashCode
public int hashCode()
Returns the hashcode for thisPoint2D.- Overrides:
hashCodein classObject- Returns:
- a hash code for this
Point2D. - See Also:
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
equals
public boolean equals(Object obj)
Determines whether or not two points are equal. Two instances ofPoint2Dare equal if the values of theirxandymember fields, representing their position in the coordinate space, are the same.- Overrides:
equalsin classObject- Parameters:
obj- an object to be compared with thisPoint2D- Returns:
trueif the object to be compared is an instance ofPoint2Dand has the same values;falseotherwise.- Since:
- 1.2
- See Also:
Object.hashCode(),HashMap
-
-