Point2D (Java Platform SE 7 )
Keywords: java.awt.geom.Point2D class

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

  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 and 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 and Description
    --- | ---
    `protected` | `Point2D()` This is an abstract class that cannot be instantiated directly.

  - ### Method Summary

    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 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 inherited from 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
      See Also:
        `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
      See Also:
        `Cloneable`

    - #### hashCode

          public int hashCode()

      Returns the hashcode for this `Point2D`.
      Overrides:
        `hashCode` in class `Object`
      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 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
      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, 2020, Oracle and/or its affiliates. All rights reserved.