SystemEx.Numeric.Vec3i Struct Reference

Inheritance diagram for SystemEx.Numeric.Vec3i:

Collaboration diagram for SystemEx.Numeric.Vec3i:

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

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

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

Constructor & Destructor Documentation

Vec3i() [1/5]

SystemEx.Numeric.Vec3i.Vec3i

(

)

Initializes a zero vector (0,0).

                        {
            m_x = m_y = m_z = 0;
        }

Here is the caller graph for this function:

Vec3i() [2/5]

SystemEx.Numeric.Vec3i.Vec3i	(	int	_x,
		int	_y,
		int	_z )

Initializes a vector with explicit X and Y values.

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

Vec3i() [3/5]

SystemEx.Numeric.Vec3i.Vec3i

(

int

_f

)

Initializes both components with the same value.

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

Vec3i() [4/5]

SystemEx.Numeric.Vec3i.Vec3i

(

Vec3i

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:

Vec3i() [5/5]

SystemEx.Numeric.Vec3i.Vec3i

(

int[]

lpvec

)

Initializes the vector from a int array.

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

Member Function Documentation

Angle()

int SystemEx.Numeric.Vec3i.Angle ( Vec3i v1, Vec3i v2 )

static

Computes the angle between two vectors.

                                                       {
            var _i =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));
 
            return (int)_i;
        }

Here is the call graph for this function:

CompareTo() [1/3]

int SystemEx.Numeric.Vec3i.CompareTo

(

object?

obj

)

Compares this vector to another object.

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

Here is the call graph for this function:

Here is the caller graph for this function:

CompareTo() [2/3]

CompareResult SystemEx.Numeric.Vec3i.CompareTo

(

Vec3i

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

(

Vec3i

other

)

                                                         {
            return (int)CompareTo(other);
        }

Dot()

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

(

object?

obj

)

Determines whether this instance is equal to another object.

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

Parameters

obj	The object to compare with.

Returns

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

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

Here is the call graph for this function:

Equals() [2/2]

bool SystemEx.Numeric.Vec3i.Equals

(

Vec3i

other

)

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

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

int SystemEx.Numeric.Vec3i.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.Vec3i.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()

Vec3i SystemEx.Numeric.Vec3i.InterpolateCoords ( Vec3i v1, Vec3i v2, int p )

static

Linearly interpolates between two vectors.

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

Here is the call graph for this function:

InterpolateNormal()

Vec3i SystemEx.Numeric.Vec3i.InterpolateNormal ( Vec3i v1, Vec3i v2, int p )

static

Interpolates and normalizes the result.

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

Here is the call graph for this function:

Lenght()

int SystemEx.Numeric.Vec3i.Lenght ( Vec3i 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()

int SystemEx.Numeric.Vec3i.LenghtSqrt ( Vec3i v )

static

Computes the Euclidean length of the vector.

=> (int)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.Vec3i.NearEqual ( Vec3i v1, Vec3i v2, int 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()

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

static

Normalizes the integer vector by dividing each component by its length. Integer normalization is discrete and does not apply floating‑point stability offsets.

                                                                 {
            var f = v / LenghtSqrt(v);
            return f;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

operator!=() [1/3]

bool SystemEx.Numeric.Vec3i.operator!= ( int a, Vec3i 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.Vec3i.operator!= ( Vec3i a, int 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.Vec3i.operator!= ( Vec3i a, Vec3i 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]

Vec3i SystemEx.Numeric.Vec3i.operator* ( int a, Vec3i b )

static

Multiplies a scalar with each component of the vector.

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

Here is the call graph for this function:

operator*() [2/3]

Vec3i SystemEx.Numeric.Vec3i.operator* ( Vec3i a, int b )

static

Multiplies both components of the vector by a scalar.

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

Here is the call graph for this function:

operator*() [3/3]

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

static

Multiplies two vectors component‑wise.

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

Vec3i SystemEx.Numeric.Vec3i.operator+ ( int a, Vec3i b )

static

Adds a scalar to each component of the vector.

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

Here is the call graph for this function:

operator+() [2/3]

Vec3i SystemEx.Numeric.Vec3i.operator+ ( Vec3i a, int b )

static

Adds a scalar to both components of the vector.

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

Here is the call graph for this function:

operator+() [3/3]

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

static

Adds two vectors component‑wise.

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

Vec3i SystemEx.Numeric.Vec3i.operator- ( int a, Vec3i b )

static

Subtracts each component of the vector from a scalar.

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

Here is the call graph for this function:

operator-() [2/3]

Vec3i SystemEx.Numeric.Vec3i.operator- ( Vec3i a, int b )

static

Subtracts a scalar from both components of the vector.

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

Here is the call graph for this function:

operator-() [3/3]

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

static

Subtracts two vectors component‑wise.

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

Vec3i SystemEx.Numeric.Vec3i.operator/ ( int a, Vec3i b )

static

Divides a scalar by each component of the vector.

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

Here is the call graph for this function:

operator/() [2/3]

Vec3i SystemEx.Numeric.Vec3i.operator/ ( Vec3i a, int b )

static

Divides both components of the vector by a scalar.

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

Here is the call graph for this function:

operator/() [3/3]

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

static

Divides two vectors component‑wise.

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

static

Represents Vector(MAX,MAX,MAX).

Min

readonly Vec3i SystemEx.Numeric.Vec3i.Min = new Vec3i(int.MinValue, int.MinValue, int.MinValue)

static

Represents Vector(MIN,MIN,MIN).

NegativeOne

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

static

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

One

readonly Vec3i SystemEx.Numeric.Vec3i.One = new Vec3i(1, 1, 1)

static

Represents Vector(1,1,1).

Zero

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

static

Represents Vector(0,0,0).

Property Documentation

Count

int SystemEx.Numeric.Vec3i.Count

get

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

X

int SystemEx.Numeric.Vec3i.X

getset

Gets or sets the X component.

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

Y

int SystemEx.Numeric.Vec3i.Y

getset

Gets or sets the Y component.

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

Z

int SystemEx.Numeric.Vec3i.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:

• Vec3i.cs