class_vector2i.rst 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680
  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.0/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/4.0/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_LEFT:
  136. .. rst-class:: classref-constant
  137. **LEFT** = ``Vector2i(-1, 0)``
  138. Left unit vector. Represents the direction of left.
  139. .. _class_Vector2i_constant_RIGHT:
  140. .. rst-class:: classref-constant
  141. **RIGHT** = ``Vector2i(1, 0)``
  142. Right unit vector. Represents the direction of right.
  143. .. _class_Vector2i_constant_UP:
  144. .. rst-class:: classref-constant
  145. **UP** = ``Vector2i(0, -1)``
  146. Up unit vector. Y is down in 2D, so this vector points -Y.
  147. .. _class_Vector2i_constant_DOWN:
  148. .. rst-class:: classref-constant
  149. **DOWN** = ``Vector2i(0, 1)``
  150. Down unit vector. Y is down in 2D, so this vector points +Y.
  151. .. rst-class:: classref-section-separator
  152. ----
  153. .. rst-class:: classref-descriptions-group
  154. Property Descriptions
  155. ---------------------
  156. .. _class_Vector2i_property_x:
  157. .. rst-class:: classref-property
  158. :ref:`int<class_int>` **x** = ``0``
  159. The vector's X component. Also accessible by using the index position ``[0]``.
  160. .. rst-class:: classref-item-separator
  161. ----
  162. .. _class_Vector2i_property_y:
  163. .. rst-class:: classref-property
  164. :ref:`int<class_int>` **y** = ``0``
  165. The vector's Y component. Also accessible by using the index position ``[1]``.
  166. .. rst-class:: classref-section-separator
  167. ----
  168. .. rst-class:: classref-descriptions-group
  169. Constructor Descriptions
  170. ------------------------
  171. .. _class_Vector2i_constructor_Vector2i:
  172. .. rst-class:: classref-constructor
  173. :ref:`Vector2i<class_Vector2i>` **Vector2i** **(** **)**
  174. Constructs a default-initialized **Vector2i** with all components set to ``0``.
  175. .. rst-class:: classref-item-separator
  176. ----
  177. .. rst-class:: classref-constructor
  178. :ref:`Vector2i<class_Vector2i>` **Vector2i** **(** :ref:`Vector2i<class_Vector2i>` from **)**
  179. Constructs a **Vector2i** as a copy of the given **Vector2i**.
  180. .. rst-class:: classref-item-separator
  181. ----
  182. .. rst-class:: classref-constructor
  183. :ref:`Vector2i<class_Vector2i>` **Vector2i** **(** :ref:`Vector2<class_Vector2>` from **)**
  184. 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.
  185. .. rst-class:: classref-item-separator
  186. ----
  187. .. rst-class:: classref-constructor
  188. :ref:`Vector2i<class_Vector2i>` **Vector2i** **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y **)**
  189. Constructs a new **Vector2i** from the given ``x`` and ``y``.
  190. .. rst-class:: classref-section-separator
  191. ----
  192. .. rst-class:: classref-descriptions-group
  193. Method Descriptions
  194. -------------------
  195. .. _class_Vector2i_method_abs:
  196. .. rst-class:: classref-method
  197. :ref:`Vector2i<class_Vector2i>` **abs** **(** **)** |const|
  198. Returns a new vector with all components in absolute values (i.e. positive).
  199. .. rst-class:: classref-item-separator
  200. ----
  201. .. _class_Vector2i_method_aspect:
  202. .. rst-class:: classref-method
  203. :ref:`float<class_float>` **aspect** **(** **)** |const|
  204. Returns the aspect ratio of this vector, the ratio of :ref:`x<class_Vector2i_property_x>` to :ref:`y<class_Vector2i_property_y>`.
  205. .. rst-class:: classref-item-separator
  206. ----
  207. .. _class_Vector2i_method_clamp:
  208. .. rst-class:: classref-method
  209. :ref:`Vector2i<class_Vector2i>` **clamp** **(** :ref:`Vector2i<class_Vector2i>` min, :ref:`Vector2i<class_Vector2i>` max **)** |const|
  210. 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.
  211. .. rst-class:: classref-item-separator
  212. ----
  213. .. _class_Vector2i_method_length:
  214. .. rst-class:: classref-method
  215. :ref:`float<class_float>` **length** **(** **)** |const|
  216. Returns the length (magnitude) of this vector.
  217. .. rst-class:: classref-item-separator
  218. ----
  219. .. _class_Vector2i_method_length_squared:
  220. .. rst-class:: classref-method
  221. :ref:`int<class_int>` **length_squared** **(** **)** |const|
  222. Returns the squared length (squared magnitude) of this vector.
  223. 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.
  224. .. rst-class:: classref-item-separator
  225. ----
  226. .. _class_Vector2i_method_max_axis_index:
  227. .. rst-class:: classref-method
  228. :ref:`int<class_int>` **max_axis_index** **(** **)** |const|
  229. 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>`.
  230. .. rst-class:: classref-item-separator
  231. ----
  232. .. _class_Vector2i_method_min_axis_index:
  233. .. rst-class:: classref-method
  234. :ref:`int<class_int>` **min_axis_index** **(** **)** |const|
  235. 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>`.
  236. .. rst-class:: classref-item-separator
  237. ----
  238. .. _class_Vector2i_method_sign:
  239. .. rst-class:: classref-method
  240. :ref:`Vector2i<class_Vector2i>` **sign** **(** **)** |const|
  241. 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.
  242. .. rst-class:: classref-item-separator
  243. ----
  244. .. _class_Vector2i_method_snapped:
  245. .. rst-class:: classref-method
  246. :ref:`Vector2i<class_Vector2i>` **snapped** **(** :ref:`Vector2i<class_Vector2i>` step **)** |const|
  247. Returns a new vector with each component snapped to the closest multiple of the corresponding component in ``step``.
  248. .. rst-class:: classref-section-separator
  249. ----
  250. .. rst-class:: classref-descriptions-group
  251. Operator Descriptions
  252. ---------------------
  253. .. _class_Vector2i_operator_neq_Vector2i:
  254. .. rst-class:: classref-operator
  255. :ref:`bool<class_bool>` **operator !=** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  256. Returns ``true`` if the vectors are not equal.
  257. .. rst-class:: classref-item-separator
  258. ----
  259. .. _class_Vector2i_operator_mod_Vector2i:
  260. .. rst-class:: classref-operator
  261. :ref:`Vector2i<class_Vector2i>` **operator %** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  262. 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.
  263. ::
  264. print(Vector2i(10, -20) % Vector2i(7, 8)) # Prints "(3, -4)"
  265. .. rst-class:: classref-item-separator
  266. ----
  267. .. _class_Vector2i_operator_mod_int:
  268. .. rst-class:: classref-operator
  269. :ref:`Vector2i<class_Vector2i>` **operator %** **(** :ref:`int<class_int>` right **)**
  270. 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.
  271. ::
  272. print(Vector2i(10, -20) % 7) # Prints "(3, -6)"
  273. .. rst-class:: classref-item-separator
  274. ----
  275. .. _class_Vector2i_operator_mul_Vector2i:
  276. .. rst-class:: classref-operator
  277. :ref:`Vector2i<class_Vector2i>` **operator *** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  278. Multiplies each component of the **Vector2i** by the components of the given **Vector2i**.
  279. ::
  280. print(Vector2i(10, 20) * Vector2i(3, 4)) # Prints "(30, 80)"
  281. .. rst-class:: classref-item-separator
  282. ----
  283. .. _class_Vector2i_operator_mul_float:
  284. .. rst-class:: classref-operator
  285. :ref:`Vector2<class_Vector2>` **operator *** **(** :ref:`float<class_float>` right **)**
  286. Multiplies each component of the **Vector2i** by the given :ref:`float<class_float>`. Returns a :ref:`Vector2<class_Vector2>`.
  287. ::
  288. print(Vector2i(10, 15) * 0.9) # Prints "(9, 13.5)"
  289. .. rst-class:: classref-item-separator
  290. ----
  291. .. _class_Vector2i_operator_mul_int:
  292. .. rst-class:: classref-operator
  293. :ref:`Vector2i<class_Vector2i>` **operator *** **(** :ref:`int<class_int>` right **)**
  294. Multiplies each component of the **Vector2i** by the given :ref:`int<class_int>`.
  295. .. rst-class:: classref-item-separator
  296. ----
  297. .. _class_Vector2i_operator_sum_Vector2i:
  298. .. rst-class:: classref-operator
  299. :ref:`Vector2i<class_Vector2i>` **operator +** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  300. Adds each component of the **Vector2i** by the components of the given **Vector2i**.
  301. ::
  302. print(Vector2i(10, 20) + Vector2i(3, 4)) # Prints "(13, 24)"
  303. .. rst-class:: classref-item-separator
  304. ----
  305. .. _class_Vector2i_operator_dif_Vector2i:
  306. .. rst-class:: classref-operator
  307. :ref:`Vector2i<class_Vector2i>` **operator -** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  308. Subtracts each component of the **Vector2i** by the components of the given **Vector2i**.
  309. ::
  310. print(Vector2i(10, 20) - Vector2i(3, 4)) # Prints "(7, 16)"
  311. .. rst-class:: classref-item-separator
  312. ----
  313. .. _class_Vector2i_operator_div_Vector2i:
  314. .. rst-class:: classref-operator
  315. :ref:`Vector2i<class_Vector2i>` **operator /** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  316. Divides each component of the **Vector2i** by the components of the given **Vector2i**.
  317. ::
  318. print(Vector2i(10, 20) / Vector2i(2, 5)) # Prints "(5, 4)"
  319. .. rst-class:: classref-item-separator
  320. ----
  321. .. _class_Vector2i_operator_div_float:
  322. .. rst-class:: classref-operator
  323. :ref:`Vector2<class_Vector2>` **operator /** **(** :ref:`float<class_float>` right **)**
  324. Divides each component of the **Vector2i** by the given :ref:`float<class_float>`. Returns a :ref:`Vector2<class_Vector2>`.
  325. ::
  326. print(Vector2i(10, 20) / 2.9) # Prints "(5, 10)"
  327. .. rst-class:: classref-item-separator
  328. ----
  329. .. _class_Vector2i_operator_div_int:
  330. .. rst-class:: classref-operator
  331. :ref:`Vector2i<class_Vector2i>` **operator /** **(** :ref:`int<class_int>` right **)**
  332. Divides each component of the **Vector2i** by the given :ref:`int<class_int>`.
  333. .. rst-class:: classref-item-separator
  334. ----
  335. .. _class_Vector2i_operator_lt_Vector2i:
  336. .. rst-class:: classref-operator
  337. :ref:`bool<class_bool>` **operator <** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  338. 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.
  339. .. rst-class:: classref-item-separator
  340. ----
  341. .. _class_Vector2i_operator_lte_Vector2i:
  342. .. rst-class:: classref-operator
  343. :ref:`bool<class_bool>` **operator <=** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  344. 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.
  345. .. rst-class:: classref-item-separator
  346. ----
  347. .. _class_Vector2i_operator_eq_Vector2i:
  348. .. rst-class:: classref-operator
  349. :ref:`bool<class_bool>` **operator ==** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  350. Returns ``true`` if the vectors are equal.
  351. .. rst-class:: classref-item-separator
  352. ----
  353. .. _class_Vector2i_operator_gt_Vector2i:
  354. .. rst-class:: classref-operator
  355. :ref:`bool<class_bool>` **operator >** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  356. 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.
  357. .. rst-class:: classref-item-separator
  358. ----
  359. .. _class_Vector2i_operator_gte_Vector2i:
  360. .. rst-class:: classref-operator
  361. :ref:`bool<class_bool>` **operator >=** **(** :ref:`Vector2i<class_Vector2i>` right **)**
  362. 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.
  363. .. rst-class:: classref-item-separator
  364. ----
  365. .. _class_Vector2i_operator_idx_int:
  366. .. rst-class:: classref-operator
  367. :ref:`int<class_int>` **operator []** **(** :ref:`int<class_int>` index **)**
  368. Access vector components using their ``index``. ``v[0]`` is equivalent to ``v.x``, and ``v[1]`` is equivalent to ``v.y``.
  369. .. rst-class:: classref-item-separator
  370. ----
  371. .. _class_Vector2i_operator_unplus:
  372. .. rst-class:: classref-operator
  373. :ref:`Vector2i<class_Vector2i>` **operator unary+** **(** **)**
  374. Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable.
  375. .. rst-class:: classref-item-separator
  376. ----
  377. .. _class_Vector2i_operator_unminus:
  378. .. rst-class:: classref-operator
  379. :ref:`Vector2i<class_Vector2i>` **operator unary-** **(** **)**
  380. 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.
  381. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  382. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  383. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  384. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  385. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  386. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`