class_vector4i.rst 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717
  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 Vector4i 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:`int<class_int>` | :ref:`distance_squared_to<class_Vector4i_method_distance_squared_to>` **(** :ref:`Vector4i<class_Vector4i>` to **)** |const| |
  55. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`float<class_float>` | :ref:`distance_to<class_Vector4i_method_distance_to>` **(** :ref:`Vector4i<class_Vector4i>` to **)** |const| |
  57. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`float<class_float>` | :ref:`length<class_Vector4i_method_length>` **(** **)** |const| |
  59. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`int<class_int>` | :ref:`length_squared<class_Vector4i_method_length_squared>` **(** **)** |const| |
  61. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`int<class_int>` | :ref:`max_axis_index<class_Vector4i_method_max_axis_index>` **(** **)** |const| |
  63. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`int<class_int>` | :ref:`min_axis_index<class_Vector4i_method_min_axis_index>` **(** **)** |const| |
  65. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`Vector4i<class_Vector4i>` | :ref:`sign<class_Vector4i_method_sign>` **(** **)** |const| |
  67. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  68. | :ref:`Vector4i<class_Vector4i>` | :ref:`snapped<class_Vector4i_method_snapped>` **(** :ref:`Vector4i<class_Vector4i>` 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_Vector4i_operator_neq_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  77. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  78. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator %<class_Vector4i_operator_mod_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  79. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  80. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator %<class_Vector4i_operator_mod_int>` **(** :ref:`int<class_int>` right **)** |
  81. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  82. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator *<class_Vector4i_operator_mul_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  83. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  84. | :ref:`Vector4<class_Vector4>` | :ref:`operator *<class_Vector4i_operator_mul_float>` **(** :ref:`float<class_float>` right **)** |
  85. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  86. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator *<class_Vector4i_operator_mul_int>` **(** :ref:`int<class_int>` right **)** |
  87. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  88. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator +<class_Vector4i_operator_sum_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  89. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  90. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator -<class_Vector4i_operator_dif_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  91. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  92. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator /<class_Vector4i_operator_div_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  93. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  94. | :ref:`Vector4<class_Vector4>` | :ref:`operator /<class_Vector4i_operator_div_float>` **(** :ref:`float<class_float>` right **)** |
  95. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  96. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator /<class_Vector4i_operator_div_int>` **(** :ref:`int<class_int>` right **)** |
  97. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  98. | :ref:`bool<class_bool>` | :ref:`operator \<<class_Vector4i_operator_lt_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  99. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  100. | :ref:`bool<class_bool>` | :ref:`operator \<=<class_Vector4i_operator_lte_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  101. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  102. | :ref:`bool<class_bool>` | :ref:`operator ==<class_Vector4i_operator_eq_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  103. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  104. | :ref:`bool<class_bool>` | :ref:`operator ><class_Vector4i_operator_gt_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  105. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  106. | :ref:`bool<class_bool>` | :ref:`operator >=<class_Vector4i_operator_gte_Vector4i>` **(** :ref:`Vector4i<class_Vector4i>` right **)** |
  107. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  108. | :ref:`int<class_int>` | :ref:`operator []<class_Vector4i_operator_idx_int>` **(** :ref:`int<class_int>` index **)** |
  109. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  110. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator unary+<class_Vector4i_operator_unplus>` **(** **)** |
  111. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  112. | :ref:`Vector4i<class_Vector4i>` | :ref:`operator unary-<class_Vector4i_operator_unminus>` **(** **)** |
  113. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  114. .. rst-class:: classref-section-separator
  115. ----
  116. .. rst-class:: classref-descriptions-group
  117. Constants
  118. ---------
  119. .. _class_Vector4i_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_Vector4i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector4i_method_min_axis_index>`.
  123. .. _class_Vector4i_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_Vector4i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector4i_method_min_axis_index>`.
  127. .. _class_Vector4i_constant_AXIS_Z:
  128. .. rst-class:: classref-constant
  129. **AXIS_Z** = ``2``
  130. 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>`.
  131. .. _class_Vector4i_constant_AXIS_W:
  132. .. rst-class:: classref-constant
  133. **AXIS_W** = ``3``
  134. 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>`.
  135. .. _class_Vector4i_constant_ZERO:
  136. .. rst-class:: classref-constant
  137. **ZERO** = ``Vector4i(0, 0, 0, 0)``
  138. Zero vector, a vector with all components set to ``0``.
  139. .. _class_Vector4i_constant_ONE:
  140. .. rst-class:: classref-constant
  141. **ONE** = ``Vector4i(1, 1, 1, 1)``
  142. One vector, a vector with all components set to ``1``.
  143. .. _class_Vector4i_constant_MIN:
  144. .. rst-class:: classref-constant
  145. **MIN** = ``Vector4i(-2147483648, -2147483648, -2147483648, -2147483648)``
  146. 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>`.
  147. .. _class_Vector4i_constant_MAX:
  148. .. rst-class:: classref-constant
  149. **MAX** = ``Vector4i(2147483647, 2147483647, 2147483647, 2147483647)``
  150. 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>`.
  151. .. rst-class:: classref-section-separator
  152. ----
  153. .. rst-class:: classref-descriptions-group
  154. Property Descriptions
  155. ---------------------
  156. .. _class_Vector4i_property_w:
  157. .. rst-class:: classref-property
  158. :ref:`int<class_int>` **w** = ``0``
  159. The vector's W component. Also accessible by using the index position ``[3]``.
  160. .. rst-class:: classref-item-separator
  161. ----
  162. .. _class_Vector4i_property_x:
  163. .. rst-class:: classref-property
  164. :ref:`int<class_int>` **x** = ``0``
  165. The vector's X component. Also accessible by using the index position ``[0]``.
  166. .. rst-class:: classref-item-separator
  167. ----
  168. .. _class_Vector4i_property_y:
  169. .. rst-class:: classref-property
  170. :ref:`int<class_int>` **y** = ``0``
  171. The vector's Y component. Also accessible by using the index position ``[1]``.
  172. .. rst-class:: classref-item-separator
  173. ----
  174. .. _class_Vector4i_property_z:
  175. .. rst-class:: classref-property
  176. :ref:`int<class_int>` **z** = ``0``
  177. The vector's Z component. Also accessible by using the index position ``[2]``.
  178. .. rst-class:: classref-section-separator
  179. ----
  180. .. rst-class:: classref-descriptions-group
  181. Constructor Descriptions
  182. ------------------------
  183. .. _class_Vector4i_constructor_Vector4i:
  184. .. rst-class:: classref-constructor
  185. :ref:`Vector4i<class_Vector4i>` **Vector4i** **(** **)**
  186. Constructs a default-initialized **Vector4i** with all components set to ``0``.
  187. .. rst-class:: classref-item-separator
  188. ----
  189. .. rst-class:: classref-constructor
  190. :ref:`Vector4i<class_Vector4i>` **Vector4i** **(** :ref:`Vector4i<class_Vector4i>` from **)**
  191. Constructs a **Vector4i** as a copy of the given **Vector4i**.
  192. .. rst-class:: classref-item-separator
  193. ----
  194. .. rst-class:: classref-constructor
  195. :ref:`Vector4i<class_Vector4i>` **Vector4i** **(** :ref:`Vector4<class_Vector4>` from **)**
  196. 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.
  197. .. rst-class:: classref-item-separator
  198. ----
  199. .. rst-class:: classref-constructor
  200. :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 **)**
  201. Returns a **Vector4i** with the given components.
  202. .. rst-class:: classref-section-separator
  203. ----
  204. .. rst-class:: classref-descriptions-group
  205. Method Descriptions
  206. -------------------
  207. .. _class_Vector4i_method_abs:
  208. .. rst-class:: classref-method
  209. :ref:`Vector4i<class_Vector4i>` **abs** **(** **)** |const|
  210. Returns a new vector with all components in absolute values (i.e. positive).
  211. .. rst-class:: classref-item-separator
  212. ----
  213. .. _class_Vector4i_method_clamp:
  214. .. rst-class:: classref-method
  215. :ref:`Vector4i<class_Vector4i>` **clamp** **(** :ref:`Vector4i<class_Vector4i>` min, :ref:`Vector4i<class_Vector4i>` max **)** |const|
  216. 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.
  217. .. rst-class:: classref-item-separator
  218. ----
  219. .. _class_Vector4i_method_distance_squared_to:
  220. .. rst-class:: classref-method
  221. :ref:`int<class_int>` **distance_squared_to** **(** :ref:`Vector4i<class_Vector4i>` to **)** |const|
  222. Returns the squared distance between this vector and ``to``.
  223. This method runs faster than :ref:`distance_to<class_Vector4i_method_distance_to>`, 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_Vector4i_method_distance_to:
  227. .. rst-class:: classref-method
  228. :ref:`float<class_float>` **distance_to** **(** :ref:`Vector4i<class_Vector4i>` to **)** |const|
  229. Returns the distance between this vector and ``to``.
  230. .. rst-class:: classref-item-separator
  231. ----
  232. .. _class_Vector4i_method_length:
  233. .. rst-class:: classref-method
  234. :ref:`float<class_float>` **length** **(** **)** |const|
  235. Returns the length (magnitude) of this vector.
  236. .. rst-class:: classref-item-separator
  237. ----
  238. .. _class_Vector4i_method_length_squared:
  239. .. rst-class:: classref-method
  240. :ref:`int<class_int>` **length_squared** **(** **)** |const|
  241. Returns the squared length (squared magnitude) of this vector.
  242. 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.
  243. .. rst-class:: classref-item-separator
  244. ----
  245. .. _class_Vector4i_method_max_axis_index:
  246. .. rst-class:: classref-method
  247. :ref:`int<class_int>` **max_axis_index** **(** **)** |const|
  248. 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>`.
  249. .. rst-class:: classref-item-separator
  250. ----
  251. .. _class_Vector4i_method_min_axis_index:
  252. .. rst-class:: classref-method
  253. :ref:`int<class_int>` **min_axis_index** **(** **)** |const|
  254. 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>`.
  255. .. rst-class:: classref-item-separator
  256. ----
  257. .. _class_Vector4i_method_sign:
  258. .. rst-class:: classref-method
  259. :ref:`Vector4i<class_Vector4i>` **sign** **(** **)** |const|
  260. 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.
  261. .. rst-class:: classref-item-separator
  262. ----
  263. .. _class_Vector4i_method_snapped:
  264. .. rst-class:: classref-method
  265. :ref:`Vector4i<class_Vector4i>` **snapped** **(** :ref:`Vector4i<class_Vector4i>` step **)** |const|
  266. Returns a new vector with each component snapped to the closest multiple of the corresponding component in ``step``.
  267. .. rst-class:: classref-section-separator
  268. ----
  269. .. rst-class:: classref-descriptions-group
  270. Operator Descriptions
  271. ---------------------
  272. .. _class_Vector4i_operator_neq_Vector4i:
  273. .. rst-class:: classref-operator
  274. :ref:`bool<class_bool>` **operator !=** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  275. Returns ``true`` if the vectors are not equal.
  276. .. rst-class:: classref-item-separator
  277. ----
  278. .. _class_Vector4i_operator_mod_Vector4i:
  279. .. rst-class:: classref-operator
  280. :ref:`Vector4i<class_Vector4i>` **operator %** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  281. 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.
  282. ::
  283. print(Vector4i(10, -20, 30, -40) % Vector4i(7, 8, 9, 10)) # Prints "(3, -4, 3, 0)"
  284. .. rst-class:: classref-item-separator
  285. ----
  286. .. _class_Vector4i_operator_mod_int:
  287. .. rst-class:: classref-operator
  288. :ref:`Vector4i<class_Vector4i>` **operator %** **(** :ref:`int<class_int>` right **)**
  289. 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.
  290. ::
  291. print(Vector4i(10, -20, 30, -40) % 7) # Prints "(3, -6, 2, -5)"
  292. .. rst-class:: classref-item-separator
  293. ----
  294. .. _class_Vector4i_operator_mul_Vector4i:
  295. .. rst-class:: classref-operator
  296. :ref:`Vector4i<class_Vector4i>` **operator *** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  297. Multiplies each component of the **Vector4i** by the components of the given **Vector4i**.
  298. ::
  299. print(Vector4i(10, 20, 30, 40) * Vector4i(3, 4, 5, 6)) # Prints "(30, 80, 150, 240)"
  300. .. rst-class:: classref-item-separator
  301. ----
  302. .. _class_Vector4i_operator_mul_float:
  303. .. rst-class:: classref-operator
  304. :ref:`Vector4<class_Vector4>` **operator *** **(** :ref:`float<class_float>` right **)**
  305. Multiplies each component of the **Vector4i** by the given :ref:`float<class_float>`.
  306. Returns a Vector4 value due to floating-point operations.
  307. ::
  308. print(Vector4i(10, 20, 30, 40) * 2) # Prints "(20, 40, 60, 80)"
  309. .. rst-class:: classref-item-separator
  310. ----
  311. .. _class_Vector4i_operator_mul_int:
  312. .. rst-class:: classref-operator
  313. :ref:`Vector4i<class_Vector4i>` **operator *** **(** :ref:`int<class_int>` right **)**
  314. Multiplies each component of the **Vector4i** by the given :ref:`int<class_int>`.
  315. .. rst-class:: classref-item-separator
  316. ----
  317. .. _class_Vector4i_operator_sum_Vector4i:
  318. .. rst-class:: classref-operator
  319. :ref:`Vector4i<class_Vector4i>` **operator +** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  320. Adds each component of the **Vector4i** by the components of the given **Vector4i**.
  321. ::
  322. print(Vector4i(10, 20, 30, 40) + Vector4i(3, 4, 5, 6)) # Prints "(13, 24, 35, 46)"
  323. .. rst-class:: classref-item-separator
  324. ----
  325. .. _class_Vector4i_operator_dif_Vector4i:
  326. .. rst-class:: classref-operator
  327. :ref:`Vector4i<class_Vector4i>` **operator -** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  328. Subtracts each component of the **Vector4i** by the components of the given **Vector4i**.
  329. ::
  330. print(Vector4i(10, 20, 30, 40) - Vector4i(3, 4, 5, 6)) # Prints "(7, 16, 25, 34)"
  331. .. rst-class:: classref-item-separator
  332. ----
  333. .. _class_Vector4i_operator_div_Vector4i:
  334. .. rst-class:: classref-operator
  335. :ref:`Vector4i<class_Vector4i>` **operator /** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  336. Divides each component of the **Vector4i** by the components of the given **Vector4i**.
  337. ::
  338. print(Vector4i(10, 20, 30, 40) / Vector4i(2, 5, 3, 4)) # Prints "(5, 4, 10, 10)"
  339. .. rst-class:: classref-item-separator
  340. ----
  341. .. _class_Vector4i_operator_div_float:
  342. .. rst-class:: classref-operator
  343. :ref:`Vector4<class_Vector4>` **operator /** **(** :ref:`float<class_float>` right **)**
  344. Divides each component of the **Vector4i** by the given :ref:`float<class_float>`.
  345. Returns a Vector4 value due to floating-point operations.
  346. ::
  347. print(Vector4i(10, 20, 30, 40) / 2 # Prints "(5, 10, 15, 20)"
  348. .. rst-class:: classref-item-separator
  349. ----
  350. .. _class_Vector4i_operator_div_int:
  351. .. rst-class:: classref-operator
  352. :ref:`Vector4i<class_Vector4i>` **operator /** **(** :ref:`int<class_int>` right **)**
  353. Divides each component of the **Vector4i** by the given :ref:`int<class_int>`.
  354. .. rst-class:: classref-item-separator
  355. ----
  356. .. _class_Vector4i_operator_lt_Vector4i:
  357. .. rst-class:: classref-operator
  358. :ref:`bool<class_bool>` **operator <** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  359. 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.
  360. .. rst-class:: classref-item-separator
  361. ----
  362. .. _class_Vector4i_operator_lte_Vector4i:
  363. .. rst-class:: classref-operator
  364. :ref:`bool<class_bool>` **operator <=** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  365. 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.
  366. .. rst-class:: classref-item-separator
  367. ----
  368. .. _class_Vector4i_operator_eq_Vector4i:
  369. .. rst-class:: classref-operator
  370. :ref:`bool<class_bool>` **operator ==** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  371. Returns ``true`` if the vectors are exactly equal.
  372. .. rst-class:: classref-item-separator
  373. ----
  374. .. _class_Vector4i_operator_gt_Vector4i:
  375. .. rst-class:: classref-operator
  376. :ref:`bool<class_bool>` **operator >** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  377. 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.
  378. .. rst-class:: classref-item-separator
  379. ----
  380. .. _class_Vector4i_operator_gte_Vector4i:
  381. .. rst-class:: classref-operator
  382. :ref:`bool<class_bool>` **operator >=** **(** :ref:`Vector4i<class_Vector4i>` right **)**
  383. 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.
  384. .. rst-class:: classref-item-separator
  385. ----
  386. .. _class_Vector4i_operator_idx_int:
  387. .. rst-class:: classref-operator
  388. :ref:`int<class_int>` **operator []** **(** :ref:`int<class_int>` index **)**
  389. 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``.
  390. .. rst-class:: classref-item-separator
  391. ----
  392. .. _class_Vector4i_operator_unplus:
  393. .. rst-class:: classref-operator
  394. :ref:`Vector4i<class_Vector4i>` **operator unary+** **(** **)**
  395. Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable.
  396. .. rst-class:: classref-item-separator
  397. ----
  398. .. _class_Vector4i_operator_unminus:
  399. .. rst-class:: classref-operator
  400. :ref:`Vector4i<class_Vector4i>` **operator unary-** **(** **)**
  401. 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.
  402. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  403. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  404. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  405. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  406. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  407. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  408. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`