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 * <code>Plane</code> defines a plane where Normal dot (x,y,z) = Constant. 4159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * This provides methods for calculating a "distance" of a point from this 4259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * plane. The distance is pseudo due to the fact that it can be negative if the 4359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * point is on the non-normal side of the plane. 4459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 4559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @author Mark Powell 4659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @author Joshua Slack 4759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 4859b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapublic class Plane implements Savable, Cloneable, java.io.Serializable { 4959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta static final long serialVersionUID = 1; 5159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private static final Logger logger = Logger 5359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta .getLogger(Plane.class.getName()); 5459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public static enum Side { 5659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta None, 5759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Positive, 5859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Negative 5959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 6059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 6159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 6259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Vector normal to the plane. 6359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 6459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta protected Vector3f normal = new Vector3f(); 6559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 6659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 6759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Constant of the plane. See formula in class definition. 6859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 6959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta protected float constant; 7059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 7259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Constructor instantiates a new <code>Plane</code> object. This is the 7359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * default object and contains a normal of (0,0,0) and a constant of 0. 7459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 7559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Plane() { 7659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 7759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 7859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 7959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Constructor instantiates a new <code>Plane</code> object. The normal 8059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * and constant values are set at creation. 8159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 8259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param normal 8359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the normal of the plane. 8459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param constant 8559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the constant of the plane. 8659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 8759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Plane(Vector3f normal, float constant) { 8859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (normal == null) { 8959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta throw new IllegalArgumentException("normal cannot be null"); 9059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 9159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.normal.set(normal); 9359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.constant = constant; 9459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 9559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 9759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>setNormal</code> sets the normal of the plane. 9859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 9959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param normal 10059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the new normal of the plane. 10159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 10259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setNormal(Vector3f normal) { 10359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (normal == null) { 10459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta throw new IllegalArgumentException("normal cannot be null"); 10559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 10659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.normal.set(normal); 10759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 10859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 10959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 11059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>setNormal</code> sets the normal of the plane. 11159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 11259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 11359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setNormal(float x, float y, float z) { 11459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.normal.set(x,y,z); 11559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 11659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 11759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 11859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>getNormal</code> retrieves the normal of the plane. 11959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 12059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the normal of the plane. 12159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 12259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f getNormal() { 12359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return normal; 12459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 12559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 12659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 12759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>setConstant</code> sets the constant value that helps define the 12859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * plane. 12959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 13059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param constant 13159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the new constant value. 13259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 13359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setConstant(float constant) { 13459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.constant = constant; 13559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 13659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 13759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 13859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>getConstant</code> returns the constant of the plane. 13959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 14059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the constant of the plane. 14159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 14259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float getConstant() { 14359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return constant; 14459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 14559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 14659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f getClosestPoint(Vector3f point, Vector3f store){ 14759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// float t = constant - normal.dot(point); 14859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta// return store.set(normal).multLocal(t).addLocal(point); 14959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float t = (constant - normal.dot(point)) / normal.dot(normal); 15059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return store.set(normal).multLocal(t).addLocal(point); 15159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 15259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 15359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f getClosestPoint(Vector3f point){ 15459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return getClosestPoint(point, new Vector3f()); 15559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 15659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 15759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f reflect(Vector3f point, Vector3f store){ 15859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (store == null) 15959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta store = new Vector3f(); 16059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 16159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float d = pseudoDistance(point); 16259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta store.set(normal).negateLocal().multLocal(d * 2f); 16359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta store.addLocal(point); 16459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return store; 16559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 16659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 16759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 16859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>pseudoDistance</code> calculates the distance from this plane to 16959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * a provided point. If the point is on the negative side of the plane the 17059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * distance returned is negative, otherwise it is positive. If the point is 17159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * on the plane, it is zero. 17259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 17359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param point 17459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the point to check. 17559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the signed distance from the plane to a point. 17659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 17759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public float pseudoDistance(Vector3f point) { 17859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return normal.dot(point) - constant; 17959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 18059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 18159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 18259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>whichSide</code> returns the side at which a point lies on the 18359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * plane. The positive values returned are: NEGATIVE_SIDE, POSITIVE_SIDE and 18459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * NO_SIDE. 18559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 18659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param point 18759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the point to check. 18859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the side at which the point lies. 18959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 19059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Side whichSide(Vector3f point) { 19159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float dis = pseudoDistance(point); 19259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (dis < 0) { 19359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return Side.Negative; 19459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } else if (dis > 0) { 19559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return Side.Positive; 19659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } else { 19759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return Side.None; 19859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 19959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 20059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 20159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public boolean isOnPlane(Vector3f point){ 20259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float dist = pseudoDistance(point); 20359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (dist < FastMath.FLT_EPSILON && dist > -FastMath.FLT_EPSILON) 20459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return true; 20559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta else 20659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return false; 20759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 20859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 20959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 21059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Initialize this plane using the three points of the given triangle. 21159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 21259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param t 21359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the triangle 21459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 21559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setPlanePoints(AbstractTriangle t) { 21659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta setPlanePoints(t.get1(), t.get2(), t.get3()); 21759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 21859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 21959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 22059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Initialize this plane using a point of origin and a normal. 22159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 22259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param origin 22359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param normal 22459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 22559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setOriginNormal(Vector3f origin, Vector3f normal){ 22659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.normal.set(normal); 22759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.constant = normal.x * origin.x + normal.y * origin.y + normal.z * origin.z; 22859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 22959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 23059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 23159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Initialize the Plane using the given 3 points as coplanar. 23259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 23359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param v1 23459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the first point 23559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param v2 23659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the second point 23759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param v3 23859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the third point 23959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 24059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setPlanePoints(Vector3f v1, Vector3f v2, Vector3f v3) { 24159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta normal.set(v2).subtractLocal(v1); 24259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta normal.crossLocal(v3.x - v1.x, v3.y - v1.y, v3.z - v1.z) 24359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta .normalizeLocal(); 24459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta constant = normal.dot(v1); 24559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 24659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 24759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 24859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>toString</code> returns a string thta represents the string 24959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * representation of this plane. It represents the normal as a 25059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>Vector3f</code> object, so the format is the following: 25159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * com.jme.math.Plane [Normal: org.jme.math.Vector3f [X=XX.XXXX, Y=YY.YYYY, 25259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Z=ZZ.ZZZZ] - Constant: CC.CCCCC] 25359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 25459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the string representation of this plane. 25559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 25659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta @Override 25759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public String toString() { 25859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return getClass().getSimpleName() + " [Normal: " + normal + " - Constant: " 25959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta + constant + "]"; 26059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 26159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 26259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void write(JmeExporter e) throws IOException { 26359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta OutputCapsule capsule = e.getCapsule(this); 26459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta capsule.write(normal, "normal", Vector3f.ZERO); 26559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta capsule.write(constant, "constant", 0); 26659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 26759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 26859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void read(JmeImporter e) throws IOException { 26959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta InputCapsule capsule = e.getCapsule(this); 27059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta normal = (Vector3f) capsule.readSavable("normal", Vector3f.ZERO.clone()); 27159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta constant = capsule.readFloat("constant", 0); 27259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 27359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 27459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta @Override 27559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Plane clone() { 27659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta try { 27759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Plane p = (Plane) super.clone(); 27859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta p.normal = normal.clone(); 27959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return p; 28059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } catch (CloneNotSupportedException e) { 28159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta throw new AssertionError(); 28259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 28359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 28459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta} 285