Struct Int3
- Namespace
- Stride.Core.Mathematics
- Assembly
- Stride.Core.Mathematics.dll
Represents a three dimensional mathematical vector.
[DataContract("Int3")]
[DataStyle(DataStyle.Compact)]
public struct Int3 : IEquatable<Int3>, IFormattable
- Implements
Constructors
Int3(Vector2, int)
Initializes a new instance of the Int3 struct.
public Int3(Vector2 value, int z)
Parameters
value
Vector2A vector containing the values with which to initialize the X and Y components.
z
intInitial value for the Z component of the vector.
Int3(int)
Initializes a new instance of the Int3 struct.
public Int3(int value)
Parameters
value
intThe value that will be assigned to all components.
Int3(int, int, int)
Initializes a new instance of the Int3 struct.
public Int3(int x, int y, int z)
Parameters
x
intInitial value for the X component of the vector.
y
intInitial value for the Y component of the vector.
z
intInitial value for the Z component of the vector.
Int3(int[])
Initializes a new instance of the Int3 struct.
public Int3(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
isnull
.- ArgumentOutOfRangeException
Thrown when
values
contains more or less than three elements.
Fields
One
A Int3 with all of its components set to one.
public static readonly Int3 One
Field Value
SizeInBytes
The size of the Int3 type, in bytes.
public static readonly int SizeInBytes
Field Value
UnitX
The X unit Int3 (1, 0, 0).
public static readonly Int3 UnitX
Field Value
UnitY
The Y unit Int3 (0, 1, 0).
public static readonly Int3 UnitY
Field Value
UnitZ
The Z unit Int3 (0, 0, 1).
public static readonly Int3 UnitZ
Field Value
X
The X component of the vector.
[DataMember(0)]
public int X
Field Value
Y
The Y component of the vector.
[DataMember(1)]
public int Y
Field Value
Z
The Z component of the vector.
[DataMember(2)]
public int Z
Field Value
Zero
A Int3 with all of its components set to zero.
public static readonly Int3 Zero
Field Value
Properties
this[int]
Gets or sets the component at the specified index.
public int this[int index] { get; set; }
Parameters
index
intThe index of the component to access. Use 0 for the X component, 1 for the Y component, and 2 for the Z component.
Property Value
- int
The value of the X, Y, or Z component, depending on the index.
Exceptions
- ArgumentOutOfRangeException
Thrown when the
index
is out of the range [0, 2].
Methods
Add(Int3, Int3)
Adds two vectors.
public static Int3 Add(Int3 left, Int3 right)
Parameters
Returns
- Int3
The sum of the two vectors.
Add(ref readonly Int3, ref readonly Int3, out Int3)
Adds two vectors.
public static void Add(ref readonly Int3 left, ref readonly Int3 right, out Int3 result)
Parameters
left
Int3The first vector to add.
right
Int3The second vector to add.
result
Int3When the method completes, contains the sum of the two vectors.
Clamp(Int3, Int3, Int3)
Restricts a value to be within a specified range.
public static Int3 Clamp(Int3 value, Int3 min, Int3 max)
Parameters
Returns
- Int3
The clamped value.
Clamp(ref readonly Int3, ref readonly Int3, ref readonly Int3, out Int3)
Restricts a value to be within a specified range.
public static void Clamp(ref readonly Int3 value, ref readonly Int3 min, ref readonly Int3 max, out Int3 result)
Parameters
value
Int3The value to clamp.
min
Int3The minimum value.
max
Int3The maximum value.
result
Int3When the method completes, contains the clamped value.
Deconstruct(out int, out int, out int)
Deconstructs the vector's components into named variables.
public void Deconstruct(out int x, out int y, out int z)
Parameters
Divide(Int3, int)
Scales a vector by the given value.
public static Int3 Divide(Int3 value, int scale)
Parameters
Returns
- Int3
The scaled vector.
Divide(ref readonly Int3, int, out Int3)
Scales a vector by the given value.
public static void Divide(ref readonly Int3 value, int scale, out Int3 result)
Parameters
value
Int3The vector to scale.
scale
intThe amount by which to scale the vector.
result
Int3When the method completes, contains the scaled vector.
Dot(Int3, Int3)
Calculates the dot product of two vectors.
public static int Dot(Int3 left, Int3 right)
Parameters
Returns
- int
The dot product of the two vectors.
Dot(ref readonly Int3, ref readonly Int3, out int)
Calculates the dot product of two vectors.
public static void Dot(ref readonly Int3 left, ref readonly Int3 right, out int result)
Parameters
left
Int3First source vector.
right
Int3Second source vector.
result
intWhen the method completes, contains the dot product of the two vectors.
Equals(Int3)
Determines whether the specified Int3 is equal to this instance.
public bool Equals(Int3 other)
Parameters
Returns
Equals(object)
Determines whether the specified object is equal to this instance.
public override bool Equals(object value)
Parameters
Returns
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.
LengthUntruncated()
Calculates the untruncated length of the vector.
public float LengthUntruncated()
Returns
- float
The length of the vector untruncated.
Lerp(Int3, Int3, float)
Performs a linear interpolation between two vectors.
public static Int3 Lerp(Int3 start, Int3 end, float amount)
Parameters
start
Int3Start vector.
end
Int3End vector.
amount
floatValue between 0 and 1 indicating the weight of
end
.
Returns
- Int3
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 readonly Int3, ref readonly Int3, float, out Int3)
Performs a linear interpolation between two vectors.
public static void Lerp(ref readonly Int3 start, ref readonly Int3 end, float amount, out Int3 result)
Parameters
start
Int3Start vector.
end
Int3End vector.
amount
floatValue between 0 and 1 indicating the weight of
end
.result
Int3When 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(Int3, Int3)
Returns a vector containing the largest components of the specified vectors.
public static Int3 Max(Int3 left, Int3 right)
Parameters
Returns
- Int3
A vector containing the largest components of the source vectors.
Max(ref readonly Int3, ref readonly Int3, out Int3)
Returns a vector containing the smallest components of the specified vectors.
public static void Max(ref readonly Int3 left, ref readonly Int3 right, out Int3 result)
Parameters
left
Int3The first source vector.
right
Int3The second source vector.
result
Int3When the method completes, contains an new vector composed of the largest components of the source vectors.
Min(Int3, Int3)
Returns a vector containing the smallest components of the specified vectors.
public static Int3 Min(Int3 left, Int3 right)
Parameters
Returns
- Int3
A vector containing the smallest components of the source vectors.
Min(ref readonly Int3, ref readonly Int3, out Int3)
Returns a vector containing the smallest components of the specified vectors.
public static void Min(ref readonly Int3 left, ref readonly Int3 right, out Int3 result)
Parameters
left
Int3The first source vector.
right
Int3The second source vector.
result
Int3When the method completes, contains an new vector composed of the smallest components of the source vectors.
Modulate(Int3, Int3)
Modulates a vector with another by performing component-wise multiplication.
public static Int3 Modulate(Int3 left, Int3 right)
Parameters
Returns
- Int3
The modulated vector.
Modulate(ref readonly Int3, ref readonly Int3, out Int3)
Modulates a vector with another by performing component-wise multiplication.
public static void Modulate(ref readonly Int3 left, ref readonly Int3 right, out Int3 result)
Parameters
left
Int3The first vector to modulate.
right
Int3The second vector to modulate.
result
Int3When the method completes, contains the modulated vector.
Multiply(Int3, int)
Scales a vector by the given value.
public static Int3 Multiply(Int3 value, int scale)
Parameters
Returns
- Int3
The scaled vector.
Multiply(ref readonly Int3, int, out Int3)
Scales a vector by the given value.
public static void Multiply(ref readonly Int3 value, int scale, out Int3 result)
Parameters
value
Int3The vector to scale.
scale
intThe amount by which to scale the vector.
result
Int3When the method completes, contains the scaled vector.
Negate(Int3)
Reverses the direction of a given vector.
public static Int3 Negate(Int3 value)
Parameters
value
Int3The vector to negate.
Returns
- Int3
A vector facing in the opposite direction.
Negate(ref readonly Int3, out Int3)
Reverses the direction of a given vector.
public static void Negate(ref readonly Int3 value, out Int3 result)
Parameters
value
Int3The vector to negate.
result
Int3When 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
intThe exponent.
Round(in Vector3, out Int3, MidpointRounding)
Returns a vector containing the rounded values of the specified vector.
public static void Round(in Vector3 value, out Int3 result, MidpointRounding rounding = MidpointRounding.ToEven)
Parameters
value
Vector3The source vector.
result
Int3When the method completes, contains an new vector composed of the rounded values of the specified vector.
rounding
MidpointRoundingThe rounding strategy to use.
Round(in Vector3, MidpointRounding)
Returns a vector containing the rounded values of the specified vector.
public static Int3 Round(in Vector3 value, MidpointRounding rounding = MidpointRounding.ToEven)
Parameters
value
Vector3The source vector.
rounding
MidpointRoundingThe rounding strategy to use.
Returns
- Int3
A vector containing the rounded values of the source vector.
SmoothStep(Int3, Int3, float)
Performs a cubic interpolation between two vectors.
public static Int3 SmoothStep(Int3 start, Int3 end, float amount)
Parameters
start
Int3Start vector.
end
Int3End vector.
amount
floatValue between 0 and 1 indicating the weight of
end
.
Returns
- Int3
The cubic interpolation of the two vectors.
SmoothStep(ref readonly Int3, ref readonly Int3, float, out Int3)
Performs a cubic interpolation between two vectors.
public static void SmoothStep(ref readonly Int3 start, ref readonly Int3 end, float amount, out Int3 result)
Parameters
start
Int3Start vector.
end
Int3End vector.
amount
floatValue between 0 and 1 indicating the weight of
end
.result
Int3When the method completes, contains the cubic interpolation of the two vectors.
Subtract(Int3, Int3)
Subtracts two vectors.
public static Int3 Subtract(Int3 left, Int3 right)
Parameters
Returns
- Int3
The difference of the two vectors.
Subtract(ref readonly Int3, ref readonly Int3, out Int3)
Subtracts two vectors.
public static void Subtract(ref readonly Int3 left, ref readonly Int3 right, out Int3 result)
Parameters
left
Int3The first vector to subtract.
right
Int3The second vector to subtract.
result
Int3When 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 three-element array containing the components of the vector.
ToString()
Returns a string that represents this instance.
public override string ToString()
Returns
ToString(IFormatProvider)
Returns a string that represents this instance.
public string ToString(IFormatProvider formatProvider)
Parameters
formatProvider
IFormatProviderThe format provider.
Returns
ToString(string)
Returns a string that represents this instance.
public string ToString(string format)
Parameters
format
stringThe format.
Returns
ToString(string, IFormatProvider)
Returns a string that represents this instance.
public string ToString(string format, IFormatProvider formatProvider)
Parameters
format
stringThe format.
formatProvider
IFormatProviderThe format provider.
Returns
Operators
operator +(Int3, Int3)
Adds two vectors.
public static Int3 operator +(Int3 left, Int3 right)
Parameters
Returns
- Int3
The sum of the two vectors.
operator /(Int3, float)
Scales a vector by the given value.
public static Int3 operator /(Int3 value, float scale)
Parameters
Returns
- Int3
The scaled vector.
operator ==(Int3, Int3)
Tests for equality between two objects.
public static bool operator ==(Int3 left, Int3 right)
Parameters
Returns
- bool
true
ifleft
has the same value asright
; otherwise,false
.
explicit operator Vector2(Int3)
public static explicit operator Vector2(Int3 value)
Parameters
value
Int3The value.
Returns
- Vector2
The result of the conversion.
explicit operator Vector3(Int3)
public static explicit operator Vector3(Int3 value)
Parameters
value
Int3The value.
Returns
- Vector3
The result of the conversion.
explicit operator Vector4(Int3)
public static explicit operator Vector4(Int3 value)
Parameters
value
Int3The value.
Returns
- Vector4
The result of the conversion.
operator !=(Int3, Int3)
Tests for inequality between two objects.
public static bool operator !=(Int3 left, Int3 right)
Parameters
Returns
- bool
true
ifleft
has a different value thanright
; otherwise,false
.
operator *(Int3, float)
Scales a vector by the given value.
public static Int3 operator *(Int3 value, float scale)
Parameters
Returns
- Int3
The scaled vector.
operator *(float, Int3)
Scales a vector by the given value.
public static Int3 operator *(float scale, Int3 value)
Parameters
Returns
- Int3
The scaled vector.
operator -(Int3, Int3)
Subtracts two vectors.
public static Int3 operator -(Int3 left, Int3 right)
Parameters
Returns
- Int3
The difference of the two vectors.
operator -(Int3)
Reverses the direction of a given vector.
public static Int3 operator -(Int3 value)
Parameters
value
Int3The vector to negate.
Returns
- Int3
A vector facing in the opposite direction.
operator +(Int3)
Assert a vector (return it unchanged).
public static Int3 operator +(Int3 value)
Parameters
value
Int3The vector to assert (unchange).
Returns
- Int3
The asserted (unchanged) vector.