SystemEx.Numeric.Vec3d Struct Reference

Inheritance diagram for SystemEx.Numeric.Vec3d:

Collaboration diagram for SystemEx.Numeric.Vec3d:

Public Member Functions
	Vec3d ()
	Initializes a zero vector (0,0).
	Vec3d (double _x, double _y, double _z)
	Initializes a vector with explicit X and Y values.
	Vec3d (double _f)
	Initializes both components with the same value.
	Vec3d (Vec3d vec)
	Copy constructor.
	Vec3d (double[] lpvec)
	Initializes the vector from a double array.
double	Get (int index)
	Gets a component by index (0 = X, 1 = Y).
override int	GetHashCode ()
	Computes a hash code for this vector.
int	CompareTo (object? obj)
	Compares this vector to another object.
CompareResult	CompareTo (Vec3d a)
	Compares two vectors lexicographically.
bool	Equals (Vec3d other)
	Determines whether this instance is equal to another Half16 value, using the same semantics as the operator ==(Vec3d,Vec3d).
override bool	Equals (object? obj)
	Determines whether this instance is equal to another object.
int IComparable< Vec3d >.	CompareTo (Vec3d other)
FixedVector< byte >	ToBytes ()
	Converts the vector into a deterministic byte sequence.
Public Member Functions inherited from SystemEx.IComparableEx< T >
CompareResult	CompareTo (T a)
	Compares this instance with the specified value and returns a CompareResult describing the relationship between them.

Static Public Member Functions
static double	Lenght (Vec3d v)
	Computes the squared length of the vector.
static double	LenghtSqrt (Vec3d v)
	Computes the Euclidean length of the vector.
static double	Dot (Vec3d v1, Vec3d v2)
	Computes the dot product of two vectors.
static double	Angle (Vec3d v1, Vec3d v2)
	Computes the angle between two vectors.
static Vec3d	InterpolateCoords (Vec3d v1, Vec3d v2, double p)
	Linearly interpolates between two vectors.
static Vec3d	InterpolateNormal (Vec3d v1, Vec3d v2, double p)
	Interpolates and normalizes the result.
static bool	NearEqual (Vec3d v1, Vec3d v2, double epsilon)
	Checks whether two vectors are approximately equal.
static Vec3d	Normalize (Vec3d v, bool ex=false)
	Normalizes the vector.
static Vec3d	operator+ (Vec3d a, Vec3d b)
	Adds two vectors component‑wise.
static Vec3d	operator- (Vec3d a, Vec3d b)
	Subtracts two vectors component‑wise.
static Vec3d	operator/ (Vec3d a, Vec3d b)
	Divides two vectors component‑wise.
static Vec3d	operator* (Vec3d a, Vec3d b)
	Multiplies two vectors component‑wise.
static Vec3d	operator+ (Vec3d a, double b)
	Adds a scalar to both components of the vector.
static Vec3d	operator- (Vec3d a, double b)
	Subtracts a scalar from both components of the vector.
static Vec3d	operator/ (Vec3d a, double b)
	Divides both components of the vector by a scalar.
static Vec3d	operator* (Vec3d a, double b)
static Vec3d	operator- (double a, Vec3d b)
	Subtracts each component of the vector from a scalar.
static Vec3d	operator/ (double a, Vec3d b)
static Vec3d	operator* (double a, Vec3d b)
	Multiplies a scalar with each component of the vector.
static Vec3d	operator+ (double a, Vec3d b)
	Adds a scalar to each component of the vector.
static bool	operator== (Vec3d a, Vec3d b)
	Determines whether two vectors are equal component‑wise.
static bool	operator!= (Vec3d a, Vec3d b)
	Determines whether two vectors differ in any component.
static bool	operator<= (Vec3d a, Vec3d b)
	Determines whether all components of a are less than or equal to those of b .
static bool	operator>= (Vec3d a, Vec3d b)
	Determines whether all components of a are greater than or equal to those of b .
static bool	operator< (Vec3d a, Vec3d b)
	Determines whether all components of a are strictly less than those of b .
static bool	operator> (Vec3d a, Vec3d b)
	Determines whether all components of a are strictly greater than those of b .
