Class Vector3d

java.lang.Object

eu.mihosoft.vrl.v3d.Vector3d

public class Vector3d
extends Object

3D Vector3d.

Author:

Michael Hoffer <info@michaelhoffer.de>

Field Summary

Fields

Modifier and Type	Field	Description
static final Vector3d	UNITY
double	x
static final Vector3d	X_ONE
double	y
static final Vector3d	Y_ONE
double	z
static final Vector3d	Z_ONE
static final Vector3d	ZERO

Constructor Summary

Constructors

Constructor	Description
Vector3d(double x, double y)	Creates a new vector with specified x, y and z = 0.
Vector3d(double x, double y, double z)	Creates a new vector.
Vector3d(Vector3d vec)	Creates a new vector based on provided vector (copy constructor)

Method Summary

Modifier and Type	Method	Description
Vector3d	add(double x, double y, double z)
Vector3d	add(Vector3d vec)
double	angle(Vector3d v)	Returns the angle between this and the specified vector.
Vector3d	clone()
Vector3d	cross(Vector3d a)	Returns the cross product of this vector and the specified vector.
double	distance(Vector3d v)
Vector3d	dividedBy(double a)	Returns this vector devided by the specified value.
double	dot(Vector3d a)	Returns the dot product of this vector and the specified vector.
boolean	equals(Object obj)
int	hashCode()
Vector3d	lerp(Vector3d a, double t)	Linearly interpolates between this and the specified vector.
double	magnitude()	Returns the magnitude of this vector.
double	magnitudeSq()	Returns the squared magnitude of this vector (this.dot(this)).
Vector3d	midpoint(Vector3d point)	Constructs a new Point3D at the geometric mean of this point and the given point.
Vector3d	minus(Vector3d v)	Returns the difference of this vector and the specified vector.
Vector3d	negated()	Returns a negated copy of this vector.
Vector3d	normalized()	Returns a normalized copy of this vector with length 1.
Vector3d	orthogonal()	Creates a new vector which is orthogonal to this.
double	phi()
Vector3d	plus(Vector3d v)	Returns the sum of this vector and the specified vector.
void	rotate(Vector3d vector, double angle)	Rotates the given vector clockwise around the axis produced by this vector by the given angle.
Vector3d	rotateX(double angle)
Vector3d	rotateY(double angle)
Vector3d	rotateZ(double angle)
void	set(double x, double y)
void	set(double x, double y, double z)
void	set(Vector3d vec)
Vector3d	sub(Vector3d vector)	Subtracts the given vector from this vector
double	theta()
Vector3d	times(double a)	Returns the product of this vector and the specified value.
Vector3d	times(Vector3d a)	Returns the product of this vector and the specified vector.
String	toObjString()	Returns this vector in OBJ string format.
StringBuilder	toObjString(StringBuilder sb)	Returns this vector in OBJ string format.
String	toStlString()	Returns this vector in STL string format.
StringBuilder	toStlString(StringBuilder sb)	Returns this vector in STL string format.
String	toString()
Vector3d	transform(Transform transform)	Applies the specified transformation to this vector.
Vector3d	transform(Transform transform, double amount)	Applies the specified transformation to this vector.
Vector3d	transformed(Transform transform)	Returns a transformed copy of this vector.
Vector3d	transformed(Transform transform, double amount)	Returns a transformed copy of this vector.
static Vector3d	x(double x)	Creates a new vector with specified x
static Vector3d	y(double y)	Creates a new vector with specified y
static Vector3d	z(double z)	Creates a new vector with specified z

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

x

public double x

y

public double y

z

public double z

ZERO

public static final Vector3d ZERO

UNITY

public static final Vector3d UNITY

X_ONE

public static final Vector3d X_ONE

Y_ONE

public static final Vector3d Y_ONE

Z_ONE

public static final Vector3d Z_ONE

Constructor Details

Vector3d

public Vector3d(double x,
 double y,
 double z)

Creates a new vector.

Parameters:

x - x value

y - y value

z - z value

Vector3d

public Vector3d(Vector3d vec)

Creates a new vector based on provided vector (copy constructor)

Parameters:

vec - vector for copy constructor

Vector3d

public Vector3d(double x,
 double y)

Creates a new vector with specified x, y and z = 0.

Parameters:

x - x value

y - y value

Method Details

set

public void set(double x,
 double y,
 double z)

set

public void set(double x,
 double y)

set

public void set(Vector3d vec)

sub

public Vector3d sub(Vector3d vector)

Subtracts the given vector from this vector

Parameters:

vector - the vector to subtract from this vector

Returns:

Vector3d

clone

public Vector3d clone()

Overrides:

clone in class Object

negated

public Vector3d negated()

Returns a negated copy of this vector. Note: this vector is not modified.

Returns:

a negated copy of this vector

plus

public Vector3d plus(Vector3d v)

Returns the sum of this vector and the specified vector.

Parameters:

v - the vector to add Note: this vector is not modified.

Returns:

the sum of this vector and the specified vector

minus

