/** * ***************************************************************************** * Copyright (c) 2013, Daniel Murphy * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. ***************************************************************************** */ package org.jbox2d.common; import java.io.Serializable; /** * A 2D column vector */ public class Vec2 implements Serializable { private static final long serialVersionUID = 1L; public float x, y; public Vec2() { this(0, 0); } public Vec2(float x, float y) { this.x = x; this.y = y; } public Vec2(Vec2 toCopy) { this(toCopy.x, toCopy.y); } /** * Zero out this vector. */ public final void setZero() { x = 0.0f; y = 0.0f; } /** * Set the vector component-wise. * * @param x * @param y * @return */ public final Vec2 set(float x, float y) { this.x = x; this.y = y; return this; } /** * Set this vector to another vector. * * @param v * @return */ public final Vec2 set(Vec2 v) { this.x = v.x; this.y = v.y; return this; } /** * Return the sum of this vector and another; does not alter either one. * * @param v * @return */ public final Vec2 add(Vec2 v) { return new Vec2(x + v.x, y + v.y); } /** * Return the difference of this vector and another; does not alter either * one. * * @param v * @return */ public final Vec2 sub(Vec2 v) { return new Vec2(x - v.x, y - v.y); } /** * Return this vector multiplied by a scalar; does not alter this vector. * * @param a * @return */ public final Vec2 mul(float a) { return new Vec2(x * a, y * a); } /** * Return the negation of this vector; does not alter this vector. * * @return */ public final Vec2 negate() { return new Vec2(-x, -y); } /** * Flip the vector and return it - alters this vector. * * @return */ public final Vec2 negateLocal() { x = -x; y = -y; return this; } /** * Add another vector to this one and returns result - alters this vector. * * @param v * @return */ public final Vec2 addLocal(Vec2 v) { x += v.x; y += v.y; return this; } /** * Adds values to this vector and returns result - alters this vector. * * @param x * @param y * @return */ public final Vec2 addLocal(float x, float y) { this.x += x; this.y += y; return this; } /** * Subtract another vector from this one and return result - alters this * vector. * * @param v * @return */ public final Vec2 subLocal(Vec2 v) { x -= v.x; y -= v.y; return this; } /** * Multiply this vector by a number and return result - alters this vector. * * @param a * @return */ public final Vec2 mulLocal(float a) { x *= a; y *= a; return this; } /** * Get the skew vector such that dot(skew_vec, other) == cross(vec, other) * * @return */ public final Vec2 skew() { return new Vec2(-y, x); } /** * Get the skew vector such that dot(skew_vec, other) == cross(vec, other) * * @param out */ public final void skew(Vec2 out) { out.x = -y; out.y = x; } /** * Return the length of this vector. * * @return */ public final float length() { return MathUtils.sqrt(x * x + y * y); } /** * Return the squared length of this vector. * * @return */ public final float lengthSquared() { return (x * x + y * y); } /** * Normalize this vector and return the length before normalization. Alters * this vector. * * @return */ public final float normalize() { float length = length(); if (length < Settings.EPSILON) { return 0f; } float invLength = 1.0f / length; x *= invLength; y *= invLength; return length; } /** * True if the vector represents a pair of valid, non-infinite floating * point numbers. * * @return */ public final boolean isValid() { return !Float.isNaN(x) && !Float.isInfinite(x) && !Float.isNaN(y) && !Float.isInfinite(y); } /** * Return a new vector that has positive components. * * @return */ public final Vec2 abs() { return new Vec2(MathUtils.abs(x), MathUtils.abs(y)); } public final void absLocal() { x = MathUtils.abs(x); y = MathUtils.abs(y); } // @Override // annotation omitted for GWT-compatibility /** * Return a copy of this vector. * * @return */ @Override public final Vec2 clone() { return new Vec2(x, y); } @Override public final String toString() { return "(" + x + "," + y + ")"; } /* * Static */ public final static Vec2 abs(Vec2 a) { return new Vec2(MathUtils.abs(a.x), MathUtils.abs(a.y)); } public final static void absToOut(Vec2 a, Vec2 out) { out.x = MathUtils.abs(a.x); out.y = MathUtils.abs(a.y); } public final static float dot(final Vec2 a, final Vec2 b) { return a.x * b.x + a.y * b.y; } public final static float cross(final Vec2 a, final Vec2 b) { return a.x * b.y - a.y * b.x; } public final static Vec2 cross(Vec2 a, float s) { return new Vec2(s * a.y, -s * a.x); } public final static void crossToOut(Vec2 a, float s, Vec2 out) { final float tempy = -s * a.x; out.x = s * a.y; out.y = tempy; } public final static void crossToOutUnsafe(Vec2 a, float s, Vec2 out) { assert (out != a); out.x = s * a.y; out.y = -s * a.x; } public final static Vec2 cross(float s, Vec2 a) { return new Vec2(-s * a.y, s * a.x); } public final static void crossToOut(float s, Vec2 a, Vec2 out) { final float tempY = s * a.x; out.x = -s * a.y; out.y = tempY; } public final static void crossToOutUnsafe(float s, Vec2 a, Vec2 out) { assert (out != a); out.x = -s * a.y; out.y = s * a.x; } public final static void negateToOut(Vec2 a, Vec2 out) { out.x = -a.x; out.y = -a.y; } public final static Vec2 min(Vec2 a, Vec2 b) { return new Vec2(a.x < b.x ? a.x : b.x, a.y < b.y ? a.y : b.y); } public final static Vec2 max(Vec2 a, Vec2 b) { return new Vec2(a.x > b.x ? a.x : b.x, a.y > b.y ? a.y : b.y); } public final static void minToOut(Vec2 a, Vec2 b, Vec2 out) { out.x = a.x < b.x ? a.x : b.x; out.y = a.y < b.y ? a.y : b.y; } public final static void maxToOut(Vec2 a, Vec2 b, Vec2 out) { out.x = a.x > b.x ? a.x : b.x; out.y = a.y > b.y ? a.y : b.y; } /** * @see java.lang.Object#hashCode() */ @Override public int hashCode() { // automatically generated by Eclipse final int prime = 31; int result = 1; result = prime * result + Float.floatToIntBits(x); result = prime * result + Float.floatToIntBits(y); return result; } /** * @see java.lang.Object#equals(java.lang.Object) */ @Override public boolean equals(Object obj) { // automatically generated by Eclipse if (this == obj) { return true; } if (obj == null) { return false; } if (getClass() != obj.getClass()) { return false; } Vec2 other = (Vec2) obj; if (Float.floatToIntBits(x) != Float.floatToIntBits(other.x)) { return false; } return (Float.floatToIntBits(y) == Float.floatToIntBits(other.y)); } }