static bool	operator== (double a, Vec3d b)
	Determines whether a scalar equals both components of the vector.
static bool	operator!= (double a, Vec3d b)
	Determines whether a scalar differs from any component of the vector.
static bool	operator<= (double a, Vec3d b)
	Determines whether a scalar is less than or equal to both vector components.
static bool	operator>= (double a, Vec3d b)
	Determines whether a scalar is greater than or equal to both vector components.
static bool	operator< (double a, Vec3d b)
	Determines whether a scalar is strictly less than both vector components.
static bool	operator> (double a, Vec3d b)
	Determines whether a scalar is strictly greater than both vector components.
static bool	operator== (Vec3d a, double b)
	Determines whether both vector components equal the scalar.
static bool	operator!= (Vec3d a, double b)
	Determines whether any vector component differs from the scalar.
static bool	operator<= (Vec3d a, double b)
	Determines whether both vector components are less than or equal to the scalar.
static bool	operator>= (Vec3d a, double b)
	Determines whether both vector components are greater than or equal to the scalar.
static bool	operator< (Vec3d a, double b)
	Determines whether both vector components are strictly less than the scalar.
static bool	operator> (Vec3d a, double b)
	Determines whether both vector components are strictly greater than the scalar.

Static Public Attributes
static readonly Vec3d	Zero = new Vec3d(0,0,0)
	Represents Vector(0,0,0).
static readonly Vec3d	One = new Vec3d(1f, 1f, 1f)
	Represents Vector(1,1,1).
static readonly Vec3d	NegativeOne = new Vec3d(-1f, -1f, -1f)
	Represents Vector(-1,-1,-1).
static readonly Vec3d	Min = new Vec3d(double.MinValue, double.MinValue, double.MinValue)
	Represents Vector(MIN,MIN,MIN).
static readonly Vec3d	Max = new Vec3d(double.MaxValue, double.MaxValue, double.MaxValue)
	Represents Vector(MAX,MAX,MAX).

Properties
int	Count [get]
	Gets the number of components in this vector (always 3).
double	X [get, set]
	Gets or sets the X component.
double	Y [get, set]
	Gets or sets the Y component.
double	Z [get, set]
	Gets or sets the Z component.

Constructor & Destructor Documentation

Vec3d() [1/5]

SystemEx.Numeric.Vec3d.Vec3d

(

)

Initializes a zero vector (0,0).

                        {
            m_x = m_y = m_z = 0.0f;
        }

Here is the caller graph for this function:

Vec3d() [2/5]

SystemEx.Numeric.Vec3d.Vec3d	(	double	_x,
		double	_y,
		double	_z )

Initializes a vector with explicit X and Y values.

                                                         {
            m_x = _x;
            m_y = _y;
            m_z = _z;
        }

Vec3d() [3/5]

SystemEx.Numeric.Vec3d.Vec3d

(

double

_f

)

Initializes both components with the same value.

                                   {
            m_x = _f;
            m_y = _f;
            m_z = _f;
        }

Vec3d() [4/5]

SystemEx.Numeric.Vec3d.Vec3d

(

Vec3d

vec

)

Copy constructor.

                                   {
            m_x = vec.m_x;
            m_y = vec.m_y;
            m_z = vec.m_z;
        }

Here is the call graph for this function:

Vec3d() [5/5]

SystemEx.Numeric.Vec3d.Vec3d

(

double[]

lpvec

)

Initializes the vector from a double array.

                                        {
            m_x = lpvec[0];
            m_y = lpvec[1];
            m_z = lpvec[2];
        }

Member Function Documentation

Angle()

double SystemEx.Numeric.Vec3d.Angle ( Vec3d v1, Vec3d v2 )

static

Computes the angle between two vectors.

                                                          {
            return System.Math.Acos(v1.m_x * v2.m_x + v1.m_y * v2.m_y + v1.m_z * v2.m_z) /
                   System.Math.Sqrt((v1.m_x * v1.m_x + v1.m_y * v1.m_y + v1.m_z * v1.m_z) *
                              (v2.m_x * v2.m_x + v2.m_y * v2.m_y + v2.m_z * v2.m_z));
        }

Here is the call graph for this function:

CompareTo() [1/3]

