jadex.extension.envsupport.math.IVector3 Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jadex-kernel-extension-envsupport Show documentation
Show all versions of jadex-kernel-extension-envsupport Show documentation
The Jadex kernel extension envsupport allows for using 2D spaces in concert with components.
package jadex.extension.envsupport.math;
import java.math.BigDecimal;
/** Interface for cartesian 2-vectors
* NOTE: All operations on the vector are destructive and the instance
* returned is the same as the one whose method was called.
* If you require a copy of the vector before performing operations
* on it, use the copy constructor, the copy method or the clone
* interface.
*/
public interface IVector3
{
/** Assigns this vector the values of another vector.
*
* @param vector the other vector
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 assign(IVector3 vector);
/** Adds a scalar to each component of this vector.
*
* @param scalar scalar value as double
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 add(double scalar);
/** Adds a scalar to each component of this vector.
*
* @param scalar scalar value
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 add(IVector1 scalar);
/** Adds another vector to this vector, adding individual components.
*
* @param vector the vector to add to this vector
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 add(IVector3 vector);
/** Subtracts a scalar to each component of this vector.
*
* @param scalar scalar value as double
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 subtract(double scalar);
/** Subtracts a scalar to each component of this vector.
*
* @param scalar scalar value
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 subtract(IVector1 scalar);
/** Subtracts another vector to this vector, subtracting individual components.
*
* @param vector the vector to subtract from this vector
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 subtract(IVector3 vector);
/** Applies a modulo vector. The modulus will be added first so that
* values in the interval (-modulus, 0) will wrap over into the positive range.
*
* @param modulus modulus
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 mod(IVector3 modulus);
/** Performs a scalar multiplication (scaling) on the vector.
*
* @param scalar the scale factor double
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 multiply(double scalar);
/** Performs a scalar multiplication (scaling) on the vector.
*
* @param scalar the scale factor
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 multiply(IVector1 scalar);
/** Performs a multiplication on the vector.
*
* @param vector vector
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 multiply(IVector3 vector);
/** Performs a division on the vector.
*
* @param vector vector
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 divide(IVector3 vector);
/** Sets all vector components to zero.
*
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 zero();
/** Negates the x-component.
*
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 negateX();
/** Negates the y-component.
*
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 negateY();
/** Negates the z-component.
*
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 negateZ();
/** Negates the vector by negating its components.
*
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 negate();
/** Sets the x-component to a random value in the interval [lower,upper]
*
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 randomX(IVector1 lower, IVector1 upper);
/** Sets the y-component to a random value in the interval [lower,upper]
*
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 randomY(IVector1 lower, IVector1 upper);
/** Sets the z-component to a random value in the interval [lower,upper]
*
* @return a reference to the called vector (NOT a copy)
*/
public IVector3 randomZ(IVector1 lower, IVector1 upper);
/** Converts the vector to a unit vector (normalization)
*/
public IVector3 normalize();
/** Returns the length (magnitude) of the vector.
*
* @return vector length
*/
public IVector1 getLength();
/** Returns the direction (theta) of the vector.
*
* @return vector direction
*/
public IVector2 getDirection();
/** Returns the distance to another vector.
*
* @param vector other vector
* @return distance
*/
public IVector1 getDistance(IVector3 vector);
/** Returns the x-component of the vector.
*
* @return x-component
*/
public IVector1 getX();
/** Returns the y-component of the vector.
*
* @return y-component
*/
public IVector1 getY();
/** Returns the z-component of the vector.
*
* @return z-component
*/
public IVector1 getZ();
/** Returns the x-component of the vector as integer.
*
* @return x-component as integer
*/
public int getXAsInteger();
/** Returns the component of the vector as integer.
*
* @return y-component as float
*/
public int getYAsInteger();
/** Returns the component of the vector as integer.
*
* @return y-component as float
*/
public int getZAsInteger();
/** Returns the x-component of the vector as long.
*
* @return x-component as long
*/
public long getXAsLong();
/** Returns the component of the vector as float.
*
* @return y-component as float
*/
public long getYAsLong();
/** Returns the component of the vector as float.
*
* @return z-component as float
*/
public long getZAsLong();
/** Returns the x-component of the vector as float.
*
* @return x-component as float
*/
public float getXAsFloat();
/** Returns the component of the vector as float.
*
* @return y-component as float
*/
public float getYAsFloat();
/** Returns the component of the vector as float.
*
* @return z-component as float
*/
public float getZAsFloat();
/** Returns the x-component of the vector as double.
*
* @return x-component as double
*/
public double getXAsDouble();
/** Returns the component of the vector as double.
*
* @return y-component as double
*/
public double getYAsDouble();
/** Returns the component of the vector as double.
*
* @return z-component as double
*/
public double getZAsDouble();
/** Returns the x-component of the vector as BigDecimal.
*
* @return x-component as BigDecimal
*/
public BigDecimal getXAsBigDecimal();
/** Returns the component of the vector as BigDecima;.
*
* @return y-component as BigDecimal
*/
public BigDecimal getYAsBigDecimal();
/** Returns the component of the vector as BigDecima;.
*
* @return y-component as BigDecimal
*/
public BigDecimal getZAsBigDecimal();
/** Makes a copy of the vector without using the complex clone interface.
*
* @return copy of the vector
*/
public IVector3 copy();
/** Generates a deep clone of the vector.
*
* @return clone of this vector
*/
public Object clone() throws CloneNotSupportedException;
/** Compares the vector to an object
*
* @param obj the object
* @return always returns false unless the object is an IVector3,
* in which case it is equivalent to equals(IVector vector)
*/
public boolean equals(Object obj);
/** Compares the vector to another vector.
* The vectors are equal if the components are equal.
*
* @param vector the other vector
* @return true if the vectors are equal
*/
public boolean equals(IVector3 vector);
}