class_packedvector2array.rst 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555
  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/PackedVector2Array.xml.
  6. .. _class_PackedVector2Array:
  7. PackedVector2Array
  8. ==================
  9. A packed array of :ref:`Vector2<class_Vector2>`\ s.
  10. .. rst-class:: classref-introduction-group
  11. Description
  12. -----------
  13. An array specifically designed to hold :ref:`Vector2<class_Vector2>`. Packs data tightly, so it saves memory for large array sizes.
  14. \ **Differences between packed arrays, typed arrays, and untyped arrays:** Packed arrays are generally faster to iterate on and modify compared to a typed array of the same type (e.g. **PackedVector2Array** versus ``Array[Vector2]``). Also, packed arrays consume less memory. As a downside, packed arrays are less flexible as they don't offer as many convenience methods such as :ref:`Array.map()<class_Array_method_map>`. Typed arrays are in turn faster to iterate on and modify than untyped arrays.
  15. \ **Note:** Packed arrays are always passed by reference. To get a copy of an array that can be modified independently of the original array, use :ref:`duplicate()<class_PackedVector2Array_method_duplicate>`. This is *not* the case for built-in properties and methods. In these cases the returned packed array is a copy, and changing it will *not* affect the original value. To update a built-in property of this type, modify the returned array and then assign it to the property again.
  16. .. note::
  17. There are notable differences when using this API with C#. See :ref:`doc_c_sharp_differences` for more information.
  18. .. rst-class:: classref-introduction-group
  19. Tutorials
  20. ---------
  21. - `Grid-based Navigation with AStarGrid2D Demo <https://godotengine.org/asset-library/asset/2723>`__
  22. .. rst-class:: classref-reftable-group
  23. Constructors
  24. ------------
  25. .. table::
  26. :widths: auto
  27. +-----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
  28. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`PackedVector2Array<class_PackedVector2Array_constructor_PackedVector2Array>`\ (\ ) |
  29. +-----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
  30. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`PackedVector2Array<class_PackedVector2Array_constructor_PackedVector2Array>`\ (\ from\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) |
  31. +-----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
  32. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`PackedVector2Array<class_PackedVector2Array_constructor_PackedVector2Array>`\ (\ from\: :ref:`Array<class_Array>`\ ) |
  33. +-----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
  34. .. rst-class:: classref-reftable-group
  35. Methods
  36. -------
  37. .. table::
  38. :widths: auto
  39. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`bool<class_bool>` | :ref:`append<class_PackedVector2Array_method_append>`\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) |
  41. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  42. | |void| | :ref:`append_array<class_PackedVector2Array_method_append_array>`\ (\ array\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) |
  43. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`int<class_int>` | :ref:`bsearch<class_PackedVector2Array_method_bsearch>`\ (\ value\: :ref:`Vector2<class_Vector2>`, before\: :ref:`bool<class_bool>` = true\ ) |
  45. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  46. | |void| | :ref:`clear<class_PackedVector2Array_method_clear>`\ (\ ) |
  47. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  48. | :ref:`int<class_int>` | :ref:`count<class_PackedVector2Array_method_count>`\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  49. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  50. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`duplicate<class_PackedVector2Array_method_duplicate>`\ (\ ) |
  51. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  52. | :ref:`bool<class_bool>` | :ref:`erase<class_PackedVector2Array_method_erase>`\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) |
  53. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  54. | |void| | :ref:`fill<class_PackedVector2Array_method_fill>`\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) |
  55. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`int<class_int>` | :ref:`find<class_PackedVector2Array_method_find>`\ (\ value\: :ref:`Vector2<class_Vector2>`, from\: :ref:`int<class_int>` = 0\ ) |const| |
  57. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`Vector2<class_Vector2>` | :ref:`get<class_PackedVector2Array_method_get>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  59. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`bool<class_bool>` | :ref:`has<class_PackedVector2Array_method_has>`\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) |const| |
  61. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`int<class_int>` | :ref:`insert<class_PackedVector2Array_method_insert>`\ (\ at_index\: :ref:`int<class_int>`, value\: :ref:`Vector2<class_Vector2>`\ ) |
  63. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`bool<class_bool>` | :ref:`is_empty<class_PackedVector2Array_method_is_empty>`\ (\ ) |const| |
  65. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`bool<class_bool>` | :ref:`push_back<class_PackedVector2Array_method_push_back>`\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) |
  67. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  68. | |void| | :ref:`remove_at<class_PackedVector2Array_method_remove_at>`\ (\ index\: :ref:`int<class_int>`\ ) |
  69. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  70. | :ref:`int<class_int>` | :ref:`resize<class_PackedVector2Array_method_resize>`\ (\ new_size\: :ref:`int<class_int>`\ ) |
  71. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  72. | |void| | :ref:`reverse<class_PackedVector2Array_method_reverse>`\ (\ ) |
  73. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  74. | :ref:`int<class_int>` | :ref:`rfind<class_PackedVector2Array_method_rfind>`\ (\ value\: :ref:`Vector2<class_Vector2>`, from\: :ref:`int<class_int>` = -1\ ) |const| |
  75. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  76. | |void| | :ref:`set<class_PackedVector2Array_method_set>`\ (\ index\: :ref:`int<class_int>`, value\: :ref:`Vector2<class_Vector2>`\ ) |
  77. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  78. | :ref:`int<class_int>` | :ref:`size<class_PackedVector2Array_method_size>`\ (\ ) |const| |
  79. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  80. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`slice<class_PackedVector2Array_method_slice>`\ (\ begin\: :ref:`int<class_int>`, end\: :ref:`int<class_int>` = 2147483647\ ) |const| |
  81. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  82. | |void| | :ref:`sort<class_PackedVector2Array_method_sort>`\ (\ ) |
  83. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  84. | :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`to_byte_array<class_PackedVector2Array_method_to_byte_array>`\ (\ ) |const| |
  85. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  86. .. rst-class:: classref-reftable-group
  87. Operators
  88. ---------
  89. .. table::
  90. :widths: auto
  91. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  92. | :ref:`bool<class_bool>` | :ref:`operator !=<class_PackedVector2Array_operator_neq_PackedVector2Array>`\ (\ right\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) |
  93. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  94. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`operator *<class_PackedVector2Array_operator_mul_Transform2D>`\ (\ right\: :ref:`Transform2D<class_Transform2D>`\ ) |
  95. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  96. | :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`operator +<class_PackedVector2Array_operator_sum_PackedVector2Array>`\ (\ right\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) |
  97. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  98. | :ref:`bool<class_bool>` | :ref:`operator ==<class_PackedVector2Array_operator_eq_PackedVector2Array>`\ (\ right\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) |
  99. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  100. | :ref:`Vector2<class_Vector2>` | :ref:`operator []<class_PackedVector2Array_operator_idx_int>`\ (\ index\: :ref:`int<class_int>`\ ) |
  101. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  102. .. rst-class:: classref-section-separator
  103. ----
  104. .. rst-class:: classref-descriptions-group
  105. Constructor Descriptions
  106. ------------------------
  107. .. _class_PackedVector2Array_constructor_PackedVector2Array:
  108. .. rst-class:: classref-constructor
  109. :ref:`PackedVector2Array<class_PackedVector2Array>` **PackedVector2Array**\ (\ ) :ref:`🔗<class_PackedVector2Array_constructor_PackedVector2Array>`
  110. Constructs an empty **PackedVector2Array**.
  111. .. rst-class:: classref-item-separator
  112. ----
  113. .. rst-class:: classref-constructor
  114. :ref:`PackedVector2Array<class_PackedVector2Array>` **PackedVector2Array**\ (\ from\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ )
  115. Constructs a **PackedVector2Array** as a copy of the given **PackedVector2Array**.
  116. .. rst-class:: classref-item-separator
  117. ----
  118. .. rst-class:: classref-constructor
  119. :ref:`PackedVector2Array<class_PackedVector2Array>` **PackedVector2Array**\ (\ from\: :ref:`Array<class_Array>`\ )
  120. Constructs a new **PackedVector2Array**. Optionally, you can pass in a generic :ref:`Array<class_Array>` that will be converted.
  121. \ **Note:** When initializing a **PackedVector2Array** with elements, it must be initialized with an :ref:`Array<class_Array>` of :ref:`Vector2<class_Vector2>` values:
  122. ::
  123. var array = PackedVector2Array([Vector2(12, 34), Vector2(56, 78)])
  124. .. rst-class:: classref-section-separator
  125. ----
  126. .. rst-class:: classref-descriptions-group
  127. Method Descriptions
  128. -------------------
  129. .. _class_PackedVector2Array_method_append:
  130. .. rst-class:: classref-method
  131. :ref:`bool<class_bool>` **append**\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) :ref:`🔗<class_PackedVector2Array_method_append>`
  132. Appends an element at the end of the array (alias of :ref:`push_back()<class_PackedVector2Array_method_push_back>`).
  133. .. rst-class:: classref-item-separator
  134. ----
  135. .. _class_PackedVector2Array_method_append_array:
  136. .. rst-class:: classref-method
  137. |void| **append_array**\ (\ array\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) :ref:`🔗<class_PackedVector2Array_method_append_array>`
  138. Appends a **PackedVector2Array** at the end of this array.
  139. .. rst-class:: classref-item-separator
  140. ----
  141. .. _class_PackedVector2Array_method_bsearch:
  142. .. rst-class:: classref-method
  143. :ref:`int<class_int>` **bsearch**\ (\ value\: :ref:`Vector2<class_Vector2>`, before\: :ref:`bool<class_bool>` = true\ ) :ref:`🔗<class_PackedVector2Array_method_bsearch>`
  144. Finds the index of an existing value (or the insertion index that maintains sorting order, if the value is not yet present in the array) using binary search. Optionally, a ``before`` specifier can be passed. If ``false``, the returned index comes after all existing entries of the value in the array.
  145. \ **Note:** Calling :ref:`bsearch()<class_PackedVector2Array_method_bsearch>` on an unsorted array results in unexpected behavior.
  146. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this method may not be accurate if NaNs are included.
  147. .. rst-class:: classref-item-separator
  148. ----
  149. .. _class_PackedVector2Array_method_clear:
  150. .. rst-class:: classref-method
  151. |void| **clear**\ (\ ) :ref:`🔗<class_PackedVector2Array_method_clear>`
  152. Clears the array. This is equivalent to using :ref:`resize()<class_PackedVector2Array_method_resize>` with a size of ``0``.
  153. .. rst-class:: classref-item-separator
  154. ----
  155. .. _class_PackedVector2Array_method_count:
  156. .. rst-class:: classref-method
  157. :ref:`int<class_int>` **count**\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`🔗<class_PackedVector2Array_method_count>`
  158. Returns the number of times an element is in the array.
  159. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this method may not be accurate if NaNs are included.
  160. .. rst-class:: classref-item-separator
  161. ----
  162. .. _class_PackedVector2Array_method_duplicate:
  163. .. rst-class:: classref-method
  164. :ref:`PackedVector2Array<class_PackedVector2Array>` **duplicate**\ (\ ) :ref:`🔗<class_PackedVector2Array_method_duplicate>`
  165. Creates a copy of the array, and returns it.
  166. .. rst-class:: classref-item-separator
  167. ----
  168. .. _class_PackedVector2Array_method_erase:
  169. .. rst-class:: classref-method
  170. :ref:`bool<class_bool>` **erase**\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) :ref:`🔗<class_PackedVector2Array_method_erase>`
  171. Removes the first occurrence of a value from the array and returns ``true``. If the value does not exist in the array, nothing happens and ``false`` is returned. To remove an element by index, use :ref:`remove_at()<class_PackedVector2Array_method_remove_at>` instead.
  172. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this method may not be accurate if NaNs are included.
  173. .. rst-class:: classref-item-separator
  174. ----
  175. .. _class_PackedVector2Array_method_fill:
  176. .. rst-class:: classref-method
  177. |void| **fill**\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) :ref:`🔗<class_PackedVector2Array_method_fill>`
  178. Assigns the given value to all elements in the array. This can typically be used together with :ref:`resize()<class_PackedVector2Array_method_resize>` to create an array with a given size and initialized elements.
  179. .. rst-class:: classref-item-separator
  180. ----
  181. .. _class_PackedVector2Array_method_find:
  182. .. rst-class:: classref-method
  183. :ref:`int<class_int>` **find**\ (\ value\: :ref:`Vector2<class_Vector2>`, from\: :ref:`int<class_int>` = 0\ ) |const| :ref:`🔗<class_PackedVector2Array_method_find>`
  184. Searches the array for a value and returns its index or ``-1`` if not found. Optionally, the initial search index can be passed.
  185. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this method may not be accurate if NaNs are included.
  186. .. rst-class:: classref-item-separator
  187. ----
  188. .. _class_PackedVector2Array_method_get:
  189. .. rst-class:: classref-method
  190. :ref:`Vector2<class_Vector2>` **get**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PackedVector2Array_method_get>`
  191. Returns the :ref:`Vector2<class_Vector2>` at the given ``index`` in the array. If ``index`` out-of-bounds or negative, this method fails and returns ``Vector2(0, 0)``.
  192. This method is similar (but not identical) to the ``[]`` operator. Most notably, when this method fails, it doesn't pause project execution if run from the editor.
  193. .. rst-class:: classref-item-separator
  194. ----
  195. .. _class_PackedVector2Array_method_has:
  196. .. rst-class:: classref-method
  197. :ref:`bool<class_bool>` **has**\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) |const| :ref:`🔗<class_PackedVector2Array_method_has>`
  198. Returns ``true`` if the array contains ``value``.
  199. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this method may not be accurate if NaNs are included.
  200. .. rst-class:: classref-item-separator
  201. ----
  202. .. _class_PackedVector2Array_method_insert:
  203. .. rst-class:: classref-method
  204. :ref:`int<class_int>` **insert**\ (\ at_index\: :ref:`int<class_int>`, value\: :ref:`Vector2<class_Vector2>`\ ) :ref:`🔗<class_PackedVector2Array_method_insert>`
  205. Inserts a new element at a given position in the array. The position must be valid, or at the end of the array (``idx == size()``).
  206. .. rst-class:: classref-item-separator
  207. ----
  208. .. _class_PackedVector2Array_method_is_empty:
  209. .. rst-class:: classref-method
  210. :ref:`bool<class_bool>` **is_empty**\ (\ ) |const| :ref:`🔗<class_PackedVector2Array_method_is_empty>`
  211. Returns ``true`` if the array is empty.
  212. .. rst-class:: classref-item-separator
  213. ----
  214. .. _class_PackedVector2Array_method_push_back:
  215. .. rst-class:: classref-method
  216. :ref:`bool<class_bool>` **push_back**\ (\ value\: :ref:`Vector2<class_Vector2>`\ ) :ref:`🔗<class_PackedVector2Array_method_push_back>`
  217. Inserts a :ref:`Vector2<class_Vector2>` at the end.
  218. .. rst-class:: classref-item-separator
  219. ----
  220. .. _class_PackedVector2Array_method_remove_at:
  221. .. rst-class:: classref-method
  222. |void| **remove_at**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PackedVector2Array_method_remove_at>`
  223. Removes an element from the array by index.
  224. .. rst-class:: classref-item-separator
  225. ----
  226. .. _class_PackedVector2Array_method_resize:
  227. .. rst-class:: classref-method
  228. :ref:`int<class_int>` **resize**\ (\ new_size\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PackedVector2Array_method_resize>`
  229. Sets the size of the array. If the array is grown, reserves elements at the end of the array. If the array is shrunk, truncates the array to the new size. Calling :ref:`resize()<class_PackedVector2Array_method_resize>` once and assigning the new values is faster than adding new elements one by one.
  230. Returns :ref:`@GlobalScope.OK<class_@GlobalScope_constant_OK>` on success, or one of the following :ref:`Error<enum_@GlobalScope_Error>` constants if this method fails: :ref:`@GlobalScope.ERR_INVALID_PARAMETER<class_@GlobalScope_constant_ERR_INVALID_PARAMETER>` if the size is negative, or :ref:`@GlobalScope.ERR_OUT_OF_MEMORY<class_@GlobalScope_constant_ERR_OUT_OF_MEMORY>` if allocations fail. Use :ref:`size()<class_PackedVector2Array_method_size>` to find the actual size of the array after resize.
  231. .. rst-class:: classref-item-separator
  232. ----
  233. .. _class_PackedVector2Array_method_reverse:
  234. .. rst-class:: classref-method
  235. |void| **reverse**\ (\ ) :ref:`🔗<class_PackedVector2Array_method_reverse>`
  236. Reverses the order of the elements in the array.
  237. .. rst-class:: classref-item-separator
  238. ----
  239. .. _class_PackedVector2Array_method_rfind:
  240. .. rst-class:: classref-method
  241. :ref:`int<class_int>` **rfind**\ (\ value\: :ref:`Vector2<class_Vector2>`, from\: :ref:`int<class_int>` = -1\ ) |const| :ref:`🔗<class_PackedVector2Array_method_rfind>`
  242. Searches the array in reverse order. Optionally, a start search index can be passed. If negative, the start index is considered relative to the end of the array.
  243. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this method may not be accurate if NaNs are included.
  244. .. rst-class:: classref-item-separator
  245. ----
  246. .. _class_PackedVector2Array_method_set:
  247. .. rst-class:: classref-method
  248. |void| **set**\ (\ index\: :ref:`int<class_int>`, value\: :ref:`Vector2<class_Vector2>`\ ) :ref:`🔗<class_PackedVector2Array_method_set>`
  249. Changes the :ref:`Vector2<class_Vector2>` at the given index.
  250. .. rst-class:: classref-item-separator
  251. ----
  252. .. _class_PackedVector2Array_method_size:
  253. .. rst-class:: classref-method
  254. :ref:`int<class_int>` **size**\ (\ ) |const| :ref:`🔗<class_PackedVector2Array_method_size>`
  255. Returns the number of elements in the array.
  256. .. rst-class:: classref-item-separator
  257. ----
  258. .. _class_PackedVector2Array_method_slice:
  259. .. rst-class:: classref-method
  260. :ref:`PackedVector2Array<class_PackedVector2Array>` **slice**\ (\ begin\: :ref:`int<class_int>`, end\: :ref:`int<class_int>` = 2147483647\ ) |const| :ref:`🔗<class_PackedVector2Array_method_slice>`
  261. Returns the slice of the **PackedVector2Array**, from ``begin`` (inclusive) to ``end`` (exclusive), as a new **PackedVector2Array**.
  262. The absolute value of ``begin`` and ``end`` will be clamped to the array size, so the default value for ``end`` makes it slice to the size of the array by default (i.e. ``arr.slice(1)`` is a shorthand for ``arr.slice(1, arr.size())``).
  263. If either ``begin`` or ``end`` are negative, they will be relative to the end of the array (i.e. ``arr.slice(0, -2)`` is a shorthand for ``arr.slice(0, arr.size() - 2)``).
  264. .. rst-class:: classref-item-separator
  265. ----
  266. .. _class_PackedVector2Array_method_sort:
  267. .. rst-class:: classref-method
  268. |void| **sort**\ (\ ) :ref:`🔗<class_PackedVector2Array_method_sort>`
  269. Sorts the elements of the array in ascending order.
  270. \ **Note:** Vectors with :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` elements don't behave the same as other vectors. Therefore, the results from this method may not be accurate if NaNs are included.
  271. .. rst-class:: classref-item-separator
  272. ----
  273. .. _class_PackedVector2Array_method_to_byte_array:
  274. .. rst-class:: classref-method
  275. :ref:`PackedByteArray<class_PackedByteArray>` **to_byte_array**\ (\ ) |const| :ref:`🔗<class_PackedVector2Array_method_to_byte_array>`
  276. Returns a :ref:`PackedByteArray<class_PackedByteArray>` with each vector encoded as bytes.
  277. .. rst-class:: classref-section-separator
  278. ----
  279. .. rst-class:: classref-descriptions-group
  280. Operator Descriptions
  281. ---------------------
  282. .. _class_PackedVector2Array_operator_neq_PackedVector2Array:
  283. .. rst-class:: classref-operator
  284. :ref:`bool<class_bool>` **operator !=**\ (\ right\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) :ref:`🔗<class_PackedVector2Array_operator_neq_PackedVector2Array>`
  285. Returns ``true`` if contents of the arrays differ.
  286. .. rst-class:: classref-item-separator
  287. ----
  288. .. _class_PackedVector2Array_operator_mul_Transform2D:
  289. .. rst-class:: classref-operator
  290. :ref:`PackedVector2Array<class_PackedVector2Array>` **operator ***\ (\ right\: :ref:`Transform2D<class_Transform2D>`\ ) :ref:`🔗<class_PackedVector2Array_operator_mul_Transform2D>`
  291. Returns a new **PackedVector2Array** with all vectors in this array inversely transformed (multiplied) 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).
  292. \ ``array * transform`` is equivalent to ``transform.inverse() * array``. See :ref:`Transform2D.inverse()<class_Transform2D_method_inverse>`.
  293. For transforming by inverse of an affine transformation (e.g. with scaling) ``transform.affine_inverse() * array`` can be used instead. See :ref:`Transform2D.affine_inverse()<class_Transform2D_method_affine_inverse>`.
  294. .. rst-class:: classref-item-separator
  295. ----
  296. .. _class_PackedVector2Array_operator_sum_PackedVector2Array:
  297. .. rst-class:: classref-operator
  298. :ref:`PackedVector2Array<class_PackedVector2Array>` **operator +**\ (\ right\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) :ref:`🔗<class_PackedVector2Array_operator_sum_PackedVector2Array>`
  299. Returns a new **PackedVector2Array** with contents of ``right`` added at the end of this array. For better performance, consider using :ref:`append_array()<class_PackedVector2Array_method_append_array>` instead.
  300. .. rst-class:: classref-item-separator
  301. ----
  302. .. _class_PackedVector2Array_operator_eq_PackedVector2Array:
  303. .. rst-class:: classref-operator
  304. :ref:`bool<class_bool>` **operator ==**\ (\ right\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ ) :ref:`🔗<class_PackedVector2Array_operator_eq_PackedVector2Array>`
  305. Returns ``true`` if contents of both arrays are the same, i.e. they have all equal :ref:`Vector2<class_Vector2>`\ s at the corresponding indices.
  306. .. rst-class:: classref-item-separator
  307. ----
  308. .. _class_PackedVector2Array_operator_idx_int:
  309. .. rst-class:: classref-operator
  310. :ref:`Vector2<class_Vector2>` **operator []**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PackedVector2Array_operator_idx_int>`
  311. Returns the :ref:`Vector2<class_Vector2>` at index ``index``. Negative indices can be used to access the elements starting from the end. Using index out of array's bounds will result in an error.
  312. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  313. .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
  314. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  315. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  316. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  317. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  318. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  319. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  320. .. |void| replace:: :abbr:`void (No return value.)`