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.
• 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