Struct Int2

Namespace

Stride.Core.Mathematics

Assembly

Stride.Core.Mathematics.dll

Represents a two dimensional mathematical vector.

[DataContract("Int2")]
[DataStyle(DataStyle.Compact)]
public struct Int2 : IEquatable<Int2>, IFormattable

Implements

IEquatable<Int2>

IFormattable

Constructors

Int2(Vector2)

Initializes a new instance of the Int2 struct.

public Int2(Vector2 value)

Parameters

value Vector2

A vector containing the values with which to initialize the X and Y components.

Int2(int)

Initializes a new instance of the Int2 struct.

public Int2(int value)

Parameters

value int

The value that will be assigned to all components.

Int2(int, int)

Initializes a new instance of the Int2 struct.

public Int2(int x, int y)

Parameters

x int

Initial value for the X component of the vector.

y int

Initial value for the Y component of the vector.

Int2(int[])

Initializes a new instance of the Int2 struct.

public Int2(int[] values)

Parameters

values int[]

The values to assign to the X, Y, and Z components of the vector. This must be an array with three elements.

Exceptions

ArgumentNullException

Thrown when values is null.

ArgumentOutOfRangeException

Thrown when values contains more or less than three elements.

Fields

One

A Int2 with all of its components set to one.

public static readonly Int2 One

Field Value

Int2

SizeInBytes

The size of the Int2 type, in bytes.

public static readonly int SizeInBytes

Field Value

int

UnitX

The X unit Int2 (1, 0, 0).

public static readonly Int2 UnitX

Field Value

Int2

UnitY

The Y unit Int2 (0, 1, 0).

public static readonly Int2 UnitY

Field Value

Int2

X

The X component of the vector.

[DataMember(0)]
public int X

Field Value

int

Y

The Y component of the vector.

[DataMember(1)]
public int Y

Field Value

int

Zero

A Int2 with all of its components set to zero.

public static readonly Int2 Zero

Field Value

Int2

Properties

this[int]

Gets or sets the component at the specified index.

public int this[int index] { get; set; }

Parameters

index int

The index of the component to access. Use 0 for the X component and 1 for the Y component.

Property Value

int

The value of the X or Y component, depending on the index.

Exceptions

ArgumentOutOfRangeException

Thrown when the index is out of the range [0, 1].

Methods

Add(Int2, Int2)

Adds two vectors.

public static Int2 Add(Int2 left, Int2 right)

Parameters

left Int2

The first vector to add.

right Int2

The second vector to add.

Returns

Int2

The sum of the two vectors.

Add(ref Int2, ref Int2, out Int2)

Adds two vectors.

public static void Add(ref Int2 left, ref Int2 right, out Int2 result)

Parameters

left Int2

The first vector to add.

right Int2

The second vector to add.

result Int2

When the method completes, contains the sum of the two vectors.

Clamp(Int2, Int2, Int2)

Restricts a value to be within a specified range.

public static Int2 Clamp(Int2 value, Int2 min, Int2 max)

Parameters

value Int2

The value to clamp.

min Int2

The minimum value.

max Int2

The maximum value.

Returns

Int2

The clamped value.

Clamp(ref Int2, ref Int2, ref Int2, out Int2)

Restricts a value to be within a specified range.

public static void Clamp(ref Int2 value, ref Int2 min, ref Int2 max, out Int2 result)

Parameters

value Int2

The value to clamp.

min Int2

The minimum value.

max Int2

The maximum value.

result Int2

When the method completes, contains the clamped value.

Deconstruct(out int, out int)

Deconstructs the vector's components into named variables.

public void Deconstruct(out int x, out int y)

Parameters

x int

The X component

y int

The Y component

Divide(Int2, int)

Scales a vector by the given value.

public static Int2 Divide(Int2 value, int scale)

Parameters

value Int2

The vector to scale.

scale int

The amount by which to scale the vector.

Returns

Int2

The scaled vector.

Divide(ref Int2, int, out Int2)

Scales a vector by the given value.

public static void Divide(ref Int2 value, int scale, out Int2 result)

Parameters

value Int2

The vector to scale.

scale int

The amount by which to scale the vector.

result Int2

When the method completes, contains the scaled vector.

Dot(Int2, Int2)

Calculates the dot product of two vectors.

public static int Dot(Int2 left, Int2 right)

Parameters

left Int2

First source vector.

right Int2

Second source vector.

Returns

int

The dot product of the two vectors.

Dot(ref Int2, ref Int2, out int)

Calculates the dot product of two vectors.

public static void Dot(ref Int2 left, ref Int2 right, out int result)

Parameters

left Int2

First source vector.

right Int2

Second source vector.

result int

When the method completes, contains the dot product of the two vectors.

Equals(Int2)

Determines whether the specified Int2 is equal to this instance.

public bool Equals(Int2 other)