int SystemEx.Numeric.Vec3d.CompareTo

(

object?

obj

)

Compares this vector to another object.

                                             {
            if ( (obj is Vec3d) ) {
                return (int)CompareTo((Vec3d)(obj));
            }
            throw new ArgumentException("Object is not a Vec3d object");
        }

Here is the call graph for this function:

Here is the caller graph for this function:

CompareTo() [2/3]

CompareResult SystemEx.Numeric.Vec3d.CompareTo

(

Vec3d

a

)

Compares two vectors lexicographically.

                                                   {
            CompareResult _ret = CompareResult.Equal;
 
            if ( this < a ) _ret = CompareResult.AIsSmallerB;
            else if ( this > a ) _ret = CompareResult.AIsLargerB;
 
 
            return _ret;
        }

Here is the call graph for this function:

CompareTo() [3/3]

int IComparable< Vec3d >. SystemEx.Numeric.Vec3d.CompareTo

(

Vec3d

other

)

                                                         {
            return (int)CompareTo(other);
        }

Dot()

double SystemEx.Numeric.Vec3d.Dot ( Vec3d v1, Vec3d v2 )

static

Computes the dot product of two vectors.

                                                        {
            return (v1.m_x * v2.m_x + v1.m_y * v2.m_y + v1.m_z * v2.m_z);
        }

Here is the call graph for this function:

Equals() [1/2]

override bool SystemEx.Numeric.Vec3d.Equals

(

object?

obj

)

Determines whether this instance is equal to another object.

The object is considered equal if it is a Vec3d and compares equal using Equals(Vec3d).

Parameters

obj	The object to compare with.

Returns

true if obj is a Vec3d and equal to this instance; otherwise false.

                                                    {
            if ( obj == null ) return false;
            return (obj is Vec3d) && Equals((Vec3d)obj);
        }

Here is the call graph for this function:

Equals() [2/2]

bool SystemEx.Numeric.Vec3d.Equals

(

Vec3d

other

)

Determines whether this instance is equal to another Half16 value, using the same semantics as the operator ==(Vec3d,Vec3d).

Parameters

other

The value to compare with.

Returns

true if the values are equal; otherwise false.

                                           {
            return this.X == other.X && this.Y == other.Y && this.Z == other.Z;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

Get()

double SystemEx.Numeric.Vec3d.Get

(

int

index

)

Gets a component by index (0 = X, 1 = Y).

                                        {
            return index switch
            {
                0 => m_x,
                1 => m_y,
                2 => m_z,
                _ => throw new ArgumentOutOfRangeException(nameof(index))
            };
        }

Here is the caller graph for this function:

GetHashCode()

override int SystemEx.Numeric.Vec3d.GetHashCode

(

)

Computes a hash code for this vector.

The primary hash is generated using HashFactory and the HashAlgorithmAttribute applied to this struct.
If hashing fails (rare), a fallback XOR‑based hash is used.

                                           {
            var x =  HashFactory.Hash32(this, 674545);
            if ( x.Value != 0 ) return (int)x.Value;
 
            return m_x.GetHashCode() ^ m_y.GetHashCode() ^ m_z.GetHashCode();
 
        }

InterpolateCoords()

Vec3d SystemEx.Numeric.Vec3d.InterpolateCoords ( Vec3d v1, Vec3d v2, double p )

static

Linearly interpolates between two vectors.

                                                                               {
            return v1 + p * (v2 - v1);
        }

Here is the call graph for this function:

InterpolateNormal()

Vec3d SystemEx.Numeric.Vec3d.InterpolateNormal ( Vec3d v1, Vec3d v2, double p )

static

Interpolates and normalizes the result.

                                                                               {
            return Normalize(v1 + p * (v2 - v1));
        }

Here is the call graph for this function:

Lenght()

double SystemEx.Numeric.Vec3d.Lenght ( Vec3d v )

static

Computes the squared length of the vector.

=> (v.m_x * v.m_x + v.m_y * v.m_y + v.m_z * v.m_z);

Here is the call graph for this function:

Here is the caller graph for this function:

LenghtSqrt()

double SystemEx.Numeric.Vec3d.LenghtSqrt ( Vec3d v )

static

Computes the Euclidean length of the vector.

=> System.Math.Sqrt(Lenght(v));

Here is the call graph for this function:

Here is the caller graph for this function:

NearEqual()

bool SystemEx.Numeric.Vec3d.NearEqual ( Vec3d v1, Vec3d v2, double epsilon )

static

Checks whether two vectors are approximately equal.

                                                                            {
            return (System.Math.Abs(v1.m_x - v2.m_x) <= epsilon) &&
                   (System.Math.Abs(v1.m_y - v2.m_y) <= epsilon) &&
                   (System.Math.Abs(v1.m_z - v2.m_z) <= epsilon);
        }

Here is the call graph for this function:

Normalize()

Vec3d SystemEx.Numeric.Vec3d.Normalize ( Vec3d v, bool ex = false )

static

Normalizes the vector.

                                                                 {
            var f = v / LenghtSqrt(v);
            return ex ? (f + 0.0001f) : f;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

operator!=() [1/3]

bool SystemEx.Numeric.Vec3d.operator!= ( double a, Vec3d b )

static

Determines whether a scalar differs from any component of the vector.

                                                           {
            return a != b.m_x && a != b.m_y && a != b.m_z;
        }

Here is the call graph for this function:

operator!=() [2/3]

bool SystemEx.Numeric.Vec3d.operator!= ( Vec3d a, double b )

static

Determines whether any vector component differs from the scalar.

                                                           {
            return a.m_x != b && a.m_y != b && a.m_z != b;
        }

Here is the call graph for this function:

operator!=() [3/3]

bool SystemEx.Numeric.Vec3d.operator!= ( Vec3d a, Vec3d b )

static

Determines whether two vectors differ in any component.

                                                          {
            return a.m_x != b.m_x && a.m_y != b.m_y && a.m_z != b.m_z;
        }

Here is the call graph for this function:

operator*() [1/3]

Vec3d SystemEx.Numeric.Vec3d.operator* ( double a, Vec3d b )

static

Multiplies a scalar with each component of the vector.

                                                             {
            return new Vec3d(a * b.m_x, a * b.m_y, a * b.m_z);
        }

Here is the call graph for this function:

operator*() [2/3]

Vec3d SystemEx.Numeric.Vec3d.operator* ( Vec3d a, double b )

static

Multiplies both components of the vector by a scalar.

                                                             {
            return new Vec3d(a.m_x * b, a.m_y * b, a.m_z * b);
        }

Here is the call graph for this function:

operator*() [3/3]

Vec3d SystemEx.Numeric.Vec3d.operator* ( Vec3d a, Vec3d b )

static

Multiplies two vectors component‑wise.

                                                            {
            return new Vec3d(a.m_x * b.m_x, a.m_y * b.m_y, a.m_z * b.m_z);
        }

Here is the call graph for this function:

operator+() [1/3]

Vec3d SystemEx.Numeric.Vec3d.operator+ ( double a, Vec3d b )

static

Adds a scalar to each component of the vector.

                                                             {
            return new Vec3d(a + b.m_x, a + b.m_y, a + b.m_z);
        }

Here is the call graph for this function:

operator+() [2/3]

Vec3d SystemEx.Numeric.Vec3d.operator+ ( Vec3d a, double b )

static

Adds a scalar to both components of the vector.

                                                             {
            return new Vec3d(a.m_x + b, a.m_y + b, a.m_z + b);
        }

Here is the call graph for this function:

operator+() [3/3]

Vec3d SystemEx.Numeric.Vec3d.operator+ ( Vec3d a, Vec3d b )

static

Adds two vectors component‑wise.

                                                            {
            return new Vec3d(a.m_x + b.m_x, a.m_y + b.m_y, a.m_z + b.m_z);
        }

Here is the call graph for this function:

operator-() [1/3]

Vec3d SystemEx.Numeric.Vec3d.operator- ( double a, Vec3d b )

static

Subtracts each component of the vector from a scalar.

                                                             {
            return new Vec3d(a - b.m_x, a - b.m_y, a - b.m_z);
        }

Here is the call graph for this function:

operator-() [2/3]

Vec3d SystemEx.Numeric.Vec3d.operator- ( Vec3d a, double b )

static

Subtracts a scalar from both components of the vector.

                                                             {
            return new Vec3d(a.m_x - b, a.m_y - b, a.m_z - b);
        }

Here is the call graph for this function:

operator-() [3/3]

Vec3d SystemEx.Numeric.Vec3d.operator- ( Vec3d a, Vec3d b )

static

Subtracts two vectors component‑wise.

                                                            {
            return new Vec3d(a.m_x - b.m_x, a.m_y - b.m_y, a.m_z - b.m_z);
        }

Here is the call graph for this function:

operator/() [1/3]

Vec3d SystemEx.Numeric.Vec3d.operator/ ( double a, Vec3d b )

static

Divides a scalar by each component of the vector.

                                                             {
            return new Vec3d(a / b.m_x, a / b.m_y, a / b.m_z);
        }

Here is the call graph for this function:

operator/() [2/3]

Vec3d SystemEx.Numeric.Vec3d.operator/ ( Vec3d a, double b )

static

Divides both components of the vector by a scalar.

                                                             {
            return new Vec3d(a.m_x / b, a.m_y / b, a.m_z / b);
        }

Here is the call graph for this function:

operator/() [3/3]

Vec3d SystemEx.Numeric.Vec3d.operator/ ( Vec3d a, Vec3d b )

static

Divides two vectors component‑wise.

                                                            {
            return new Vec3d(a.m_x / b.m_x, a.m_y / b.m_y, a.m_z / b.m_z);
        }

Here is the call graph for this function:

operator<() [1/3]

bool SystemEx.Numeric.Vec3d.operator< ( double a, Vec3d b )

static

Determines whether a scalar is strictly less than both vector components.

                                                            {
            return a < b.m_x && a < b.m_y && a < b.m_z;
        }

Here is the call graph for this function:

operator<() [2/3]

bool SystemEx.Numeric.Vec3d.operator< ( Vec3d a, double b )

static

Determines whether both vector components are strictly less than the scalar.

                                                            {
            return a.m_x < b && a.m_y < b && a.m_z < b;
        }

Here is the call graph for this function:

operator<() [3/3]

bool SystemEx.Numeric.Vec3d.operator< ( Vec3d a, Vec3d b )

static

Determines whether all components of a are strictly less than those of b .

                                                           {
            return a.m_x < b.m_x && a.m_y < b.m_y && a.m_z < b.m_z;
        }

Here is the call graph for this function:

operator<=() [1/3]

bool SystemEx.Numeric.Vec3d.operator<= ( double a, Vec3d b )

static

Determines whether a scalar is less than or equal to both vector components.

                                                           {
            return a <= b.m_x && a <= b.m_y && a <= b.m_z;
        }

Here is the call graph for this function:

operator<=() [2/3]

bool SystemEx.Numeric.Vec3d.operator<= ( Vec3d a, double b )

static

Determines whether both vector components are less than or equal to the scalar.

                                                           {
            return a.m_x <= b && a.m_y <= b && a.m_z <= b;
        }

Here is the call graph for this function:

operator<=() [3/3]

bool SystemEx.Numeric.Vec3d.operator<= ( Vec3d a, Vec3d b )

static

Determines whether all components of a are less than or equal to those of b .

                                                          {
            return a.m_x <= b.m_x && a.m_y <= b.m_y && a.m_z <= b.m_z;
        }

Here is the call graph for this function:

operator==() [1/3]

bool SystemEx.Numeric.Vec3d.operator== ( double a, Vec3d b )

static

Determines whether a scalar equals both components of the vector.

                                                           {
            return a == b.m_x && a == b.m_y && a == b.m_z;
        }

Here is the call graph for this function:

operator==() [2/3]

bool SystemEx.Numeric.Vec3d.operator== ( Vec3d a, double b )

static

Determines whether both vector components equal the scalar.

                                                           {
            return a.m_x == b && a.m_y == b && a.m_z == b;
        }

Here is the call graph for this function:

operator==() [3/3]

bool SystemEx.Numeric.Vec3d.operator== ( Vec3d a, Vec3d b )

static

Determines whether two vectors are equal component‑wise.

                                                          {
            return a.m_x == b.m_x && a.m_y == b.m_y && a.m_z == b.m_z;
        }

Here is the call graph for this function:

operator>() [1/3]

bool SystemEx.Numeric.Vec3d.operator> ( double a, Vec3d b )

static

Determines whether a scalar is strictly greater than both vector components.

                                                            {
            return a > b.m_x && a > b.m_y && a > b.m_z;
        }

Here is the call graph for this function:

operator>() [2/3]

bool SystemEx.Numeric.Vec3d.operator> ( Vec3d a, double b )

static

Determines whether both vector components are strictly greater than the scalar.

                                                            {
            return a.m_x > b && a.m_y > b && a.m_z > b;
        }

Here is the call graph for this function:

operator>() [3/3]

bool SystemEx.Numeric.Vec3d.operator> ( Vec3d a, Vec3d b )

static

Determines whether all components of a are strictly greater than those of b .

                                                           {
            return a.m_x > b.m_x && a.m_y > b.m_y && a.m_z > b.m_z;
        }

Here is the call graph for this function:

operator>=() [1/3]

bool SystemEx.Numeric.Vec3d.operator>= ( double a, Vec3d b )

static

Determines whether a scalar is greater than or equal to both vector components.

                                                           {
            return a >= b.m_x && a >= b.m_y && a >= b.m_z;
        }

Here is the call graph for this function:

operator>=() [2/3]

bool SystemEx.Numeric.Vec3d.operator>= ( Vec3d a, double b )

static

Determines whether both vector components are greater than or equal to the scalar.

                                                           {
            return a.m_x >= b && a.m_y >= b && a.m_z >= b;
        }

Here is the call graph for this function:

operator>=() [3/3]

bool SystemEx.Numeric.Vec3d.operator>= ( Vec3d a, Vec3d b )

static

Determines whether all components of a are greater than or equal to those of b .

                                                          {
            return a.m_x >= b.m_x && a.m_y >= b.m_y && a.m_z >= b.m_z;
        }

Here is the call graph for this function:

ToBytes()

FixedVector< byte > SystemEx.Numeric.Vec3d.ToBytes

(

)

Converts the vector into a deterministic byte sequence.

This method is used by HashFactory to compute attribute‑driven hashes. The byte layout is stable and platform‑safe, ensuring consistent hashing across devices and backends.

Implements SystemEx.Hash.IHashable< T >.

                                            {
            Cache m = new Cache(sizeof(double) * Count);
 
            for ( byte i = 0 ; i < Count ; i++ )
                m.WriteRange((ulong)(sizeof(double) * i), Get(i).ToBytes());
 
            return m.ToArrayEx();
        }

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

Max

readonly Vec3d SystemEx.Numeric.Vec3d.Max = new Vec3d(double.MaxValue, double.MaxValue, double.MaxValue)

static

Represents Vector(MAX,MAX,MAX).

Min

readonly Vec3d SystemEx.Numeric.Vec3d.Min = new Vec3d(double.MinValue, double.MinValue, double.MinValue)

static

Represents Vector(MIN,MIN,MIN).

NegativeOne

readonly Vec3d SystemEx.Numeric.Vec3d.NegativeOne = new Vec3d(-1f, -1f, -1f)

static

Represents Vector(-1,-1,-1).

One

readonly Vec3d SystemEx.Numeric.Vec3d.One = new Vec3d(1f, 1f, 1f)

static

Represents Vector(1,1,1).

Zero

readonly Vec3d SystemEx.Numeric.Vec3d.Zero = new Vec3d(0,0,0)

static

Represents Vector(0,0,0).

Property Documentation

Count

int SystemEx.Numeric.Vec3d.Count

get

Gets the number of components in this vector (always 3).

X

double SystemEx.Numeric.Vec3d.X

getset

Gets or sets the X component.

{ get => m_x; set => m_x = value; }

Y

double SystemEx.Numeric.Vec3d.Y

getset

Gets or sets the Y component.

{ get => m_y; set => m_y = value; }

Z

double SystemEx.Numeric.Vec3d.Z

getset

Gets or sets the Z component.

{ get => m_z; set => m_z = value; }

---

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

• Vec3d.cs