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 Barta 3859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 3959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta/** 4059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 4159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>Rectangle</code> defines a finite plane within three dimensional space 4259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * that is specified via three points (A, B, C). These three points define a 4359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * triangle with the forth point defining the rectangle ((B + C) - A. 4459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 4559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @author Mark Powell 4659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @author Joshua Slack 4759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 4859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 4959b2e6871c65f58fdad78cd7229c292f6a177578Scott Bartapublic final class Rectangle implements Savable, Cloneable, java.io.Serializable { 5059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta static final long serialVersionUID = 1; 5259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta private Vector3f a, b, c; 5459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 5559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 5659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Constructor creates a new <code>Rectangle</code> with no defined corners. 5759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * A, B, and C must be set to define a valid rectangle. 5859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 5959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 6059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Rectangle() { 6159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta a = new Vector3f(); 6259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta b = new Vector3f(); 6359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta c = new Vector3f(); 6459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 6559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 6659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 6759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Constructor creates a new <code>Rectangle</code> with defined A, B, and C 6859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * points that define the area of the rectangle. 6959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 7059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param a 7159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the first corner of the rectangle. 7259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param b 7359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the second corner of the rectangle. 7459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param c 7559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the third corner of the rectangle. 7659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 7759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Rectangle(Vector3f a, Vector3f b, Vector3f c) { 7859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.a = a; 7959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.b = b; 8059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.c = c; 8159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 8259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 8359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 8459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>getA</code> returns the first point of the rectangle. 8559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 8659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the first point of the rectangle. 8759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 8859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f getA() { 8959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return a; 9059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 9159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 9259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 9359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>setA</code> sets the first point of the rectangle. 9459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 9559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param a 9659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the first point of the rectangle. 9759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 9859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setA(Vector3f a) { 9959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.a = a; 10059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 10159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 10259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 10359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>getB</code> returns the second point of the rectangle. 10459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 10559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the second point of the rectangle. 10659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 10759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f getB() { 10859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return b; 10959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 11059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 11159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 11259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>setB</code> sets the second point of the rectangle. 11359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 11459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param b 11559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the second point of the rectangle. 11659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 11759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setB(Vector3f b) { 11859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.b = b; 11959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 12059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 12159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 12259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>getC</code> returns the third point of the rectangle. 12359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 12459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return the third point of the rectangle. 12559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 12659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f getC() { 12759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return c; 12859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 12959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 13059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 13159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>setC</code> sets the third point of the rectangle. 13259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 13359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param c 13459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * the third point of the rectangle. 13559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 13659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void setC(Vector3f c) { 13759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta this.c = c; 13859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 13959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 14059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 14159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>random</code> returns a random point within the plane defined by: 14259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * A, B, C, and (B + C) - A. 14359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 14459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return a random point within the rectangle. 14559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 14659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f random() { 14759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return random(null); 14859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 14959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 15059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta /** 15159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * <code>random</code> returns a random point within the plane defined by: 15259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * A, B, C, and (B + C) - A. 15359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * 15459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @param result 15559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * Vector to store result in 15659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta * @return a random point within the rectangle. 15759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta */ 15859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Vector3f random(Vector3f result) { 15959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta if (result == null) { 16059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result = new Vector3f(); 16159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 16259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 16359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float s = FastMath.nextRandomFloat(); 16459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float t = FastMath.nextRandomFloat(); 16559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 16659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta float aMod = 1.0f - s - t; 16759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta result.set(a.mult(aMod).addLocal(b.mult(s).addLocal(c.mult(t)))); 16859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return result; 16959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 17059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 17159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void write(JmeExporter e) throws IOException { 17259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta OutputCapsule capsule = e.getCapsule(this); 17359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta capsule.write(a, "a", Vector3f.ZERO); 17459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta capsule.write(b, "b", Vector3f.ZERO); 17559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta capsule.write(c, "c", Vector3f.ZERO); 17659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 17759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 17859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public void read(JmeImporter e) throws IOException { 17959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta InputCapsule capsule = e.getCapsule(this); 18059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta a = (Vector3f) capsule.readSavable("a", Vector3f.ZERO.clone()); 18159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta b = (Vector3f) capsule.readSavable("b", Vector3f.ZERO.clone()); 18259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta c = (Vector3f) capsule.readSavable("c", Vector3f.ZERO.clone()); 18359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 18459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta 18559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta @Override 18659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta public Rectangle clone() { 18759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta try { 18859b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta Rectangle r = (Rectangle) super.clone(); 18959b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta r.a = a.clone(); 19059b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta r.b = b.clone(); 19159b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta r.c = c.clone(); 19259b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta return r; 19359b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } catch (CloneNotSupportedException e) { 19459b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta throw new AssertionError(); 19559b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 19659b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta } 19759b2e6871c65f58fdad78cd7229c292f6a177578Scott Barta} 198