/*
 * Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package com.sun.javafx.geom;

A 3-dimensional, double-precision, floating-point vector.
/** * A 3-dimensional, double-precision, floating-point vector. * */
public class Vec3d {
The x coordinate.
/** * The x coordinate. */
public double x;
The y coordinate.
/** * The y coordinate. */
public double y;
The z coordinate.
/** * The z coordinate. */
public double z; public Vec3d() { } public Vec3d(double x, double y, double z) { this.x = x; this.y = y; this.z = z; } public Vec3d(Vec3d v) { set(v); } public Vec3d(Vec3f v) { set(v); } public void set(Vec3f v) { this.x = v.x; this.y = v.y; this.z = v.z; } public void set(Vec3d v) { this.x = v.x; this.y = v.y; this.z = v.z; } public void set(double x, double y, double z) { this.x = x; this.y = y; this.z = z; }
Multiplies this vector by the specified scalar value.
Params:
  • scale – the scalar value
/** * Multiplies this vector by the specified scalar value. * @param scale the scalar value */
public void mul(double scale) { x *= scale; y *= scale; z *= scale; }
Sets the value of this vector to the difference of vectors t1 and t2 (this = t1 - t2).
Params:
  • t1 – the first vector
  • t2 – the second vector
/** * Sets the value of this vector to the difference * of vectors t1 and t2 (this = t1 - t2). * @param t1 the first vector * @param t2 the second vector */
public void sub(Vec3f t1, Vec3f t2) { this.x = t1.x - t2.x; this.y = t1.y - t2.y; this.z = t1.z - t2.z; }
Sets the value of this vector to the difference of vectors t1 and t2 (this = t1 - t2).
Params:
  • t1 – the first vector
  • t2 – the second vector
/** * Sets the value of this vector to the difference * of vectors t1 and t2 (this = t1 - t2). * @param t1 the first vector * @param t2 the second vector */
public void sub(Vec3d t1, Vec3d t2) { this.x = t1.x - t2.x; this.y = t1.y - t2.y; this.z = t1.z - t2.z; }
Sets the value of this vector to the difference of itself and vector t1 (this = this - t1) .
Params:
  • t1 – the other vector
/** * Sets the value of this vector to the difference of * itself and vector t1 (this = this - t1) . * @param t1 the other vector */
public void sub(Vec3d t1) { this.x -= t1.x; this.y -= t1.y; this.z -= t1.z; }
Sets the value of this vector to the sum of vectors t1 and t2 (this = t1 + t2).
Params:
  • t1 – the first vector
  • t2 – the second vector
/** * Sets the value of this vector to the sum * of vectors t1 and t2 (this = t1 + t2). * @param t1 the first vector * @param t2 the second vector */
public void add(Vec3d t1, Vec3d t2) { this.x = t1.x + t2.x; this.y = t1.y + t2.y; this.z = t1.z + t2.z; }
Sets the value of this vector to the sum of itself and vector t1 (this = this + t1) .
Params:
  • t1 – the other vector
/** * Sets the value of this vector to the sum of * itself and vector t1 (this = this + t1) . * @param t1 the other vector */
public void add(Vec3d t1) { this.x += t1.x; this.y += t1.y; this.z += t1.z; }
Returns the length of this vector.
Returns:the length of this vector
/** * Returns the length of this vector. * @return the length of this vector */
public double length() { return Math.sqrt(this.x*this.x + this.y*this.y + this.z*this.z); }
Normalize this vector.
/** * Normalize this vector. */
public void normalize() { double norm = 1.0 / length(); this.x = this.x * norm; this.y = this.y * norm; this.z = this.z * norm; }
Sets this vector to be the vector cross product of vectors v1 and v2.
Params:
  • v1 – the first vector
  • v2 – the second vector
/** * Sets this vector to be the vector cross product of vectors v1 and v2. * @param v1 the first vector * @param v2 the second vector */
public void cross(Vec3d v1, Vec3d v2) { double tmpX; double tmpY; tmpX = v1.y * v2.z - v1.z * v2.y; tmpY = v2.x * v1.z - v2.z * v1.x; this.z = v1.x * v2.y - v1.y * v2.x; this.x = tmpX; this.y = tmpY; }
Computes the dot product of this vector and vector v1.
Params:
  • v1 – the other vector
Returns:the dot product of this vector and v1
/** * Computes the dot product of this vector and vector v1. * @param v1 the other vector * @return the dot product of this vector and v1 */
public double dot(Vec3d v1) { return this.x * v1.x + this.y * v1.y + this.z * v1.z; }
Returns the hashcode for this Vec3f.
Returns: a hash code for this Vec3f.
/** * Returns the hashcode for this <code>Vec3f</code>. * @return a hash code for this <code>Vec3f</code>. */
@Override public int hashCode() { long bits = 7L; bits = 31L * bits + Double.doubleToLongBits(x); bits = 31L * bits + Double.doubleToLongBits(y); bits = 31L * bits + Double.doubleToLongBits(z); return (int) (bits ^ (bits >> 32)); }
Determines whether or not two 3D points or vectors are equal. Two instances of Vec3d are equal if the values of their x, y and z member fields, representing their position in the coordinate space, are the same.
Params:
  • obj – an object to be compared with this Vec3d
Returns:true if the object to be compared is an instance of Vec3d and has the same values; false otherwise.
/** * Determines whether or not two 3D points or vectors are equal. * Two instances of <code>Vec3d</code> are equal if the values of their * <code>x</code>, <code>y</code> and <code>z</code> member fields, * representing their position in the coordinate space, are the same. * @param obj an object to be compared with this <code>Vec3d</code> * @return <code>true</code> if the object to be compared is * an instance of <code>Vec3d</code> and has * the same values; <code>false</code> otherwise. */
@Override public boolean equals(Object obj) { if (obj == this) { return true; } if (obj instanceof Vec3d) { Vec3d v = (Vec3d) obj; return (x == v.x) && (y == v.y) && (z == v.z); } return false; }
Returns a String that represents the value of this Vec3f.
Returns:a string representation of this Vec3f.
/** * Returns a <code>String</code> that represents the value * of this <code>Vec3f</code>. * @return a string representation of this <code>Vec3f</code>. */
@Override public String toString() { return "Vec3d[" + x + ", " + y + ", " + z + "]"; } }