Module java.desktop
Package java.awt.geom

Class Point2D

• All Implemented Interfaces:
`Cloneable`
Direct Known Subclasses:
`Point`, `Point2D.Double`, `Point2D.Float`

```public abstract class Point2D
extends Object
implements Cloneable```
The `Point2D` class 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 class ` `Point2D.Double`
The `Double` class defines a point specified in `double` precision.
`static class ` `Point2D.Float`
The `Float` class defines a point specified in float precision.
• Constructor Summary

Constructors
Modifier Constructor Description
`protected ` `Point2D()`
This is an abstract class that cannot be instantiated directly.
• Method Summary

All Methods
Modifier and Type Method Description
`Object` `clone()`
Creates a new object of the same class and with the same contents as this object.
`double` ```distance​(double px, double py)```
Returns the distance from this `Point2D` to a specified point.
`static double` ```distance​(double x1, double y1, double x2, double y2)```
Returns the distance between two points.
`double` `distance​(Point2D pt)`
Returns the distance from this `Point2D` to a specified `Point2D`.
`double` ```distanceSq​(double px, double py)```
Returns the square of the distance from this `Point2D` to a specified point.
`static double` ```distanceSq​(double x1, double y1, double x2, double y2)```
Returns the square of the distance between two points.
`double` `distanceSq​(Point2D pt)`
Returns the square of the distance from this `Point2D` to a specified `Point2D`.
`boolean` `equals​(Object obj)`
Determines whether or not two points are equal.
`abstract double` `getX()`
Returns the X coordinate of this `Point2D` in `double` precision.
`abstract double` `getY()`
Returns the Y coordinate of this `Point2D` in `double` precision.
`int` `hashCode()`
Returns the hashcode for this `Point2D`.
`abstract void` ```setLocation​(double x, double y)```
Sets the location of this `Point2D` to the specified `double` coordinates.
`void` `setLocation​(Point2D p)`
Sets the location of this `Point2D` to the same coordinates as the specified `Point2D` object.
• Methods declared in class java.lang.Object

`finalize, getClass, notify, notifyAll, toString, wait, wait, wait`
• 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
`Point2D.Float`, `Point2D.Double`, `Point`
• Method Detail

• getX

`public abstract double getX()`
Returns the X coordinate of this `Point2D` in `double` precision.
Returns:
the X coordinate of this `Point2D`.
Since:
1.2
• getY

`public abstract double getY()`
Returns the Y coordinate of this `Point2D` in `double` precision.
Returns:
the Y coordinate of this `Point2D`.
Since:
1.2
• setLocation

```public abstract void setLocation​(double x,
double y)```
Sets the location of this `Point2D` to the specified `double` coordinates.
Parameters:
`x` - the new X coordinate of this `Point2D`
`y` - the new Y coordinate of this `Point2D`
Since:
1.2
• setLocation

`public void setLocation​(Point2D p)`
Sets the location of this `Point2D` to the same coordinates as the specified `Point2D` object.
Parameters:
`p` - the specified `Point2D` to which to set this `Point2D`
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 point
`y1` - the Y coordinate of the first specified point
`x2` - the X coordinate of the second specified point
`y2` - 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 point
`y1` - the Y coordinate of the first specified point
`x2` - the X coordinate of the second specified point
`y2` - 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 this `Point2D` to a specified point.
Parameters:
`px` - the X coordinate of the specified point to be measured against this `Point2D`
`py` - the Y coordinate of the specified point to be measured against this `Point2D`
Returns:
the square of the distance between this `Point2D` and the specified point.
Since:
1.2
• distanceSq

`public double distanceSq​(Point2D pt)`
Returns the square of the distance from this `Point2D` to a specified `Point2D`.
Parameters:
`pt` - the specified point to be measured against this `Point2D`
Returns:
the square of the distance between this `Point2D` to a specified `Point2D`.
Since:
1.2
• distance

```public double distance​(double px,
double py)```
Returns the distance from this `Point2D` to a specified point.
Parameters:
`px` - the X coordinate of the specified point to be measured against this `Point2D`
`py` - the Y coordinate of the specified point to be measured against this `Point2D`
Returns:
the distance between this `Point2D` and a specified point.
Since:
1.2
• distance

`public double distance​(Point2D pt)`
Returns the distance from this `Point2D` to a specified `Point2D`.
Parameters:
`pt` - the specified point to be measured against this `Point2D`
Returns:
the distance between this `Point2D` and the specified `Point2D`.
Since:
1.2
• clone

`public Object clone()`
Creates a new object of the same class and with the same contents as this object.
Overrides:
`clone` in class `Object`
Returns:
a clone of this instance.
Throws:
`OutOfMemoryError` - if there is not enough memory.
Since:
1.2
`Cloneable`
• equals

`public boolean equals​(Object obj)`
Determines whether or not two points are equal. Two instances of `Point2D` are equal if the values of their `x` and `y` member fields, representing their position in the coordinate space, are the same.
Overrides:
`equals` in class `Object`
Parameters:
`obj` - an object to be compared with this `Point2D`
Returns:
`true` if the object to be compared is an instance of `Point2D` and has the same values; `false` otherwise.
Since:
1.2
`Object.hashCode()`, `HashMap`