Vector math extensions More...

Static Public Member Functions
static Vector3	Slerp (Vector3 a, Vector3 b, float blend)
	Slerp between two vectors More...

static Vector3	Nlerp (Vector3 a, Vector3 b, float blend)
	Nlerp the specified a, b and blend. More...

static Vector3d	Slerp (Vector3d a, Vector3d b, double blend)
	Slerp the specified a, b and blend. More...

static Vector3d	Nlerp (Vector3d a, Vector3d b, double blend)
	Nlerp the specified a, b and blend. More...

static Vector3	SmartNlerp (Vector3 a, Vector3 b, float blend, Vector3 defaultRotateVec)
	NLerp that handles near-infinite scenario More...

static Vector3	SmartNlerp (Vector3 a, Vector3 b, float blend)
	NLerp that hanles the near-infinite scenario More...

static Vector3d	SmartNlerp (Vector3d a, Vector3d b, double blend, Vector3d defaultRotateVec)
	Smart nlerp that lerps a vector around a rotation vector More...

static Vector3d	SmartNlerp (Vector3d a, Vector3d b, double blend)
	NLerp that intelligently rotates one vector to another More...

static Vector3	Abs (Vector3 v)
	Returns the component absolute value of a vector More...

static Vector3	InverseAbs (Vector3 v)
	Returns the 1f-Abs(v) of each component of a vector More...

static bool	InSquareDistance (Vector3 a, Vector3 b, float d)
	Checks whether or not two vectors are within a square distance of each other More...

static bool	InSquareDistance (Vector3d a, Vector3d b, double d)
	Checks whether or not two vectors are within a square distance of each other More...

static bool	InSquareDistance (Vector3i a, Vector3i b, int d)
	Checks whether or not two vectors are greater than or equal to a square distance of each other More...

static double	ComponentDistance (Vector3d a, Vector3d b)
	Returns the largest distance of any components More...

static Matrix4	Rotate (Vector3 start, Vector3 end)
	Create a rotation matrix to rotate a vector from a given start vector to a target vector More...

static Matrix4	RotationMatrix (Vector3 rot)
	Create a rotation matrix given a vector to rotate given radians More...

static Matrix4	MatrixFromComponents (Vector3 translate, Vector3 rotate)
	Create a rotation and translation vector given a translation and radians More...

static Vector2	Project (Vector3 pt, Matrix4 modelview, Matrix4 projection)
	Project a 3d point to 2d given a modelview and projection More...

static Vector2d	Project (Vector3d pt, Matrix4d modelview, Matrix4d projection)
	Project a 3D point to 2D point given modelview and projection More...

static float	PointToLineDistance (Vector3 line1, Vector3 line2, Vector3 point)
	Get the distance between a point and a line More...

static Vector3	SwapXY (this Vector3 v)
	Swap X and Y components of a vector More...

static float	RotationZ (Vector3 lookDir)
	Get the rotation value of the X and Y components of a matrix More...

static float	RotationZ (Vector2 lookDir)
	Get the rotation given a 2D look direction More...

static double	RotationZ (Vector3d lookDir)
	Get the Z rotation given a 3d look direction More...

static double	RotationZ (Vector2d lookDir)
	Get the Z rotation from a 2d vector More...

static Vector3d	RotationVector (double rotZ, double speed=1.0)
	Get a rotation vector and a power More...

static Vector3	Wrap (Vector3 val)
	Wrap each component of the vector between 0-1 More...

Detailed Description

Vector math extensions

Member Function Documentation

◆ Abs()

static Vector3 pluginbase.Helpers.Computative.VExt.Abs ( Vector3 v )

static

Returns the component absolute value of a vector

Parameters

v V.

         {
             return new Vector3( Math.Abs(v.X), Math.Abs(v.Y), Math.Abs(v.Z) );
         }

◆ ComponentDistance()

static double pluginbase.Helpers.Computative.VExt.ComponentDistance	(	Vector3d	a,
		Vector3d	b
	)

static

Returns the largest distance of any components

Returns: The distance.

Parameters

a	The alpha component.
b	The blue component.

         {
             double aX = Math.Abs(a.X - b.X);
             double aY = Math.Abs(a.Y - b.Y);
             double aZ = Math.Abs(a.Z - b.Z);
             return aX > aY && aX > aZ ? aX : (aY > aZ ? aY : aZ); //Largest of the 3
         }

◆ InSquareDistance() [1/3]

static bool pluginbase.Helpers.Computative.VExt.InSquareDistance	(	Vector3	a,
		Vector3	b,
		float	d
	)

