class_vector2.rst 83 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295
  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/Vector2.xml.
  6. .. _class_Vector2:
  7. Vector2
  8. =======
  9. A 2D vector using floating-point coordinates.
  10. .. rst-class:: classref-introduction-group
  11. Description
  12. -----------
  13. A 2-element structure that can be used to represent 2D coordinates or any other pair of numeric values.
  14. It uses floating-point coordinates. By default, these floating-point values use 32-bit precision, unlike :ref:`float<class_float>` which is always 64-bit. If double precision is needed, compile the engine with the option ``precision=double``.
  15. See :ref:`Vector2i<class_Vector2i>` for its integer counterpart.
  16. \ **Note:** In a boolean context, a Vector2 will evaluate to ``false`` if it's equal to ``Vector2(0, 0)``. Otherwise, a Vector2 will always evaluate to ``true``.
  17. .. rst-class:: classref-introduction-group
  18. Tutorials
  19. ---------
  20. - :doc:`Math documentation index <../tutorials/math/index>`
  21. - :doc:`Vector math <../tutorials/math/vector_math>`
  22. - :doc:`Advanced vector math <../tutorials/math/vectors_advanced>`
  23. - `3Blue1Brown Essence of Linear Algebra <https://www.youtube.com/playlist?list=PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab>`__
  24. - `Matrix Transform Demo <https://godotengine.org/asset-library/asset/2787>`__
  25. - `All 2D Demos <https://github.com/godotengine/godot-demo-projects/tree/master/2d>`__
  26. .. rst-class:: classref-reftable-group
  27. Properties
  28. ----------
  29. .. table::
  30. :widths: auto
  31. +---------------------------+------------------------------------+---------+
  32. | :ref:`float<class_float>` | :ref:`x<class_Vector2_property_x>` | ``0.0`` |
  33. +---------------------------+------------------------------------+---------+
  34. | :ref:`float<class_float>` | :ref:`y<class_Vector2_property_y>` | ``0.0`` |
  35. +---------------------------+------------------------------------+---------+
  36. .. rst-class:: classref-reftable-group
  37. Constructors
  38. ------------
  39. .. table::
  40. :widths: auto
  41. +-------------------------------+-----------------------------------------------------------------------------------------------------------------------+
  42. | :ref:`Vector2<class_Vector2>` | :ref:`Vector2<class_Vector2_constructor_Vector2>`\ (\ ) |
  43. +-------------------------------+-----------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`Vector2<class_Vector2>` | :ref:`Vector2<class_Vector2_constructor_Vector2>`\ (\ from\: :ref:`Vector2<class_Vector2>`\ ) |
  45. +-------------------------------+-----------------------------------------------------------------------------------------------------------------------+
  46. | :ref:`Vector2<class_Vector2>` | :ref:`Vector2<class_Vector2_constructor_Vector2>`\ (\ from\: :ref:`Vector2i<class_Vector2i>`\ ) |
  47. +-------------------------------+-----------------------------------------------------------------------------------------------------------------------+
  48. | :ref:`Vector2<class_Vector2>` | :ref:`Vector2<class_Vector2_constructor_Vector2>`\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) |
  49. +-------------------------------+-----------------------------------------------------------------------------------------------------------------------+
  50. .. rst-class:: classref-reftable-group
  51. Methods
  52. -------
  53. .. table::
  54. :widths: auto
  55. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`Vector2<class_Vector2>` | :ref:`abs<class_Vector2_method_abs>`\ (\ ) |const| |
  57. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`float<class_float>` | :ref:`angle<class_Vector2_method_angle>`\ (\ ) |const| |
  59. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`float<class_float>` | :ref:`angle_to<class_Vector2_method_angle_to>`\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  61. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`float<class_float>` | :ref:`angle_to_point<class_Vector2_method_angle_to_point>`\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  63. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`float<class_float>` | :ref:`aspect<class_Vector2_method_aspect>`\ (\ ) |const| |
  65. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`Vector2<class_Vector2>` | :ref:`bezier_derivative<class_Vector2_method_bezier_derivative>`\ (\ control_1\: :ref:`Vector2<class_Vector2>`, control_2\: :ref:`Vector2<class_Vector2>`, end\: :ref:`Vector2<class_Vector2>`, t\: :ref:`float<class_float>`\ ) |const| |
  67. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  68. | :ref:`Vector2<class_Vector2>` | :ref:`bezier_interpolate<class_Vector2_method_bezier_interpolate>`\ (\ control_1\: :ref:`Vector2<class_Vector2>`, control_2\: :ref:`Vector2<class_Vector2>`, end\: :ref:`Vector2<class_Vector2>`, t\: :ref:`float<class_float>`\ ) |const| |
  69. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  70. | :ref:`Vector2<class_Vector2>` | :ref:`bounce<class_Vector2_method_bounce>`\ (\ n\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  71. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  72. | :ref:`Vector2<class_Vector2>` | :ref:`ceil<class_Vector2_method_ceil>`\ (\ ) |const| |
  73. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  74. | :ref:`Vector2<class_Vector2>` | :ref:`clamp<class_Vector2_method_clamp>`\ (\ min\: :ref:`Vector2<class_Vector2>`, max\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  75. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  76. | :ref:`Vector2<class_Vector2>` | :ref:`clampf<class_Vector2_method_clampf>`\ (\ min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) |const| |
  77. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  78. | :ref:`float<class_float>` | :ref:`cross<class_Vector2_method_cross>`\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  79. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  80. | :ref:`Vector2<class_Vector2>` | :ref:`cubic_interpolate<class_Vector2_method_cubic_interpolate>`\ (\ b\: :ref:`Vector2<class_Vector2>`, pre_a\: :ref:`Vector2<class_Vector2>`, post_b\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`\ ) |const| |
  81. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  82. | :ref:`Vector2<class_Vector2>` | :ref:`cubic_interpolate_in_time<class_Vector2_method_cubic_interpolate_in_time>`\ (\ b\: :ref:`Vector2<class_Vector2>`, pre_a\: :ref:`Vector2<class_Vector2>`, post_b\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`, b_t\: :ref:`float<class_float>`, pre_a_t\: :ref:`float<class_float>`, post_b_t\: :ref:`float<class_float>`\ ) |const| |
  83. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  84. | :ref:`Vector2<class_Vector2>` | :ref:`direction_to<class_Vector2_method_direction_to>`\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  85. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  86. | :ref:`float<class_float>` | :ref:`distance_squared_to<class_Vector2_method_distance_squared_to>`\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  87. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  88. | :ref:`float<class_float>` | :ref:`distance_to<class_Vector2_method_distance_to>`\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  89. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  90. | :ref:`float<class_float>` | :ref:`dot<class_Vector2_method_dot>`\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  91. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  92. | :ref:`Vector2<class_Vector2>` | :ref:`floor<class_Vector2_method_floor>`\ (\ ) |const| |
  93. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  94. | :ref:`Vector2<class_Vector2>` | :ref:`from_angle<class_Vector2_method_from_angle>`\ (\ angle\: :ref:`float<class_float>`\ ) |static| |
  95. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  96. | :ref:`bool<class_bool>` | :ref:`is_equal_approx<class_Vector2_method_is_equal_approx>`\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  97. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  98. | :ref:`bool<class_bool>` | :ref:`is_finite<class_Vector2_method_is_finite>`\ (\ ) |const| |
  99. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  100. | :ref:`bool<class_bool>` | :ref:`is_normalized<class_Vector2_method_is_normalized>`\ (\ ) |const| |
  101. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  102. | :ref:`bool<class_bool>` | :ref:`is_zero_approx<class_Vector2_method_is_zero_approx>`\ (\ ) |const| |
  103. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  104. | :ref:`float<class_float>` | :ref:`length<class_Vector2_method_length>`\ (\ ) |const| |
  105. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  106. | :ref:`float<class_float>` | :ref:`length_squared<class_Vector2_method_length_squared>`\ (\ ) |const| |
  107. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  108. | :ref:`Vector2<class_Vector2>` | :ref:`lerp<class_Vector2_method_lerp>`\ (\ to\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`\ ) |const| |
  109. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  110. | :ref:`Vector2<class_Vector2>` | :ref:`limit_length<class_Vector2_method_limit_length>`\ (\ length\: :ref:`float<class_float>` = 1.0\ ) |const| |
  111. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  112. | :ref:`Vector2<class_Vector2>` | :ref:`max<class_Vector2_method_max>`\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  113. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  114. | :ref:`int<class_int>` | :ref:`max_axis_index<class_Vector2_method_max_axis_index>`\ (\ ) |const| |
  115. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  116. | :ref:`Vector2<class_Vector2>` | :ref:`maxf<class_Vector2_method_maxf>`\ (\ with\: :ref:`float<class_float>`\ ) |const| |
  117. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  118. | :ref:`Vector2<class_Vector2>` | :ref:`min<class_Vector2_method_min>`\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  119. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  120. | :ref:`int<class_int>` | :ref:`min_axis_index<class_Vector2_method_min_axis_index>`\ (\ ) |const| |
  121. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  122. | :ref:`Vector2<class_Vector2>` | :ref:`minf<class_Vector2_method_minf>`\ (\ with\: :ref:`float<class_float>`\ ) |const| |
  123. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  124. | :ref:`Vector2<class_Vector2>` | :ref:`move_toward<class_Vector2_method_move_toward>`\ (\ to\: :ref:`Vector2<class_Vector2>`, delta\: :ref:`float<class_float>`\ ) |const| |
  125. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  126. | :ref:`Vector2<class_Vector2>` | :ref:`normalized<class_Vector2_method_normalized>`\ (\ ) |const| |
  127. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  128. | :ref:`Vector2<class_Vector2>` | :ref:`orthogonal<class_Vector2_method_orthogonal>`\ (\ ) |const| |
  129. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  130. | :ref:`Vector2<class_Vector2>` | :ref:`posmod<class_Vector2_method_posmod>`\ (\ mod\: :ref:`float<class_float>`\ ) |const| |
  131. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  132. | :ref:`Vector2<class_Vector2>` | :ref:`posmodv<class_Vector2_method_posmodv>`\ (\ modv\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  133. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  134. | :ref:`Vector2<class_Vector2>` | :ref:`project<class_Vector2_method_project>`\ (\ b\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  135. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  136. | :ref:`Vector2<class_Vector2>` | :ref:`reflect<class_Vector2_method_reflect>`\ (\ line\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  137. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  138. | :ref:`Vector2<class_Vector2>` | :ref:`rotated<class_Vector2_method_rotated>`\ (\ angle\: :ref:`float<class_float>`\ ) |const| |
  139. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  140. | :ref:`Vector2<class_Vector2>` | :ref:`round<class_Vector2_method_round>`\ (\ ) |const| |
  141. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  142. | :ref:`Vector2<class_Vector2>` | :ref:`sign<class_Vector2_method_sign>`\ (\ ) |const| |
  143. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  144. | :ref:`Vector2<class_Vector2>` | :ref:`slerp<class_Vector2_method_slerp>`\ (\ to\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`\ ) |const| |
  145. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  146. | :ref:`Vector2<class_Vector2>` | :ref:`slide<class_Vector2_method_slide>`\ (\ n\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  147. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  148. | :ref:`Vector2<class_Vector2>` | :ref:`snapped<class_Vector2_method_snapped>`\ (\ step\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  149. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  150. | :ref:`Vector2<class_Vector2>` | :ref:`snappedf<class_Vector2_method_snappedf>`\ (\ step\: :ref:`float<class_float>`\ ) |const| |
  151. +-------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  152. .. rst-class:: classref-reftable-group
  153. Operators
  154. ---------
  155. .. table::
  156. :widths: auto
  157. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  158. | :ref:`bool<class_bool>` | :ref:`operator !=<class_Vector2_operator_neq_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  159. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  160. | :ref:`Vector2<class_Vector2>` | :ref:`operator *<class_Vector2_operator_mul_Transform2D>`\ (\ right\: :ref:`Transform2D<class_Transform2D>`\ ) |
  161. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  162. | :ref:`Vector2<class_Vector2>` | :ref:`operator *<class_Vector2_operator_mul_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  163. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  164. | :ref:`Vector2<class_Vector2>` | :ref:`operator *<class_Vector2_operator_mul_float>`\ (\ right\: :ref:`float<class_float>`\ ) |
  165. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  166. | :ref:`Vector2<class_Vector2>` | :ref:`operator *<class_Vector2_operator_mul_int>`\ (\ right\: :ref:`int<class_int>`\ ) |
  167. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  168. | :ref:`Vector2<class_Vector2>` | :ref:`operator +<class_Vector2_operator_sum_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  169. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  170. | :ref:`Vector2<class_Vector2>` | :ref:`operator -<class_Vector2_operator_dif_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  171. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  172. | :ref:`Vector2<class_Vector2>` | :ref:`operator /<class_Vector2_operator_div_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  173. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  174. | :ref:`Vector2<class_Vector2>` | :ref:`operator /<class_Vector2_operator_div_float>`\ (\ right\: :ref:`float<class_float>`\ ) |
  175. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  176. | :ref:`Vector2<class_Vector2>` | :ref:`operator /<class_Vector2_operator_div_int>`\ (\ right\: :ref:`int<class_int>`\ ) |
  177. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  178. | :ref:`bool<class_bool>` | :ref:`operator \<<class_Vector2_operator_lt_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  179. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  180. | :ref:`bool<class_bool>` | :ref:`operator \<=<class_Vector2_operator_lte_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  181. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  182. | :ref:`bool<class_bool>` | :ref:`operator ==<class_Vector2_operator_eq_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  183. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  184. | :ref:`bool<class_bool>` | :ref:`operator ><class_Vector2_operator_gt_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  185. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  186. | :ref:`bool<class_bool>` | :ref:`operator >=<class_Vector2_operator_gte_Vector2>`\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) |
  187. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  188. | :ref:`float<class_float>` | :ref:`operator []<class_Vector2_operator_idx_int>`\ (\ index\: :ref:`int<class_int>`\ ) |
  189. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  190. | :ref:`Vector2<class_Vector2>` | :ref:`operator unary+<class_Vector2_operator_unplus>`\ (\ ) |
  191. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  192. | :ref:`Vector2<class_Vector2>` | :ref:`operator unary-<class_Vector2_operator_unminus>`\ (\ ) |
  193. +-------------------------------+----------------------------------------------------------------------------------------------------------------+
  194. .. rst-class:: classref-section-separator
  195. ----
  196. .. rst-class:: classref-descriptions-group
  197. Enumerations
  198. ------------
  199. .. _enum_Vector2_Axis:
  200. .. rst-class:: classref-enumeration
  201. enum **Axis**: :ref:`๐Ÿ”—<enum_Vector2_Axis>`
  202. .. _class_Vector2_constant_AXIS_X:
  203. .. rst-class:: classref-enumeration-constant
  204. :ref:`Axis<enum_Vector2_Axis>` **AXIS_X** = ``0``
  205. Enumerated value for the X axis. Returned by :ref:`max_axis_index<class_Vector2_method_max_axis_index>` and :ref:`min_axis_index<class_Vector2_method_min_axis_index>`.
  206. .. _class_Vector2_constant_AXIS_Y:
  207. .. rst-class:: classref-enumeration-constant
  208. :ref:`Axis<enum_Vector2_Axis>` **AXIS_Y** = ``1``
  209. Enumerated value for the Y axis. Returned by :ref:`max_axis_index<class_Vector2_method_max_axis_index>` and :ref:`min_axis_index<class_Vector2_method_min_axis_index>`.
  210. .. rst-class:: classref-section-separator
  211. ----
  212. .. rst-class:: classref-descriptions-group
  213. Constants
  214. ---------
  215. .. _class_Vector2_constant_ZERO:
  216. .. rst-class:: classref-constant
  217. **ZERO** = ``Vector2(0, 0)`` :ref:`๐Ÿ”—<class_Vector2_constant_ZERO>`
  218. Zero vector, a vector with all components set to ``0``.
  219. .. _class_Vector2_constant_ONE:
  220. .. rst-class:: classref-constant
  221. **ONE** = ``Vector2(1, 1)`` :ref:`๐Ÿ”—<class_Vector2_constant_ONE>`
  222. One vector, a vector with all components set to ``1``.
  223. .. _class_Vector2_constant_INF:
  224. .. rst-class:: classref-constant
  225. **INF** = ``Vector2(inf, inf)`` :ref:`๐Ÿ”—<class_Vector2_constant_INF>`
  226. Infinity vector, a vector with all components set to :ref:`@GDScript.INF<class_@GDScript_constant_INF>`.
  227. .. _class_Vector2_constant_LEFT:
  228. .. rst-class:: classref-constant
  229. **LEFT** = ``Vector2(-1, 0)`` :ref:`๐Ÿ”—<class_Vector2_constant_LEFT>`
  230. Left unit vector. Represents the direction of left.
  231. .. _class_Vector2_constant_RIGHT:
  232. .. rst-class:: classref-constant
  233. **RIGHT** = ``Vector2(1, 0)`` :ref:`๐Ÿ”—<class_Vector2_constant_RIGHT>`
  234. Right unit vector. Represents the direction of right.
  235. .. _class_Vector2_constant_UP:
  236. .. rst-class:: classref-constant
  237. **UP** = ``Vector2(0, -1)`` :ref:`๐Ÿ”—<class_Vector2_constant_UP>`
  238. Up unit vector. Y is down in 2D, so this vector points -Y.
  239. .. _class_Vector2_constant_DOWN:
  240. .. rst-class:: classref-constant
  241. **DOWN** = ``Vector2(0, 1)`` :ref:`๐Ÿ”—<class_Vector2_constant_DOWN>`
  242. Down unit vector. Y is down in 2D, so this vector points +Y.
  243. .. rst-class:: classref-section-separator
  244. ----
  245. .. rst-class:: classref-descriptions-group
  246. Property Descriptions
  247. ---------------------
  248. .. _class_Vector2_property_x:
  249. .. rst-class:: classref-property
  250. :ref:`float<class_float>` **x** = ``0.0`` :ref:`๐Ÿ”—<class_Vector2_property_x>`
  251. The vector's X component. Also accessible by using the index position ``[0]``.
  252. .. rst-class:: classref-item-separator
  253. ----
  254. .. _class_Vector2_property_y:
  255. .. rst-class:: classref-property
  256. :ref:`float<class_float>` **y** = ``0.0`` :ref:`๐Ÿ”—<class_Vector2_property_y>`
  257. The vector's Y component. Also accessible by using the index position ``[1]``.
  258. .. rst-class:: classref-section-separator
  259. ----
  260. .. rst-class:: classref-descriptions-group
  261. Constructor Descriptions
  262. ------------------------
  263. .. _class_Vector2_constructor_Vector2:
  264. .. rst-class:: classref-constructor
  265. :ref:`Vector2<class_Vector2>` **Vector2**\ (\ ) :ref:`๐Ÿ”—<class_Vector2_constructor_Vector2>`
  266. Constructs a default-initialized **Vector2** with all components set to ``0``.
  267. .. rst-class:: classref-item-separator
  268. ----
  269. .. rst-class:: classref-constructor
  270. :ref:`Vector2<class_Vector2>` **Vector2**\ (\ from\: :ref:`Vector2<class_Vector2>`\ )
  271. Constructs a **Vector2** as a copy of the given **Vector2**.
  272. .. rst-class:: classref-item-separator
  273. ----
  274. .. rst-class:: classref-constructor
  275. :ref:`Vector2<class_Vector2>` **Vector2**\ (\ from\: :ref:`Vector2i<class_Vector2i>`\ )
  276. Constructs a new **Vector2** from :ref:`Vector2i<class_Vector2i>`.
  277. .. rst-class:: classref-item-separator
  278. ----
  279. .. rst-class:: classref-constructor
  280. :ref:`Vector2<class_Vector2>` **Vector2**\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ )
  281. Constructs a new **Vector2** from the given ``x`` and ``y``.
  282. .. rst-class:: classref-section-separator
  283. ----
  284. .. rst-class:: classref-descriptions-group
  285. Method Descriptions
  286. -------------------
  287. .. _class_Vector2_method_abs:
  288. .. rst-class:: classref-method
  289. :ref:`Vector2<class_Vector2>` **abs**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_abs>`
  290. Returns a new vector with all components in absolute values (i.e. positive).
  291. .. rst-class:: classref-item-separator
  292. ----
  293. .. _class_Vector2_method_angle:
  294. .. rst-class:: classref-method
  295. :ref:`float<class_float>` **angle**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_angle>`
  296. Returns this vector's angle with respect to the positive X axis, or ``(1, 0)`` vector, in radians.
  297. For example, ``Vector2.RIGHT.angle()`` will return zero, ``Vector2.DOWN.angle()`` will return ``PI / 2`` (a quarter turn, or 90 degrees), and ``Vector2(1, -1).angle()`` will return ``-PI / 4`` (a negative eighth turn, or -45 degrees).
  298. \ `Illustration of the returned angle. <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/vector2_angle.png>`__\
  299. Equivalent to the result of :ref:`@GlobalScope.atan2<class_@GlobalScope_method_atan2>` when called with the vector's :ref:`y<class_Vector2_property_y>` and :ref:`x<class_Vector2_property_x>` as parameters: ``atan2(y, x)``.
  300. .. rst-class:: classref-item-separator
  301. ----
  302. .. _class_Vector2_method_angle_to:
  303. .. rst-class:: classref-method
  304. :ref:`float<class_float>` **angle_to**\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_angle_to>`
  305. Returns the angle to the given vector, in radians.
  306. \ `Illustration of the returned angle. <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/vector2_angle_to.png>`__
  307. .. rst-class:: classref-item-separator
  308. ----
  309. .. _class_Vector2_method_angle_to_point:
  310. .. rst-class:: classref-method
  311. :ref:`float<class_float>` **angle_to_point**\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_angle_to_point>`
  312. Returns the angle between the line connecting the two points and the X axis, in radians.
  313. \ ``a.angle_to_point(b)`` is equivalent of doing ``(b - a).angle()``.
  314. \ `Illustration of the returned angle. <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/vector2_angle_to_point.png>`__
  315. .. rst-class:: classref-item-separator
  316. ----
  317. .. _class_Vector2_method_aspect:
  318. .. rst-class:: classref-method
  319. :ref:`float<class_float>` **aspect**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_aspect>`
  320. Returns the aspect ratio of this vector, the ratio of :ref:`x<class_Vector2_property_x>` to :ref:`y<class_Vector2_property_y>`.
  321. .. rst-class:: classref-item-separator
  322. ----
  323. .. _class_Vector2_method_bezier_derivative:
  324. .. rst-class:: classref-method
  325. :ref:`Vector2<class_Vector2>` **bezier_derivative**\ (\ control_1\: :ref:`Vector2<class_Vector2>`, control_2\: :ref:`Vector2<class_Vector2>`, end\: :ref:`Vector2<class_Vector2>`, t\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_bezier_derivative>`
  326. Returns the derivative at the given ``t`` on the `Bรฉzier curve <https://en.wikipedia.org/wiki/B%C3%A9zier_curve>`__ defined by this vector and the given ``control_1``, ``control_2``, and ``end`` points.
  327. .. rst-class:: classref-item-separator
  328. ----
  329. .. _class_Vector2_method_bezier_interpolate:
  330. .. rst-class:: classref-method
  331. :ref:`Vector2<class_Vector2>` **bezier_interpolate**\ (\ control_1\: :ref:`Vector2<class_Vector2>`, control_2\: :ref:`Vector2<class_Vector2>`, end\: :ref:`Vector2<class_Vector2>`, t\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_bezier_interpolate>`
  332. Returns the point at the given ``t`` on the `Bรฉzier curve <https://en.wikipedia.org/wiki/B%C3%A9zier_curve>`__ defined by this vector and the given ``control_1``, ``control_2``, and ``end`` points.
  333. .. rst-class:: classref-item-separator
  334. ----
  335. .. _class_Vector2_method_bounce:
  336. .. rst-class:: classref-method
  337. :ref:`Vector2<class_Vector2>` **bounce**\ (\ n\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_bounce>`
  338. Returns the vector "bounced off" from a line defined by the given normal ``n`` perpendicular to the line.
  339. \ **Note:** :ref:`bounce<class_Vector2_method_bounce>` performs the operation that most engines and frameworks call ``reflect()``.
  340. .. rst-class:: classref-item-separator
  341. ----
  342. .. _class_Vector2_method_ceil:
  343. .. rst-class:: classref-method
  344. :ref:`Vector2<class_Vector2>` **ceil**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_ceil>`
  345. Returns a new vector with all components rounded up (towards positive infinity).
  346. .. rst-class:: classref-item-separator
  347. ----
  348. .. _class_Vector2_method_clamp:
  349. .. rst-class:: classref-method
  350. :ref:`Vector2<class_Vector2>` **clamp**\ (\ min\: :ref:`Vector2<class_Vector2>`, max\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_clamp>`
  351. 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.
  352. .. rst-class:: classref-item-separator
  353. ----
  354. .. _class_Vector2_method_clampf:
  355. .. rst-class:: classref-method
  356. :ref:`Vector2<class_Vector2>` **clampf**\ (\ min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_clampf>`
  357. Returns a new vector with all components clamped between ``min`` and ``max``, by running :ref:`@GlobalScope.clamp<class_@GlobalScope_method_clamp>` on each component.
  358. .. rst-class:: classref-item-separator
  359. ----
  360. .. _class_Vector2_method_cross:
  361. .. rst-class:: classref-method
  362. :ref:`float<class_float>` **cross**\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_cross>`
  363. Returns the 2D analog of the cross product for this vector and ``with``.
  364. This is the signed area of the parallelogram formed by the two vectors. If the second vector is clockwise from the first vector, then the cross product is the positive area. If counter-clockwise, the cross product is the negative area. If the two vectors are parallel this returns zero, making it useful for testing if two vectors are parallel.
  365. \ **Note:** Cross product is not defined in 2D mathematically. This method embeds the 2D vectors in the XY plane of 3D space and uses their cross product's Z component as the analog.
  366. .. rst-class:: classref-item-separator
  367. ----
  368. .. _class_Vector2_method_cubic_interpolate:
  369. .. rst-class:: classref-method
  370. :ref:`Vector2<class_Vector2>` **cubic_interpolate**\ (\ b\: :ref:`Vector2<class_Vector2>`, pre_a\: :ref:`Vector2<class_Vector2>`, post_b\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_cubic_interpolate>`
  371. Performs a cubic interpolation between this vector and ``b`` using ``pre_a`` and ``post_b`` as handles, and returns the result at position ``weight``. ``weight`` is on the range of 0.0 to 1.0, representing the amount of interpolation.
  372. .. rst-class:: classref-item-separator
  373. ----
  374. .. _class_Vector2_method_cubic_interpolate_in_time:
  375. .. rst-class:: classref-method
  376. :ref:`Vector2<class_Vector2>` **cubic_interpolate_in_time**\ (\ b\: :ref:`Vector2<class_Vector2>`, pre_a\: :ref:`Vector2<class_Vector2>`, post_b\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`, b_t\: :ref:`float<class_float>`, pre_a_t\: :ref:`float<class_float>`, post_b_t\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_cubic_interpolate_in_time>`
  377. Performs a cubic interpolation between this vector and ``b`` using ``pre_a`` and ``post_b`` as handles, and returns the result at position ``weight``. ``weight`` is on the range of 0.0 to 1.0, representing the amount of interpolation.
  378. It can perform smoother interpolation than :ref:`cubic_interpolate<class_Vector2_method_cubic_interpolate>` by the time values.
  379. .. rst-class:: classref-item-separator
  380. ----
  381. .. _class_Vector2_method_direction_to:
  382. .. rst-class:: classref-method
  383. :ref:`Vector2<class_Vector2>` **direction_to**\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_direction_to>`
  384. Returns the normalized vector pointing from this vector to ``to``. This is equivalent to using ``(b - a).normalized()``.
  385. .. rst-class:: classref-item-separator
  386. ----
  387. .. _class_Vector2_method_distance_squared_to:
  388. .. rst-class:: classref-method
  389. :ref:`float<class_float>` **distance_squared_to**\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_distance_squared_to>`
  390. Returns the squared distance between this vector and ``to``.
  391. This method runs faster than :ref:`distance_to<class_Vector2_method_distance_to>`, so prefer it if you need to compare vectors or need the squared distance for some formula.
  392. .. rst-class:: classref-item-separator
  393. ----
  394. .. _class_Vector2_method_distance_to:
  395. .. rst-class:: classref-method
  396. :ref:`float<class_float>` **distance_to**\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_distance_to>`
  397. Returns the distance between this vector and ``to``.
  398. .. rst-class:: classref-item-separator
  399. ----
  400. .. _class_Vector2_method_dot:
  401. .. rst-class:: classref-method
  402. :ref:`float<class_float>` **dot**\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_dot>`
  403. Returns the dot product of this vector and ``with``. This can be used to compare the angle between two vectors. For example, this can be used to determine whether an enemy is facing the player.
  404. The dot product will be ``0`` for a right angle (90 degrees), greater than 0 for angles narrower than 90 degrees and lower than 0 for angles wider than 90 degrees.
  405. When using unit (normalized) vectors, the result will always be between ``-1.0`` (180 degree angle) when the vectors are facing opposite directions, and ``1.0`` (0 degree angle) when the vectors are aligned.
  406. \ **Note:** ``a.dot(b)`` is equivalent to ``b.dot(a)``.
  407. .. rst-class:: classref-item-separator
  408. ----
  409. .. _class_Vector2_method_floor:
  410. .. rst-class:: classref-method
  411. :ref:`Vector2<class_Vector2>` **floor**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_floor>`
  412. Returns a new vector with all components rounded down (towards negative infinity).
  413. .. rst-class:: classref-item-separator
  414. ----
  415. .. _class_Vector2_method_from_angle:
  416. .. rst-class:: classref-method
  417. :ref:`Vector2<class_Vector2>` **from_angle**\ (\ angle\: :ref:`float<class_float>`\ ) |static| :ref:`๐Ÿ”—<class_Vector2_method_from_angle>`
  418. Creates a unit **Vector2** rotated to the given ``angle`` in radians. This is equivalent to doing ``Vector2(cos(angle), sin(angle))`` or ``Vector2.RIGHT.rotated(angle)``.
  419. ::
  420. print(Vector2.from_angle(0)) # Prints (1.0, 0.0)
  421. print(Vector2(1, 0).angle()) # Prints 0.0, which is the angle used above.
  422. print(Vector2.from_angle(PI / 2)) # Prints (0.0, 1.0)
  423. .. rst-class:: classref-item-separator
  424. ----
  425. .. _class_Vector2_method_is_equal_approx:
  426. .. rst-class:: classref-method
  427. :ref:`bool<class_bool>` **is_equal_approx**\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_is_equal_approx>`
  428. Returns ``true`` if this vector and ``to`` are approximately equal, by running :ref:`@GlobalScope.is_equal_approx<class_@GlobalScope_method_is_equal_approx>` on each component.
  429. .. rst-class:: classref-item-separator
  430. ----
  431. .. _class_Vector2_method_is_finite:
  432. .. rst-class:: classref-method
  433. :ref:`bool<class_bool>` **is_finite**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_is_finite>`
  434. Returns ``true`` if this vector is finite, by calling :ref:`@GlobalScope.is_finite<class_@GlobalScope_method_is_finite>` on each component.
  435. .. rst-class:: classref-item-separator
  436. ----
  437. .. _class_Vector2_method_is_normalized:
  438. .. rst-class:: classref-method
  439. :ref:`bool<class_bool>` **is_normalized**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_is_normalized>`
  440. Returns ``true`` if the vector is normalized, i.e. its length is approximately equal to 1.
  441. .. rst-class:: classref-item-separator
  442. ----
  443. .. _class_Vector2_method_is_zero_approx:
  444. .. rst-class:: classref-method
  445. :ref:`bool<class_bool>` **is_zero_approx**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_is_zero_approx>`
  446. Returns ``true`` if this vector's values are approximately zero, by running :ref:`@GlobalScope.is_zero_approx<class_@GlobalScope_method_is_zero_approx>` on each component.
  447. This method is faster than using :ref:`is_equal_approx<class_Vector2_method_is_equal_approx>` with one value as a zero vector.
  448. .. rst-class:: classref-item-separator
  449. ----
  450. .. _class_Vector2_method_length:
  451. .. rst-class:: classref-method
  452. :ref:`float<class_float>` **length**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_length>`
  453. Returns the length (magnitude) of this vector.
  454. .. rst-class:: classref-item-separator
  455. ----
  456. .. _class_Vector2_method_length_squared:
  457. .. rst-class:: classref-method
  458. :ref:`float<class_float>` **length_squared**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_length_squared>`
  459. Returns the squared length (squared magnitude) of this vector.
  460. This method runs faster than :ref:`length<class_Vector2_method_length>`, so prefer it if you need to compare vectors or need the squared distance for some formula.
  461. .. rst-class:: classref-item-separator
  462. ----
  463. .. _class_Vector2_method_lerp:
  464. .. rst-class:: classref-method
  465. :ref:`Vector2<class_Vector2>` **lerp**\ (\ to\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_lerp>`
  466. Returns the result of the linear interpolation between this vector and ``to`` by amount ``weight``. ``weight`` is on the range of ``0.0`` to ``1.0``, representing the amount of interpolation.
  467. .. rst-class:: classref-item-separator
  468. ----
  469. .. _class_Vector2_method_limit_length:
  470. .. rst-class:: classref-method
  471. :ref:`Vector2<class_Vector2>` **limit_length**\ (\ length\: :ref:`float<class_float>` = 1.0\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_limit_length>`
  472. Returns the vector with a maximum length by limiting its length to ``length``. If the vector is non-finite, the result is undefined.
  473. .. rst-class:: classref-item-separator
  474. ----
  475. .. _class_Vector2_method_max:
  476. .. rst-class:: classref-method
  477. :ref:`Vector2<class_Vector2>` **max**\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_max>`
  478. Returns the component-wise maximum of this and ``with``, equivalent to ``Vector2(maxf(x, with.x), maxf(y, with.y))``.
  479. .. rst-class:: classref-item-separator
  480. ----
  481. .. _class_Vector2_method_max_axis_index:
  482. .. rst-class:: classref-method
  483. :ref:`int<class_int>` **max_axis_index**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_max_axis_index>`
  484. Returns the axis of the vector's highest value. See ``AXIS_*`` constants. If all components are equal, this method returns :ref:`AXIS_X<class_Vector2_constant_AXIS_X>`.
  485. .. rst-class:: classref-item-separator
  486. ----
  487. .. _class_Vector2_method_maxf:
  488. .. rst-class:: classref-method
  489. :ref:`Vector2<class_Vector2>` **maxf**\ (\ with\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_maxf>`
  490. Returns the component-wise maximum of this and ``with``, equivalent to ``Vector2(maxf(x, with), maxf(y, with))``.
  491. .. rst-class:: classref-item-separator
  492. ----
  493. .. _class_Vector2_method_min:
  494. .. rst-class:: classref-method
  495. :ref:`Vector2<class_Vector2>` **min**\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_min>`
  496. Returns the component-wise minimum of this and ``with``, equivalent to ``Vector2(minf(x, with.x), minf(y, with.y))``.
  497. .. rst-class:: classref-item-separator
  498. ----
  499. .. _class_Vector2_method_min_axis_index:
  500. .. rst-class:: classref-method
  501. :ref:`int<class_int>` **min_axis_index**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_min_axis_index>`
  502. Returns the axis of the vector's lowest value. See ``AXIS_*`` constants. If all components are equal, this method returns :ref:`AXIS_Y<class_Vector2_constant_AXIS_Y>`.
  503. .. rst-class:: classref-item-separator
  504. ----
  505. .. _class_Vector2_method_minf:
  506. .. rst-class:: classref-method
  507. :ref:`Vector2<class_Vector2>` **minf**\ (\ with\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_minf>`
  508. Returns the component-wise minimum of this and ``with``, equivalent to ``Vector2(minf(x, with), minf(y, with))``.
  509. .. rst-class:: classref-item-separator
  510. ----
  511. .. _class_Vector2_method_move_toward:
  512. .. rst-class:: classref-method
  513. :ref:`Vector2<class_Vector2>` **move_toward**\ (\ to\: :ref:`Vector2<class_Vector2>`, delta\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_move_toward>`
  514. Returns a new vector moved toward ``to`` by the fixed ``delta`` amount. Will not go past the final value.
  515. .. rst-class:: classref-item-separator
  516. ----
  517. .. _class_Vector2_method_normalized:
  518. .. rst-class:: classref-method
  519. :ref:`Vector2<class_Vector2>` **normalized**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_normalized>`
  520. Returns the result of scaling the vector to unit length. Equivalent to ``v / v.length()``. Returns ``(0, 0)`` if ``v.length() == 0``. See also :ref:`is_normalized<class_Vector2_method_is_normalized>`.
  521. \ **Note:** This function may return incorrect values if the input vector length is near zero.
  522. .. rst-class:: classref-item-separator
  523. ----
  524. .. _class_Vector2_method_orthogonal:
  525. .. rst-class:: classref-method
  526. :ref:`Vector2<class_Vector2>` **orthogonal**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_orthogonal>`
  527. Returns a perpendicular vector rotated 90 degrees counter-clockwise compared to the original, with the same length.
  528. .. rst-class:: classref-item-separator
  529. ----
  530. .. _class_Vector2_method_posmod:
  531. .. rst-class:: classref-method
  532. :ref:`Vector2<class_Vector2>` **posmod**\ (\ mod\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_posmod>`
  533. Returns a vector composed of the :ref:`@GlobalScope.fposmod<class_@GlobalScope_method_fposmod>` of this vector's components and ``mod``.
  534. .. rst-class:: classref-item-separator
  535. ----
  536. .. _class_Vector2_method_posmodv:
  537. .. rst-class:: classref-method
  538. :ref:`Vector2<class_Vector2>` **posmodv**\ (\ modv\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_posmodv>`
  539. Returns a vector composed of the :ref:`@GlobalScope.fposmod<class_@GlobalScope_method_fposmod>` of this vector's components and ``modv``'s components.
  540. .. rst-class:: classref-item-separator
  541. ----
  542. .. _class_Vector2_method_project:
  543. .. rst-class:: classref-method
  544. :ref:`Vector2<class_Vector2>` **project**\ (\ b\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_project>`
  545. Returns a new vector resulting from projecting this vector onto the given vector ``b``. The resulting new vector is parallel to ``b``. See also :ref:`slide<class_Vector2_method_slide>`.
  546. \ **Note:** If the vector ``b`` is a zero vector, the components of the resulting new vector will be :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
  547. .. rst-class:: classref-item-separator
  548. ----
  549. .. _class_Vector2_method_reflect:
  550. .. rst-class:: classref-method
  551. :ref:`Vector2<class_Vector2>` **reflect**\ (\ line\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_reflect>`
  552. Returns the result of reflecting the vector from a line defined by the given direction vector ``line``.
  553. \ **Note:** :ref:`reflect<class_Vector2_method_reflect>` differs from what other engines and frameworks call ``reflect()``. In other engines, ``reflect()`` takes a normal direction which is a direction perpendicular to the line. In Godot, you specify the direction of the line directly. See also :ref:`bounce<class_Vector2_method_bounce>` which does what most engines call ``reflect()``.
  554. .. rst-class:: classref-item-separator
  555. ----
  556. .. _class_Vector2_method_rotated:
  557. .. rst-class:: classref-method
  558. :ref:`Vector2<class_Vector2>` **rotated**\ (\ angle\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_rotated>`
  559. Returns the result of rotating this vector by ``angle`` (in radians). See also :ref:`@GlobalScope.deg_to_rad<class_@GlobalScope_method_deg_to_rad>`.
  560. .. rst-class:: classref-item-separator
  561. ----
  562. .. _class_Vector2_method_round:
  563. .. rst-class:: classref-method
  564. :ref:`Vector2<class_Vector2>` **round**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_round>`
  565. Returns a new vector with all components rounded to the nearest integer, with halfway cases rounded away from zero.
  566. .. rst-class:: classref-item-separator
  567. ----
  568. .. _class_Vector2_method_sign:
  569. .. rst-class:: classref-method
  570. :ref:`Vector2<class_Vector2>` **sign**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_sign>`
  571. Returns a new vector with each component set to ``1.0`` if it's positive, ``-1.0`` if it's negative, and ``0.0`` if it's zero. The result is identical to calling :ref:`@GlobalScope.sign<class_@GlobalScope_method_sign>` on each component.
  572. .. rst-class:: classref-item-separator
  573. ----
  574. .. _class_Vector2_method_slerp:
  575. .. rst-class:: classref-method
  576. :ref:`Vector2<class_Vector2>` **slerp**\ (\ to\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_slerp>`
  577. Returns the result of spherical linear interpolation between this vector and ``to``, by amount ``weight``. ``weight`` is on the range of 0.0 to 1.0, representing the amount of interpolation.
  578. This method also handles interpolating the lengths if the input vectors have different lengths. For the special case of one or both input vectors having zero length, this method behaves like :ref:`lerp<class_Vector2_method_lerp>`.
  579. .. rst-class:: classref-item-separator
  580. ----
  581. .. _class_Vector2_method_slide:
  582. .. rst-class:: classref-method
  583. :ref:`Vector2<class_Vector2>` **slide**\ (\ n\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_slide>`
  584. Returns a new vector resulting from sliding this vector along a line with normal ``n``. The resulting new vector is perpendicular to ``n``, and is equivalent to this vector minus its projection on ``n``. See also :ref:`project<class_Vector2_method_project>`.
  585. \ **Note:** The vector ``n`` must be normalized. See also :ref:`normalized<class_Vector2_method_normalized>`.
  586. .. rst-class:: classref-item-separator
  587. ----
  588. .. _class_Vector2_method_snapped:
  589. .. rst-class:: classref-method
  590. :ref:`Vector2<class_Vector2>` **snapped**\ (\ step\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_snapped>`
  591. Returns a new vector with each component snapped to the nearest multiple of the corresponding component in ``step``. This can also be used to round the components to an arbitrary number of decimals.
  592. .. rst-class:: classref-item-separator
  593. ----
  594. .. _class_Vector2_method_snappedf:
  595. .. rst-class:: classref-method
  596. :ref:`Vector2<class_Vector2>` **snappedf**\ (\ step\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_snappedf>`
  597. Returns a new vector with each component snapped to the nearest multiple of ``step``. This can also be used to round the components to an arbitrary number of decimals.
  598. .. rst-class:: classref-section-separator
  599. ----
  600. .. rst-class:: classref-descriptions-group
  601. Operator Descriptions
  602. ---------------------
  603. .. _class_Vector2_operator_neq_Vector2:
  604. .. rst-class:: classref-operator
  605. :ref:`bool<class_bool>` **operator !=**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_neq_Vector2>`
  606. Returns ``true`` if the vectors are not equal.
  607. \ **Note:** Due to floating-point precision errors, consider using :ref:`is_equal_approx<class_Vector2_method_is_equal_approx>` instead, which is more reliable.
  608. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this operator may not be accurate if NaNs are included.
  609. .. rst-class:: classref-item-separator
  610. ----
  611. .. _class_Vector2_operator_mul_Transform2D:
  612. .. rst-class:: classref-operator
  613. :ref:`Vector2<class_Vector2>` **operator ***\ (\ right\: :ref:`Transform2D<class_Transform2D>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_mul_Transform2D>`
  614. Inversely transforms (multiplies) the **Vector2** by the given :ref:`Transform2D<class_Transform2D>` transformation matrix, under the assumption that the transformation basis is orthonormal (i.e. rotation/reflection is fine, scaling/skew is not).
  615. \ ``vector * transform`` is equivalent to ``transform.inverse() * vector``. See :ref:`Transform2D.inverse<class_Transform2D_method_inverse>`.
  616. For transforming by inverse of an affine transformation (e.g. with scaling) ``transform.affine_inverse() * vector`` can be used instead. See :ref:`Transform2D.affine_inverse<class_Transform2D_method_affine_inverse>`.
  617. .. rst-class:: classref-item-separator
  618. ----
  619. .. _class_Vector2_operator_mul_Vector2:
  620. .. rst-class:: classref-operator
  621. :ref:`Vector2<class_Vector2>` **operator ***\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_mul_Vector2>`
  622. Multiplies each component of the **Vector2** by the components of the given **Vector2**.
  623. ::
  624. print(Vector2(10, 20) * Vector2(3, 4)) # Prints (30.0, 80.0)
  625. .. rst-class:: classref-item-separator
  626. ----
  627. .. _class_Vector2_operator_mul_float:
  628. .. rst-class:: classref-operator
  629. :ref:`Vector2<class_Vector2>` **operator ***\ (\ right\: :ref:`float<class_float>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_mul_float>`
  630. Multiplies each component of the **Vector2** by the given :ref:`float<class_float>`.
  631. .. rst-class:: classref-item-separator
  632. ----
  633. .. _class_Vector2_operator_mul_int:
  634. .. rst-class:: classref-operator
  635. :ref:`Vector2<class_Vector2>` **operator ***\ (\ right\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_mul_int>`
  636. Multiplies each component of the **Vector2** by the given :ref:`int<class_int>`.
  637. .. rst-class:: classref-item-separator
  638. ----
  639. .. _class_Vector2_operator_sum_Vector2:
  640. .. rst-class:: classref-operator
  641. :ref:`Vector2<class_Vector2>` **operator +**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_sum_Vector2>`
  642. Adds each component of the **Vector2** by the components of the given **Vector2**.
  643. ::
  644. print(Vector2(10, 20) + Vector2(3, 4)) # Prints (13.0, 24.0)
  645. .. rst-class:: classref-item-separator
  646. ----
  647. .. _class_Vector2_operator_dif_Vector2:
  648. .. rst-class:: classref-operator
  649. :ref:`Vector2<class_Vector2>` **operator -**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_dif_Vector2>`
  650. Subtracts each component of the **Vector2** by the components of the given **Vector2**.
  651. ::
  652. print(Vector2(10, 20) - Vector2(3, 4)) # Prints (7.0, 16.0)
  653. .. rst-class:: classref-item-separator
  654. ----
  655. .. _class_Vector2_operator_div_Vector2:
  656. .. rst-class:: classref-operator
  657. :ref:`Vector2<class_Vector2>` **operator /**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_div_Vector2>`
  658. Divides each component of the **Vector2** by the components of the given **Vector2**.
  659. ::
  660. print(Vector2(10, 20) / Vector2(2, 5)) # Prints (5.0, 4.0)
  661. .. rst-class:: classref-item-separator
  662. ----
  663. .. _class_Vector2_operator_div_float:
  664. .. rst-class:: classref-operator
  665. :ref:`Vector2<class_Vector2>` **operator /**\ (\ right\: :ref:`float<class_float>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_div_float>`
  666. Divides each component of the **Vector2** by the given :ref:`float<class_float>`.
  667. .. rst-class:: classref-item-separator
  668. ----
  669. .. _class_Vector2_operator_div_int:
  670. .. rst-class:: classref-operator
  671. :ref:`Vector2<class_Vector2>` **operator /**\ (\ right\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_div_int>`
  672. Divides each component of the **Vector2** by the given :ref:`int<class_int>`.
  673. .. rst-class:: classref-item-separator
  674. ----
  675. .. _class_Vector2_operator_lt_Vector2:
  676. .. rst-class:: classref-operator
  677. :ref:`bool<class_bool>` **operator <**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_lt_Vector2>`
  678. Compares two **Vector2** vectors by first checking if the X value of the left vector is less than the X value of the ``right`` vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors. This operator is useful for sorting vectors.
  679. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this operator may not be accurate if NaNs are included.
  680. .. rst-class:: classref-item-separator
  681. ----
  682. .. _class_Vector2_operator_lte_Vector2:
  683. .. rst-class:: classref-operator
  684. :ref:`bool<class_bool>` **operator <=**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_lte_Vector2>`
  685. Compares two **Vector2** vectors by first checking if the X value of the left vector is less than or equal to the X value of the ``right`` vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors. This operator is useful for sorting vectors.
  686. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this operator may not be accurate if NaNs are included.
  687. .. rst-class:: classref-item-separator
  688. ----
  689. .. _class_Vector2_operator_eq_Vector2:
  690. .. rst-class:: classref-operator
  691. :ref:`bool<class_bool>` **operator ==**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_eq_Vector2>`
  692. Returns ``true`` if the vectors are exactly equal.
  693. \ **Note:** Due to floating-point precision errors, consider using :ref:`is_equal_approx<class_Vector2_method_is_equal_approx>` instead, which is more reliable.
  694. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this operator may not be accurate if NaNs are included.
  695. .. rst-class:: classref-item-separator
  696. ----
  697. .. _class_Vector2_operator_gt_Vector2:
  698. .. rst-class:: classref-operator
  699. :ref:`bool<class_bool>` **operator >**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_gt_Vector2>`
  700. Compares two **Vector2** vectors by first checking if the X value of the left vector is greater than the X value of the ``right`` vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors. This operator is useful for sorting vectors.
  701. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this operator may not be accurate if NaNs are included.
  702. .. rst-class:: classref-item-separator
  703. ----
  704. .. _class_Vector2_operator_gte_Vector2:
  705. .. rst-class:: classref-operator
  706. :ref:`bool<class_bool>` **operator >=**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_gte_Vector2>`
  707. Compares two **Vector2** vectors by first checking if the X value of the left vector is greater than or equal to the X value of the ``right`` vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors. This operator is useful for sorting vectors.
  708. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this operator may not be accurate if NaNs are included.
  709. .. rst-class:: classref-item-separator
  710. ----
  711. .. _class_Vector2_operator_idx_int:
  712. .. rst-class:: classref-operator
  713. :ref:`float<class_float>` **operator []**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_idx_int>`
  714. Access vector components using their ``index``. ``v[0]`` is equivalent to ``v.x``, and ``v[1]`` is equivalent to ``v.y``.
  715. .. rst-class:: classref-item-separator
  716. ----
  717. .. _class_Vector2_operator_unplus:
  718. .. rst-class:: classref-operator
  719. :ref:`Vector2<class_Vector2>` **operator unary+**\ (\ ) :ref:`๐Ÿ”—<class_Vector2_operator_unplus>`
  720. Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable.
  721. .. rst-class:: classref-item-separator
  722. ----
  723. .. _class_Vector2_operator_unminus:
  724. .. rst-class:: classref-operator
  725. :ref:`Vector2<class_Vector2>` **operator unary-**\ (\ ) :ref:`๐Ÿ”—<class_Vector2_operator_unminus>`
  726. Returns the negative value of the **Vector2**. This is the same as writing ``Vector2(-v.x, -v.y)``. This operation flips the direction of the vector while keeping the same magnitude. With floats, the number zero can be either positive or negative.
  727. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  728. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  729. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  730. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  731. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  732. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  733. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  734. .. |void| replace:: :abbr:`void (No return value.)`