replicant-frameworks_native/awt/java/awt/geom/Point2D.java
2009-03-03 19:31:44 -08:00

324 lines
8.2 KiB
Java

/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @author Denis M. Kishenko
* @version $Revision$
*/
package java.awt.geom;
import org.apache.harmony.misc.HashCode;
/**
* The Class Point2D represents a point whose data is given in high-precision
* values appropriate for graphical operations.
*
* @since Android 1.0
*/
public abstract class Point2D implements Cloneable {
/**
* The Class Float is the subclass of Point2D that has all of its data
* values stored with float-level precision.
*
* @since Android 1.0
*/
public static class Float extends Point2D {
/**
* The x coordinate.
*/
public float x;
/**
* The y coordinate.
*/
public float y;
/**
* Instantiates a new float-valued Point2D with its data set to zero.
*/
public Float() {
}
/**
* Instantiates a new float-valued Point2D with the specified
* coordinates.
*
* @param x
* the x coordinate.
* @param y
* the y coordinate.
*/
public Float(float x, float y) {
this.x = x;
this.y = y;
}
@Override
public double getX() {
return x;
}
@Override
public double getY() {
return y;
}
/**
* Sets the point's coordinates.
*
* @param x
* the x coordinate.
* @param y
* the y coordinate.
*/
public void setLocation(float x, float y) {
this.x = x;
this.y = y;
}
@Override
public void setLocation(double x, double y) {
this.x = (float)x;
this.y = (float)y;
}
@Override
public String toString() {
return getClass().getName() + "[x=" + x + ",y=" + y + "]"; //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$
}
}
/**
* The Class Double is the subclass of Point2D that has all of its data
* values stored with double-level precision.
*
* @since Android 1.0
*/
public static class Double extends Point2D {
/**
* The x coordinate.
*/
public double x;
/**
* The y coordinate.
*/
public double y;
/**
* Instantiates a new double-valued Point2D with its data set to zero.
*/
public Double() {
}
/**
* Instantiates a new double-valued Point2D with the specified
* coordinates.
*
* @param x
* the x coordinate.
* @param y
* the y coordinate.
*/
public Double(double x, double y) {
this.x = x;
this.y = y;
}
@Override
public double getX() {
return x;
}
@Override
public double getY() {
return y;
}
@Override
public void setLocation(double x, double y) {
this.x = x;
this.y = y;
}
@Override
public String toString() {
return getClass().getName() + "[x=" + x + ",y=" + y + "]"; //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$
}
}
/**
* Instantiates a new Point2D.
*/
protected Point2D() {
}
/**
* Gets the x coordinate.
*
* @return the x coordinate.
*/
public abstract double getX();
/**
* Gets the y coordinate.
*
* @return the y coordinate.
*/
public abstract double getY();
/**
* Sets the point's coordinates.
*
* @param x
* the x coordinate.
* @param y
* the y coordinate.
*/
public abstract void setLocation(double x, double y);
/**
* Sets the point's coordinates by copying them from another point.
*
* @param p
* the point to copy the data from.
*/
public void setLocation(Point2D p) {
setLocation(p.getX(), p.getY());
}
/**
* Finds the square of the distance between the two specified points.
*
* @param x1
* the x coordinate of the first point.
* @param y1
* the y coordinate of the first point.
* @param x2
* the x coordinate of the second point.
* @param y2
* the y coordinate of the second point.
* @return the square of the distance between the two specified points.
*/
public static double distanceSq(double x1, double y1, double x2, double y2) {
x2 -= x1;
y2 -= y1;
return x2 * x2 + y2 * y2;
}
/**
* Finds the square of the distance between this point and the specified
* point.
*
* @param px
* the x coordinate of the point.
* @param py
* the y coordinate of the point.
* @return the square of the distance between this point and the specified
* point.
*/
public double distanceSq(double px, double py) {
return Point2D.distanceSq(getX(), getY(), px, py);
}
/**
* Finds the square of the distance between this point and the specified
* point.
*
* @param p
* the other point.
* @return the square of the distance between this point and the specified
* point.
*/
public double distanceSq(Point2D p) {
return Point2D.distanceSq(getX(), getY(), p.getX(), p.getY());
}
/**
* Finds the distance between the two specified points.
*
* @param x1
* the x coordinate of the first point.
* @param y1
* the y coordinate of the first point.
* @param x2
* the x coordinate of the second point.
* @param y2
* the y coordinate of the second point.
* @return the distance between the two specified points.
*/
public static double distance(double x1, double y1, double x2, double y2) {
return Math.sqrt(distanceSq(x1, y1, x2, y2));
}
/**
* Finds the distance between this point and the specified point.
*
* @param px
* the x coordinate of the point.
* @param py
* the y coordinate of the point.
* @return the distance between this point and the specified point.
*/
public double distance(double px, double py) {
return Math.sqrt(distanceSq(px, py));
}
/**
* Finds the distance between this point and the specified point.
*
* @param p
* the other point.
* @return the distance between this point and the specified point.
*/
public double distance(Point2D p) {
return Math.sqrt(distanceSq(p));
}
@Override
public Object clone() {
try {
return super.clone();
} catch (CloneNotSupportedException e) {
throw new InternalError();
}
}
@Override
public int hashCode() {
HashCode hash = new HashCode();
hash.append(getX());
hash.append(getY());
return hash.hashCode();
}
@Override
public boolean equals(Object obj) {
if (obj == this) {
return true;
}
if (obj instanceof Point2D) {
Point2D p = (Point2D)obj;
return getX() == p.getX() && getY() == p.getY();
}
return false;
}
}