static

Checks whether or not two vectors are within a square distance of each other

Returns: true, if manhattan distance was ined, false otherwise.

Parameters

a	The a component.
b	The b component.
d	D.

         {
             if (Math.Abs(a.X - b.X) > d) return false;
             if (Math.Abs(a.Y - b.Y) > d) return false;
             if (Math.Abs(a.Z - b.Z) > d) return false;
             return true;
         }

◆ InSquareDistance() [2/3]

static bool pluginbase.Helpers.Computative.VExt.InSquareDistance	(	Vector3d	a,
		Vector3d	b,
		double	d
	)

static

Checks whether or not two vectors are within a square distance of each other

Returns: true, if manhattan distance was ined, false otherwise.

Parameters

a	The alpha component.
b	The blue component.
d	D.

         {
             if (Math.Abs(a.X - b.X) > d) return false;
             if (Math.Abs(a.Y - b.Y) > d) return false;
             if (Math.Abs(a.Z - b.Z) > d) return false;
             return true;
         }

◆ InSquareDistance() [3/3]

static bool pluginbase.Helpers.Computative.VExt.InSquareDistance	(	Vector3i	a,
		Vector3i	b,
		int	d
	)

static

Checks whether or not two vectors are greater than or equal to a square distance of each other

Returns: true, if manhattan distance was ined, false otherwise.

Parameters

a	The alpha component.
b	The blue component.
d	D.

         {
             if (Math.Abs(a.X - b.X) > d) return false;
             if (Math.Abs(a.Y - b.Y) > d) return false;
             if (Math.Abs(a.Z - b.Z) > d) return false;
             return true;
         }

◆ InverseAbs()

static Vector3 pluginbase.Helpers.Computative.VExt.InverseAbs ( Vector3 v )

static

Returns the 1f-Abs(v) of each component of a vector

Returns: The abs.

Parameters

v V.

         {
             return new Vector3(1f - Math.Abs(v.X), 1f - Math.Abs(v.Y), 1f - Math.Abs(v.Z));
         }

◆ MatrixFromComponents()

static Matrix4 pluginbase.Helpers.Computative.VExt.MatrixFromComponents	(	Vector3	translate,
		Vector3	rotate
	)

static

Create a rotation and translation vector given a translation and radians

Returns: The from components.

Parameters

translate	Translate.
rotate	Rotate.

         {
             Matrix4 mat = Matrix4.Identity;
             mat *= Matrix4.CreateRotationX(rotate.X);
             mat *= Matrix4.CreateRotationY(rotate.Y);
             mat *= Matrix4.CreateRotationZ(rotate.Z);
             mat *= Matrix4.CreateTranslation(translate);
             return mat;
         }

◆ Nlerp() [1/2]

static Vector3 pluginbase.Helpers.Computative.VExt.Nlerp	(	Vector3	a,
		Vector3	b,
		float	blend
	)

static

Nlerp the specified a, b and blend.

Parameters

a	The alpha component.
b	The blue component.
blend	Blend.

         {
             return Vector3.Normalize( a * (1f - blend) + b * blend);
         }

◆ Nlerp() [2/2]

static Vector3d pluginbase.Helpers.Computative.VExt.Nlerp	(	Vector3d	a,
		Vector3d	b,
		double	blend
	)

static

Nlerp the specified a, b and blend.

Parameters

a	The alpha component.
b	The blue component.
blend	Blend.

         {
             return Vector3d.Normalize( a * (1.0 - blend) + b * blend);
         }

◆ PointToLineDistance()

static float pluginbase.Helpers.Computative.VExt.PointToLineDistance	(	Vector3	line1,
		Vector3	line2,
		Vector3	point
	)

static

Get the distance between a point and a line

Returns: The to line distance.

Parameters

line1	Line1.
line2	Line2.
point	Point.

         {
             return Vector3.Cross(point - line1, point - line2).Length / (line2 - line1).Length;
         }

◆ Project() [1/2]

static Vector2 pluginbase.Helpers.Computative.VExt.Project	(	Vector3	pt,
		Matrix4	modelview,
		Matrix4	projection
	)

static

Project a 3d point to 2d given a modelview and projection

Parameters

pt	Point.
modelview	Modelview.
projection	Projection.

         {
             Vector4 vec = new Vector4(pt, 1f);
             vec = Vector4.Transform(vec, modelview);
             vec = Vector4.Transform(vec, projection);
             vec.Xyz /= vec.W;
             return new Vector2((vec.X + 1f) * 0.5f, (vec.Y + 1f) * 0.5f);
         }

