Class reference
Vector2i
A 2D vector using integer coordinates.
Description
A 2-element structure that can be used to represent 2D grid coordinates or any other pair of integers. It uses integer coordinates and is therefore preferable to Vector2 when exact precision is required. Note that the values are limited to 32 bits, and unlike Vector2 this cannot be configured with an engine build option. Use int or PackedInt64Array if 64-bit values are needed. Note: In a boolean context, a Vector2i will evaluate to false if it's equal to Vector2i(0, 0). Otherwise, a Vector2i will always evaluate to true.
Properties
Constructors
Vector2i Vector2i()
Vector2i Vector2i()Constructs a default-initialized Vector2i with all components set to 0.
Vector2i Vector2i(Vector2i from)
Vector2i Vector2i(Vector2i from)Vector2i Vector2i(Vector2 from)
Vector2i Vector2i(Vector2 from)Constructs a new Vector2i from the given Vector2 by truncating components' fractional parts (rounding towards zero). For a different behavior consider passing the result of Vector2.ceil(), Vector2.floor() or Vector2.round() to this constructor instead.
Vector2i Vector2i(int x, int y)
Vector2i Vector2i(int x, int y)Constructs a new Vector2i from the given x and y.
Methods
Vector2i abs() const
Vector2i abs() constReturns a new vector with all components in absolute values (i.e. positive).
float aspect() const
float aspect() constReturns the aspect ratio of this vector, the ratio of x to y.
Vector2i clamp(Vector2i min, Vector2i max) const
Vector2i clamp(Vector2i min, Vector2i max) constReturns a new vector with all components clamped between the components of min and max, by running @GlobalScope.clamp() on each component.
Vector2i clampi(int min, int max) const
Vector2i clampi(int min, int max) constReturns a new vector with all components clamped between min and max, by running @GlobalScope.clamp() on each component.
int distance_squared_to(Vector2i to) const
int distance_squared_to(Vector2i to) constReturns the squared distance between this vector and to. This method runs faster than distance_to(), so prefer it if you need to compare vectors or need the squared distance for some formula.
float distance_to(Vector2i to) const
float distance_to(Vector2i to) constReturns the distance between this vector and to.
float length() const
float length() constReturns the length (magnitude) of this vector.
int length_squared() const
int length_squared() constReturns the squared length (squared magnitude) of this vector. This method runs faster than length(), so prefer it if you need to compare vectors or need the squared distance for some formula.
Vector2i max(Vector2i with) const
Vector2i max(Vector2i with) constReturns the component-wise maximum of this and with, equivalent to Vector2i(maxi(x, with.x), maxi(y, with.y)).
int max_axis_index() const
int max_axis_index() constReturns the axis of the vector's highest value. See AXIS_* constants. If all components are equal, this method returns AXIS_X.
Vector2i maxi(int with) const
Vector2i maxi(int with) constReturns the component-wise maximum of this and with, equivalent to Vector2i(maxi(x, with), maxi(y, with)).
Vector2i min(Vector2i with) const
Vector2i min(Vector2i with) constReturns the component-wise minimum of this and with, equivalent to Vector2i(mini(x, with.x), mini(y, with.y)).
int min_axis_index() const
int min_axis_index() constReturns the axis of the vector's lowest value. See AXIS_* constants. If all components are equal, this method returns AXIS_Y.
Vector2i mini(int with) const
Vector2i mini(int with) constReturns the component-wise minimum of this and with, equivalent to Vector2i(mini(x, with), mini(y, with)).
Vector2i sign() const
Vector2i sign() constReturns a new vector with each component set to 1 if it's positive, -1 if it's negative, and 0 if it's zero. The result is identical to calling @GlobalScope.sign() on each component.
Vector2i snapped(Vector2i step) const
Vector2i snapped(Vector2i step) constReturns a new vector with each component snapped to the closest multiple of the corresponding component in step.
Vector2i snappedi(int step) const
Vector2i snappedi(int step) constReturns a new vector with each component snapped to the closest multiple of step.
Constants
AXIS_X = 0
Enumerated value for the X axis. Returned by max_axis_index() and min_axis_index().
AXIS_Y = 1
Enumerated value for the Y axis. Returned by max_axis_index() and min_axis_index().
ZERO = Vector2i(0, 0)
Zero vector, a vector with all components set to 0.
ONE = Vector2i(1, 1)
One vector, a vector with all components set to 1.
MIN = Vector2i(-2147483648, -2147483648)
Min vector, a vector with all components equal to INT32_MIN. Can be used as a negative integer equivalent of Vector2.INF.
MAX = Vector2i(2147483647, 2147483647)
Max vector, a vector with all components equal to INT32_MAX. Can be used as an integer equivalent of Vector2.INF.
LEFT = Vector2i(-1, 0)
Left unit vector. Represents the direction of left.
RIGHT = Vector2i(1, 0)
Right unit vector. Represents the direction of right.
UP = Vector2i(0, -1)
Up unit vector. Y is down in 2D, so this vector points -Y.
DOWN = Vector2i(0, 1)
Down unit vector. Y is down in 2D, so this vector points +Y.
Operators
bool operator !=(Vector2i right)
bool operator !=(Vector2i right)Returns true if the vectors are not equal.
Vector2i operator %(Vector2i right)
Vector2i operator %(Vector2i right)Gets the remainder of each component of the Vector2i with the components of the given Vector2i. This operation uses truncated division, which is often not desired as it does not work well with negative numbers. Consider using @GlobalScope.posmod() instead if you want to handle negative numbers.
print(Vector2i(10, -20) % Vector2i(7, 8)) # Prints (3, -4)
Vector2i operator %(int right)
Vector2i operator %(int right)Gets the remainder of each component of the Vector2i with the given int. This operation uses truncated division, which is often not desired as it does not work well with negative numbers. Consider using @GlobalScope.posmod() instead if you want to handle negative numbers.
print(Vector2i(10, -20) % 7) # Prints (3, -6)
Vector2i operator *(Vector2i right)
Vector2i operator *(Vector2i right)Multiplies each component of the Vector2i by the components of the given Vector2i.
print(Vector2i(10, 20) * Vector2i(3, 4)) # Prints (30, 80)
Vector2 operator *(float right)
Vector2 operator *(float right)Multiplies each component of the Vector2i by the given float. Returns a Vector2.
print(Vector2i(10, 15) * 0.9) # Prints (9.0, 13.5)
Vector2i operator *(int right)
Vector2i operator *(int right)Vector2i operator +(Vector2i right)
Vector2i operator +(Vector2i right)Adds each component of the Vector2i by the components of the given Vector2i.
print(Vector2i(10, 20) + Vector2i(3, 4)) # Prints (13, 24)
Vector2i operator -(Vector2i right)
Vector2i operator -(Vector2i right)Subtracts each component of the Vector2i by the components of the given Vector2i.
print(Vector2i(10, 20) - Vector2i(3, 4)) # Prints (7, 16)
Vector2i operator /(Vector2i right)
Vector2i operator /(Vector2i right)Divides each component of the Vector2i by the components of the given Vector2i.
print(Vector2i(10, 20) / Vector2i(2, 5)) # Prints (5, 4)
Vector2 operator /(float right)
Vector2 operator /(float right)Divides each component of the Vector2i by the given float. Returns a Vector2.
print(Vector2i(1, 2) / 2.5) # Prints (0.4, 0.8)
Vector2i operator /(int right)
Vector2i operator /(int right)bool operator <(Vector2i right)
bool operator <(Vector2i right)Compares two Vector2i vectors by first checking if the X value of the left vector is less than the X value of the right vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors. This operator is useful for sorting vectors.
bool operator <=(Vector2i right)
bool operator <=(Vector2i right)Compares two Vector2i vectors by first checking if the X value of the left vector is less than or equal to the X value of the right vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors. This operator is useful for sorting vectors.
bool operator ==(Vector2i right)
bool operator ==(Vector2i right)Returns true if the vectors are equal.
bool operator >(Vector2i right)
bool operator >(Vector2i right)Compares two Vector2i vectors by first checking if the X value of the left vector is greater than the X value of the right vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors. This operator is useful for sorting vectors.
bool operator >=(Vector2i right)
bool operator >=(Vector2i right)Compares two Vector2i vectors by first checking if the X value of the left vector is greater than or equal to the X value of the right vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors. This operator is useful for sorting vectors.
int operator [](int index)
int operator [](int index)Access vector components using their index. v[0] is equivalent to v.x, and v[1] is equivalent to v.y.
Vector2i operator unary+()
Vector2i operator unary+()Returns the same value as if the + was not there. Unary + does nothing, but sometimes it can make your code more readable.
Vector2i operator unary-()
Vector2i operator unary-()Returns the negative value of the Vector2i. This is the same as writing Vector2i(-v.x, -v.y). This operation flips the direction of the vector while keeping the same magnitude.