| gvSIG desktop 1

/*

 *

 * Este codigo se distribuye bajo licencia GPL

 * de GNU. Para obtener una c?pia integra de esta

 * licencia acude a www.gnu.org.

 * 

 * Este software se distribuye "como es". AGIL

 * solo  pretende desarrollar herramientas para

 * la promoci?n del GIS Libre.

 * AGIL no se responsabiliza de las perdidas econ?micas o de 

 * informaci?n derivadas del uso de este software.

 */

package com.iver.cit.jdwglib.util;

/**

 *  3dim double point. A point is transformed different than a vector.

 *  The class is now declared final to allow a more aggresive optimization.

 *

 *  @see       dxfviewer.math.Vector3D;

 *

 *  @version   1.10,?01/13/99

 */

public final class Point3D {

  public double   x, y, z;     // coordinates, allowing direct access

  /**

   *

   */

  public Point3D() {

  }

  /**

   *  Copy constructor.

   *  @param  p    point to copy

   */

  public Point3D(Point3D p) {

        x = p.x;

        y = p.y;

        z = p.z;

  }

  /**

   *  @param   xx    x coord

   *  @param   yy    y coord

   *  @param   zz    z coord

   */

  public Point3D(double xx, double yy, double zz) {

        x = xx;

        y = yy;

        z = zz;

  }

  /**

   *  Scale.

   *  @param   f     scaling factor

   */

  public void scale(double f) {

        if (f != 1f) {

          x *= f;

          y *= f;

          z *= f;

        }

  }

  /**

   *  Add a vector.

   *  @param  v      vector to add

   */

  public void add(Vector3D v) {

        x += v.x;

        y += v.y;

        z += v.z;

  }

  /**

   *  Get sum with vector.

   *  @param  v     vector to add

   *  @return this+v

   */

  public Point3D plus(Vector3D v) {

        Point3D ret = new Point3D(this);

        ret.add(v);

        return ret;

  }

  /**

   *  Substract a vector.

   *  @param  v     vector to substract

   */

  public void sub(Vector3D v) {

        x -= v.x;

        y -= v.y;

        z -= v.z;

  }

  /**

   *  Get difference with vector.

   *  @param  v     vector to substract

   *  @return this-v

   */

  public Point3D minus(Vector3D v) {

        Point3D ret = new Point3D(this);

        ret.sub(v);

        return ret;

  }

  /**

   *  Get difference with point.

   *  @param  p     point to substract

   *  @return this-p

   */

  public Vector3D minus(Point3D p) {

        Vector3D ret = new Vector3D(this);

        ret.sub(new Vector3D(p));

        return ret;

  }

  /**

   *  Output.

   *  @return  output string

   */

  public String toString() {

        return new String(new StringBuffer().append("[").append(x).append(",").append(y).append(",").append(z).append("]"));

  }

}