class_vector4i.rst 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688
  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/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Vector4i.xml.
  6. .. _class_Vector4i:
  7. Vector4i
  8. ========
  9. A 4D vector using integer coordinates.
  10. .. rst-class:: classref-introduction-group
  11. Description
  12. -----------
  13. A 4-element structure that can be used to represent 4D grid coordinates or any other quadruplet of integers.
  14. It uses integer coordinates and is therefore preferable to :ref:`Vector4<class_Vector4>` when exact precision is required. Note that the values are limited to 32 bits, and unlike :ref:`Vector4<class_Vector4>` 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 Vector4i will evaluate to ``false`` if it's equal to ``Vector4i(0, 0, 0, 0)``. Otherwise, a Vector3i will always evaluate to ``true``.
  16. .. rst-class:: classref-reftable-group
  17. Properties
  18. ----------
  19. .. table::
  20. :widths: auto
  21. +-----------------------+-------------------------------------+-------+
  22. | :ref:`int<class_int>` | :ref:`w<class_Vector4i_property_w>` | ``0`` |
  23. +-----------------------+-------------------------------------+-------+
  24. | :ref:`int<class_int>` | :ref:`x<class_Vector4i_property_x>` | ``0`` |
  25. +-----------------------+-------------------------------------+-------+
  26. | :ref:`int<class_int>` | :ref:`y<class_Vector4i_property_y>` | ``0`` |
  27. +-----------------------+-------------------------------------+-------+
  28. | :ref:`int<class_int>` | :ref:`z<class_Vector4i_property_z>` | ``0`` |
  29. +-----------------------+-------------------------------------+-------+
  30. .. rst-class:: classref-reftable-group
  31. Constructors
  32. ------------
  33. .. table::
  34. :widths: auto
  35. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  36. | :ref:`Vector4i<class_Vector4i>` | :ref:`Vector4i<class_Vector4i_constructor_Vector4i>` **(** **)** |
  37. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  38. | :ref:`Vector4i<class_Vector4i>` | :ref:`Vector4i<class_Vector4i_constructor_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` from **)** |
  39. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`Vector4i<class_Vector4i>` | :ref:`Vector4i<class_Vector4i_constructor_Vector4i>` **(** :ref:`Vector4<class_Vector4>` from **)** |
  41. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`Vector4i<class_Vector4i>` | :ref:`Vector4i<class_Vector4i_constructor_Vector4i>` **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y, :ref:`int<class_int>` z, :ref:`int<class_int>` w **)** |
  43. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  44. .. rst-class:: classref-reftable-group
  45. Methods
  46. -------
  47. .. table::
  48. :widths: auto
  49. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  50. | :ref:`Vector4i<class_Vector4i>` | :ref:`abs<class_Vector4i_method_abs>` **(** **)** |const| |
  51. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  52. | :ref:`Vector4i<class_Vector4i>` | :ref:`clamp<class_Vector4i_method_clamp>` **(** :ref:`Vector4i<class_Vector4i>` min, :ref:`Vector4i<class_Vector4i>` max **)** |const| |
  53. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  54. | :ref:`float<class_float>` | :ref:`length<class_Vector4i_method_length>` **(** **)** |const| |
  55. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`int<class_int>` | :ref:`length_squared<class_Vector4i_method_length_squared>` **(** **)** |const| |
  57. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`int<class_int>` | :ref:`max_axis_index<class_Vector4i_method_max_axis_index>` **(** **)** |const| |
  59. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`int<class_int>` | :ref:`min_axis_index<class_Vector4i_method_min_axis_index>` **(** **)** |const| |
  61. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`Vector4i<class_Vector4i>` | :ref:`sign<class_Vector4i_method_sign>` **(** **)** |const| |
  63. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`Vector4i<class_Vector4i>` | :ref:`snapped<class_Vector4i_method_snapped>` **(** :ref:`Vector4i<class_Vector4i>` step **)** |const| |
  65. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  66. .. rst-class:: classref-reftable-group
  67. Operators
  68. ---------
  69. .. table::
  70. :widths: auto
  71. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  72. | :ref:`bool<class_bool>` | :ref:`operator !=<class_Vector4i_operator_neq_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  73. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  74. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator %<class_Vector4i_operator_mod_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  75. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  76. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator %<class_Vector4i_operator_mod_int>` **(** :ref:`int<class_int>` right **)** |
  77. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  78. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator *<class_Vector4i_operator_mul_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  79. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  80. | :ref:`Vector4<class_Vector4>` | :ref:`operator *<class_Vector4i_operator_mul_float>` **(** :ref:`float<class_float>` right **)** |
  81. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  82. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator *<class_Vector4i_operator_mul_int>` **(** :ref:`int<class_int>` right **)** |
  83. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  84. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator +<class_Vector4i_operator_sum_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  85. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  86. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator -<class_Vector4i_operator_dif_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  87. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  88. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator /<class_Vector4i_operator_div_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  89. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  90. | :ref:`Vector4<class_Vector4>` | :ref:`operator /<class_Vector4i_operator_div_float>` **(** :ref:`float<class_float>` right **)** |
  91. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  92. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator /<class_Vector4i_operator_div_int>` **(** :ref:`int<class_int>` right **)** |
  93. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  94. | :ref:`bool<class_bool>` | :ref:`operator \<<class_Vector4i_operator_lt_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  95. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  96. | :ref:`bool<class_bool>` | :ref:`operator \<=<class_Vector4i_operator_lte_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  97. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  98. | :ref:`bool<class_bool>` | :ref:`operator ==<class_Vector4i_operator_eq_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  99. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  100. | :ref:`bool<class_bool>` | :ref:`operator ><class_Vector4i_operator_gt_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  101. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  102. | :ref:`bool<class_bool>` | :ref:`operator >=<class_Vector4i_operator_gte_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  103. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  104. | :ref:`int<class_int>` | :ref:`operator []<class_Vector4i_operator_idx_int>` **(** :ref:`int<class_int>` index **)** |
  105. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  106. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator unary+<class_Vector4i_operator_unplus>` **(** **)** |
  107. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  108. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator unary-<class_Vector4i_operator_unminus>` **(** **)** |
  109. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  110. .. rst-class:: classref-section-separator
  111. ----
  112. .. rst-class:: classref-descriptions-group
  113. Constants
  114. ---------
  115. .. _class_Vector4i_constant_AXIS_X:
  116. .. rst-class:: classref-constant
  117. **AXIS_X** = ``0``
  118. Enumerated value for the X axis. Returned by :ref:`max_axis_index<class_Vector4i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector4i_method_min_axis_index>`.
  119. .. _class_Vector4i_constant_AXIS_Y:
  120. .. rst-class:: classref-constant
  121. **AXIS_Y** = ``1``
  122. Enumerated value for the Y axis. Returned by :ref:`max_axis_index<class_Vector4i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector4i_method_min_axis_index>`.
  123. .. _class_Vector4i_constant_AXIS_Z:
  124. .. rst-class:: classref-constant
  125. **AXIS_Z** = ``2``
  126. Enumerated value for the Z axis. Returned by :ref:`max_axis_index<class_Vector4i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector4i_method_min_axis_index>`.
  127. .. _class_Vector4i_constant_AXIS_W:
  128. .. rst-class:: classref-constant
  129. **AXIS_W** = ``3``
  130. Enumerated value for the W axis. Returned by :ref:`max_axis_index<class_Vector4i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector4i_method_min_axis_index>`.
  131. .. _class_Vector4i_constant_ZERO:
  132. .. rst-class:: classref-constant
  133. **ZERO** = ``Vector4i(0, 0, 0, 0)``
  134. Zero vector, a vector with all components set to ``0``.
  135. .. _class_Vector4i_constant_ONE:
  136. .. rst-class:: classref-constant
  137. **ONE** = ``Vector4i(1, 1, 1, 1)``
  138. One vector, a vector with all components set to ``1``.
  139. .. _class_Vector4i_constant_MIN:
  140. .. rst-class:: classref-constant
  141. **MIN** = ``Vector4i(-2147483648, -2147483648, -2147483648, -2147483648)``
  142. Min vector, a vector with all components equal to ``INT32_MIN``. Can be used as a negative integer equivalent of :ref:`Vector4.INF<class_Vector4_constant_INF>`.
  143. .. _class_Vector4i_constant_MAX:
  144. .. rst-class:: classref-constant
  145. **MAX** = ``Vector4i(2147483647, 2147483647, 2147483647, 2147483647)``
  146. Max vector, a vector with all components equal to ``INT32_MAX``. Can be used as an integer equivalent of :ref:`Vector4.INF<class_Vector4_constant_INF>`.
  147. .. rst-class:: classref-section-separator
  148. ----
  149. .. rst-class:: classref-descriptions-group
  150. Property Descriptions
  151. ---------------------
  152. .. _class_Vector4i_property_w:
  153. .. rst-class:: classref-property
  154. :ref:`int<class_int>` **w** = ``0``
  155. The vector's W component. Also accessible by using the index position ``[3]``.
  156. .. rst-class:: classref-item-separator
  157. ----
  158. .. _class_Vector4i_property_x:
  159. .. rst-class:: classref-property
  160. :ref:`int<class_int>` **x** = ``0``
  161. The vector's X component. Also accessible by using the index position ``[0]``.
  162. .. rst-class:: classref-item-separator
  163. ----
  164. .. _class_Vector4i_property_y:
  165. .. rst-class:: classref-property
  166. :ref:`int<class_int>` **y** = ``0``
  167. The vector's Y component. Also accessible by using the index position ``[1]``.
  168. .. rst-class:: classref-item-separator
  169. ----
  170. .. _class_Vector4i_property_z:
  171. .. rst-class:: classref-property
  172. :ref:`int<class_int>` **z** = ``0``
  173. The vector's Z component. Also accessible by using the index position ``[2]``.
  174. .. rst-class:: classref-section-separator
  175. ----
  176. .. rst-class:: classref-descriptions-group
  177. Constructor Descriptions
  178. ------------------------
  179. .. _class_Vector4i_constructor_Vector4i:
  180. .. rst-class:: classref-constructor
  181. :ref:`Vector4i<class_Vector4i>` **Vector4i** **(** **)**
  182. Constructs a default-initialized **Vector4i** with all components set to ``0``.
  183. .. rst-class:: classref-item-separator
  184. ----
  185. .. rst-class:: classref-constructor
  186. :ref:`Vector4i<class_Vector4i>` **Vector4i** **(** :ref:`Vector4i<class_Vector4i>` from **)**
  187. Constructs a **Vector4i** as a copy of the given **Vector4i**.
  188. .. rst-class:: classref-item-separator
  189. ----
  190. .. rst-class:: classref-constructor
  191. :ref:`Vector4i<class_Vector4i>` **Vector4i** **(** :ref:`Vector4<class_Vector4>` from **)**
  192. Constructs a new **Vector4i** from the given :ref:`Vector4<class_Vector4>` by truncating components' fractional parts (rounding towards zero). For a different behavior consider passing the result of :ref:`Vector4.ceil<class_Vector4_method_ceil>`, :ref:`Vector4.floor<class_Vector4_method_floor>` or :ref:`Vector4.round<class_Vector4_method_round>` to this constructor instead.
  193. .. rst-class:: classref-item-separator
  194. ----
  195. .. rst-class:: classref-constructor
  196. :ref:`Vector4i<class_Vector4i>` **Vector4i** **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y, :ref:`int<class_int>` z, :ref:`int<class_int>` w **)**
  197. Returns a **Vector4i** with the given components.
  198. .. rst-class:: classref-section-separator
  199. ----
  200. .. rst-class:: classref-descriptions-group
  201. Method Descriptions
  202. -------------------
  203. .. _class_Vector4i_method_abs:
  204. .. rst-class:: classref-method
  205. :ref:`Vector4i<class_Vector4i>` **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_Vector4i_method_clamp:
  210. .. rst-class:: classref-method
  211. :ref:`Vector4i<class_Vector4i>` **clamp** **(** :ref:`Vector4i<class_Vector4i>` min, :ref:`Vector4i<class_Vector4i>` max **)** |const|
  212. 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.
  213. .. rst-class:: classref-item-separator
  214. ----
  215. .. _class_Vector4i_method_length:
  216. .. rst-class:: classref-method
  217. :ref:`float<class_float>` **length** **(** **)** |const|
  218. Returns the length (magnitude) of this vector.
  219. .. rst-class:: classref-item-separator
  220. ----
  221. .. _class_Vector4i_method_length_squared:
  222. .. rst-class:: classref-method
  223. :ref:`int<class_int>` **length_squared** **(** **)** |const|
  224. Returns the squared length (squared magnitude) of this vector.
  225. This method runs faster than :ref:`length<class_Vector4i_method_length>`, so prefer it if you need to compare vectors or need the squared distance for some formula.
  226. .. rst-class:: classref-item-separator
  227. ----
  228. .. _class_Vector4i_method_max_axis_index:
  229. .. rst-class:: classref-method
  230. :ref:`int<class_int>` **max_axis_index** **(** **)** |const|
  231. Returns the axis of the vector's highest value. See ``AXIS_*`` constants. If all components are equal, this method returns :ref:`AXIS_X<class_Vector4i_constant_AXIS_X>`.
  232. .. rst-class:: classref-item-separator
  233. ----
  234. .. _class_Vector4i_method_min_axis_index:
  235. .. rst-class:: classref-method
  236. :ref:`int<class_int>` **min_axis_index** **(** **)** |const|
  237. Returns the axis of the vector's lowest value. See ``AXIS_*`` constants. If all components are equal, this method returns :ref:`AXIS_W<class_Vector4i_constant_AXIS_W>`.
  238. .. rst-class:: classref-item-separator
  239. ----
  240. .. _class_Vector4i_method_sign:
  241. .. rst-class:: classref-method
  242. :ref:`Vector4i<class_Vector4i>` **sign** **(** **)** |const|
  243. 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.
  244. .. rst-class:: classref-item-separator
  245. ----
  246. .. _class_Vector4i_method_snapped:
  247. .. rst-class:: classref-method
  248. :ref:`Vector4i<class_Vector4i>` **snapped** **(** :ref:`Vector4i<class_Vector4i>` step **)** |const|
  249. Returns a new vector with each component snapped to the closest multiple of the corresponding component in ``step``.
  250. .. rst-class:: classref-section-separator
  251. ----
  252. .. rst-class:: classref-descriptions-group
  253. Operator Descriptions
  254. ---------------------
  255. .. _class_Vector4i_operator_neq_Vector4i:
  256. .. rst-class:: classref-operator
  257. :ref:`bool<class_bool>` **operator !=** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  258. Returns ``true`` if the vectors are not equal.
  259. .. rst-class:: classref-item-separator
  260. ----
  261. .. _class_Vector4i_operator_mod_Vector4i:
  262. .. rst-class:: classref-operator
  263. :ref:`Vector4i<class_Vector4i>` **operator %** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  264. Gets the remainder of each component of the **Vector4i** with the components of the given **Vector4i**. 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.
  265. ::
  266. print(Vector4i(10, -20, 30, -40) % Vector4i(7, 8, 9, 10)) # Prints "(3, -4, 3, 0)"
  267. .. rst-class:: classref-item-separator
  268. ----
  269. .. _class_Vector4i_operator_mod_int:
  270. .. rst-class:: classref-operator
  271. :ref:`Vector4i<class_Vector4i>` **operator %** **(** :ref:`int<class_int>` right **)**
  272. Gets the remainder of each component of the **Vector4i** with the 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.
  273. ::
  274. print(Vector4i(10, -20, 30, -40) % 7) # Prints "(3, -6, 2, -5)"
  275. .. rst-class:: classref-item-separator
  276. ----
  277. .. _class_Vector4i_operator_mul_Vector4i:
  278. .. rst-class:: classref-operator
  279. :ref:`Vector4i<class_Vector4i>` **operator *** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  280. Multiplies each component of the **Vector4i** by the components of the given **Vector4i**.
  281. ::
  282. print(Vector4i(10, 20, 30, 40) * Vector4i(3, 4, 5, 6)) # Prints "(30, 80, 150, 240)"
  283. .. rst-class:: classref-item-separator
  284. ----
  285. .. _class_Vector4i_operator_mul_float:
  286. .. rst-class:: classref-operator
  287. :ref:`Vector4<class_Vector4>` **operator *** **(** :ref:`float<class_float>` right **)**
  288. Multiplies each component of the **Vector4i** by the given :ref:`float<class_float>`.
  289. Returns a Vector4 value due to floating-point operations.
  290. ::
  291. print(Vector4i(10, 20, 30, 40) * 2) # Prints "(20, 40, 60, 80)"
  292. .. rst-class:: classref-item-separator
  293. ----
  294. .. _class_Vector4i_operator_mul_int:
  295. .. rst-class:: classref-operator
  296. :ref:`Vector4i<class_Vector4i>` **operator *** **(** :ref:`int<class_int>` right **)**
  297. Multiplies each component of the **Vector4i** by the given :ref:`int<class_int>`.
  298. .. rst-class:: classref-item-separator
  299. ----
  300. .. _class_Vector4i_operator_sum_Vector4i:
  301. .. rst-class:: classref-operator
  302. :ref:`Vector4i<class_Vector4i>` **operator +** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  303. Adds each component of the **Vector4i** by the components of the given **Vector4i**.
  304. ::
  305. print(Vector4i(10, 20, 30, 40) + Vector4i(3, 4, 5, 6)) # Prints "(13, 24, 35, 46)"
  306. .. rst-class:: classref-item-separator
  307. ----
  308. .. _class_Vector4i_operator_dif_Vector4i:
  309. .. rst-class:: classref-operator
  310. :ref:`Vector4i<class_Vector4i>` **operator -** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  311. Subtracts each component of the **Vector4i** by the components of the given **Vector4i**.
  312. ::
  313. print(Vector4i(10, 20, 30, 40) - Vector4i(3, 4, 5, 6)) # Prints "(7, 16, 25, 34)"
  314. .. rst-class:: classref-item-separator
  315. ----
  316. .. _class_Vector4i_operator_div_Vector4i:
  317. .. rst-class:: classref-operator
  318. :ref:`Vector4i<class_Vector4i>` **operator /** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  319. Divides each component of the **Vector4i** by the components of the given **Vector4i**.
  320. ::
  321. print(Vector4i(10, 20, 30, 40) / Vector4i(2, 5, 3, 4)) # Prints "(5, 4, 10, 10)"
  322. .. rst-class:: classref-item-separator
  323. ----
  324. .. _class_Vector4i_operator_div_float:
  325. .. rst-class:: classref-operator
  326. :ref:`Vector4<class_Vector4>` **operator /** **(** :ref:`float<class_float>` right **)**
  327. Divides each component of the **Vector4i** by the given :ref:`float<class_float>`.
  328. Returns a Vector4 value due to floating-point operations.
  329. ::
  330. print(Vector4i(10, 20, 30, 40) / 2 # Prints "(5, 10, 15, 20)"
  331. .. rst-class:: classref-item-separator
  332. ----
  333. .. _class_Vector4i_operator_div_int:
  334. .. rst-class:: classref-operator
  335. :ref:`Vector4i<class_Vector4i>` **operator /** **(** :ref:`int<class_int>` right **)**
  336. Divides each component of the **Vector4i** by the given :ref:`int<class_int>`.
  337. .. rst-class:: classref-item-separator
  338. ----
  339. .. _class_Vector4i_operator_lt_Vector4i:
  340. .. rst-class:: classref-operator
  341. :ref:`bool<class_bool>` **operator <** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  342. Compares two **Vector4i** 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, Z values of the two vectors, and then with the W values. This operator is useful for sorting vectors.
  343. .. rst-class:: classref-item-separator
  344. ----
  345. .. _class_Vector4i_operator_lte_Vector4i:
  346. .. rst-class:: classref-operator
  347. :ref:`bool<class_bool>` **operator <=** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  348. Compares two **Vector4i** 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, Z values of the two vectors, and then with the W values. This operator is useful for sorting vectors.
  349. .. rst-class:: classref-item-separator
  350. ----
  351. .. _class_Vector4i_operator_eq_Vector4i:
  352. .. rst-class:: classref-operator
  353. :ref:`bool<class_bool>` **operator ==** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  354. Returns ``true`` if the vectors are exactly equal.
  355. .. rst-class:: classref-item-separator
  356. ----
  357. .. _class_Vector4i_operator_gt_Vector4i:
  358. .. rst-class:: classref-operator
  359. :ref:`bool<class_bool>` **operator >** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  360. Compares two **Vector4i** 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, Z values of the two vectors, and then with the W values. This operator is useful for sorting vectors.
  361. .. rst-class:: classref-item-separator
  362. ----
  363. .. _class_Vector4i_operator_gte_Vector4i:
  364. .. rst-class:: classref-operator
  365. :ref:`bool<class_bool>` **operator >=** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  366. Compares two **Vector4i** 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, Z values of the two vectors, and then with the W values. This operator is useful for sorting vectors.
  367. .. rst-class:: classref-item-separator
  368. ----
  369. .. _class_Vector4i_operator_idx_int:
  370. .. rst-class:: classref-operator
  371. :ref:`int<class_int>` **operator []** **(** :ref:`int<class_int>` index **)**
  372. Access vector components using their ``index``. ``v[0]`` is equivalent to ``v.x``, ``v[1]`` is equivalent to ``v.y``, ``v[2]`` is equivalent to ``v.z``, and ``v[3]`` is equivalent to ``v.w``.
  373. .. rst-class:: classref-item-separator
  374. ----
  375. .. _class_Vector4i_operator_unplus:
  376. .. rst-class:: classref-operator
  377. :ref:`Vector4i<class_Vector4i>` **operator unary+** **(** **)**
  378. Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable.
  379. .. rst-class:: classref-item-separator
  380. ----
  381. .. _class_Vector4i_operator_unminus:
  382. .. rst-class:: classref-operator
  383. :ref:`Vector4i<class_Vector4i>` **operator unary-** **(** **)**
  384. Returns the negative value of the **Vector4i**. This is the same as writing ``Vector4i(-v.x, -v.y, -v.z, -v.w)``. This operation flips the direction of the vector while keeping the same magnitude.
  385. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  386. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  387. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  388. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  389. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  390. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  391. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`