Parameters

other Int2

The Int2 to compare with this instance.

Returns

bool

true if the specified Int2 is equal to this instance; otherwise, false.

Equals(object)

Determines whether the specified object is equal to this instance.

public override bool Equals(object value)

Parameters

value object

The object to compare with this instance.

Returns

bool

true if the specified object is equal to this instance; otherwise, false.

GetHashCode()

Returns a hash code for this instance.

public override int GetHashCode()

Returns

int

A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table.

Length()

Calculates the length of the vector.

public int Length()

Returns

int

The length of the vector.

Remarks

LengthSquared() may be preferred when only the relative length is needed and speed is of the essence.

LengthSquared()

Calculates the squared length of the vector.

public int LengthSquared()

Returns

int

The squared length of the vector.

Remarks

This method may be preferred to Length() when only a relative length is needed and speed is of the essence.

Lerp(Int2, Int2, float)

Performs a linear interpolation between two vectors.

public static Int2 Lerp(Int2 start, Int2 end, float amount)

Parameters

start Int2

Start vector.

end Int2

End vector.

amount float

Value between 0 and 1 indicating the weight of end.

Returns

Int2

The linear interpolation of the two vectors.

Remarks

This method performs the linear interpolation based on the following formula.

start + (end - start) * amount

Passing amount a value of 0 will cause start to be returned; a value of 1 will cause end to be returned.

Lerp(ref Int2, ref Int2, float, out Int2)

Performs a linear interpolation between two vectors.

public static void Lerp(ref Int2 start, ref Int2 end, float amount, out Int2 result)

Parameters

start Int2

Start vector.

end Int2

End vector.

amount float

Value between 0 and 1 indicating the weight of end.

result Int2

When the method completes, contains the linear interpolation of the two vectors.

Remarks

This method performs the linear interpolation based on the following formula.

start + (end - start) * amount

Passing amount a value of 0 will cause start to be returned; a value of 1 will cause end to be returned.

Max(Int2, Int2)

Returns a vector containing the largest components of the specified vectors.

public static Int2 Max(Int2 left, Int2 right)

Parameters

left Int2

The first source vector.

right Int2

The second source vector.

Returns

Int2

A vector containing the largest components of the source vectors.

Max(ref Int2, ref Int2, out Int2)

Returns a vector containing the smallest components of the specified vectors.

public static void Max(ref Int2 left, ref Int2 right, out Int2 result)

Parameters

left Int2

The first source vector.

right Int2

The second source vector.

result Int2

When the method completes, contains an new vector composed of the largest components of the source vectors.

Min(Int2, Int2)

Returns a vector containing the smallest components of the specified vectors.

public static Int2 Min(Int2 left, Int2 right)

Parameters

left Int2

The first source vector.

right Int2

The second source vector.

Returns

Int2

A vector containing the smallest components of the source vectors.

Min(ref Int2, ref Int2, out Int2)

Returns a vector containing the smallest components of the specified vectors.

public static void Min(ref Int2 left, ref Int2 right, out Int2 result)

Parameters

left Int2

The first source vector.

right Int2

The second source vector.

result Int2

When the method completes, contains an new vector composed of the smallest components of the source vectors.

Modulate(Int2, Int2)

Modulates a vector with another by performing component-wise multiplication.

public static Int2 Modulate(Int2 left, Int2 right)

Parameters

left Int2

The first vector to modulate.

right Int2

The second vector to modulate.

Returns

Int2

The modulated vector.

Modulate(ref Int2, ref Int2, out Int2)

Modulates a vector with another by performing component-wise multiplication.

public static void Modulate(ref Int2 left, ref Int2 right, out Int2 result)

Parameters

left Int2

The first vector to modulate.

right Int2

The second vector to modulate.

result Int2

When the method completes, contains the modulated vector.

Multiply(Int2, int)

Scales a vector by the given value.

public static Int2 Multiply(Int2 value, int scale)

Parameters

value Int2

The vector to scale.

scale int

The amount by which to scale the vector.

Returns

Int2

The scaled vector.

Multiply(ref Int2, int, out Int2)

Scales a vector by the given value.

public static void Multiply(ref Int2 value, int scale, out Int2 result)

Parameters

value Int2

The vector to scale.

scale int

The amount by which to scale the vector.

result Int2

When the method completes, contains the scaled vector.

Negate(Int2)

Reverses the direction of a given vector.

public static Int2 Negate(Int2 value)

Parameters

value Int2

The vector to negate.

Returns

Int2

A vector facing in the opposite direction.

Negate(ref Int2, out Int2)

Reverses the direction of a given vector.

public static void Negate(ref Int2 value, out Int2 result)

Parameters

value Int2

The vector to negate.

result Int2

When the method completes, contains a vector facing in the opposite direction.

Pow(int)

Raises the exponent for each components.

public void Pow(int exponent)

