class_vector2.rst 83 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298
  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 signed 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 **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. \ **Note:** The length of the returned **Vector2** is *approximately* ``1.0``, but is is not guaranteed to be exactly ``1.0`` due to floating-point precision issues. Call :ref:`normalized()<class_Vector2_method_normalized>` on the returned **Vector2** if you require a unit vector.
  424. .. rst-class:: classref-item-separator
  425. ----
  426. .. _class_Vector2_method_is_equal_approx:
  427. .. rst-class:: classref-method
  428. :ref:`bool<class_bool>` **is_equal_approx**\ (\ to\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_is_equal_approx>`
  429. 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.
  430. .. rst-class:: classref-item-separator
  431. ----
  432. .. _class_Vector2_method_is_finite:
  433. .. rst-class:: classref-method
  434. :ref:`bool<class_bool>` **is_finite**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_is_finite>`
  435. Returns ``true`` if this vector is finite, by calling :ref:`@GlobalScope.is_finite()<class_@GlobalScope_method_is_finite>` on each component.
  436. .. rst-class:: classref-item-separator
  437. ----
  438. .. _class_Vector2_method_is_normalized:
  439. .. rst-class:: classref-method
  440. :ref:`bool<class_bool>` **is_normalized**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_is_normalized>`
  441. Returns ``true`` if the vector is normalized, i.e. its length is approximately equal to 1.
  442. .. rst-class:: classref-item-separator
  443. ----
  444. .. _class_Vector2_method_is_zero_approx:
  445. .. rst-class:: classref-method
  446. :ref:`bool<class_bool>` **is_zero_approx**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_is_zero_approx>`
  447. 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.
  448. This method is faster than using :ref:`is_equal_approx()<class_Vector2_method_is_equal_approx>` with one value as a zero vector.
  449. .. rst-class:: classref-item-separator
  450. ----
  451. .. _class_Vector2_method_length:
  452. .. rst-class:: classref-method
  453. :ref:`float<class_float>` **length**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_length>`
  454. Returns the length (magnitude) of this vector.
  455. .. rst-class:: classref-item-separator
  456. ----
  457. .. _class_Vector2_method_length_squared:
  458. .. rst-class:: classref-method
  459. :ref:`float<class_float>` **length_squared**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_length_squared>`
  460. Returns the squared length (squared magnitude) of this vector.
  461. 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.
  462. .. rst-class:: classref-item-separator
  463. ----
  464. .. _class_Vector2_method_lerp:
  465. .. rst-class:: classref-method
  466. :ref:`Vector2<class_Vector2>` **lerp**\ (\ to\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_lerp>`
  467. 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.
  468. .. rst-class:: classref-item-separator
  469. ----
  470. .. _class_Vector2_method_limit_length:
  471. .. rst-class:: classref-method
  472. :ref:`Vector2<class_Vector2>` **limit_length**\ (\ length\: :ref:`float<class_float>` = 1.0\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_limit_length>`
  473. Returns the vector with a maximum length by limiting its length to ``length``. If the vector is non-finite, the result is undefined.
  474. .. rst-class:: classref-item-separator
  475. ----
  476. .. _class_Vector2_method_max:
  477. .. rst-class:: classref-method
  478. :ref:`Vector2<class_Vector2>` **max**\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_max>`
  479. Returns the component-wise maximum of this and ``with``, equivalent to ``Vector2(maxf(x, with.x), maxf(y, with.y))``.
  480. .. rst-class:: classref-item-separator
  481. ----
  482. .. _class_Vector2_method_max_axis_index:
  483. .. rst-class:: classref-method
  484. :ref:`int<class_int>` **max_axis_index**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_max_axis_index>`
  485. 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>`.
  486. .. rst-class:: classref-item-separator
  487. ----
  488. .. _class_Vector2_method_maxf:
  489. .. rst-class:: classref-method
  490. :ref:`Vector2<class_Vector2>` **maxf**\ (\ with\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_maxf>`
  491. Returns the component-wise maximum of this and ``with``, equivalent to ``Vector2(maxf(x, with), maxf(y, with))``.
  492. .. rst-class:: classref-item-separator
  493. ----
  494. .. _class_Vector2_method_min:
  495. .. rst-class:: classref-method
  496. :ref:`Vector2<class_Vector2>` **min**\ (\ with\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_min>`
  497. Returns the component-wise minimum of this and ``with``, equivalent to ``Vector2(minf(x, with.x), minf(y, with.y))``.
  498. .. rst-class:: classref-item-separator
  499. ----
  500. .. _class_Vector2_method_min_axis_index:
  501. .. rst-class:: classref-method
  502. :ref:`int<class_int>` **min_axis_index**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_min_axis_index>`
  503. 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>`.
  504. .. rst-class:: classref-item-separator
  505. ----
  506. .. _class_Vector2_method_minf:
  507. .. rst-class:: classref-method
  508. :ref:`Vector2<class_Vector2>` **minf**\ (\ with\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_minf>`
  509. Returns the component-wise minimum of this and ``with``, equivalent to ``Vector2(minf(x, with), minf(y, with))``.
  510. .. rst-class:: classref-item-separator
  511. ----
  512. .. _class_Vector2_method_move_toward:
  513. .. rst-class:: classref-method
  514. :ref:`Vector2<class_Vector2>` **move_toward**\ (\ to\: :ref:`Vector2<class_Vector2>`, delta\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_move_toward>`
  515. Returns a new vector moved toward ``to`` by the fixed ``delta`` amount. Will not go past the final value.
  516. .. rst-class:: classref-item-separator
  517. ----
  518. .. _class_Vector2_method_normalized:
  519. .. rst-class:: classref-method
  520. :ref:`Vector2<class_Vector2>` **normalized**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_normalized>`
  521. 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>`.
  522. \ **Note:** This function may return incorrect values if the input vector length is near zero.
  523. .. rst-class:: classref-item-separator
  524. ----
  525. .. _class_Vector2_method_orthogonal:
  526. .. rst-class:: classref-method
  527. :ref:`Vector2<class_Vector2>` **orthogonal**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_orthogonal>`
  528. Returns a perpendicular vector rotated 90 degrees counter-clockwise compared to the original, with the same length.
  529. .. rst-class:: classref-item-separator
  530. ----
  531. .. _class_Vector2_method_posmod:
  532. .. rst-class:: classref-method
  533. :ref:`Vector2<class_Vector2>` **posmod**\ (\ mod\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_posmod>`
  534. Returns a vector composed of the :ref:`@GlobalScope.fposmod()<class_@GlobalScope_method_fposmod>` of this vector's components and ``mod``.
  535. .. rst-class:: classref-item-separator
  536. ----
  537. .. _class_Vector2_method_posmodv:
  538. .. rst-class:: classref-method
  539. :ref:`Vector2<class_Vector2>` **posmodv**\ (\ modv\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_posmodv>`
  540. Returns a vector composed of the :ref:`@GlobalScope.fposmod()<class_@GlobalScope_method_fposmod>` of this vector's components and ``modv``'s components.
  541. .. rst-class:: classref-item-separator
  542. ----
  543. .. _class_Vector2_method_project:
  544. .. rst-class:: classref-method
  545. :ref:`Vector2<class_Vector2>` **project**\ (\ b\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_project>`
  546. 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>`.
  547. \ **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>`.
  548. .. rst-class:: classref-item-separator
  549. ----
  550. .. _class_Vector2_method_reflect:
  551. .. rst-class:: classref-method
  552. :ref:`Vector2<class_Vector2>` **reflect**\ (\ line\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_reflect>`
  553. Returns the result of reflecting the vector from a line defined by the given direction vector ``line``.
  554. \ **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()``.
  555. .. rst-class:: classref-item-separator
  556. ----
  557. .. _class_Vector2_method_rotated:
  558. .. rst-class:: classref-method
  559. :ref:`Vector2<class_Vector2>` **rotated**\ (\ angle\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_rotated>`
  560. Returns the result of rotating this vector by ``angle`` (in radians). See also :ref:`@GlobalScope.deg_to_rad()<class_@GlobalScope_method_deg_to_rad>`.
  561. .. rst-class:: classref-item-separator
  562. ----
  563. .. _class_Vector2_method_round:
  564. .. rst-class:: classref-method
  565. :ref:`Vector2<class_Vector2>` **round**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_round>`
  566. Returns a new vector with all components rounded to the nearest integer, with halfway cases rounded away from zero.
  567. .. rst-class:: classref-item-separator
  568. ----
  569. .. _class_Vector2_method_sign:
  570. .. rst-class:: classref-method
  571. :ref:`Vector2<class_Vector2>` **sign**\ (\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_sign>`
  572. 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.
  573. .. rst-class:: classref-item-separator
  574. ----
  575. .. _class_Vector2_method_slerp:
  576. .. rst-class:: classref-method
  577. :ref:`Vector2<class_Vector2>` **slerp**\ (\ to\: :ref:`Vector2<class_Vector2>`, weight\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_slerp>`
  578. 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.
  579. 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>`.
  580. .. rst-class:: classref-item-separator
  581. ----
  582. .. _class_Vector2_method_slide:
  583. .. rst-class:: classref-method
  584. :ref:`Vector2<class_Vector2>` **slide**\ (\ n\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_slide>`
  585. 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>`.
  586. \ **Note:** The vector ``n`` must be normalized. See also :ref:`normalized()<class_Vector2_method_normalized>`.
  587. .. rst-class:: classref-item-separator
  588. ----
  589. .. _class_Vector2_method_snapped:
  590. .. rst-class:: classref-method
  591. :ref:`Vector2<class_Vector2>` **snapped**\ (\ step\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_snapped>`
  592. 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.
  593. .. rst-class:: classref-item-separator
  594. ----
  595. .. _class_Vector2_method_snappedf:
  596. .. rst-class:: classref-method
  597. :ref:`Vector2<class_Vector2>` **snappedf**\ (\ step\: :ref:`float<class_float>`\ ) |const| :ref:`๐Ÿ”—<class_Vector2_method_snappedf>`
  598. 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.
  599. .. rst-class:: classref-section-separator
  600. ----
  601. .. rst-class:: classref-descriptions-group
  602. Operator Descriptions
  603. ---------------------
  604. .. _class_Vector2_operator_neq_Vector2:
  605. .. rst-class:: classref-operator
  606. :ref:`bool<class_bool>` **operator !=**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_neq_Vector2>`
  607. Returns ``true`` if the vectors are not equal.
  608. \ **Note:** Due to floating-point precision errors, consider using :ref:`is_equal_approx()<class_Vector2_method_is_equal_approx>` instead, which is more reliable.
  609. \ **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.
  610. .. rst-class:: classref-item-separator
  611. ----
  612. .. _class_Vector2_operator_mul_Transform2D:
  613. .. rst-class:: classref-operator
  614. :ref:`Vector2<class_Vector2>` **operator ***\ (\ right\: :ref:`Transform2D<class_Transform2D>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_mul_Transform2D>`
  615. 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).
  616. \ ``vector * transform`` is equivalent to ``transform.inverse() * vector``. See :ref:`Transform2D.inverse()<class_Transform2D_method_inverse>`.
  617. 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>`.
  618. .. rst-class:: classref-item-separator
  619. ----
  620. .. _class_Vector2_operator_mul_Vector2:
  621. .. rst-class:: classref-operator
  622. :ref:`Vector2<class_Vector2>` **operator ***\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_mul_Vector2>`
  623. Multiplies each component of the **Vector2** by the components of the given **Vector2**.
  624. ::
  625. print(Vector2(10, 20) * Vector2(3, 4)) # Prints (30.0, 80.0)
  626. .. rst-class:: classref-item-separator
  627. ----
  628. .. _class_Vector2_operator_mul_float:
  629. .. rst-class:: classref-operator
  630. :ref:`Vector2<class_Vector2>` **operator ***\ (\ right\: :ref:`float<class_float>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_mul_float>`
  631. Multiplies each component of the **Vector2** by the given :ref:`float<class_float>`.
  632. .. rst-class:: classref-item-separator
  633. ----
  634. .. _class_Vector2_operator_mul_int:
  635. .. rst-class:: classref-operator
  636. :ref:`Vector2<class_Vector2>` **operator ***\ (\ right\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_mul_int>`
  637. Multiplies each component of the **Vector2** by the given :ref:`int<class_int>`.
  638. .. rst-class:: classref-item-separator
  639. ----
  640. .. _class_Vector2_operator_sum_Vector2:
  641. .. rst-class:: classref-operator
  642. :ref:`Vector2<class_Vector2>` **operator +**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_sum_Vector2>`
  643. Adds each component of the **Vector2** by the components of the given **Vector2**.
  644. ::
  645. print(Vector2(10, 20) + Vector2(3, 4)) # Prints (13.0, 24.0)
  646. .. rst-class:: classref-item-separator
  647. ----
  648. .. _class_Vector2_operator_dif_Vector2:
  649. .. rst-class:: classref-operator
  650. :ref:`Vector2<class_Vector2>` **operator -**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_dif_Vector2>`
  651. Subtracts each component of the **Vector2** by the components of the given **Vector2**.
  652. ::
  653. print(Vector2(10, 20) - Vector2(3, 4)) # Prints (7.0, 16.0)
  654. .. rst-class:: classref-item-separator
  655. ----
  656. .. _class_Vector2_operator_div_Vector2:
  657. .. rst-class:: classref-operator
  658. :ref:`Vector2<class_Vector2>` **operator /**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_div_Vector2>`
  659. Divides each component of the **Vector2** by the components of the given **Vector2**.
  660. ::
  661. print(Vector2(10, 20) / Vector2(2, 5)) # Prints (5.0, 4.0)
  662. .. rst-class:: classref-item-separator
  663. ----
  664. .. _class_Vector2_operator_div_float:
  665. .. rst-class:: classref-operator
  666. :ref:`Vector2<class_Vector2>` **operator /**\ (\ right\: :ref:`float<class_float>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_div_float>`
  667. Divides each component of the **Vector2** by the given :ref:`float<class_float>`.
  668. .. rst-class:: classref-item-separator
  669. ----
  670. .. _class_Vector2_operator_div_int:
  671. .. rst-class:: classref-operator
  672. :ref:`Vector2<class_Vector2>` **operator /**\ (\ right\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_div_int>`
  673. Divides each component of the **Vector2** by the given :ref:`int<class_int>`.
  674. .. rst-class:: classref-item-separator
  675. ----
  676. .. _class_Vector2_operator_lt_Vector2:
  677. .. rst-class:: classref-operator
  678. :ref:`bool<class_bool>` **operator <**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_lt_Vector2>`
  679. 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.
  680. \ **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.
  681. .. rst-class:: classref-item-separator
  682. ----
  683. .. _class_Vector2_operator_lte_Vector2:
  684. .. rst-class:: classref-operator
  685. :ref:`bool<class_bool>` **operator <=**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_lte_Vector2>`
  686. 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.
  687. \ **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.
  688. .. rst-class:: classref-item-separator
  689. ----
  690. .. _class_Vector2_operator_eq_Vector2:
  691. .. rst-class:: classref-operator
  692. :ref:`bool<class_bool>` **operator ==**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_eq_Vector2>`
  693. Returns ``true`` if the vectors are exactly equal.
  694. \ **Note:** Due to floating-point precision errors, consider using :ref:`is_equal_approx()<class_Vector2_method_is_equal_approx>` instead, which is more reliable.
  695. \ **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.
  696. .. rst-class:: classref-item-separator
  697. ----
  698. .. _class_Vector2_operator_gt_Vector2:
  699. .. rst-class:: classref-operator
  700. :ref:`bool<class_bool>` **operator >**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_gt_Vector2>`
  701. 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.
  702. \ **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.
  703. .. rst-class:: classref-item-separator
  704. ----
  705. .. _class_Vector2_operator_gte_Vector2:
  706. .. rst-class:: classref-operator
  707. :ref:`bool<class_bool>` **operator >=**\ (\ right\: :ref:`Vector2<class_Vector2>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_gte_Vector2>`
  708. 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.
  709. \ **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.
  710. .. rst-class:: classref-item-separator
  711. ----
  712. .. _class_Vector2_operator_idx_int:
  713. .. rst-class:: classref-operator
  714. :ref:`float<class_float>` **operator []**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`๐Ÿ”—<class_Vector2_operator_idx_int>`
  715. Access vector components using their ``index``. ``v[0]`` is equivalent to ``v.x``, and ``v[1]`` is equivalent to ``v.y``.
  716. .. rst-class:: classref-item-separator
  717. ----
  718. .. _class_Vector2_operator_unplus:
  719. .. rst-class:: classref-operator
  720. :ref:`Vector2<class_Vector2>` **operator unary+**\ (\ ) :ref:`๐Ÿ”—<class_Vector2_operator_unplus>`
  721. Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable.
  722. .. rst-class:: classref-item-separator
  723. ----
  724. .. _class_Vector2_operator_unminus:
  725. .. rst-class:: classref-operator
  726. :ref:`Vector2<class_Vector2>` **operator unary-**\ (\ ) :ref:`๐Ÿ”—<class_Vector2_operator_unminus>`
  727. 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.
  728. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  729. .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
  730. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  731. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  732. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  733. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  734. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  735. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  736. .. |void| replace:: :abbr:`void (No return value.)`