构造器详细资料

• Point2D

  public Point2D()

  构造一个新的 Point2D 对象。

• Point2D

  public Point2D(double x,
                 double y)

  根据指定的参数来构造一个 Point2D 的新对象。

  参数:

  x - Point2D 的 X 坐标值。

  y - Point2D 的 Y 坐标值。

• Point2D

  public Point2D(Point2D pt)

  根据给定的 Point2D 对象构造一个与其完全相同的新对象。

  参数:

  pt - 指定的 Point2D 对象。

方法详细资料

• getEMPTY

  public static final Point2D getEMPTY()

  返回一个空的点对象，即其 X，Y 坐标值均为-1.7976931348623157e+308。

  返回:

  一个空的点对象。

  Example:

  以下代码示范如何构造空的二维点对象。

   public void getEmptyTest() {
          // 构造空的二维点对象
          Point2D point2D = Point2D.getEMPTY();
          System.out.println(point2D.isEmpty()); // true
      }
   

• isEmpty

  public boolean isEmpty()

  判断此点对象是否为空，即其 X 坐标和 Y 坐标是否都为-1.7976931348623157e+308。

  其使用的判断精度为默认零值精度。关于默认零值精度的详细信息请参见 Environment 类。

  返回:

  如果此 Point2D 对象为空则返回 true，否则返回 false。

  Default:

  默认值为 true，即 Point2D 对象为空。

• getX

  public double getX()

  返回此点对象的 X 坐标。

  返回:

  此二维点对象的 X 坐标。

  Default:

  默认值为 -1.79769313486232E+308。

• setX

  public void setX(double value)

  设置此点对象的 X 坐标。

  参数:

  value - 指定的此点对象的 X 坐标值。

• getY

  public double getY()

  返回此点对象的 Y 坐标。

  返回:

  此点对象的 Y 坐标。

  Default:

  默认值为 -1.79769313486232E+308。

• setY

  public void setY(double value)

  设置此点对象的 Y 坐标。

  参数:

  value - 指定的此点对象的 Y 坐标值。

• clone

  public Point2D clone()

  返回当前 Point2D 对象的一个拷贝。

  覆盖:

  clone 在类中 java.lang.Object

  返回:

  通过克隆操作得到的 Point2D 对象。

• equals

  public boolean equals(Point2D pt)

  判定此 Point2D 是否与指定的 Point2D 相等，即有相同的坐标值。注意其判定精度为零值判断精度。关于更多零值判断精度的信息，请参见 Environment 类。

  参数:

  pt - 要与此 Point2D 相比较的二维点对象。

  返回:

  如果 pt 与此 Point2D 相同返回 true，否则返回 false。

• ceiling

  public static Point2D ceiling(Point2D pt)

  返回一个新的点对象，其 X、Y 坐标值分别为大于等于指定点对象的 X、Y 坐标值的最小整数值，例如：给定点对象的 X、Y 坐标值为（32.12, 20.67），则生成的新的点对象的 X 坐标值应取大于等于给定点对象 X 坐标值的最小整数值，所以新的点对象的 X 坐标值为33，同理新的点对象的 Y 坐标值为21，因此，得到的新的点对象的坐标为（33，21）。

  参数:

  pt - 需要转换的二维点对象。

  返回:

  转换后的二维点对象。

  Example:

  以下代码示范对点几何对象进行 ceiling 操作。

   public void ceilingTest() {
          // 构造二维点对象
          Point2D point2D = new Point2D(100.5, 100.4);
          System.out.println(point2D); // {X=100.5,Y=100.4}
  
          // ceiling 操作
          Point2D point2D_c = Point2D.ceiling(point2D);
          System.out.println(point2D_c); // {X=101.0,Y=101.0}
      }
   

• round

  public static Point2D round(Point2D pt)

  返回一个新的点对象。如果给定对象的 X 或 Y 坐标值是整数值，则新对象的 X 或 Y 坐标值取给定对象的整数值坐标；对于给定对象的 X 或者 Y 坐标值为小数时，则新对象的 X 或者 Y 坐标值取给定对象的小数坐标值经过舍入后的整数值， 其中，小数部分的舍入存在一定的规则：取最接近小数的整数，如果小数正好处于两个整数中间，其中一个整数为偶数，另一个整数为奇数，则返回偶数。

  例如：

  • 给定的点对象的坐标为（32.12，26.67），则新的点对象的坐标为（32，27）；
  • 给定的点对象的坐标为（32，26.67），则新的点对象的坐标为（32，27）；
  • 给定的点对象的坐标为（32.5，25.5），则新的点对象的坐标为（32，26）。

  参数:

  pt - 要转换的二维点对象。

  返回:

  转换后的二维点对象。

• floor

  public static Point2D floor(Point2D pt)

  返回一个新的点对象，其 X、Y 坐标值分别为小于等于指定点对象的 X、Y 坐标值的最大整数值，例如：给定点对象的 X、Y 坐标值为（32.12，20.67），则生成的新的点对象的 X 坐标值应取小于等于给定点对象 X 坐标值的最大整数值，所以新的点对象的 X 坐标值为32，同理新的点对象的 Y 坐标值为20，因此，得到的新的点对象的坐标为（32，20）。 如果给定的点对象的 X 或者 Y 坐标值为整数值，则新的点对象的 X 或者 Y 坐标值为与给定点对象相等的整数坐标值，例如：给定的点对象坐标值为（10，20）则新的点对象的坐标值为（10，20）；如果给定的点对象的坐标值为（32.12，15）则新的点对象的坐标值为（32，15）。

  参数:

  pt - 要转换的二维点对象。

  返回:

  转换后的二维点对象。

  Example:

  以下代码示范对点几何对象进行 floor 操作。

   public void floorTest() {
          // 构造二维点对象
          Point2D point2D = new Point2D(100.5, 100.6);
          System.out.println(point2D); // {X=100.5,Y=100.6}
  
          // floor 操作
          Point2D point2D_f = Point2D.floor(point2D);
          System.out.println(point2D_f); // {X=100.0,Y=100.0}
      }
   

• offset

  public void offset(double dx,
                     double dy)

  将此点对象的坐标平移指定的量。

  参数:

  dx - X 坐标的偏移量。

  dy - Y 坐标的偏移量。

  Example:

  以下代码示范对点几何对象进行偏移操作。

   public void offsetTest() {
          // 构造二维点对象
          Point2D point2D = new Point2D(100, 100);
          System.out.println(point2D); // {X=100.0,Y=100.0}
  
          // offset 操作
          point2D.offset(20.5, -51.6);
          System.out.println(point2D); // {X=120.5,Y=48.4}
      }
   

• toString

  public java.lang.String toString()

  返回一个表示此点对象的坐标的格式化字符串，如点(2,3)，则返回的格式化的字符串为“{X=2.0,Y=3.0}”。

  覆盖:

  toString 在类中 java.lang.Object

  返回:

  表示此 Point2D 的字符串。

• equals

  public boolean equals(java.lang.Object obj)

  指定此 Point2D 是否包含与指定 System.Object 有相同的坐标。

  覆盖:

  equals 在类中 java.lang.Object

  参数:

  obj - 要测试的对象。

  返回:

  一个布尔值，若 obj 为 Point2D 并与此 Point2D 的坐标相等，则为 true，否则为 false。

• hashCode

  public int hashCode()

  返回此 Point2D 结构体对象的哈希代码。

  覆盖:

  hashCode 在类中 java.lang.Object

  返回:

  此 Point2D 结构体对象的哈希代码。