class_vector2i.rst 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/4.2/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/4.2/doc/classes/Vector2i.xml.
  6. .. _class_Vector2i:
  7. Vector2i
  8. ========
  9. A 2D vector using integer coordinates.
  10. .. rst-class:: classref-introduction-group
  11. Description
  12. -----------
  13. A 2-element structure that can be used to represent 2D grid coordinates or any other pair of integers.
  14. It uses integer coordinates and is therefore preferable to :ref:`Vector2<class_Vector2>` when exact precision is required. Note that the values are limited to 32 bits, and unlike :ref:`Vector2<class_Vector2>` this cannot be configured with an engine build option. Use :ref:`int<class_int>` or :ref:`PackedInt64Array<class_PackedInt64Array>` if 64-bit values are needed.
  15. \ **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``.
  16. .. rst-class:: classref-introduction-group
  17. Tutorials
  18. ---------
  19. - :doc:`Math documentation index <../tutorials/math/index>`
  20. - :doc:`Vector math <../tutorials/math/vector_math>`
  21. - `3Blue1Brown Essence of Linear Algebra <https://www.youtube.com/playlist?list=PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab>`__
  22. .. rst-class:: classref-reftable-group
  23. Properties
  24. ----------
  25. .. table::
  26. :widths: auto
  27. +-----------------------+-------------------------------------+-------+
  28. | :ref:`int<class_int>` | :ref:`x<class_Vector2i_property_x>` | ``0`` |
  29. +-----------------------+-------------------------------------+-------+
  30. | :ref:`int<class_int>` | :ref:`y<class_Vector2i_property_y>` | ``0`` |
  31. +-----------------------+-------------------------------------+-------+
  32. .. rst-class:: classref-reftable-group
  33. Constructors
  34. ------------
  35. .. table::
  36. :widths: auto
  37. +---------------------------------+-------------------------------------------------------------------------------------------------------------------+
  38. | :ref:`Vector2i<class_Vector2i>` | :ref:`Vector2i<class_Vector2i_constructor_Vector2i>` **(** **)** |
  39. +---------------------------------+-------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`Vector2i<class_Vector2i>` | :ref:`Vector2i<class_Vector2i_constructor_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` from **)** |
  41. +---------------------------------+-------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`Vector2i<class_Vector2i>` | :ref:`Vector2i<class_Vector2i_constructor_Vector2i>` **(** :ref:`Vector2<class_Vector2>` from **)** |
  43. +---------------------------------+-------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`Vector2i<class_Vector2i>` | :ref:`Vector2i<class_Vector2i_constructor_Vector2i>` **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y **)** |
  45. +---------------------------------+-------------------------------------------------------------------------------------------------------------------+
  46. .. rst-class:: classref-reftable-group
  47. Methods
  48. -------
  49. .. table::
  50. :widths: auto
  51. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  52. | :ref:`Vector2i<class_Vector2i>` | :ref:`abs<class_Vector2i_method_abs>` **(** **)** |const| |
  53. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  54. | :ref:`float<class_float>` | :ref:`aspect<class_Vector2i_method_aspect>` **(** **)** |const| |
  55. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`Vector2i<class_Vector2i>` | :ref:`clamp<class_Vector2i_method_clamp>` **(** :ref:`Vector2i<class_Vector2i>` min, :ref:`Vector2i<class_Vector2i>` max **)** |const| |
  57. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`float<class_float>` | :ref:`length<class_Vector2i_method_length>` **(** **)** |const| |
  59. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`int<class_int>` | :ref:`length_squared<class_Vector2i_method_length_squared>` **(** **)** |const| |
  61. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`int<class_int>` | :ref:`max_axis_index<class_Vector2i_method_max_axis_index>` **(** **)** |const| |
  63. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`int<class_int>` | :ref:`min_axis_index<class_Vector2i_method_min_axis_index>` **(** **)** |const| |
  65. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`Vector2i<class_Vector2i>` | :ref:`sign<class_Vector2i_method_sign>` **(** **)** |const| |
  67. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  68. | :ref:`Vector2i<class_Vector2i>` | :ref:`snapped<class_Vector2i_method_snapped>` **(** :ref:`Vector2i<class_Vector2i>` step **)** |const| |
  69. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  70. .. rst-class:: classref-reftable-group
  71. Operators
  72. ---------
  73. .. table::
  74. :widths: auto
  75. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  76. | :ref:`bool<class_bool>` | :ref:`operator !=<class_Vector2i_operator_neq_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  77. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  78. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator %<class_Vector2i_operator_mod_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  79. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  80. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator %<class_Vector2i_operator_mod_int>` **(** :ref:`int<class_int>` right **)** |
  81. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  82. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator *<class_Vector2i_operator_mul_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  83. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  84. | :ref:`Vector2<class_Vector2>` | :ref:`operator *<class_Vector2i_operator_mul_float>` **(** :ref:`float<class_float>` right **)** |
  85. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  86. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator *<class_Vector2i_operator_mul_int>` **(** :ref:`int<class_int>` right **)** |
  87. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  88. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator +<class_Vector2i_operator_sum_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  89. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  90. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator -<class_Vector2i_operator_dif_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  91. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  92. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator /<class_Vector2i_operator_div_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  93. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  94. | :ref:`Vector2<class_Vector2>` | :ref:`operator /<class_Vector2i_operator_div_float>` **(** :ref:`float<class_float>` right **)** |
  95. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  96. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator /<class_Vector2i_operator_div_int>` **(** :ref:`int<class_int>` right **)** |
  97. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  98. | :ref:`bool<class_bool>` | :ref:`operator \<<class_Vector2i_operator_lt_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  99. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  100. | :ref:`bool<class_bool>` | :ref:`operator \<=<class_Vector2i_operator_lte_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  101. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  102. | :ref:`bool<class_bool>` | :ref:`operator ==<class_Vector2i_operator_eq_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  103. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  104. | :ref:`bool<class_bool>` | :ref:`operator ><class_Vector2i_operator_gt_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  105. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  106. | :ref:`bool<class_bool>` | :ref:`operator >=<class_Vector2i_operator_gte_Vector2i>` **(** :ref:`Vector2i<class_Vector2i>` right **)** |
  107. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  108. | :ref:`int<class_int>` | :ref:`operator []<class_Vector2i_operator_idx_int>` **(** :ref:`int<class_int>` index **)** |
  109. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  110. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator unary+<class_Vector2i_operator_unplus>` **(** **)** |
  111. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  112. | :ref:`Vector2i<class_Vector2i>` | :ref:`operator unary-<class_Vector2i_operator_unminus>` **(** **)** |
  113. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  114. .. rst-class:: classref-section-separator
  115. ----
  116. .. rst-class:: classref-descriptions-group
  117. Constants
  118. ---------
  119. .. _class_Vector2i_constant_AXIS_X:
  120. .. rst-class:: classref-constant
  121. **AXIS_X** = ``0``
  122. Enumerated value for the X axis. Returned by :ref:`max_axis_index<class_Vector2i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector2i_method_min_axis_index>`.
  123. .. _class_Vector2i_constant_AXIS_Y:
  124. .. rst-class:: classref-constant
  125. **AXIS_Y** = ``1``
  126. Enumerated value for the Y axis. Returned by :ref:`max_axis_index<class_Vector2i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector2i_method_min_axis_index>`.
  127. .. _class_Vector2i_constant_ZERO:
  128. .. rst-class:: classref-constant
  129. **ZERO** = ``Vector2i(0, 0)``
  130. Zero vector, a vector with all components set to ``0``.
  131. .. _class_Vector2i_constant_ONE:
  132. .. rst-class:: classref-constant
  133. **ONE** = ``Vector2i(1, 1)``
  134. One vector, a vector with all components set to ``1``.
  135. .. _class_Vector2i_constant_MIN:
  136. .. rst-class:: classref-constant
  137. **MIN** = ``Vector2i(-2147483648, -2147483648)``
  138. Min vector, a vector with all components equal to ``INT32_MIN``. Can be used as a negative integer equivalent of :ref:`Vector2.INF<class_Vector2_constant_INF>`.
  139. .. _class_Vector2i_constant_MAX:
  140. .. rst-class:: classref-constant
  141. **MAX** = ``Vector2i(2147483647, 2147483647)``
  142. Max vector, a vector with all components equal to ``INT32_MAX``. Can be used as an integer equivalent of :ref:`Vector2.INF<class_Vector2_constant_INF>`.
  143. .. _class_Vector2i_constant_LEFT:
  144. .. rst-class:: classref-constant
  145. **LEFT** = ``Vector2i(-1, 0)``
  146. Left unit vector. Represents the direction of left.
  147. .. _class_Vector2i_constant_RIGHT:
  148. .. rst-class:: classref-constant
  149. **RIGHT** = ``Vector2i(1, 0)``
  150. Right unit vector. Represents the direction of right.
  151. .. _class_Vector2i_constant_UP:
  152. .. rst-class:: classref-constant
  153. **UP** = ``Vector2i(0, -1)``
  154. Up unit vector. Y is down in 2D, so this vector points -Y.
  155. .. _class_Vector2i_constant_DOWN:
  156. .. rst-class:: classref-constant
  157. **DOWN** = ``Vector2i(0, 1)``
  158. Down unit vector. Y is down in 2D, so this vector points +Y.
  159. .. rst-class:: classref-section-separator
  160. ----
  161. .. rst-class:: classref-descriptions-group
  162. Property Descriptions
  163. ---------------------
  164. .. _class_Vector2i_property_x:
  165. .. rst-class:: classref-property
  166. :ref:`int<class_int>` **x** = ``0``
  167. The vector's X component. Also accessible by using the index position ``[0]``.
  168. .. rst-class:: classref-item-separator
  169. ----
  170. .. _class_Vector2i_property_y:
  171. .. rst-class:: classref-property
  172. :ref:`int<class_int>` **y** = ``0``
  173. The vector's Y component. Also accessible by using the index position ``[1]``.
  174. .. rst-class:: classref-section-separator
  175. ----
  176. .. rst-class:: classref-descriptions-group
  177. Constructor Descriptions
  178. ------------------------
  179. .. _class_Vector2i_constructor_Vector2i:
  180. .. rst-class:: classref-constructor
  181. :ref:`Vector2i<class_Vector2i>` **Vector2i** **(** **)**
  182. Constructs a default-initialized **Vector2i** with all components set to ``0``.
  183. .. rst-class:: classref-item-separator
  184. ----
  185. .. rst-class:: classref-constructor
  186. :ref:`Vector2i<class_Vector2i>` **Vector2i** **(** :ref:`Vector2i<class_Vector2i>` from **)**
  187. Constructs a **Vector2i** as a copy of the given **Vector2i**.
  188. .. rst-class:: classref-item-separator
  189. ----
  190. .. rst-class:: classref-constructor
  191. :ref:`Vector2i<class_Vector2i>` **Vector2i** **(** :ref:`Vector2<class_Vector2>` from **)**
  192. Constructs a new **Vector2i** from the given :ref:`Vector2<class_Vector2>` by truncating components' fractional parts (rounding towards zero). For a different behavior consider passing the result of :ref:`Vector2.ceil<class_Vector2_method_ceil>`, :ref:`Vector2.floor<class_Vector2_method_floor>` or :ref:`Vector2.round<class_Vector2_method_round>` to this constructor instead.
  193. .. rst-class:: classref-item-separator
  194. ----
  195. .. rst-class:: classref-constructor
  196. :ref:`Vector2i<class_Vector2i>` **Vector2i** **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y **)**
  197. Constructs a new **Vector2i** from the given ``x`` and ``y``.
  198. .. rst-class:: classref-section-separator
  199. ----
  200. .. rst-class:: classref-descriptions-group
  201. Method Descriptions
  202. -------------------
  203. .. _class_Vector2i_method_abs:
  204. .. rst-class:: classref-method
  205. :ref:`Vector2i<class_Vector2i>` **abs** **(** **)** |const|
  206. Returns a new vector with all components in absolute values (i.e. positive).
  207. .. rst-class:: classref-item-separator
  208. ----
  209. .. _class_Vector2i_method_aspect:
  210. .. rst-class:: classref-method
  211. :ref:`float<class_float>` **aspect** **(** **)** |const|
  212. Returns the aspect ratio of this vector, the ratio of :ref:`x<class_Vector2i_property_x>` to :ref:`y<class_Vector2i_property_y>`.
  213. .. rst-class:: classref-item-separator
  214. ----
  215. .. _class_Vector2i_method_clamp:
  216. .. rst-class:: classref-method
  217. :ref:`Vector2i<class_Vector2i>` **clamp** **(** :ref:`Vector2i<class_Vector2i>` min, :ref:`Vector2i<class_Vector2i>` max **)** |const|
  218. Returns a new vector with all components clamped between the components of ``min`` and ``max``, by running :ref:`@GlobalScope.clamp<class_@GlobalScope_method_clamp>` on each component.
  219. .. rst-class:: classref-item-separator
  220. ----
  221. .. _class_Vector2i_method_length:
  222. .. rst-class:: classref-method
  223. :ref:`float<class_float>` **length** **(** **)** |const|
  224. Returns the length (magnitude) of this vector.
  225. .. rst-class:: classref-item-separator
  226. ----
  227. .. _class_Vector2i_method_length_squared:
  228. .. rst-class:: classref-method
  229. :ref:`int<class_int>` **length_squared** **(** **)** |const|
  230. Returns the squared length (squared magnitude) of this vector.
  231. This method runs faster than :ref:`length<class_Vector2i_method_length>`, so prefer it if you need to compare vectors or need the squared distance for some formula.
  232. .. rst-class:: classref-item-separator
  233. ----
  234. .. _class_Vector2i_method_max_axis_index:
  235. .. rst-class:: classref-method
  236. :ref:`int<class_int>` **max_axis_index** **(** **)** |const|
  237. Returns the axis of the vector's highest value. See ``AXIS_*`` constants. If all components are equal, this method returns :ref:`AXIS_X<class_Vector2i_constant_AXIS_X>`.
  238. .. rst-class:: classref-item-separator
  239. ----
  240. .. _class_Vector2i_method_min_axis_index:
  241. .. rst-class:: classref-method
  242. :ref:`int<class_int>` **min_axis_index** **(** **)** |const|
  243. Returns the axis of the vector's lowest value. See ``AXIS_*`` constants. If all components are equal, this method returns :ref:`AXIS_Y<class_Vector2i_constant_AXIS_Y>`.
  244. .. rst-class:: classref-item-separator
  245. ----
  246. .. _class_Vector2i_method_sign:
  247. .. rst-class:: classref-method
  248. :ref:`Vector2i<class_Vector2i>` **sign** **(** **)** |const|
  249. Returns 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 :ref:`@GlobalScope.sign<class_@GlobalScope_method_sign>` on each component.
  250. .. rst-class:: classref-item-separator
  251. ----
  252. .. _class_Vector2i_method_snapped:
  253. .. rst-class:: classref-method
  254. :ref:`Vector2i<class_Vector2i>` **snapped** **(** :ref:`Vector2i<class_Vector2i>` step **)** |const|
  255. Returns a new vector with each component snapped to the closest multiple of the corresponding component in ``step``.
  256. .. rst-class:: classref-section-separator
  257. ----
  258. .. rst-class:: classref-descriptions-group
  259. Operator Descriptions
  260. ---------------------
  261. .. _class_Vector2i_operator_neq_Vector2i:
  262. .. rst-class:: classref-operator
  263. :ref:`bool<class_bool>` **operator !=** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  264. Returns ``true`` if the vectors are not equal.
  265. .. rst-class:: classref-item-separator
  266. ----
  267. .. _class_Vector2i_operator_mod_Vector2i:
  268. .. rst-class:: classref-operator
  269. :ref:`Vector2i<class_Vector2i>` **operator %** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  270. 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 :ref:`@GlobalScope.posmod<class_@GlobalScope_method_posmod>` instead if you want to handle negative numbers.
  271. ::
  272. print(Vector2i(10, -20) % Vector2i(7, 8)) # Prints "(3, -4)"
  273. .. rst-class:: classref-item-separator
  274. ----
  275. .. _class_Vector2i_operator_mod_int:
  276. .. rst-class:: classref-operator
  277. :ref:`Vector2i<class_Vector2i>` **operator %** **(** :ref:`int<class_int>` right **)**
  278. Gets the remainder of each component of the **Vector2i** with the given :ref:`int<class_int>`. This operation uses truncated division, which is often not desired as it does not work well with negative numbers. Consider using :ref:`@GlobalScope.posmod<class_@GlobalScope_method_posmod>` instead if you want to handle negative numbers.
  279. ::
  280. print(Vector2i(10, -20) % 7) # Prints "(3, -6)"
  281. .. rst-class:: classref-item-separator
  282. ----
  283. .. _class_Vector2i_operator_mul_Vector2i:
  284. .. rst-class:: classref-operator
  285. :ref:`Vector2i<class_Vector2i>` **operator *** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  286. Multiplies each component of the **Vector2i** by the components of the given **Vector2i**.
  287. ::
  288. print(Vector2i(10, 20) * Vector2i(3, 4)) # Prints "(30, 80)"
  289. .. rst-class:: classref-item-separator
  290. ----
  291. .. _class_Vector2i_operator_mul_float:
  292. .. rst-class:: classref-operator
  293. :ref:`Vector2<class_Vector2>` **operator *** **(** :ref:`float<class_float>` right **)**
  294. Multiplies each component of the **Vector2i** by the given :ref:`float<class_float>`. Returns a :ref:`Vector2<class_Vector2>`.
  295. ::
  296. print(Vector2i(10, 15) * 0.9) # Prints "(9, 13.5)"
  297. .. rst-class:: classref-item-separator
  298. ----
  299. .. _class_Vector2i_operator_mul_int:
  300. .. rst-class:: classref-operator
  301. :ref:`Vector2i<class_Vector2i>` **operator *** **(** :ref:`int<class_int>` right **)**
  302. Multiplies each component of the **Vector2i** by the given :ref:`int<class_int>`.
  303. .. rst-class:: classref-item-separator
  304. ----
  305. .. _class_Vector2i_operator_sum_Vector2i:
  306. .. rst-class:: classref-operator
  307. :ref:`Vector2i<class_Vector2i>` **operator +** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  308. Adds each component of the **Vector2i** by the components of the given **Vector2i**.
  309. ::
  310. print(Vector2i(10, 20) + Vector2i(3, 4)) # Prints "(13, 24)"
  311. .. rst-class:: classref-item-separator
  312. ----
  313. .. _class_Vector2i_operator_dif_Vector2i:
  314. .. rst-class:: classref-operator
  315. :ref:`Vector2i<class_Vector2i>` **operator -** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  316. Subtracts each component of the **Vector2i** by the components of the given **Vector2i**.
  317. ::
  318. print(Vector2i(10, 20) - Vector2i(3, 4)) # Prints "(7, 16)"
  319. .. rst-class:: classref-item-separator
  320. ----
  321. .. _class_Vector2i_operator_div_Vector2i:
  322. .. rst-class:: classref-operator
  323. :ref:`Vector2i<class_Vector2i>` **operator /** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  324. Divides each component of the **Vector2i** by the components of the given **Vector2i**.
  325. ::
  326. print(Vector2i(10, 20) / Vector2i(2, 5)) # Prints "(5, 4)"
  327. .. rst-class:: classref-item-separator
  328. ----
  329. .. _class_Vector2i_operator_div_float:
  330. .. rst-class:: classref-operator
  331. :ref:`Vector2<class_Vector2>` **operator /** **(** :ref:`float<class_float>` right **)**
  332. Divides each component of the **Vector2i** by the given :ref:`float<class_float>`. Returns a :ref:`Vector2<class_Vector2>`.
  333. ::
  334. print(Vector2i(10, 20) / 2.9) # Prints "(5, 10)"
  335. .. rst-class:: classref-item-separator
  336. ----
  337. .. _class_Vector2i_operator_div_int:
  338. .. rst-class:: classref-operator
  339. :ref:`Vector2i<class_Vector2i>` **operator /** **(** :ref:`int<class_int>` right **)**
  340. Divides each component of the **Vector2i** by the given :ref:`int<class_int>`.
  341. .. rst-class:: classref-item-separator
  342. ----
  343. .. _class_Vector2i_operator_lt_Vector2i:
  344. .. rst-class:: classref-operator
  345. :ref:`bool<class_bool>` **operator <** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  346. 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.
  347. .. rst-class:: classref-item-separator
  348. ----
  349. .. _class_Vector2i_operator_lte_Vector2i:
  350. .. rst-class:: classref-operator
  351. :ref:`bool<class_bool>` **operator <=** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  352. 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.
  353. .. rst-class:: classref-item-separator
  354. ----
  355. .. _class_Vector2i_operator_eq_Vector2i:
  356. .. rst-class:: classref-operator
  357. :ref:`bool<class_bool>` **operator ==** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  358. Returns ``true`` if the vectors are equal.
  359. .. rst-class:: classref-item-separator
  360. ----
  361. .. _class_Vector2i_operator_gt_Vector2i:
  362. .. rst-class:: classref-operator
  363. :ref:`bool<class_bool>` **operator >** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  364. 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.
  365. .. rst-class:: classref-item-separator
  366. ----
  367. .. _class_Vector2i_operator_gte_Vector2i:
  368. .. rst-class:: classref-operator
  369. :ref:`bool<class_bool>` **operator >=** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  370. 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.
  371. .. rst-class:: classref-item-separator
  372. ----
  373. .. _class_Vector2i_operator_idx_int:
  374. .. rst-class:: classref-operator
  375. :ref:`int<class_int>` **operator []** **(** :ref:`int<class_int>` index **)**
  376. Access vector components using their ``index``. ``v[0]`` is equivalent to ``v.x``, and ``v[1]`` is equivalent to ``v.y``.
  377. .. rst-class:: classref-item-separator
  378. ----
  379. .. _class_Vector2i_operator_unplus:
  380. .. rst-class:: classref-operator
  381. :ref:`Vector2i<class_Vector2i>` **operator unary+** **(** **)**
  382. Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable.
  383. .. rst-class:: classref-item-separator
  384. ----
  385. .. _class_Vector2i_operator_unminus:
  386. .. rst-class:: classref-operator
  387. :ref:`Vector2i<class_Vector2i>` **operator unary-** **(** **)**
  388. 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.
  389. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  390. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  391. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  392. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  393. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  394. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  395. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`