159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/* 259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Copyright (c) 2009-2010 jMonkeyEngine 359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * All rights reserved. 459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Redistribution and use in source and binary forms, with or without 659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * modification, are permitted provided that the following conditions are 759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * met: 859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Redistributions of source code must retain the above copyright 1059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * notice, this list of conditions and the following disclaimer. 1159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 1259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Redistributions in binary form must reproduce the above copyright 1359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * notice, this list of conditions and the following disclaimer in the 1459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * documentation and/or other materials provided with the distribution. 1559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 1659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * * Neither the name of 'jMonkeyEngine' nor the names of its contributors 1759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * may be used to endorse or promote products derived from this software 1859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * without specific prior written permission. 1959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 2059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 2259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 2359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 2459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 2559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 2659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 2759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 2859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 2959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 3059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 3159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 3259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3359b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapackage com.jme3.math; 3459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3559b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport com.jme3.export.*; 3659b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport java.io.IOException; 3759b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartaimport java.util.logging.Logger; 3859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/* 4059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * -- Added *Local methods to cut down on object creation - JS 4159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 4259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 4359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/** 4459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>Vector3f</code> defines a Vector for a three float value tuple. 4559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>Vector3f</code> can represent any three dimensional value, such as a 4659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * vertex, a normal, etc. Utility methods are also included to aid in 4759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * mathematical calculations. 4859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 4959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @author Mark Powell 5059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @author Joshua Slack 5159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 5259b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapublic final class Vector3f implements Savable, Cloneable, java.io.Serializable { 5359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta static final long serialVersionUID = 1; 5559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private static final Logger logger = Logger.getLogger(Vector3f.class.getName()); 5759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public final static Vector3f ZERO = new Vector3f(0, 0, 0); 5959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public final static Vector3f NAN = new Vector3f(Float.NaN, Float.NaN, Float.NaN); 6059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public final static Vector3f UNIT_X = new Vector3f(1, 0, 0); 6159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public final static Vector3f UNIT_Y = new Vector3f(0, 1, 0); 6259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public final static Vector3f UNIT_Z = new Vector3f(0, 0, 1); 6359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public final static Vector3f UNIT_XYZ = new Vector3f(1, 1, 1); 6459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public final static Vector3f POSITIVE_INFINITY = new Vector3f( 6559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.POSITIVE_INFINITY, 6659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.POSITIVE_INFINITY, 6759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.POSITIVE_INFINITY); 6859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public final static Vector3f NEGATIVE_INFINITY = new Vector3f( 6959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.NEGATIVE_INFINITY, 7059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.NEGATIVE_INFINITY, 7159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.NEGATIVE_INFINITY); 7259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 7559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the x value of the vector. 7659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 7759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float x; 7859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 8059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the y value of the vector. 8159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 8259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float y; 8359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 8459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 8559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the z value of the vector. 8659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 8759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float z; 8859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 8959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 9059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Constructor instantiates a new <code>Vector3f</code> with default 9159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * values of (0,0,0). 9259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 9359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 9459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f() { 9559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = y = z = 0; 9659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 9759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 9959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Constructor instantiates a new <code>Vector3f</code> with provides 10059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * values. 10159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 10259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param x 10359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the x value of the vector. 10459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param y 10559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the y value of the vector. 10659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param z 10759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the z value of the vector. 10859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 10959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f(float x, float y, float z) { 11059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.x = x; 11159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.y = y; 11259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.z = z; 11359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 11459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 11559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 11659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Constructor instantiates a new <code>Vector3f</code> that is a copy 11759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * of the provided vector 11859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param copy The Vector3f to copy 11959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 12059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f(Vector3f copy) { 12159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.set(copy); 12259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 12359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 12459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 12559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>set</code> sets the x,y,z values of the vector based on passed 12659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * parameters. 12759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 12859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param x 12959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the x value of the vector. 13059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param y 13159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the y value of the vector. 13259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param z 13359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the z value of the vector. 13459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this vector 13559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 13659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f set(float x, float y, float z) { 13759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.x = x; 13859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.y = y; 13959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.z = z; 14059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 14159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 14259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 14359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 14459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>set</code> sets the x,y,z values of the vector by copying the 14559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * supplied vector. 14659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 14759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vect 14859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to copy. 14959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this vector 15059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 15159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f set(Vector3f vect) { 15259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.x = vect.x; 15359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.y = vect.y; 15459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.z = vect.z; 15559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 15659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 15759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 15859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 15959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 16059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>add</code> adds a provided vector to this vector creating a 16159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * resultant vector which is returned. If the provided vector is null, null 16259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * is returned. 16359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 16459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 16559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to add to this. 16659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the resultant vector. 16759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 16859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f add(Vector3f vec) { 16959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (null == vec) { 17059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta logger.warning("Provided vector is null, null returned."); 17159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return null; 17259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 17359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(x + vec.x, y + vec.y, z + vec.z); 17459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 17559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 17659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 17759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 17859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>add</code> adds the values of a provided vector storing the 17959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * values in the supplied vector. 18059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 18159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 18259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to add to this 18359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param result 18459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to store the result in 18559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return result returns the supplied result vector. 18659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 18759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f add(Vector3f vec, Vector3f result) { 18859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result.x = x + vec.x; 18959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result.y = y + vec.y; 19059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result.z = z + vec.z; 19159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return result; 19259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 19359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 19459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 19559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>addLocal</code> adds a provided vector to this vector internally, 19659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * and returns a handle to this vector for easy chaining of calls. If the 19759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * provided vector is null, null is returned. 19859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 19959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 20059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to add to this vector. 20159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 20259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 20359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f addLocal(Vector3f vec) { 20459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (null == vec) { 20559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta logger.warning("Provided vector is null, null returned."); 20659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return null; 20759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 20859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x += vec.x; 20959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y += vec.y; 21059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z += vec.z; 21159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 21259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 21359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 21459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 21559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 21659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>add</code> adds the provided values to this vector, creating a 21759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * new vector that is then returned. 21859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 21959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param addX 22059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the x value to add. 22159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param addY 22259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the y value to add. 22359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param addZ 22459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the z value to add. 22559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the result vector. 22659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 22759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f add(float addX, float addY, float addZ) { 22859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(x + addX, y + addY, z + addZ); 22959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 23059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 23159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 23259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>addLocal</code> adds the provided values to this vector 23359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * internally, and returns a handle to this vector for easy chaining of 23459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * calls. 23559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 23659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param addX 23759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * value to add to x 23859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param addY 23959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * value to add to y 24059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param addZ 24159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * value to add to z 24259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 24359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 24459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f addLocal(float addX, float addY, float addZ) { 24559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x += addX; 24659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y += addY; 24759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z += addZ; 24859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 24959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 25059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 25159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 25259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 25359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>scaleAdd</code> multiplies this vector by a scalar then adds the 25459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * given Vector3f. 25559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 25659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar 25759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to multiply this vector by. 25859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param add 25959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to add 26059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 26159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f scaleAdd(float scalar, Vector3f add) { 26259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = x * scalar + add.x; 26359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y = y * scalar + add.y; 26459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z = z * scalar + add.z; 26559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 26659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 26759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 26859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 26959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 27059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>scaleAdd</code> multiplies the given vector by a scalar then adds 27159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the given vector. 27259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 27359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar 27459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to multiply this vector by. 27559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param mult 27659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to multiply the scalar by 27759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param add 27859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to add 27959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 28059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f scaleAdd(float scalar, Vector3f mult, Vector3f add) { 28159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.x = mult.x * scalar + add.x; 28259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.y = mult.y * scalar + add.y; 28359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.z = mult.z * scalar + add.z; 28459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 28559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 28659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 28759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 28859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 28959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>dot</code> calculates the dot product of this vector with a 29059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * provided vector. If the provided vector is null, 0 is returned. 29159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 29259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 29359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to dot with this vector. 29459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the resultant dot product of this vector and a given vector. 29559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 29659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float dot(Vector3f vec) { 29759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (null == vec) { 29859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta logger.warning("Provided vector is null, 0 returned."); 29959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return 0; 30059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 30159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return x * vec.x + y * vec.y + z * vec.z; 30259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 30359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 30459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 30559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>cross</code> calculates the cross product of this vector with a 30659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * parameter vector v. 30759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 30859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param v 30959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to take the cross product of with this. 31059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the cross product vector. 31159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 31259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f cross(Vector3f v) { 31359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return cross(v, null); 31459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 31559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 31659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 31759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>cross</code> calculates the cross product of this vector with a 31859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * parameter vector v. The result is stored in <code>result</code> 31959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 32059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param v 32159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to take the cross product of with this. 32259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param result 32359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to store the cross product result. 32459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return result, after recieving the cross product vector. 32559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 32659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f cross(Vector3f v,Vector3f result) { 32759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return cross(v.x, v.y, v.z, result); 32859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 32959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 33059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 33159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>cross</code> calculates the cross product of this vector with a 33259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * parameter vector v. The result is stored in <code>result</code> 33359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 33459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param otherX 33559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * x component of the vector to take the cross product of with this. 33659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param otherY 33759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * y component of the vector to take the cross product of with this. 33859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param otherZ 33959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * z component of the vector to take the cross product of with this. 34059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param result 34159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to store the cross product result. 34259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return result, after recieving the cross product vector. 34359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 34459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f cross(float otherX, float otherY, float otherZ, Vector3f result) { 34559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (result == null) result = new Vector3f(); 34659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float resX = ((y * otherZ) - (z * otherY)); 34759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float resY = ((z * otherX) - (x * otherZ)); 34859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float resZ = ((x * otherY) - (y * otherX)); 34959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result.set(resX, resY, resZ); 35059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return result; 35159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 35259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 35359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 35459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>crossLocal</code> calculates the cross product of this vector 35559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * with a parameter vector v. 35659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 35759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param v 35859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to take the cross product of with this. 35959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this. 36059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 36159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f crossLocal(Vector3f v) { 36259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return crossLocal(v.x, v.y, v.z); 36359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 36459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 36559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 36659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>crossLocal</code> calculates the cross product of this vector 36759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * with a parameter vector v. 36859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 36959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param otherX 37059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * x component of the vector to take the cross product of with this. 37159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param otherY 37259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * y component of the vector to take the cross product of with this. 37359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param otherZ 37459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * z component of the vector to take the cross product of with this. 37559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this. 37659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 37759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f crossLocal(float otherX, float otherY, float otherZ) { 37859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float tempx = ( y * otherZ ) - ( z * otherY ); 37959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float tempy = ( z * otherX ) - ( x * otherZ ); 38059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z = (x * otherY) - (y * otherX); 38159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = tempx; 38259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y = tempy; 38359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 38459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 38559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 38659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f project(Vector3f other){ 38759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float n = this.dot(other); // A . B 38859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float d = other.lengthSquared(); // |B|^2 38959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(other).normalizeLocal().multLocal(n/d); 39059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 39159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 39259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 39359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Returns true if this vector is a unit vector (length() ~= 1), 39459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * returns false otherwise. 39559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 39659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return true if this vector is a unit vector (length() ~= 1), 39759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * or false otherwise. 39859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 39959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public boolean isUnitVector(){ 40059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float len = length(); 40159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return 0.99f < len && len < 1.01f; 40259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 40359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 40459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 40559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>length</code> calculates the magnitude of this vector. 40659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 40759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the length or magnitude of the vector. 40859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 40959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float length() { 41059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return FastMath.sqrt(lengthSquared()); 41159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 41259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 41359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 41459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>lengthSquared</code> calculates the squared value of the 41559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * magnitude of the vector. 41659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 41759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the magnitude squared of the vector. 41859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 41959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float lengthSquared() { 42059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return x * x + y * y + z * z; 42159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 42259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 42359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 42459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>distanceSquared</code> calculates the distance squared between 42559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * this vector and vector v. 42659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 42759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param v the second vector to determine the distance squared. 42859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the distance squared between the two vectors. 42959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 43059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float distanceSquared(Vector3f v) { 43159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta double dx = x - v.x; 43259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta double dy = y - v.y; 43359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta double dz = z - v.z; 43459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return (float) (dx * dx + dy * dy + dz * dz); 43559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 43659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 43759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 43859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>distance</code> calculates the distance between this vector and 43959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * vector v. 44059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 44159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param v the second vector to determine the distance. 44259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the distance between the two vectors. 44359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 44459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float distance(Vector3f v) { 44559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return FastMath.sqrt(distanceSquared(v)); 44659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 44759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 44859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 44959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 45059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>mult</code> multiplies this vector by a scalar. The resultant 45159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * vector is returned. 45259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 45359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar 45459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to multiply this vector by. 45559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the new vector. 45659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 45759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f mult(float scalar) { 45859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(x * scalar, y * scalar, z * scalar); 45959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 46059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 46159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 46259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 46359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>mult</code> multiplies this vector by a scalar. The resultant 46459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * vector is supplied as the second parameter and returned. 46559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 46659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar the scalar to multiply this vector by. 46759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param product the product to store the result in. 46859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return product 46959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 47059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f mult(float scalar, Vector3f product) { 47159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (null == product) { 47259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta product = new Vector3f(); 47359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 47459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 47559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta product.x = x * scalar; 47659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta product.y = y * scalar; 47759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta product.z = z * scalar; 47859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return product; 47959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 48059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 48159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 48259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>multLocal</code> multiplies this vector by a scalar internally, 48359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * and returns a handle to this vector for easy chaining of calls. 48459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 48559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar 48659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to multiply this vector by. 48759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 48859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 48959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f multLocal(float scalar) { 49059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x *= scalar; 49159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y *= scalar; 49259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z *= scalar; 49359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 49459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 49559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 49659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 49759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>multLocal</code> multiplies a provided vector to this vector 49859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * internally, and returns a handle to this vector for easy chaining of 49959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * calls. If the provided vector is null, null is returned. 50059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 50159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 50259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to mult to this vector. 50359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 50459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 50559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f multLocal(Vector3f vec) { 50659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (null == vec) { 50759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta logger.warning("Provided vector is null, null returned."); 50859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return null; 50959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 51059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x *= vec.x; 51159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y *= vec.y; 51259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z *= vec.z; 51359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 51459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 51559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 51659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 51759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>multLocal</code> multiplies this vector by 3 scalars 51859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * internally, and returns a handle to this vector for easy chaining of 51959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * calls. 52059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 52159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param x 52259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param y 52359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param z 52459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 52559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 52659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f multLocal(float x, float y, float z) { 52759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.x *= x; 52859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.y *= y; 52959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.z *= z; 53059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 53159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 53259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 53359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 53459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>multLocal</code> multiplies a provided vector to this vector 53559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * internally, and returns a handle to this vector for easy chaining of 53659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * calls. If the provided vector is null, null is returned. 53759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 53859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 53959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to mult to this vector. 54059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 54159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 54259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f mult(Vector3f vec) { 54359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (null == vec) { 54459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta logger.warning("Provided vector is null, null returned."); 54559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return null; 54659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 54759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return mult(vec, null); 54859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 54959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 55059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 55159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>multLocal</code> multiplies a provided vector to this vector 55259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * internally, and returns a handle to this vector for easy chaining of 55359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * calls. If the provided vector is null, null is returned. 55459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 55559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 55659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to mult to this vector. 55759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param store result vector (null to create a new vector) 55859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 55959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 56059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f mult(Vector3f vec, Vector3f store) { 56159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (null == vec) { 56259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta logger.warning("Provided vector is null, null returned."); 56359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return null; 56459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 56559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (store == null) store = new Vector3f(); 56659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return store.set(x * vec.x, y * vec.y, z * vec.z); 56759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 56859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 56959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 57059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 57159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>divide</code> divides the values of this vector by a scalar and 57259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * returns the result. The values of this vector remain untouched. 57359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 57459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar 57559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to divide this vectors attributes by. 57659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the result <code>Vector</code>. 57759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 57859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f divide(float scalar) { 57959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta scalar = 1f/scalar; 58059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(x * scalar, y * scalar, z * scalar); 58159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 58259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 58359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 58459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>divideLocal</code> divides this vector by a scalar internally, 58559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * and returns a handle to this vector for easy chaining of calls. Dividing 58659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * by zero will result in an exception. 58759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 58859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar 58959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to divides this vector by. 59059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 59159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 59259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f divideLocal(float scalar) { 59359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta scalar = 1f/scalar; 59459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x *= scalar; 59559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y *= scalar; 59659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z *= scalar; 59759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 59859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 59959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 60059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 60159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 60259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>divide</code> divides the values of this vector by a scalar and 60359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * returns the result. The values of this vector remain untouched. 60459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 60559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar 60659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to divide this vectors attributes by. 60759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the result <code>Vector</code>. 60859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 60959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f divide(Vector3f scalar) { 61059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(x / scalar.x, y / scalar.y, z / scalar.z); 61159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 61259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 61359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 61459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>divideLocal</code> divides this vector by a scalar internally, 61559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * and returns a handle to this vector for easy chaining of calls. Dividing 61659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * by zero will result in an exception. 61759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 61859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param scalar 61959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the value to divides this vector by. 62059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 62159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 62259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f divideLocal(Vector3f scalar) { 62359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x /= scalar.x; 62459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y /= scalar.y; 62559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z /= scalar.z; 62659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 62759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 62859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 62959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 63059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 63159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>negate</code> returns the negative of this vector. All values are 63259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * negated and set to a new vector. 63359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 63459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the negated vector. 63559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 63659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f negate() { 63759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(-x, -y, -z); 63859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 63959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 64059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 64159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 64259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>negateLocal</code> negates the internal values of this vector. 64359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 64459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this. 64559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 64659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f negateLocal() { 64759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = -x; 64859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y = -y; 64959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z = -z; 65059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 65159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 65259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 65359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 65459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 65559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>subtract</code> subtracts the values of a given vector from those 65659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * of this vector creating a new vector object. If the provided vector is 65759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * null, null is returned. 65859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 65959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 66059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to subtract from this vector. 66159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the result vector. 66259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 66359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f subtract(Vector3f vec) { 66459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(x - vec.x, y - vec.y, z - vec.z); 66559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 66659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 66759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 66859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>subtractLocal</code> subtracts a provided vector to this vector 66959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * internally, and returns a handle to this vector for easy chaining of 67059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * calls. If the provided vector is null, null is returned. 67159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 67259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 67359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to subtract 67459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 67559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 67659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f subtractLocal(Vector3f vec) { 67759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (null == vec) { 67859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta logger.warning("Provided vector is null, null returned."); 67959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return null; 68059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 68159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x -= vec.x; 68259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y -= vec.y; 68359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z -= vec.z; 68459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 68559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 68659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 68759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 68859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 68959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>subtract</code> 69059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 69159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vec 69259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to subtract from this 69359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param result 69459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the vector to store the result in 69559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return result 69659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 69759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f subtract(Vector3f vec, Vector3f result) { 69859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if(result == null) { 69959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result = new Vector3f(); 70059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 70159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result.x = x - vec.x; 70259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result.y = y - vec.y; 70359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result.z = z - vec.z; 70459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return result; 70559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 70659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 70759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 70859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 70959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>subtract</code> subtracts the provided values from this vector, 71059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * creating a new vector that is then returned. 71159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 71259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param subtractX 71359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the x value to subtract. 71459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param subtractY 71559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the y value to subtract. 71659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param subtractZ 71759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the z value to subtract. 71859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the result vector. 71959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 72059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f subtract(float subtractX, float subtractY, float subtractZ) { 72159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(x - subtractX, y - subtractY, z - subtractZ); 72259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 72359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 72459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 72559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>subtractLocal</code> subtracts the provided values from this vector 72659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * internally, and returns a handle to this vector for easy chaining of 72759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * calls. 72859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 72959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param subtractX 73059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the x value to subtract. 73159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param subtractY 73259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the y value to subtract. 73359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param subtractZ 73459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the z value to subtract. 73559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this 73659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 73759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f subtractLocal(float subtractX, float subtractY, float subtractZ) { 73859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x -= subtractX; 73959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y -= subtractY; 74059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z -= subtractZ; 74159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 74259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 74359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 74459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 74559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>normalize</code> returns the unit vector of this vector. 74659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 74759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return unit vector of this vector. 74859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 74959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f normalize() { 75059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// float length = length(); 75159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// if (length != 0) { 75259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// return divide(length); 75359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// } 75459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// 75559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// return divide(1); 75659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float length = x * x + y * y + z * z; 75759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (length != 1f && length != 0f){ 75859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta length = 1.0f / FastMath.sqrt(length); 75959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return new Vector3f(x * length, y * length, z * length); 76059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 76159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return clone(); 76259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 76359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 76459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 76559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>normalizeLocal</code> makes this vector into a unit vector of 76659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * itself. 76759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 76859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return this. 76959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 77059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f normalizeLocal() { 77159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta // NOTE: this implementation is more optimized 77259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta // than the old jme normalize as this method 77359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta // is commonly used. 77459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float length = x * x + y * y + z * z; 77559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (length != 1f && length != 0f){ 77659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta length = 1.0f / FastMath.sqrt(length); 77759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x *= length; 77859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y *= length; 77959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z *= length; 78059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 78159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 78259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 78359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 78459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 78559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>maxLocal</code> computes the maximum value for each 78659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * component in this and <code>other</code> vector. The result is stored 78759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * in this vector. 78859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param other 78959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 79059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void maxLocal(Vector3f other){ 79159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = other.x > x ? other.x : x; 79259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y = other.y > y ? other.y : y; 79359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z = other.z > z ? other.z : z; 79459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 79559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 79659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 79759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>minLocal</code> computes the minimum value for each 79859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * component in this and <code>other</code> vector. The result is stored 79959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * in this vector. 80059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param other 80159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 80259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void minLocal(Vector3f other){ 80359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = other.x < x ? other.x : x; 80459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y = other.y < y ? other.y : y; 80559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z = other.z < z ? other.z : z; 80659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 80759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 80859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 80959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>zero</code> resets this vector's data to zero internally. 81059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 81159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f zero() { 81259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = y = z = 0; 81359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 81459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 81559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 81659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 81759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>angleBetween</code> returns (in radians) the angle between two vectors. 81859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * It is assumed that both this vector and the given vector are unit vectors (iow, normalized). 81959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 82059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param otherVector a unit vector to find the angle against 82159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the angle in radians. 82259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 82359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float angleBetween(Vector3f otherVector) { 82459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float dotProduct = dot(otherVector); 82559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float angle = FastMath.acos(dotProduct); 82659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return angle; 82759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 82859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 82959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 83059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Sets this vector to the interpolation by changeAmnt from this to the finalVec 83159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * this=(1-changeAmnt)*this + changeAmnt * finalVec 83259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param finalVec The final vector to interpolate towards 83359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param changeAmnt An amount between 0.0 - 1.0 representing a precentage 83459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * change from this towards finalVec 83559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 83659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f interpolate(Vector3f finalVec, float changeAmnt) { 83759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.x=(1-changeAmnt)*this.x + changeAmnt*finalVec.x; 83859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.y=(1-changeAmnt)*this.y + changeAmnt*finalVec.y; 83959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.z=(1-changeAmnt)*this.z + changeAmnt*finalVec.z; 84059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 84159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 84259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 84359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 84459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Sets this vector to the interpolation by changeAmnt from beginVec to finalVec 84559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * this=(1-changeAmnt)*beginVec + changeAmnt * finalVec 84659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param beginVec the beging vector (changeAmnt=0) 84759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param finalVec The final vector to interpolate towards 84859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param changeAmnt An amount between 0.0 - 1.0 representing a precentage 84959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * change from beginVec towards finalVec 85059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 85159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f interpolate(Vector3f beginVec,Vector3f finalVec, float changeAmnt) { 85259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.x=(1-changeAmnt)*beginVec.x + changeAmnt*finalVec.x; 85359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.y=(1-changeAmnt)*beginVec.y + changeAmnt*finalVec.y; 85459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.z=(1-changeAmnt)*beginVec.z + changeAmnt*finalVec.z; 85559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 85659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 85759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 85859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 85959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Check a vector... if it is null or its floats are NaN or infinite, 86059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * return false. Else return true. 86159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param vector the vector to check 86259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return true or false as stated above. 86359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 86459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public static boolean isValidVector(Vector3f vector) { 86559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (vector == null) return false; 86659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (Float.isNaN(vector.x) || 86759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.isNaN(vector.y) || 86859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.isNaN(vector.z)) return false; 86959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (Float.isInfinite(vector.x) || 87059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.isInfinite(vector.y) || 87159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Float.isInfinite(vector.z)) return false; 87259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return true; 87359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 87459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 87559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public static void generateOrthonormalBasis(Vector3f u, Vector3f v, Vector3f w) { 87659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta w.normalizeLocal(); 87759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta generateComplementBasis(u, v, w); 87859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 87959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 88059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public static void generateComplementBasis(Vector3f u, Vector3f v, 88159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Vector3f w) { 88259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float fInvLength; 88359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 88459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (FastMath.abs(w.x) >= FastMath.abs(w.y)) { 88559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta // w.x or w.z is the largest magnitude component, swap them 88659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta fInvLength = FastMath.invSqrt(w.x * w.x + w.z * w.z); 88759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta u.x = -w.z * fInvLength; 88859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta u.y = 0.0f; 88959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta u.z = +w.x * fInvLength; 89059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta v.x = w.y * u.z; 89159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta v.y = w.z * u.x - w.x * u.z; 89259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta v.z = -w.y * u.x; 89359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } else { 89459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta // w.y or w.z is the largest magnitude component, swap them 89559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta fInvLength = FastMath.invSqrt(w.y * w.y + w.z * w.z); 89659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta u.x = 0.0f; 89759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta u.y = +w.z * fInvLength; 89859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta u.z = -w.y * fInvLength; 89959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta v.x = w.y * u.z - w.z * u.y; 90059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta v.y = -w.x * u.z; 90159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta v.z = w.x * u.y; 90259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 90359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 90459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 90559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta @Override 90659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f clone() { 90759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta try { 90859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return (Vector3f) super.clone(); 90959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } catch (CloneNotSupportedException e) { 91059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta throw new AssertionError(); // can not happen 91159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 91259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 91359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 91459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 91559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Saves this Vector3f into the given float[] object. 91659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 91759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param floats 91859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * The float[] to take this Vector3f. If null, a new float[3] is 91959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * created. 92059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return The array, with X, Y, Z float values in that order 92159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 92259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float[] toArray(float[] floats) { 92359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (floats == null) { 92459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta floats = new float[3]; 92559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 92659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta floats[0] = x; 92759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta floats[1] = y; 92859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta floats[2] = z; 92959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return floats; 93059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 93159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 93259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 93359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * are these two vectors the same? they are is they both have the same x,y, 93459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * and z values. 93559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 93659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param o 93759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the object to compare for equality 93859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return true if they are equal 93959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 94059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public boolean equals(Object o) { 94159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (!(o instanceof Vector3f)) { return false; } 94259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 94359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (this == o) { return true; } 94459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 94559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Vector3f comp = (Vector3f) o; 94659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (Float.compare(x,comp.x) != 0) return false; 94759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (Float.compare(y,comp.y) != 0) return false; 94859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (Float.compare(z,comp.z) != 0) return false; 94959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return true; 95059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 95159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 95259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 95359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>hashCode</code> returns a unique code for this vector object based 95459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * on it's values. If two vectors are logically equivalent, they will return 95559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the same hash code value. 95659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the hash code value of this vector. 95759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 95859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public int hashCode() { 95959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta int hash = 37; 96059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta hash += 37 * hash + Float.floatToIntBits(x); 96159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta hash += 37 * hash + Float.floatToIntBits(y); 96259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta hash += 37 * hash + Float.floatToIntBits(z); 96359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return hash; 96459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 96559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 96659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 96759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>toString</code> returns the string representation of this vector. 96859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * The format is: 96959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 97059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * org.jme.math.Vector3f [X=XX.XXXX, Y=YY.YYYY, Z=ZZ.ZZZZ] 97159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 97259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the string representation of this vector. 97359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 97459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public String toString() { 97559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return "(" + x + ", " + y + ", " + z + ")"; 97659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 97759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 97859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void write(JmeExporter e) throws IOException { 97959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta OutputCapsule capsule = e.getCapsule(this); 98059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta capsule.write(x, "x", 0); 98159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta capsule.write(y, "y", 0); 98259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta capsule.write(z, "z", 0); 98359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 98459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 98559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void read(JmeImporter e) throws IOException { 98659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta InputCapsule capsule = e.getCapsule(this); 98759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = capsule.readFloat("x", 0); 98859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y = capsule.readFloat("y", 0); 98959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z = capsule.readFloat("z", 0); 99059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 99159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 99259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float getX() { 99359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return x; 99459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 99559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 99659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f setX(float x) { 99759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.x = x; 99859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 99959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 100059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 100159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float getY() { 100259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return y; 100359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 100459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 100559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f setY(float y) { 100659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.y = y; 100759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 100859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 100959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 101059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float getZ() { 101159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return z; 101259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 101359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 101459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f setZ(float z) { 101559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.z = z; 101659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return this; 101759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 101859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 101959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 102059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param index 102159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return x value if index == 0, y value if index == 1 or z value if index == 102259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 2 102359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @throws IllegalArgumentException 102459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * if index is not one of 0, 1, 2. 102559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 102659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float get(int index) { 102759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta switch (index) { 102859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta case 0: 102959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return x; 103059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta case 1: 103159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return y; 103259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta case 2: 103359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return z; 103459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 103559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta throw new IllegalArgumentException("index must be either 0, 1 or 2"); 103659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 103759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 103859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 103959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param index 104059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * which field index in this vector to set. 104159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param value 104259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * to set to one of x, y or z. 104359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @throws IllegalArgumentException 104459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * if index is not one of 0, 1, 2. 104559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 104659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void set(int index, float value) { 104759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta switch (index) { 104859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta case 0: 104959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta x = value; 105059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return; 105159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta case 1: 105259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta y = value; 105359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return; 105459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta case 2: 105559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta z = value; 105659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return; 105759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 105859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta throw new IllegalArgumentException("index must be either 0, 1 or 2"); 105959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 106059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 106159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta} 1062