◆ Project() [2/2]

static Vector2d pluginbase.Helpers.Computative.VExt.Project	(	Vector3d	pt,
		Matrix4d	modelview,
		Matrix4d	projection
	)

static

Project a 3D point to 2D point given modelview and projection

Parameters

pt	Point.
modelview	Modelview.
projection	Projection.

         {
             Vector4d vec = new Vector4d(pt, 1f);
             vec = Vector4d.Transform(vec, modelview);
             vec = Vector4d.Transform(vec, projection);
             vec.Xyz /= vec.W;
             return new Vector2d((vec.X + 1f) * 0.5f, (vec.Y + 1f) * 0.5f);
         }

◆ Rotate()

static Matrix4 pluginbase.Helpers.Computative.VExt.Rotate	(	Vector3	start,
		Vector3	end
	)

static

Create a rotation matrix to rotate a vector from a given start vector to a target vector

Parameters

start	Start.
end	End.

         {
             float dot = Vector3.Dot(start, end);
             if (dot <= 0.999f)
             {
                 Vector3 axis = Vector3.Normalize(Vector3.Cross(start, end));
                 float theta = (float)Math.Acos(dot);
                 return Matrix4.CreateFromAxisAngle(axis, theta);
             }
             return Matrix4.Identity;
         }

◆ RotationMatrix()

static Matrix4 pluginbase.Helpers.Computative.VExt.RotationMatrix ( Vector3 rot )

static

Create a rotation matrix given a vector to rotate given radians

Returns: The matrix.

Parameters

rot Rot.

         {
             Matrix4 mat = Matrix4.Identity;
             mat *= Matrix4.CreateRotationX(rot.X);
             mat *= Matrix4.CreateRotationY(rot.Y);
             mat *= Matrix4.CreateRotationZ(rot.Z);
             return mat;
         }

◆ RotationVector()

static Vector3d pluginbase.Helpers.Computative.VExt.RotationVector	(	double	rotZ,
		double	speed = `1.0`
	)

static

Get a rotation vector and a power

Returns: The vector.

Parameters

rotZ	Rot z.
speed	Speed.

         {
             return new Vector3d(Math.Sin(rotZ) * speed, Math.Cos(rotZ) * speed, 0.0);
         }

◆ RotationZ() [1/4]

static float pluginbase.Helpers.Computative.VExt.RotationZ ( Vector3 lookDir )

static

Get the rotation value of the X and Y components of a matrix

Returns: The z.

Parameters

lookDir Look dir.

         {
             return (float)Math.Atan2(lookDir.X, lookDir.Y);
         }

◆ RotationZ() [2/4]

static float pluginbase.Helpers.Computative.VExt.RotationZ ( Vector2 lookDir )

static

Get the rotation given a 2D look direction

Returns: The z.

Parameters

lookDir Look dir.

         {
             return (float)Math.Atan2(lookDir.X, lookDir.Y);
         }

◆ RotationZ() [3/4]

static double pluginbase.Helpers.Computative.VExt.RotationZ ( Vector3d lookDir )

static

Get the Z rotation given a 3d look direction

Returns: The z.

Parameters

lookDir Look dir.

         {
             return Math.Atan2(lookDir.X, lookDir.Y);
         }

◆ RotationZ() [4/4]

static double pluginbase.Helpers.Computative.VExt.RotationZ ( Vector2d lookDir )

static

Get the Z rotation from a 2d vector

Returns: The z.

Parameters

lookDir Look dir.

         {
             return Math.Atan2(lookDir.X, lookDir.Y);
         }

◆ Slerp() [1/2]

static Vector3 pluginbase.Helpers.Computative.VExt.Slerp	(	Vector3	a,
		Vector3	b,
		float	blend
	)

static

Slerp between two vectors

Parameters

a	The alpha component.
b	The blue component.
blend	Blend.

         {
             float dot = Vector3.Dot(a, b);
             dot = MExt.Clamp(dot, -1f, 1f);
             float theta = (float)Math.Acos(dot) * blend;
             Vector3 rel = b - a * dot;
             rel.Normalize();
             return ((a * (float)Math.Cos(theta)) + rel * (float)Math.Sin(theta));
         }

◆ Slerp() [2/2]

static Vector3d pluginbase.Helpers.Computative.VExt.Slerp	(	Vector3d	a,
		Vector3d	b,
		double	blend
	)

static

Slerp the specified a, b and blend.

