Class Vector2D

java.lang.Object
gaiasky.util.math.Vector2D
All Implemented Interfaces:
VectorDouble<Vector2D>
public class Vector2D extends Object implements VectorDouble<Vector2D>

  • Field Details

    • X

      public static final Vector2D X

    • Y

      public static final Vector2D Y

    • Zero

      public static final Vector2D Zero

    • x

      public double x
      the x-component of this vector

    • y

      public double y
      the y-component of this vector

  • Constructor Details

    • Vector2D

      public Vector2D()
      Constructs a new vector at (0,0)

    • Vector2D

      public Vector2D(double x, double y)
      Constructs a vector with the given components
      Parameters:
      x - The x-component
      y - The y-component

    • Vector2D

      public Vector2D(Vector2D v)
      Constructs a vector from the given vector
      Parameters:
      v - The vector

  • Method Details

    • len

      public static double len(double x, double y)

    • len2

      public static double len2(double x, double y)

    • dot

      public static double dot(double x1, double y1, double x2, double y2)

    • dst

      public static double dst(double x1, double y1, double x2, double y2)

    • dst2

      public static double dst2(double x1, double y1, double x2, double y2)

    • x

      public double x()

    • y

      public double y()

    • cpy

      public Vector2D cpy()
      Specified by:
      cpy in interface VectorDouble<Vector2D>
      Returns:
      a copy of this vector

    • len

      public double len()
      Specified by:
      len in interface VectorDouble<Vector2D>
      Returns:
      The euclidean length

    • len2

      public double len2()
      Description copied from interface: VectorDouble
      This method is faster than VectorDouble.len() because it avoids calculating a square root. It is useful for comparisons, but not for getting exact lengths, as the return value is the square of the actual length.
      Specified by:
      len2 in interface VectorDouble<Vector2D>
      Returns:
      The squared euclidean length

    • set

      public Vector2D set(Vector2D v)
      Description copied from interface: VectorDouble
      Sets this vector from the given vector
      Specified by:
      set in interface VectorDouble<Vector2D>
      Parameters:
      v - The vector
      Returns:
      This vector for chaining

    • set

      public Vector2D set(double[] vals)

    • set

      public Vector2D set(double x, double y)
      Sets the components of this vector
      Parameters:
      x - The x-component
      y - The y-component
      Returns:
      This vector for chaining

    • sub

      public Vector2D sub(Vector2D v)
      Description copied from interface: VectorDouble
      Subtracts the given vector from this vector.
      Specified by:
      sub in interface VectorDouble<Vector2D>
      Parameters:
      v - The vector
      Returns:
      This vector for chaining

    • sub

      public Vector2D sub(double x, double y)
      Substracts the other vector from this vector.
      Parameters:
      x - The x-component of the other vector
      y - The y-component of the other vector
      Returns:
      This vector for chaining

    • nor

      public Vector2D nor()
      Description copied from interface: VectorDouble
      Normalizes this vector. Does nothing if it is zero.
      Specified by:
      nor in interface VectorDouble<Vector2D>
      Returns:
      This vector for chaining

    • add

      public Vector2D add(Vector2D v)
      Description copied from interface: VectorDouble
      Adds the given vector to this vector
      Specified by:
      add in interface VectorDouble<Vector2D>
      Parameters:
      v - The vector
      Returns:
      This vector for chaining

    • add

      public Vector2D add(double x, double y)
      Adds the given components to this vector
      Parameters:
      x - The x-component
      y - The y-component
      Returns:
      This vector for chaining

    • dot

      public double dot(Vector2D v)
      Specified by:
      dot in interface VectorDouble<Vector2D>
      Parameters:
      v - The other vector
      Returns:
      The dot product between this and the other vector

    • dot

      public double dot(double ox, double oy)

    • scl

      public Vector2D scl(double scalar)
      Description copied from interface: VectorDouble
      Scales this vector by a scalar
      Specified by:
      scl in interface VectorDouble<Vector2D>
      Parameters:
      scalar - The scalar
      Returns:
      This vector for chaining

    • scl

      public Vector2D scl(double x, double y)
      Multiplies this vector by a scalar
      Returns:
      This vector for chaining

    • scl

      public Vector2D scl(Vector2D v)
      Description copied from interface: VectorDouble
      Scales this vector by another vector
      Specified by:
      scl in interface VectorDouble<Vector2D>
      Returns:
      This vector for chaining

    • mulAdd

      public Vector2D mulAdd(Vector2D vec, double scalar)
      Description copied from interface: VectorDouble
      First scale a supplied vector, then add it to this vector.
      Specified by:
      mulAdd in interface VectorDouble<Vector2D>
      Parameters:
      vec - addition vector.
      scalar - for scaling the addition vector.

    • mulAdd

      public Vector2D mulAdd(Vector2D vec, Vector2D mulVec)
      Description copied from interface: VectorDouble
      First scale a supplied vector, then add it to this vector.
      Specified by:
      mulAdd in interface VectorDouble<Vector2D>
      Parameters:
      vec - addition vector.
      mulVec - vector by whose values the addition vector will be scaled.

    • setZero

      public Vector2D setZero()
      Description copied from interface: VectorDouble
      Sets the components of this vector to 0.
      Specified by:
      setZero in interface VectorDouble<Vector2D>
      Returns:
      This vector for chaining.

    • dst

      public double dst(Vector2D v)
      Specified by:
      dst in interface VectorDouble<Vector2D>
      Parameters:
      v - The other vector
      Returns:
      the distance between this and the other vector

    • dst

      public double dst(double x, double y)
      Parameters:
      x - The x-component of the other vector
      y - The y-component of the other vector
      Returns:
      the distance between this and the other vector

    • dst2

      public double dst2(Vector2D v)
      Description copied from interface: VectorDouble
      This method is faster than VectorDouble.dst(VectorDouble) because it avoids calculating a square root. It is useful for comparisons, but not for getting accurate distances, as the return value is the square of the actual distance.
      Specified by:
      dst2 in interface VectorDouble<Vector2D>
      Parameters:
      v - The other vector
      Returns:
      the squared distance between this and the other vector

    • dst2

      public double dst2(double x, double y)
      Parameters:
      x - The x-component of the other vector
      y - The y-component of the other vector
      Returns:
      the squared distance between this and the other vector

    • limit

      public Vector2D limit(double limit)
      Description copied from interface: VectorDouble
      Limits the length of this vector, based on the desired maximum length.
      Specified by:
      limit in interface VectorDouble<Vector2D>
      Parameters:
      limit - desired maximum length for this vector
      Returns:
      this vector for chaining

    • limit2

      public Vector2D limit2(double limit2)
      Description copied from interface: VectorDouble

      Limits the length of this vector, based on the desired maximum length squared.

      This method is slightly faster than limit().
      Specified by:
      limit2 in interface VectorDouble<Vector2D>
      Parameters:
      limit2 - squared desired maximum length for this vector
      Returns:
      this vector for chaining
      See Also:

    • setLength

      public Vector2D setLength(double len)
      Description copied from interface: VectorDouble
      Sets the length of this vector. Does nothing is this vector is zero.
      Specified by:
      setLength in interface VectorDouble<Vector2D>
      Parameters:
      len - desired length for this vector
      Returns:
      this vector for chaining

    • setLength2

      public Vector2D setLength2(double len2)
      Description copied from interface: VectorDouble

      Sets the length of this vector, based on the square of the desired length. Does nothing is this vector is zero.

      This method is slightly faster than setLength().
      Specified by:
      setLength2 in interface VectorDouble<Vector2D>
      Parameters:
      len2 - desired square of the length for this vector.
      Returns:
      this vector for chaining.
      See Also:

    • clamp

      public Vector2D clamp(double min, double max)
      Description copied from interface: VectorDouble
      Clamps this vector's length to given min and max values
      Specified by:
      clamp in interface VectorDouble<Vector2D>
      Parameters:
      min - Min length
      max - Max length
      Returns:
      This vector for chaining

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • mul

      public Vector2D mul(com.badlogic.gdx.math.Matrix3 mat)
      Left-multiplies this vector by the given matrix
      Parameters:
      mat - the matrix
      Returns:
      this vector

    • crs

      public double crs(Vector2D v)
      Calculates the 2D cross product between this and the given vector.
      Parameters:
      v - the other vector
      Returns:
      the cross product

    • crs

      public double crs(double x, double y)
      Calculates the 2D cross product between this and the given vector.
      Parameters:
      x - the x-coordinate of the other vector
      y - the y-coordinate of the other vector
      Returns:
      the cross product

    • angle

      public double angle()
      Returns:
      the angle in degrees of this vector (point) relative to the x-axis. Angles are towards the positive y-axis (typically counter-clockwise) and between 0 and 360.

    • getAngleRad

      public double getAngleRad()
      Returns:
      the angle in radians of this vector (point) relative to the x-axis. Angles are towards the positive y-axis. (typically counter-clockwise)

    • setAngleRad

      public Vector2D setAngleRad(double radians)
      Sets the angle of the vector in radians relative to the x-axis, towards the positive y-axis (typically counter-clockwise).
      Parameters:
      radians - The angle in radians to set.

    • setAngle

      public Vector2D setAngle(double degrees)
      Sets the angle of the vector in degrees relative to the x-axis, towards the positive y-axis (typically counter-clockwise).
      Parameters:
      degrees - The angle in degrees to set.

    • rotate

      public Vector2D rotate(double degrees)
      Rotates the Vector2d by the given angle, counter-clockwise assuming the y-axis points up.
      Parameters:
      degrees - the angle in degrees

    • rotateRad

      public Vector2D rotateRad(double radians)
      Rotates the Vector2d by the given angle, counter-clockwise assuming the y-axis points up.
      Parameters:
      radians - the angle in radians

    • values

      public double[] values()

    • rotate90

      public Vector2D rotate90(int dir)
      Rotates the Vector2D by 90 degrees in the specified direction, where ≥0 is counter-clockwise and <0 is clockwise.

    • lerp

      public Vector2D lerp(Vector2D target, double alpha)
      Description copied from interface: VectorDouble
      Linearly interpolates between this vector and the target vector by alpha which is in the range [0,1]. The result is stored in this vector.
      Specified by:
      lerp in interface VectorDouble<Vector2D>
      Parameters:
      target - The target vector
      alpha - The interpolation coefficient
      Returns:
      This vector for chaining.

    • interpolate

      public Vector2D interpolate(Vector2D target, double alpha, InterpolationDouble interpolation)
      Description copied from interface: VectorDouble
      Interpolates between this vector and the given target vector by alpha (within range [0,1]) using the given Interpolation method. the result is stored in this vector.
      Specified by:
      interpolate in interface VectorDouble<Vector2D>
      Parameters:
      target - The target vector
      alpha - The interpolation coefficient
      interpolation - An Interpolation object describing the used interpolation method
      Returns:
      This vector for chaining.

    • setToRandomDirection

      public Vector2D setToRandomDirection()
      Description copied from interface: VectorDouble
      Sets this vector to the unit vector with a random direction
      Specified by:
      setToRandomDirection in interface VectorDouble<Vector2D>
      Returns:
      This vector for chaining

    • epsilonEquals

      public boolean epsilonEquals(Vector2D other, double epsilon)
      Description copied from interface: VectorDouble
      Compares this vector with the other vector, using the supplied epsilon for fuzzy equality testing.
      Specified by:
      epsilonEquals in interface VectorDouble<Vector2D>
      Parameters:
      other - The other vector.
      epsilon - The maximum deviation.
      Returns:
      whether the vectors have fuzzy equality.

    • epsilonEquals

      public boolean epsilonEquals(double x, double y, double epsilon)
      Compares this vector with the other vector, using the supplied epsilon for fuzzy equality testing.
      Returns:
      whether the vectors are the same.

    • isUnit

      public boolean isUnit()
      Specified by:
      isUnit in interface VectorDouble<Vector2D>
      Returns:
      Whether this vector is a unit length vector

    • isUnit

      public boolean isUnit(double margin)
      Specified by:
      isUnit in interface VectorDouble<Vector2D>
      Returns:
      Whether this vector is a unit length vector within the given margin.

    • isZero

      public boolean isZero()
      Specified by:
      isZero in interface VectorDouble<Vector2D>
      Returns:
      Whether this vector is a zero vector

    • isZero

      public boolean isZero(double margin)
      Specified by:
      isZero in interface VectorDouble<Vector2D>
      Returns:
      Whether the length of this vector is smaller than the given margin

    • isOnLine

      public boolean isOnLine(Vector2D other)
      Specified by:
      isOnLine in interface VectorDouble<Vector2D>
      Returns:
      true if this vector is in line with the other vector (either in the same or the opposite direction)

    • isOnLine

      public boolean isOnLine(Vector2D other, double epsilon)
      Specified by:
      isOnLine in interface VectorDouble<Vector2D>
      Returns:
      true if this vector is in line with the other vector (either in the same or the opposite direction)

    • isCollinear

      public boolean isCollinear(Vector2D other, double epsilon)
      Specified by:
      isCollinear in interface VectorDouble<Vector2D>
      Returns:
      true if this vector is collinear with the other vector (VectorDouble.isOnLine(VectorDouble, double) and VectorDouble.hasSameDirection(VectorDouble)).

    • isCollinear

      public boolean isCollinear(Vector2D other)
      Specified by:
      isCollinear in interface VectorDouble<Vector2D>
      Returns:
      true if this vector is collinear with the other vector (VectorDouble.isOnLine(VectorDouble) and VectorDouble.hasSameDirection(VectorDouble)).

    • isCollinearOpposite

      public boolean isCollinearOpposite(Vector2D other, double epsilon)
      Specified by:
      isCollinearOpposite in interface VectorDouble<Vector2D>
      Returns:
      true if this vector is opposite collinear with the other vector (VectorDouble.isOnLine(VectorDouble, double) and VectorDouble.hasOppositeDirection(VectorDouble)).

    • isCollinearOpposite

      public boolean isCollinearOpposite(Vector2D other)
      Specified by:
      isCollinearOpposite in interface VectorDouble<Vector2D>
      Returns:
      true if this vector is opposite collinear with the other vector (VectorDouble.isOnLine(VectorDouble) and VectorDouble.hasOppositeDirection(VectorDouble)).

    • isPerpendicular

      public boolean isPerpendicular(Vector2D vector)
      Specified by:
      isPerpendicular in interface VectorDouble<Vector2D>
      Returns:
      Whether this vector is perpendicular with the other vector. True if the dot product is 0.

    • isPerpendicular

      public boolean isPerpendicular(Vector2D vector, double epsilon)
      Specified by:
      isPerpendicular in interface VectorDouble<Vector2D>
      Parameters:
      epsilon - a positive small number close to zero
      Returns:
      Whether this vector is perpendicular with the other vector. True if the dot product is 0.

    • hasSameDirection

      public boolean hasSameDirection(Vector2D vector)
      Specified by:
      hasSameDirection in interface VectorDouble<Vector2D>
      Returns:
      Whether this vector has similar direction compared to the other vector. True if the normalized dot product is >0.

    • hasOppositeDirection

      public boolean hasOppositeDirection(Vector2D vector)
      Specified by:
      hasOppositeDirection in interface VectorDouble<Vector2D>
      Returns:
      Whether this vector has opposite direction compared to the other vector. True if the normalized dot product is <0.