2020-02-24 17:00:40 +01:00
<?xml version="1.0" encoding="UTF-8" ?>
<class name= "Vector2i" version= "4.0" >
<brief_description >
Vector used for 2D math using integer coordinates.
</brief_description>
<description >
2-element structure that can be used to represent positions in 2D space or any other pair of numeric values.
2020-06-21 17:16:10 +02:00
It uses integer coordinates and is therefore preferable to [Vector2] when exact precision is required.
[b]Note:[/b] In a boolean context, a Vector2i will evaluate to [code]false[/code] if it's equal to [code]Vector2i(0, 0)[/code]. Otherwise, a Vector2i will always evaluate to [code]true[/code].
2020-02-24 17:00:40 +01:00
</description>
<tutorials >
2021-11-15 10:43:07 +01:00
<link title= "Math documentation index" > $DOCS_URL/tutorials/math/index.html</link>
<link title= "Vector math" > $DOCS_URL/tutorials/math/vector_math.html</link>
2020-10-01 10:34:47 +02:00
<link title= "3Blue1Brown Essence of Linear Algebra" > https://www.youtube.com/playlist?list=PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab</link>
2020-02-24 17:00:40 +01:00
</tutorials>
2021-09-21 04:49:02 +02:00
<constructors >
<constructor name= "Vector2i" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
2020-11-09 17:46:03 +01:00
<description >
Constructs a default-initialized [Vector2i] with all components set to [code]0[/code].
</description>
2021-09-21 04:49:02 +02:00
</constructor>
<constructor name= "Vector2i" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "from" type= "Vector2i" />
2020-02-24 17:00:40 +01:00
<description >
2020-11-09 17:46:03 +01:00
Constructs a [Vector2i] as a copy of the given [Vector2i].
2020-02-24 17:00:40 +01:00
</description>
2021-09-21 04:49:02 +02:00
</constructor>
<constructor name= "Vector2i" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "from" type= "Vector2" />
2020-02-24 17:00:40 +01:00
<description >
Constructs a new [Vector2i] from [Vector2]. The floating point coordinates will be truncated.
</description>
2021-09-21 04:49:02 +02:00
</constructor>
<constructor name= "Vector2i" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "x" type= "int" />
<argument index= "1" name= "y" type= "int" />
2020-11-09 17:46:03 +01:00
<description >
Constructs a new [Vector2i] from the given [code]x[/code] and [code]y[/code].
</description>
2021-09-21 04:49:02 +02:00
</constructor>
</constructors>
<methods >
2021-03-18 14:44:42 +01:00
<method name= "abs" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
2020-06-03 14:22:26 +02:00
<description >
Returns a new vector with all components in absolute values (i.e. positive).
</description>
</method>
2021-03-18 14:44:42 +01:00
<method name= "aspect" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "float" />
2020-06-03 14:22:26 +02:00
<description >
2022-01-06 11:37:08 +01:00
Returns the aspect ratio of this vector, the ratio of [member x] to [member y].
2020-06-03 14:22:26 +02:00
</description>
</method>
2021-02-01 06:10:52 +01:00
<method name= "clamp" qualifiers= "const" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "min" type= "Vector2i" />
<argument index= "1" name= "max" type= "Vector2i" />
2021-02-01 06:10:52 +01:00
<description >
Returns a new vector with all components clamped between the components of [code]min[/code] and [code]max[/code], by running [method @GlobalScope.clamp] on each component.
</description>
</method>
2021-11-29 18:13:31 +01:00
<method name= "length" qualifiers= "const" >
<return type= "float" />
<description >
Returns the length (magnitude) of this vector.
</description>
</method>
<method name= "length_squared" qualifiers= "const" >
<return type= "int" />
<description >
Returns the squared length (squared magnitude) of this vector.
This method runs faster than [method length], so prefer it if you need to compare vectors or need the squared distance for some formula.
</description>
</method>
2019-11-28 09:48:51 +01:00
<method name= "max_axis_index" qualifiers= "const" >
<return type= "int" />
<description >
Returns the axis of the vector's highest value. See [code]AXIS_*[/code] constants. If all components are equal, this method returns [constant AXIS_X].
</description>
</method>
<method name= "min_axis_index" qualifiers= "const" >
<return type= "int" />
<description >
Returns the axis of the vector's lowest value. See [code]AXIS_*[/code] constants. If all components are equal, this method returns [constant AXIS_Y].
</description>
</method>
2021-09-21 04:49:02 +02:00
<method name= "sign" qualifiers= "const" >
<return type= "Vector2i" />
2021-09-17 17:22:48 +02:00
<description >
2022-01-06 11:37:08 +01:00
Returns a new vector with each component set to one or negative one, depending on the signs of the components, or zero if the component is zero, by calling [method @GlobalScope.sign] on each component.
2021-09-17 17:22:48 +02:00
</description>
</method>
2021-09-21 04:49:02 +02:00
</methods>
<members >
<member name= "x" type= "int" setter= "" getter= "" default= "0" >
The vector's X component. Also accessible by using the index position [code][0][/code].
</member>
<member name= "y" type= "int" setter= "" getter= "" default= "0" >
The vector's Y component. Also accessible by using the index position [code][1][/code].
</member>
</members>
<constants >
<constant name= "AXIS_X" value= "0" >
2019-11-28 09:48:51 +01:00
Enumerated value for the X axis. Returned by [method max_axis_index] and [method min_axis_index].
2021-09-21 04:49:02 +02:00
</constant>
<constant name= "AXIS_Y" value= "1" >
2019-11-28 09:48:51 +01:00
Enumerated value for the Y axis. Returned by [method max_axis_index] and [method min_axis_index].
2021-09-21 04:49:02 +02:00
</constant>
<constant name= "ZERO" value= "Vector2i(0, 0)" >
Zero vector, a vector with all components set to [code]0[/code].
</constant>
<constant name= "ONE" value= "Vector2i(1, 1)" >
One vector, a vector with all components set to [code]1[/code].
</constant>
<constant name= "LEFT" value= "Vector2i(-1, 0)" >
Left unit vector. Represents the direction of left.
</constant>
<constant name= "RIGHT" value= "Vector2i(1, 0)" >
Right unit vector. Represents the direction of right.
</constant>
<constant name= "UP" value= "Vector2i(0, -1)" >
Up unit vector. Y is down in 2D, so this vector points -Y.
</constant>
<constant name= "DOWN" value= "Vector2i(0, 1)" >
Down unit vector. Y is down in 2D, so this vector points +Y.
</constant>
</constants>
<operators >
<operator name= "operator !=" >
<return type= "bool" />
<description >
</description>
</operator>
<operator name= "operator !=" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Returns [code]true[/code] if the vectors are not equal.
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator %" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
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 [method @GlobalScope.posmod] instead if you want to handle negative numbers.
[codeblock]
print(Vector2i(10, -20) % Vector2i(7, 8)) # Prints "(3, -4)"
[/codeblock]
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator %" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "right" type= "int" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Gets the remainder of each component of the [Vector2i] with the the given [int]. This operation uses truncated division, which is often not desired as it does not work well with negative numbers. Consider using [method @GlobalScope.posmod] instead if you want to handle negative numbers.
[codeblock]
print(Vector2i(10, -20) % 7) # Prints "(3, -6)"
[/codeblock]
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator *" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Multiplies each component of the [Vector2i] by the components of the given [Vector2i].
[codeblock]
print(Vector2i(10, 20) * Vector2i(3, 4)) # Prints "(30, 80)"
[/codeblock]
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator *" >
2022-02-03 22:16:58 +01:00
<return type= "Vector2" />
2021-07-30 15:28:05 +02:00
<argument index= "0" name= "right" type= "float" />
2020-11-10 14:16:20 +01:00
<description >
2022-02-03 22:16:58 +01:00
Multiplies each component of the [Vector2i] by the given [float]. Returns a [Vector2].
2021-11-04 16:58:20 +01:00
[codeblock]
2022-02-03 22:16:58 +01:00
print(Vector2i(10, 15) * 0.9) # Prints "(9, 13.5)"
2021-11-04 16:58:20 +01:00
[/codeblock]
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator *" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "right" type= "int" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Multiplies each component of the [Vector2i] by the given [int].
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator +" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Adds each component of the [Vector2i] by the components of the given [Vector2i].
[codeblock]
print(Vector2i(10, 20) + Vector2i(3, 4)) # Prints "(13, 24)"
[/codeblock]
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator -" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Subtracts each component of the [Vector2i] by the components of the given [Vector2i].
[codeblock]
print(Vector2i(10, 20) - Vector2i(3, 4)) # Prints "(7, 16)"
[/codeblock]
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator /" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Divides each component of the [Vector2i] by the components of the given [Vector2i].
[codeblock]
print(Vector2i(10, 20) / Vector2i(2, 5)) # Prints "(5, 4)"
[/codeblock]
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator /" >
2022-02-03 22:16:58 +01:00
<return type= "Vector2" />
2021-07-30 15:28:05 +02:00
<argument index= "0" name= "right" type= "float" />
2020-11-10 14:16:20 +01:00
<description >
2022-02-03 22:16:58 +01:00
Divides each component of the [Vector2i] by the given [float]. Returns a [Vector2].
2021-11-04 16:58:20 +01:00
[codeblock]
print(Vector2i(10, 20) / 2.9) # Prints "(5, 10)"
[/codeblock]
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator /" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
<argument index= "0" name= "right" type= "int" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Divides each component of the [Vector2i] by the given [int].
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator <" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Compares two [Vector2i] vectors by first checking if the X value of the left vector is less than the X value of the [code]right[/code] 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.
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator <=" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
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 [code]right[/code] 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.
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator ==" >
2021-09-17 17:22:48 +02:00
<return type= "bool" />
<description >
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator ==" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Returns [code]true[/code] if the vectors are equal.
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator >" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Compares two [Vector2i] vectors by first checking if the X value of the left vector is greater than the X value of the [code]right[/code] 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.
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator >=" >
2021-07-30 15:28:05 +02:00
<return type= "bool" />
<argument index= "0" name= "right" type= "Vector2i" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
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 [code]right[/code] 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.
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator []" >
2021-07-30 15:28:05 +02:00
<return type= "int" />
<argument index= "0" name= "index" type= "int" />
2020-11-10 14:16:20 +01:00
<description >
2021-11-04 16:58:20 +01:00
Access vector components using their index. [code]v[0][/code] is equivalent to [code]v.x[/code], and [code]v[1][/code] is equivalent to [code]v.y[/code].
2020-11-10 14:16:20 +01:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator unary+" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
2021-06-19 17:58:49 +02:00
<description >
2021-11-04 16:58:20 +01:00
Returns the same value as if the [code]+[/code] was not there. Unary [code]+[/code] does nothing, but sometimes it can make your code more readable.
2021-06-19 17:58:49 +02:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
<operator name= "operator unary-" >
2021-07-30 15:28:05 +02:00
<return type= "Vector2i" />
2021-06-19 17:58:49 +02:00
<description >
2021-11-04 16:58:20 +01:00
Returns the negative value of the [Vector2i]. This is the same as writing [code]Vector2i(-v.x, -v.y)[/code]. This operation flips the direction of the vector while keeping the same magnitude.
2021-06-19 17:58:49 +02:00
</description>
2021-09-21 04:49:02 +02:00
</operator>
</operators>
2020-02-24 17:00:40 +01:00
</class>