Parameters

a	The alpha component.
b	The blue component.
blend	Blend.

         {
             double dot = Vector3d.Dot(a, b);
             dot = MExt.Clamp(dot, -1.0, 1.0);
             double theta = Math.Acos(dot) * blend;
             Vector3d rel = b - a * dot;
             rel.Normalize();
             return a * Math.Cos(theta) + rel * Math.Sin(theta);
         }

◆ SmartNlerp() [1/4]

static Vector3 pluginbase.Helpers.Computative.VExt.SmartNlerp	(	Vector3	a,
		Vector3	b,
		float	blend,
		Vector3	defaultRotateVec
	)

static

NLerp that handles near-infinite scenario

Returns: The nlerp.

Parameters

a	The alpha component.
b	The blue component.
blend	Blend.
defaultRotateVec	Default rotate vec.

         {
             if (Vector3.Dot(a,b) < -0.99f)
             {
                 a += defaultRotateVec * 0.01f;
             }
             var blended = a * (1f - blend) + b * blend;
             if (blended == Vector3.Zero)
                 return Vector3.Zero;
             return Vector3.Normalize(blended);
         }

◆ SmartNlerp() [2/4]

static Vector3 pluginbase.Helpers.Computative.VExt.SmartNlerp	(	Vector3	a,
		Vector3	b,
		float	blend
	)

static

NLerp that hanles the near-infinite scenario

Returns: The nlerp.

Parameters

a	The alpha component.
b	The blue component.
blend	Blend.

         {
             return SmartNlerp(a, b, blend, Vector3.UnitX);
         }

◆ SmartNlerp() [3/4]

static Vector3d pluginbase.Helpers.Computative.VExt.SmartNlerp	(	Vector3d	a,
		Vector3d	b,
		double	blend,
		Vector3d	defaultRotateVec
	)

static

Smart nlerp that lerps a vector around a rotation vector

Returns: The nlerp.

Parameters

a	The alpha component.
b	The blue component.
blend	Blend.
defaultRotateVec	Default rotate vec.

         {
             if (Vector3d.Dot(a,b) < -0.999)
             {
                 a += defaultRotateVec * 0.001;
             }
             Vector3d blended = a * (1.0 - blend) + b * blend;
             if (blended == Vector3d.Zero)
                 return Vector3d.Zero;
             return Vector3d.Normalize(blended);
         }

◆ SmartNlerp() [4/4]

static Vector3d pluginbase.Helpers.Computative.VExt.SmartNlerp	(	Vector3d	a,
		Vector3d	b,
		double	blend
	)

static

NLerp that intelligently rotates one vector to another

Returns: The nlerp.

Parameters

a	The alpha component.
b	The blue component.
blend	Blend.

         {
             return SmartNlerp(a, b, blend, Vector3d.UnitX);
         }

◆ SwapXY()

static Vector3 pluginbase.Helpers.Computative.VExt.SwapXY ( this Vector3 v )

static

Swap X and Y components of a vector

Returns: The X.

Parameters

v V.

         {
             return new Vector3(v.X, v.Z, v.Y);
         }

◆ Wrap()

static Vector3 pluginbase.Helpers.Computative.VExt.Wrap ( Vector3 val )

static

Wrap each component of the vector between 0-1

Returns: The wrap.

Parameters

val Value.

         {
             return new Vector3(
                 MExt.WrapUnit(val.X),
                 MExt.WrapUnit(val.Y),
                 MExt.WrapUnit(val.Z)
             );
         }

The documentation for this class was generated from the following file:

pluginbase/Helpers/Computative/VectorExtensions.cs

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ Abs()

◆ ComponentDistance()

◆ InSquareDistance() [1/3]

◆ InSquareDistance() [2/3]

◆ InSquareDistance() [3/3]

◆ InverseAbs()

◆ MatrixFromComponents()

◆ Nlerp() [1/2]

◆ Nlerp() [2/2]

◆ PointToLineDistance()

◆ Project() [1/2]

◆ Project() [2/2]

◆ Rotate()

◆ RotationMatrix()

◆ RotationVector()

◆ RotationZ() [1/4]

◆ RotationZ() [2/4]

◆ RotationZ() [3/4]

◆ RotationZ() [4/4]

◆ Slerp() [1/2]

◆ Slerp() [2/2]

◆ SmartNlerp() [1/4]

◆ SmartNlerp() [2/4]

◆ SmartNlerp() [3/4]

◆ SmartNlerp() [4/4]

◆ SwapXY()

◆ Wrap()