class_vector3i.rst 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704
  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/Vector3i.xml.
  6. .. _class_Vector3i:
  7. Vector3i
  8. ========
  9. A 3D vector using integer coordinates.
  10. .. rst-class:: classref-introduction-group
  11. Description
  12. -----------
  13. A 3-element structure that can be used to represent 3D grid coordinates or any other triplet of integers.
  14. It uses integer coordinates and is therefore preferable to :ref:`Vector3<class_Vector3>` when exact precision is required. Note that the values are limited to 32 bits, and unlike :ref:`Vector3<class_Vector3>` 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 Vector3i will evaluate to ``false`` if it's equal to ``Vector3i(0, 0, 0)``. Otherwise, a Vector3i 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_Vector3i_property_x>` | ``0`` |
  29. +-----------------------+-------------------------------------+-------+
  30. | :ref:`int<class_int>` | :ref:`y<class_Vector3i_property_y>` | ``0`` |
  31. +-----------------------+-------------------------------------+-------+
  32. | :ref:`int<class_int>` | :ref:`z<class_Vector3i_property_z>` | ``0`` |
  33. +-----------------------+-------------------------------------+-------+
  34. .. rst-class:: classref-reftable-group
  35. Constructors
  36. ------------
  37. .. table::
  38. :widths: auto
  39. +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`Vector3i<class_Vector3i>` | :ref:`Vector3i<class_Vector3i_constructor_Vector3i>` **(** **)** |
  41. +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`Vector3i<class_Vector3i>` | :ref:`Vector3i<class_Vector3i_constructor_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` from **)** |
  43. +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`Vector3i<class_Vector3i>` | :ref:`Vector3i<class_Vector3i_constructor_Vector3i>` **(** :ref:`Vector3<class_Vector3>` from **)** |
  45. +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+
  46. | :ref:`Vector3i<class_Vector3i>` | :ref:`Vector3i<class_Vector3i_constructor_Vector3i>` **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y, :ref:`int<class_int>` z **)** |
  47. +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+
  48. .. rst-class:: classref-reftable-group
  49. Methods
  50. -------
  51. .. table::
  52. :widths: auto
  53. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  54. | :ref:`Vector3i<class_Vector3i>` | :ref:`abs<class_Vector3i_method_abs>` **(** **)** |const| |
  55. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`Vector3i<class_Vector3i>` | :ref:`clamp<class_Vector3i_method_clamp>` **(** :ref:`Vector3i<class_Vector3i>` min, :ref:`Vector3i<class_Vector3i>` max **)** |const| |
  57. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`float<class_float>` | :ref:`length<class_Vector3i_method_length>` **(** **)** |const| |
  59. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`int<class_int>` | :ref:`length_squared<class_Vector3i_method_length_squared>` **(** **)** |const| |
  61. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`int<class_int>` | :ref:`max_axis_index<class_Vector3i_method_max_axis_index>` **(** **)** |const| |
  63. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`int<class_int>` | :ref:`min_axis_index<class_Vector3i_method_min_axis_index>` **(** **)** |const| |
  65. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`Vector3i<class_Vector3i>` | :ref:`sign<class_Vector3i_method_sign>` **(** **)** |const| |
  67. +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  68. | :ref:`Vector3i<class_Vector3i>` | :ref:`snapped<class_Vector3i_method_snapped>` **(** :ref:`Vector3i<class_Vector3i>` 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_Vector3i_operator_neq_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  77. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  78. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator %<class_Vector3i_operator_mod_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  79. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  80. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator %<class_Vector3i_operator_mod_int>` **(** :ref:`int<class_int>` right **)** |
  81. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  82. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator *<class_Vector3i_operator_mul_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  83. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  84. | :ref:`Vector3<class_Vector3>` | :ref:`operator *<class_Vector3i_operator_mul_float>` **(** :ref:`float<class_float>` right **)** |
  85. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  86. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator *<class_Vector3i_operator_mul_int>` **(** :ref:`int<class_int>` right **)** |
  87. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  88. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator +<class_Vector3i_operator_sum_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  89. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  90. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator -<class_Vector3i_operator_dif_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  91. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  92. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator /<class_Vector3i_operator_div_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  93. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  94. | :ref:`Vector3<class_Vector3>` | :ref:`operator /<class_Vector3i_operator_div_float>` **(** :ref:`float<class_float>` right **)** |
  95. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  96. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator /<class_Vector3i_operator_div_int>` **(** :ref:`int<class_int>` right **)** |
  97. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  98. | :ref:`bool<class_bool>` | :ref:`operator \<<class_Vector3i_operator_lt_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  99. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  100. | :ref:`bool<class_bool>` | :ref:`operator \<=<class_Vector3i_operator_lte_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  101. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  102. | :ref:`bool<class_bool>` | :ref:`operator ==<class_Vector3i_operator_eq_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  103. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  104. | :ref:`bool<class_bool>` | :ref:`operator ><class_Vector3i_operator_gt_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  105. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  106. | :ref:`bool<class_bool>` | :ref:`operator >=<class_Vector3i_operator_gte_Vector3i>` **(** :ref:`Vector3i<class_Vector3i>` right **)** |
  107. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  108. | :ref:`int<class_int>` | :ref:`operator []<class_Vector3i_operator_idx_int>` **(** :ref:`int<class_int>` index **)** |
  109. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  110. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator unary+<class_Vector3i_operator_unplus>` **(** **)** |
  111. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  112. | :ref:`Vector3i<class_Vector3i>` | :ref:`operator unary-<class_Vector3i_operator_unminus>` **(** **)** |
  113. +---------------------------------+-------------------------------------------------------------------------------------------------------------+
  114. .. rst-class:: classref-section-separator
  115. ----
  116. .. rst-class:: classref-descriptions-group
  117. Constants
  118. ---------
  119. .. _class_Vector3i_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_Vector3i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector3i_method_min_axis_index>`.
  123. .. _class_Vector3i_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_Vector3i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector3i_method_min_axis_index>`.
  127. .. _class_Vector3i_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_Vector3i_method_max_axis_index>` and :ref:`min_axis_index<class_Vector3i_method_min_axis_index>`.
  131. .. _class_Vector3i_constant_ZERO:
  132. .. rst-class:: classref-constant
  133. **ZERO** = ``Vector3i(0, 0, 0)``
  134. Zero vector, a vector with all components set to ``0``.
  135. .. _class_Vector3i_constant_ONE:
  136. .. rst-class:: classref-constant
  137. **ONE** = ``Vector3i(1, 1, 1)``
  138. One vector, a vector with all components set to ``1``.
  139. .. _class_Vector3i_constant_LEFT:
  140. .. rst-class:: classref-constant
  141. **LEFT** = ``Vector3i(-1, 0, 0)``
  142. Left unit vector. Represents the local direction of left, and the global direction of west.
  143. .. _class_Vector3i_constant_RIGHT:
  144. .. rst-class:: classref-constant
  145. **RIGHT** = ``Vector3i(1, 0, 0)``
  146. Right unit vector. Represents the local direction of right, and the global direction of east.
  147. .. _class_Vector3i_constant_UP:
  148. .. rst-class:: classref-constant
  149. **UP** = ``Vector3i(0, 1, 0)``
  150. Up unit vector.
  151. .. _class_Vector3i_constant_DOWN:
  152. .. rst-class:: classref-constant
  153. **DOWN** = ``Vector3i(0, -1, 0)``
  154. Down unit vector.
  155. .. _class_Vector3i_constant_FORWARD:
  156. .. rst-class:: classref-constant
  157. **FORWARD** = ``Vector3i(0, 0, -1)``
  158. Forward unit vector. Represents the local direction of forward, and the global direction of north.
  159. .. _class_Vector3i_constant_BACK:
  160. .. rst-class:: classref-constant
  161. **BACK** = ``Vector3i(0, 0, 1)``
  162. Back unit vector. Represents the local direction of back, and the global direction of south.
  163. .. rst-class:: classref-section-separator
  164. ----
  165. .. rst-class:: classref-descriptions-group
  166. Property Descriptions
  167. ---------------------
  168. .. _class_Vector3i_property_x:
  169. .. rst-class:: classref-property
  170. :ref:`int<class_int>` **x** = ``0``
  171. The vector's X component. Also accessible by using the index position ``[0]``.
  172. .. rst-class:: classref-item-separator
  173. ----
  174. .. _class_Vector3i_property_y:
  175. .. rst-class:: classref-property
  176. :ref:`int<class_int>` **y** = ``0``
  177. The vector's Y component. Also accessible by using the index position ``[1]``.
  178. .. rst-class:: classref-item-separator
  179. ----
  180. .. _class_Vector3i_property_z:
  181. .. rst-class:: classref-property
  182. :ref:`int<class_int>` **z** = ``0``
  183. The vector's Z component. Also accessible by using the index position ``[2]``.
  184. .. rst-class:: classref-section-separator
  185. ----
  186. .. rst-class:: classref-descriptions-group
  187. Constructor Descriptions
  188. ------------------------
  189. .. _class_Vector3i_constructor_Vector3i:
  190. .. rst-class:: classref-constructor
  191. :ref:`Vector3i<class_Vector3i>` **Vector3i** **(** **)**
  192. Constructs a default-initialized **Vector3i** with all components set to ``0``.
  193. .. rst-class:: classref-item-separator
  194. ----
  195. .. rst-class:: classref-constructor
  196. :ref:`Vector3i<class_Vector3i>` **Vector3i** **(** :ref:`Vector3i<class_Vector3i>` from **)**
  197. Constructs a **Vector3i** as a copy of the given **Vector3i**.
  198. .. rst-class:: classref-item-separator
  199. ----
  200. .. rst-class:: classref-constructor
  201. :ref:`Vector3i<class_Vector3i>` **Vector3i** **(** :ref:`Vector3<class_Vector3>` from **)**
  202. Constructs a new **Vector3i** from the given :ref:`Vector3<class_Vector3>` by truncating components' fractional parts (rounding towards zero). For a different behavior consider passing the result of :ref:`Vector3.ceil<class_Vector3_method_ceil>`, :ref:`Vector3.floor<class_Vector3_method_floor>` or :ref:`Vector3.round<class_Vector3_method_round>` to this constructor instead.
  203. .. rst-class:: classref-item-separator
  204. ----
  205. .. rst-class:: classref-constructor
  206. :ref:`Vector3i<class_Vector3i>` **Vector3i** **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y, :ref:`int<class_int>` z **)**
  207. Returns a **Vector3i** with the given components.
  208. .. rst-class:: classref-section-separator
  209. ----
  210. .. rst-class:: classref-descriptions-group
  211. Method Descriptions
  212. -------------------
  213. .. _class_Vector3i_method_abs:
  214. .. rst-class:: classref-method
  215. :ref:`Vector3i<class_Vector3i>` **abs** **(** **)** |const|
  216. Returns a new vector with all components in absolute values (i.e. positive).
  217. .. rst-class:: classref-item-separator
  218. ----
  219. .. _class_Vector3i_method_clamp:
  220. .. rst-class:: classref-method
  221. :ref:`Vector3i<class_Vector3i>` **clamp** **(** :ref:`Vector3i<class_Vector3i>` min, :ref:`Vector3i<class_Vector3i>` max **)** |const|
  222. 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.
  223. .. rst-class:: classref-item-separator
  224. ----
  225. .. _class_Vector3i_method_length:
  226. .. rst-class:: classref-method
  227. :ref:`float<class_float>` **length** **(** **)** |const|
  228. Returns the length (magnitude) of this vector.
  229. .. rst-class:: classref-item-separator
  230. ----
  231. .. _class_Vector3i_method_length_squared:
  232. .. rst-class:: classref-method
  233. :ref:`int<class_int>` **length_squared** **(** **)** |const|
  234. Returns the squared length (squared magnitude) of this vector.
  235. This method runs faster than :ref:`length<class_Vector3i_method_length>`, so prefer it if you need to compare vectors or need the squared distance for some formula.
  236. .. rst-class:: classref-item-separator
  237. ----
  238. .. _class_Vector3i_method_max_axis_index:
  239. .. rst-class:: classref-method
  240. :ref:`int<class_int>` **max_axis_index** **(** **)** |const|
  241. Returns the axis of the vector's highest value. See ``AXIS_*`` constants. If all components are equal, this method returns :ref:`AXIS_X<class_Vector3i_constant_AXIS_X>`.
  242. .. rst-class:: classref-item-separator
  243. ----
  244. .. _class_Vector3i_method_min_axis_index:
  245. .. rst-class:: classref-method
  246. :ref:`int<class_int>` **min_axis_index** **(** **)** |const|
  247. Returns the axis of the vector's lowest value. See ``AXIS_*`` constants. If all components are equal, this method returns :ref:`AXIS_Z<class_Vector3i_constant_AXIS_Z>`.
  248. .. rst-class:: classref-item-separator
  249. ----
  250. .. _class_Vector3i_method_sign:
  251. .. rst-class:: classref-method
  252. :ref:`Vector3i<class_Vector3i>` **sign** **(** **)** |const|
  253. 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.
  254. .. rst-class:: classref-item-separator
  255. ----
  256. .. _class_Vector3i_method_snapped:
  257. .. rst-class:: classref-method
  258. :ref:`Vector3i<class_Vector3i>` **snapped** **(** :ref:`Vector3i<class_Vector3i>` step **)** |const|
  259. Returns a new vector with each component snapped to the closest multiple of the corresponding component in ``step``.
  260. .. rst-class:: classref-section-separator
  261. ----
  262. .. rst-class:: classref-descriptions-group
  263. Operator Descriptions
  264. ---------------------
  265. .. _class_Vector3i_operator_neq_Vector3i:
  266. .. rst-class:: classref-operator
  267. :ref:`bool<class_bool>` **operator !=** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  268. Returns ``true`` if the vectors are not equal.
  269. .. rst-class:: classref-item-separator
  270. ----
  271. .. _class_Vector3i_operator_mod_Vector3i:
  272. .. rst-class:: classref-operator
  273. :ref:`Vector3i<class_Vector3i>` **operator %** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  274. Gets the remainder of each component of the **Vector3i** with the components of the given **Vector3i**. 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.
  275. ::
  276. print(Vector3i(10, -20, 30) % Vector3i(7, 8, 9)) # Prints "(3, -4, 3)"
  277. .. rst-class:: classref-item-separator
  278. ----
  279. .. _class_Vector3i_operator_mod_int:
  280. .. rst-class:: classref-operator
  281. :ref:`Vector3i<class_Vector3i>` **operator %** **(** :ref:`int<class_int>` right **)**
  282. Gets the remainder of each component of the **Vector3i** 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.
  283. ::
  284. print(Vector3i(10, -20, 30) % 7) # Prints "(3, -6, 2)"
  285. .. rst-class:: classref-item-separator
  286. ----
  287. .. _class_Vector3i_operator_mul_Vector3i:
  288. .. rst-class:: classref-operator
  289. :ref:`Vector3i<class_Vector3i>` **operator *** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  290. Multiplies each component of the **Vector3i** by the components of the given **Vector3i**.
  291. ::
  292. print(Vector3i(10, 20, 30) * Vector3i(3, 4, 5)) # Prints "(30, 80, 150)"
  293. .. rst-class:: classref-item-separator
  294. ----
  295. .. _class_Vector3i_operator_mul_float:
  296. .. rst-class:: classref-operator
  297. :ref:`Vector3<class_Vector3>` **operator *** **(** :ref:`float<class_float>` right **)**
  298. Multiplies each component of the **Vector3i** by the given :ref:`float<class_float>`. Returns a :ref:`Vector3<class_Vector3>`.
  299. ::
  300. print(Vector3i(10, 15, 20) * 0.9) # Prints "(9, 13.5, 18)"
  301. .. rst-class:: classref-item-separator
  302. ----
  303. .. _class_Vector3i_operator_mul_int:
  304. .. rst-class:: classref-operator
  305. :ref:`Vector3i<class_Vector3i>` **operator *** **(** :ref:`int<class_int>` right **)**
  306. Multiplies each component of the **Vector3i** by the given :ref:`int<class_int>`.
  307. .. rst-class:: classref-item-separator
  308. ----
  309. .. _class_Vector3i_operator_sum_Vector3i:
  310. .. rst-class:: classref-operator
  311. :ref:`Vector3i<class_Vector3i>` **operator +** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  312. Adds each component of the **Vector3i** by the components of the given **Vector3i**.
  313. ::
  314. print(Vector3i(10, 20, 30) + Vector3i(3, 4, 5)) # Prints "(13, 24, 35)"
  315. .. rst-class:: classref-item-separator
  316. ----
  317. .. _class_Vector3i_operator_dif_Vector3i:
  318. .. rst-class:: classref-operator
  319. :ref:`Vector3i<class_Vector3i>` **operator -** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  320. Subtracts each component of the **Vector3i** by the components of the given **Vector3i**.
  321. ::
  322. print(Vector3i(10, 20, 30) - Vector3i(3, 4, 5)) # Prints "(7, 16, 25)"
  323. .. rst-class:: classref-item-separator
  324. ----
  325. .. _class_Vector3i_operator_div_Vector3i:
  326. .. rst-class:: classref-operator
  327. :ref:`Vector3i<class_Vector3i>` **operator /** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  328. Divides each component of the **Vector3i** by the components of the given **Vector3i**.
  329. ::
  330. print(Vector3i(10, 20, 30) / Vector3i(2, 5, 3)) # Prints "(5, 4, 10)"
  331. .. rst-class:: classref-item-separator
  332. ----
  333. .. _class_Vector3i_operator_div_float:
  334. .. rst-class:: classref-operator
  335. :ref:`Vector3<class_Vector3>` **operator /** **(** :ref:`float<class_float>` right **)**
  336. Divides each component of the **Vector3i** by the given :ref:`float<class_float>`. Returns a :ref:`Vector3<class_Vector3>`.
  337. ::
  338. print(Vector3i(10, 20, 30) / 2.9) # Prints "(5, 10, 15)"
  339. .. rst-class:: classref-item-separator
  340. ----
  341. .. _class_Vector3i_operator_div_int:
  342. .. rst-class:: classref-operator
  343. :ref:`Vector3i<class_Vector3i>` **operator /** **(** :ref:`int<class_int>` right **)**
  344. Divides each component of the **Vector3i** by the given :ref:`int<class_int>`.
  345. .. rst-class:: classref-item-separator
  346. ----
  347. .. _class_Vector3i_operator_lt_Vector3i:
  348. .. rst-class:: classref-operator
  349. :ref:`bool<class_bool>` **operator <** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  350. Compares two **Vector3i** 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, and then with the Z values. This operator is useful for sorting vectors.
  351. .. rst-class:: classref-item-separator
  352. ----
  353. .. _class_Vector3i_operator_lte_Vector3i:
  354. .. rst-class:: classref-operator
  355. :ref:`bool<class_bool>` **operator <=** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  356. Compares two **Vector3i** 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, and then with the Z values. This operator is useful for sorting vectors.
  357. .. rst-class:: classref-item-separator
  358. ----
  359. .. _class_Vector3i_operator_eq_Vector3i:
  360. .. rst-class:: classref-operator
  361. :ref:`bool<class_bool>` **operator ==** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  362. Returns ``true`` if the vectors are equal.
  363. .. rst-class:: classref-item-separator
  364. ----
  365. .. _class_Vector3i_operator_gt_Vector3i:
  366. .. rst-class:: classref-operator
  367. :ref:`bool<class_bool>` **operator >** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  368. Compares two **Vector3i** 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, and then with the Z values. This operator is useful for sorting vectors.
  369. .. rst-class:: classref-item-separator
  370. ----
  371. .. _class_Vector3i_operator_gte_Vector3i:
  372. .. rst-class:: classref-operator
  373. :ref:`bool<class_bool>` **operator >=** **(** :ref:`Vector3i<class_Vector3i>` right **)**
  374. Compares two **Vector3i** 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, and then with the Z values. This operator is useful for sorting vectors.
  375. .. rst-class:: classref-item-separator
  376. ----
  377. .. _class_Vector3i_operator_idx_int:
  378. .. rst-class:: classref-operator
  379. :ref:`int<class_int>` **operator []** **(** :ref:`int<class_int>` index **)**
  380. Access vector components using their ``index``. ``v[0]`` is equivalent to ``v.x``, ``v[1]`` is equivalent to ``v.y``, and ``v[2]`` is equivalent to ``v.z``.
  381. .. rst-class:: classref-item-separator
  382. ----
  383. .. _class_Vector3i_operator_unplus:
  384. .. rst-class:: classref-operator
  385. :ref:`Vector3i<class_Vector3i>` **operator unary+** **(** **)**
  386. Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable.
  387. .. rst-class:: classref-item-separator
  388. ----
  389. .. _class_Vector3i_operator_unminus:
  390. .. rst-class:: classref-operator
  391. :ref:`Vector3i<class_Vector3i>` **operator unary-** **(** **)**
  392. Returns the negative value of the **Vector3i**. This is the same as writing ``Vector3i(-v.x, -v.y, -v.z)``. This operation flips the direction of the vector while keeping the same magnitude.
  393. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  394. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  395. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  396. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  397. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  398. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`