Point2D (Java Platform SE 8 ) (original) (raw)

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
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 indouble 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 Static Methods Instance Methods Abstract Methods Concrete 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 thisPoint2D 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 thisPoint2D 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 indouble precision.
abstract double	getY()	Returns the Y coordinate of this Point2D indouble 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 inherited from class java.lang.[Object](../../../java/lang/Object.html "class in java.lang")  
   `[finalize](../../../java/lang/Object.html#finalize--), [getClass](../../../java/lang/Object.html#getClass--), [notify](../../../java/lang/Object.html#notify--), [notifyAll](../../../java/lang/Object.html#notifyAll--), [toString](../../../java/lang/Object.html#toString--), [wait](../../../java/lang/Object.html#wait--), [wait](../../../java/lang/Object.html#wait-long-), [wait](../../../java/lang/Object.html#wait-long-int-)`

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](../../../java/awt/geom/Point2D.Float.html "class in java.awt.geom"), [Point2D.Double](../../../java/awt/geom/Point2D.Double.html "class in java.awt.geom"), [Point](../../../java/awt/Point.html "class in java.awt")

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](../../../java/awt/geom/Point2D.html "class in java.awt.geom") 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](../../../java/awt/geom/Point2D.html "class in java.awt.geom") 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](../../../java/awt/geom/Point2D.html "class in java.awt.geom") 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](../../../java/lang/Object.html "class in java.lang") clone()  
Creates a new object of the same class and with the same contents as this object.  
Overrides:  
`[clone](../../../java/lang/Object.html#clone--)` in class `[Object](../../../java/lang/Object.html "class in java.lang")`  
Returns:  
a clone of this instance.  
Throws:  
`[OutOfMemoryError](../../../java/lang/OutOfMemoryError.html "class in java.lang")` \- if there is not enough memory.  
Since:  
1.2  
See Also:  
[Cloneable](../../../java/lang/Cloneable.html "interface in java.lang")  
* #### hashCode  
public int hashCode()  
Returns the hashcode for this `Point2D`.  
Overrides:  
`[hashCode](../../../java/lang/Object.html#hashCode--)` in class `[Object](../../../java/lang/Object.html "class in java.lang")`  
Returns:  
a hash code for this `Point2D`.  
See Also:  
[Object.equals(java.lang.Object)](../../../java/lang/Object.html#equals-java.lang.Object-), [System.identityHashCode(java.lang.Object)](../../../java/lang/System.html#identityHashCode-java.lang.Object-)  
* #### equals  
public boolean equals([Object](../../../java/lang/Object.html "class in java.lang") 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](../../../java/lang/Object.html#equals-java.lang.Object-)` in class `[Object](../../../java/lang/Object.html "class in java.lang")`  
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  
See Also:  
[Object.hashCode()](../../../java/lang/Object.html#hashCode--), [HashMap](../../../java/util/HashMap.html "class in java.util")

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

Point2D (Java Platform SE 8 ) (original) (raw)

Nested Class Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail