SystemEx.Numeric.Vec3f Struct Reference

Inheritance diagram for SystemEx.Numeric.Vec3f:

Collaboration diagram for SystemEx.Numeric.Vec3f:

Public Member Functions
	Vec3f ()
	Initializes a zero vector (0,0).
	Vec3f (float _x, float _y, float _z)
	Initializes a vector with explicit X and Y values.
	Vec3f (float _f)
	Initializes both components with the same value.
	Vec3f (Vec3f vec)
	Copy constructor.
	Vec3f (float[] lpvec)
	Initializes the vector from a float array.
float	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 (Vec3f a)
	Compares two vectors lexicographically.
bool	Equals (Vec3f other)
	Determines whether this instance is equal to another Half16 value, using the same semantics as the operator ==(Vec3f,Vec3f).
override bool	Equals (object? obj)
	Determines whether this instance is equal to another object.
int IComparable< Vec3f >.	CompareTo (Vec3f 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 float	Lenght (Vec3f v)
	Computes the squared length of the vector.
static float	LenghtSqrt (Vec3f v)
	Computes the Euclidean length of the vector.
static float	Dot (Vec3f v1, Vec3f v2)
	Computes the dot product of two vectors.
static float	Angle (Vec3f v1, Vec3f v2)
	Computes the angle between two vectors.
static Vec3f	InterpolateCoords (Vec3f v1, Vec3f v2, float p)
	Linearly interpolates between two vectors.
static Vec3f	InterpolateNormal (Vec3f v1, Vec3f v2, float p)
	Interpolates and normalizes the result.
static bool	NearEqual (Vec3f v1, Vec3f v2, float epsilon)
	Checks whether two vectors are approximately equal.
static Vec3f	Normalize (Vec3f v, bool ex=false)
	Normalizes the vector.
static Vec3f	operator+ (Vec3f a, Vec3f b)
	Adds two vectors component‑wise.
static Vec3f	operator- (Vec3f a, Vec3f b)
	Subtracts two vectors component‑wise.
static Vec3f	operator/ (Vec3f a, Vec3f b)
	Divides two vectors component‑wise.
static Vec3f	operator* (Vec3f a, Vec3f b)
	Multiplies two vectors component‑wise.
static Vec3f	operator+ (Vec3f a, float b)
	Adds a scalar to both components of the vector.
static Vec3f	operator- (Vec3f a, float b)
	Subtracts a scalar from both components of the vector.
static Vec3f	operator/ (Vec3f a, float b)
	Divides both components of the vector by a scalar.
static Vec3f	operator* (Vec3f a, float b)
static Vec3f	operator- (float a, Vec3f b)
	Subtracts each component of the vector from a scalar.
static Vec3f	operator/ (float a, Vec3f b)
static Vec3f	operator* (float a, Vec3f b)
	Multiplies a scalar with each component of the vector.
static Vec3f	operator+ (float a, Vec3f b)
	Adds a scalar to each component of the vector.
static bool	operator== (Vec3f a, Vec3f b)
	Determines whether two vectors are equal component‑wise.
static bool	operator!= (Vec3f a, Vec3f b)
	Determines whether two vectors differ in any component.
static bool	operator<= (Vec3f a, Vec3f b)
	Determines whether all components of a are less than or equal to those of b .
static bool	operator>= (Vec3f a, Vec3f b)
	Determines whether all components of a are greater than or equal to those of b .
static bool	operator< (Vec3f a, Vec3f b)
	Determines whether all components of a are strictly less than those of b .
static bool	operator> (Vec3f a, Vec3f b)
	Determines whether all components of a are strictly greater than those of b .
static bool	operator== (float a, Vec3f b)
	Determines whether a scalar equals both components of the vector.
static bool	operator!= (float a, Vec3f b)
	Determines whether a scalar differs from any component of the vector.
static bool	operator<= (float a, Vec3f b)
	Determines whether a scalar is less than or equal to both vector components.
static bool	operator>= (float a, Vec3f b)
	Determines whether a scalar is greater than or equal to both vector components.
static bool	operator< (float a, Vec3f b)
	Determines whether a scalar is strictly less than both vector components.
static bool	operator> (float a, Vec3f b)
	Determines whether a scalar is strictly greater than both vector components.
static bool	operator== (Vec3f a, float b)
	Determines whether both vector components equal the scalar.
static bool	operator!= (Vec3f a, float b)
	Determines whether any vector component differs from the scalar.
static bool	operator<= (Vec3f a, float b)
	Determines whether both vector components are less than or equal to the scalar.
static bool	operator>= (Vec3f a, float b)
	Determines whether both vector components are greater than or equal to the scalar.
static bool	operator< (Vec3f a, float b)
	Determines whether both vector components are strictly less than the scalar.
static bool	operator> (Vec3f a, float b)
	Determines whether both vector components are strictly greater than the scalar.

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

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

Constructor & Destructor Documentation

Vec3f() [1/5]

SystemEx.Numeric.Vec3f.Vec3f

(

)

Initializes a zero vector (0,0).

                        {
            m_x = m_y = m_z = 0.0f;
        }

Here is the caller graph for this function:

Vec3f() [2/5]

SystemEx.Numeric.Vec3f.Vec3f	(	float	_x,
		float	_y,
		float	_z )

Initializes a vector with explicit X and Y values.

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

Vec3f() [3/5]

SystemEx.Numeric.Vec3f.Vec3f

(

float

_f

)

Initializes both components with the same value.

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

Vec3f() [4/5]

SystemEx.Numeric.Vec3f.Vec3f

(

Vec3f

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:

Vec3f() [5/5]

SystemEx.Numeric.Vec3f.Vec3f

(

float[]

lpvec

)

Initializes the vector from a float array.

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

Member Function Documentation

Angle()

float SystemEx.Numeric.Vec3f.Angle ( Vec3f v1, Vec3f v2 )

static

Computes the angle between two vectors.

                                                         {
            return System.MathF.Acos(v1.m_x * v2.m_x + v1.m_y * v2.m_y + v1.m_z * v2.m_z) /
                   System.MathF.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.Vec3f.CompareTo

(

object?

obj

)

Compares this vector to another object.

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

Here is the call graph for this function:

Here is the caller graph for this function:

CompareTo() [2/3]

CompareResult SystemEx.Numeric.Vec3f.CompareTo

(

Vec3f

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< Vec3f >. SystemEx.Numeric.Vec3f.CompareTo

(

Vec3f

other

)

                                                         {
            return (int)CompareTo(other);
        }

Dot()

float SystemEx.Numeric.Vec3f.Dot ( Vec3f v1, Vec3f 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.Vec3f.Equals

(

object?

obj

)

Determines whether this instance is equal to another object.

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

Parameters

obj	The object to compare with.

Returns

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

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

Here is the call graph for this function:

Equals() [2/2]

bool SystemEx.Numeric.Vec3f.Equals

(

Vec3f

other

)

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

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()

float SystemEx.Numeric.Vec3f.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.Vec3f.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()

Vec3f SystemEx.Numeric.Vec3f.InterpolateCoords ( Vec3f v1, Vec3f v2, float p )

static

Linearly interpolates between two vectors.

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

Here is the call graph for this function:

InterpolateNormal()

Vec3f SystemEx.Numeric.Vec3f.InterpolateNormal ( Vec3f v1, Vec3f v2, float p )

static

Interpolates and normalizes the result.

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

Here is the call graph for this function:

Lenght()

float SystemEx.Numeric.Vec3f.Lenght ( Vec3f 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()

float SystemEx.Numeric.Vec3f.LenghtSqrt ( Vec3f v )

static

Computes the Euclidean length of the vector.

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

Here is the call graph for this function:

Here is the caller graph for this function:

NearEqual()

bool SystemEx.Numeric.Vec3f.NearEqual ( Vec3f v1, Vec3f v2, float epsilon )

static

Checks whether two vectors are approximately equal.

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

Here is the call graph for this function:

Normalize()

Vec3f SystemEx.Numeric.Vec3f.Normalize ( Vec3f 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.Vec3f.operator!= ( float a, Vec3f 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.Vec3f.operator!= ( Vec3f a, float 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.Vec3f.operator!= ( Vec3f a, Vec3f 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]

Vec3f SystemEx.Numeric.Vec3f.operator* ( float a, Vec3f b )

static

Multiplies a scalar with each component of the vector.

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

Here is the call graph for this function:

operator*() [2/3]

Vec3f SystemEx.Numeric.Vec3f.operator* ( Vec3f a, float b )

static

Multiplies both components of the vector by a scalar.

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

Here is the call graph for this function:

operator*() [3/3]

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

static

Multiplies two vectors component‑wise.

                                                            {
            return new Vec3f(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]

Vec3f SystemEx.Numeric.Vec3f.operator+ ( float a, Vec3f b )

static

Adds a scalar to each component of the vector.

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

Here is the call graph for this function:

operator+() [2/3]

Vec3f SystemEx.Numeric.Vec3f.operator+ ( Vec3f a, float b )

static

Adds a scalar to both components of the vector.

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

Here is the call graph for this function:

operator+() [3/3]

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

static

Adds two vectors component‑wise.

                                                            {
            return new Vec3f(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]

Vec3f SystemEx.Numeric.Vec3f.operator- ( float a, Vec3f b )

static

Subtracts each component of the vector from a scalar.

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

Here is the call graph for this function:

operator-() [2/3]

Vec3f SystemEx.Numeric.Vec3f.operator- ( Vec3f a, float b )

static

Subtracts a scalar from both components of the vector.

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

Here is the call graph for this function:

operator-() [3/3]

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

static

Subtracts two vectors component‑wise.

                                                            {
            return new Vec3f(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]

Vec3f SystemEx.Numeric.Vec3f.operator/ ( float a, Vec3f b )

static

Divides a scalar by each component of the vector.

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

Here is the call graph for this function:

operator/() [2/3]

Vec3f SystemEx.Numeric.Vec3f.operator/ ( Vec3f a, float b )

static

Divides both components of the vector by a scalar.

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

Here is the call graph for this function:

operator/() [3/3]

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

static

Divides two vectors component‑wise.

                                                            {
            return new Vec3f(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.Vec3f.operator< ( float a, Vec3f 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.Vec3f.operator< ( Vec3f a, float 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.Vec3f.operator< ( Vec3f a, Vec3f 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.Vec3f.operator<= ( float a, Vec3f 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.Vec3f.operator<= ( Vec3f a, float 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.Vec3f.operator<= ( Vec3f a, Vec3f 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.Vec3f.operator== ( float a, Vec3f 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.Vec3f.operator== ( Vec3f a, float 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.Vec3f.operator== ( Vec3f a, Vec3f 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.Vec3f.operator> ( float a, Vec3f 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.Vec3f.operator> ( Vec3f a, float 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.Vec3f.operator> ( Vec3f a, Vec3f 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.Vec3f.operator>= ( float a, Vec3f 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.Vec3f.operator>= ( Vec3f a, float 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.Vec3f.operator>= ( Vec3f a, Vec3f 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.Vec3f.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(float) * Count);
 
            for ( byte i = 0 ; i < Count ; i++ )
                m.WriteRange((ulong)(sizeof(float) * 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 Vec3f SystemEx.Numeric.Vec3f.Max = new Vec3f(float.MaxValue, float.MaxValue, float.MaxValue)

static

Represents Vector(MAX,MAX,MAX).

Min

readonly Vec3f SystemEx.Numeric.Vec3f.Min = new Vec3f(float.MinValue, float.MinValue, float.MinValue)

static

Represents Vector(MIN,MIN,MIN).

NegativeOne

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

static

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

One

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

static

Represents Vector(1,1,1).

Zero

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

static

Represents Vector(0,0,0).

Property Documentation

Count

int SystemEx.Numeric.Vec3f.Count

get

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

X

float SystemEx.Numeric.Vec3f.X

getset

Gets or sets the X component.

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

Y

float SystemEx.Numeric.Vec3f.Y

getset

Gets or sets the Y component.

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

Z

float SystemEx.Numeric.Vec3f.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:

• vec3f.cs