public Vector3d minus(Vector3d v)

Returns the difference of this vector and the specified vector.

Parameters:

v - the vector to subtract Note: this vector is not modified.

Returns:

the difference of this vector and the specified vector

times

public Vector3d times(double a)

Returns the product of this vector and the specified value.

Parameters:

a - the value Note: this vector is not modified.

Returns:

the product of this vector and the specified value

times

public Vector3d times(Vector3d a)

Returns the product of this vector and the specified vector.

Parameters:

a - the vector Note: this vector is not modified.

Returns:

the product of this vector and the specified vector

dividedBy

public Vector3d dividedBy(double a)

Returns this vector devided by the specified value.

Parameters:

a - the value Note: this vector is not modified.

Returns:

this vector devided by the specified value

dot

public double dot(Vector3d a)

Returns the dot product of this vector and the specified vector. Note: this vector is not modified.

Parameters:

a - the second vector

Returns:

the dot product of this vector and the specified vector

lerp

public Vector3d lerp(Vector3d a,
 double t)

Linearly interpolates between this and the specified vector. Note: this vector is not modified.

Parameters:

a - vector

t - interpolation value

Returns:

copy of this vector if t = 0; copy of a if t = 1; the point midway between this and the specified vector if t = 0.5

magnitude

public double magnitude()

Returns the magnitude of this vector. Note: this vector is not modified.

Returns:

the magnitude of this vector

magnitudeSq

public double magnitudeSq()

Returns the squared magnitude of this vector (this.dot(this)). Note: this vector is not modified.

Returns:

the squared magnitude of this vector

normalized

public Vector3d normalized()

Returns a normalized copy of this vector with length 1. Note: this vector is not modified.

Returns:

a normalized copy of this vector with length 1

cross

public Vector3d cross(Vector3d a)

Returns the cross product of this vector and the specified vector. Note: this vector is not modified.

Parameters:

a - the vector

Returns:

the cross product of this vector and the specified vector.

toStlString

public String toStlString()

Returns this vector in STL string format.

Returns:

this vector in STL string format

toStlString

public StringBuilder toStlString(StringBuilder sb)

Returns this vector in STL string format.

Parameters:

sb - string builder

Returns:

the specified string builder

toObjString

public String toObjString()

Returns this vector in OBJ string format.

Returns:

this vector in OBJ string format

toObjString

public StringBuilder toObjString(StringBuilder sb)

Returns this vector in OBJ string format.

Parameters:

sb - string builder

Returns:

the specified string builder

transform

public Vector3d transform(Transform transform)

Applies the specified transformation to this vector.

Parameters:

transform - the transform to apply

Returns:

this vector

transformed

public Vector3d transformed(Transform transform)

Returns a transformed copy of this vector.

Parameters:

transform - the transform to apply Note: this vector is not modified.

Returns:

a transformed copy of this vector

transform

public Vector3d transform(Transform transform,
 double amount)

Applies the specified transformation to this vector.

Parameters:

transform - the transform to apply

Returns:

this vector

transformed

public Vector3d transformed(Transform transform,
 double amount)

Returns a transformed copy of this vector.

Parameters:

transform - the transform to apply Note: this vector is not modified.

Returns:

a transformed copy of this vector

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

angle

public double angle(Vector3d v)

Returns the angle between this and the specified vector.

Parameters:

v - vector

Returns:

angle in radians

distance

public double distance(Vector3d v)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

x

public static Vector3d x(double x)

Creates a new vector with specified x

Parameters:

x - x value

Returns:

a new vector [x,0,0]

y

public static Vector3d y(double y)

Creates a new vector with specified y

Parameters:

y - y value

Returns:

a new vector [0,y,0]

z

public static Vector3d z(double z)

Creates a new vector with specified z

Parameters:

z - z value

Returns:

a new vector [0,0,z]

orthogonal

public Vector3d orthogonal()

Creates a new vector which is orthogonal to this. this_i , this_j , this_k => i,j,k € {1,2,3} permutation looking for orthogonal vector o to vector this: this_i * o_i + this_j * o_j + this_k * o_k = 0

Returns:

a new vector which is orthogonal to this

add

public Vector3d add(double x,
 double y,
 double z)

add

public Vector3d add(Vector3d vec)

rotateX

public Vector3d rotateX(double angle)

rotateY

public Vector3d rotateY(double angle)

rotateZ

public Vector3d rotateZ(double angle)

rotate

public void rotate(Vector3d vector,
 double angle)

Rotates the given vector clockwise around the axis produced by this vector by the given angle.

Parameters:

vector - the vector to rotate

angle - the angle of rotation

midpoint

public Vector3d midpoint(Vector3d point)

Constructs a new Point3D at the geometric mean of this point and the given point. This function behaves identically to lerp(point, 0.5).

Parameters:

point - the other point

Returns:

a point at the geometric mean of the two given points

theta

public double theta()

Returns:

theta elevation (angle between vector and z axis)

phi

public double phi()

Returns:

phi azimuth (angle between projection onto xy plane and x axis)