Parameters

exponent int

The exponent.

SmoothStep(Int2, Int2, float)

Performs a cubic interpolation between two vectors.

public static Int2 SmoothStep(Int2 start, Int2 end, float amount)

Parameters

start Int2

Start vector.

end Int2

End vector.

amount float

Value between 0 and 1 indicating the weight of end.

Returns

Int2

The cubic interpolation of the two vectors.

SmoothStep(ref Int2, ref Int2, float, out Int2)

Performs a cubic interpolation between two vectors.

public static void SmoothStep(ref Int2 start, ref Int2 end, float amount, out Int2 result)

Parameters

start Int2

Start vector.

end Int2

End vector.

amount float

Value between 0 and 1 indicating the weight of end.

result Int2

When the method completes, contains the cubic interpolation of the two vectors.

Subtract(Int2, Int2)

Subtracts two vectors.

public static Int2 Subtract(Int2 left, Int2 right)

Parameters

left Int2

The first vector to subtract.

right Int2

The second vector to subtract.

Returns

Int2

The difference of the two vectors.

Subtract(ref Int2, ref Int2, out Int2)

Subtracts two vectors.

public static void Subtract(ref Int2 left, ref Int2 right, out Int2 result)

Parameters

left Int2

The first vector to subtract.

right Int2

The second vector to subtract.

result Int2

When the method completes, contains the difference of the two vectors.

ToArray()

Creates an array containing the elements of the vector.

public int[] ToArray()

Returns

int[]

A two-element array containing the components of the vector.

ToString()

Returns a string that represents this instance.

public override string ToString()

Returns

string

A string that represents this instance.

ToString(IFormatProvider)

Returns a string that represents this instance.

public string ToString(IFormatProvider formatProvider)

Parameters

formatProvider IFormatProvider

The format provider.

Returns

string

A string that represents this instance.

ToString(string)

Returns a string that represents this instance.

public string ToString(string format)

Parameters

format string

The format.

Returns

string

A string that represents this instance.

ToString(string, IFormatProvider)

Returns a string that represents this instance.

public string ToString(string format, IFormatProvider formatProvider)

Parameters

format string

The format.

formatProvider IFormatProvider

The format provider.

Returns

string

A string that represents this instance.

Operators

operator +(Int2, Int2)

Adds two vectors.

public static Int2 operator +(Int2 left, Int2 right)

Parameters

left Int2

The first vector to add.

right Int2

The second vector to add.

Returns

Int2

The sum of the two vectors.

operator /(Int2, float)

Scales a vector by the given value.

public static Int2 operator /(Int2 value, float scale)

Parameters

value Int2

The vector to scale.

scale float

The amount by which to scale the vector.

Returns

Int2

The scaled vector.

operator ==(Int2, Int2)

Tests for equality between two objects.

public static bool operator ==(Int2 left, Int2 right)

Parameters

left Int2

The first value to compare.

right Int2

The second value to compare.

Returns

bool

true if left has the same value as right; otherwise, false.

explicit operator Vector2(Int2)

Performs an explicit conversion from Int2 to Vector2.

public static explicit operator Vector2(Int2 value)

Parameters

value Int2

The value.

Returns

Vector2

The result of the conversion.

explicit operator Vector4(Int2)

Performs an explicit conversion from Int2 to Vector4.

public static explicit operator Vector4(Int2 value)

Parameters

value Int2

The value.

Returns

Vector4

The result of the conversion.

operator !=(Int2, Int2)

Tests for inequality between two objects.

public static bool operator !=(Int2 left, Int2 right)

Parameters

left Int2

The first value to compare.

right Int2

The second value to compare.

Returns

bool

true if left has a different value than right; otherwise, false.

operator *(Int2, float)

Scales a vector by the given value.

public static Int2 operator *(Int2 value, float scale)

Parameters

value Int2

The vector to scale.

scale float

The amount by which to scale the vector.

Returns

Int2

The scaled vector.

operator *(float, Int2)

Scales a vector by the given value.

public static Int2 operator *(float scale, Int2 value)

Parameters

scale float

The amount by which to scale the vector.

value Int2

The vector to scale.

Returns

Int2

The scaled vector.

operator -(Int2, Int2)

Subtracts two vectors.

public static Int2 operator -(Int2 left, Int2 right)

Parameters

left Int2

The first vector to subtract.

right Int2

The second vector to subtract.

Returns

Int2

The difference of the two vectors.

operator -(Int2)

Reverses the direction of a given vector.

public static Int2 operator -(Int2 value)

Parameters

value Int2

The vector to negate.

Returns

Int2

A vector facing in the opposite direction.

operator +(Int2)

Assert a vector (return it unchanged).

public static Int2 operator +(Int2 value)

Parameters

value Int2

The vector to assert (unchange).

Returns

Int2

The asserted (unchanged) vector.