java.awt.geom
Class Point2D
- 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
ThePoint2D
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 and Description static class
Point2D.Double
TheDouble
class defines a point specified indouble
precision.static class
Point2D.Float
TheFloat
class defines a point specified in float precision.
-
Constructor Summary
Constructors Modifier Constructor and 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 and 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 thisPoint2D
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 thisPoint2D
to a specifiedPoint2D
.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 specifiedPoint2D
.boolean
equals(Object obj)
Determines whether or not two points are equal.abstract double
getX()
Returns the X coordinate of thisPoint2D
indouble
precision.abstract double
getY()
Returns the Y coordinate of thisPoint2D
indouble
precision.int
hashCode()
Returns the hashcode for thisPoint2D
.abstract void
setLocation(double x, double y)
Sets the location of thisPoint2D
to the specifieddouble
coordinates.void
setLocation(Point2D p)
Sets the location of thisPoint2D
to the same coordinates as the specifiedPoint2D
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
- See Also:
-
Point2D.Float
,Point2D.Double
,Point
-
Method Detail
getX
public abstract double getX()
Returns the X coordinate of thisPoint2D
indouble
precision.- Returns:
-
the X coordinate of this
Point2D
. - Since:
- 1.2
getY
public abstract double getY()
Returns the Y coordinate of thisPoint2D
indouble
precision.- Returns:
-
the Y coordinate of this
Point2D
. - Since:
- 1.2
setLocation
public abstract void setLocation(double x, double y)
Sets the location of thisPoint2D
to the specifieddouble
coordinates.- Parameters:
-
x
- the new X coordinate of thisPoint2D
-
y
- the new Y coordinate of thisPoint2D
- Since:
- 1.2
setLocation
public void setLocation(Point2D p)
Sets the location of thisPoint2D
to the same coordinates as the specifiedPoint2D
object.- Parameters:
-
p
- the specifiedPoint2D
to 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 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 thisPoint2D
to a specified point.- Parameters:
-
px
- the X coordinate of the specified point to be measured against thisPoint2D
-
py
- the Y coordinate of the specified point to be measured against thisPoint2D
- 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 thisPoint2D
to a specifiedPoint2D
.- Parameters:
-
pt
- the specified point to be measured against thisPoint2D
- Returns:
-
the square of the distance between this
Point2D
to a specifiedPoint2D
. - Since:
- 1.2
distance
public double distance(double px, double py)
Returns the distance from thisPoint2D
to a specified point.- Parameters:
-
px
- the X coordinate of the specified point to be measured against thisPoint2D
-
py
- the Y coordinate of the specified point to be measured against thisPoint2D
- Returns:
-
the distance between this
Point2D
and a specified point. - Since:
- 1.2
distance
public double distance(Point2D pt)
Returns the distance from thisPoint2D
to a specifiedPoint2D
.- Parameters:
-
pt
- the specified point to be measured against thisPoint2D
- Returns:
-
the distance between this
Point2D
and 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:
-
clone
in 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:
-
hashCode
in 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 ofPoint2D
are equal if the values of theirx
andy
member fields, representing their position in the coordinate space, are the same.- Overrides:
-
equals
in classObject
- Parameters:
-
obj
- an object to be compared with thisPoint2D
- Returns:
-
true
if the object to be compared is an instance ofPoint2D
and has the same values;false
otherwise. - Since:
- 1.2
- See Also:
-
Object.hashCode()
,HashMap
-
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, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.