Class Point2D
java.lang.Object
java.awt.geom.Point2D
- All Implemented Interfaces:
Cloneable
- Direct Known Subclasses:
Point,Point2D.Double,Point2D.Float
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 ClassesModifier and TypeClassDescriptionstatic classTheDoubleclass defines a point specified indoubleprecision.static classTheFloatclass defines a point specified in float precision. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedPoint2D()This is an abstract class that cannot be instantiated directly. -
Method Summary
Modifier and TypeMethodDescriptionclone()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.doubleReturns 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.booleanDetermines 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.voidSets the location of thisPoint2Dto the same coordinates as the specifiedPoint2Dobject.
-
Constructor Details
-
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:
-
-
Method Details
-
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
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
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
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
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:
-
hashCode
-
equals
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.
-