class_packedvector3array.rst 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548
  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/PackedVector3Array.xml.
  6. .. _class_PackedVector3Array:
  7. PackedVector3Array
  8. ==================
  9. A packed array of :ref:`Vector3<class_Vector3>`\ s.
  10. .. rst-class:: classref-introduction-group
  11. Description
  12. -----------
  13. An array specifically designed to hold :ref:`Vector3<class_Vector3>`. 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. **PackedVector3Array** versus ``Array[Vector3]``). 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_PackedVector3Array_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-reftable-group
  19. Constructors
  20. ------------
  21. .. table::
  22. :widths: auto
  23. +-----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
  24. | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`PackedVector3Array<class_PackedVector3Array_constructor_PackedVector3Array>`\ (\ ) |
  25. +-----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
  26. | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`PackedVector3Array<class_PackedVector3Array_constructor_PackedVector3Array>`\ (\ from\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) |
  27. +-----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
  28. | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`PackedVector3Array<class_PackedVector3Array_constructor_PackedVector3Array>`\ (\ from\: :ref:`Array<class_Array>`\ ) |
  29. +-----------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
  30. .. rst-class:: classref-reftable-group
  31. Methods
  32. -------
  33. .. table::
  34. :widths: auto
  35. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  36. | :ref:`bool<class_bool>` | :ref:`append<class_PackedVector3Array_method_append>`\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) |
  37. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  38. | |void| | :ref:`append_array<class_PackedVector3Array_method_append_array>`\ (\ array\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) |
  39. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  40. | :ref:`int<class_int>` | :ref:`bsearch<class_PackedVector3Array_method_bsearch>`\ (\ value\: :ref:`Vector3<class_Vector3>`, before\: :ref:`bool<class_bool>` = true\ ) |
  41. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  42. | |void| | :ref:`clear<class_PackedVector3Array_method_clear>`\ (\ ) |
  43. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`int<class_int>` | :ref:`count<class_PackedVector3Array_method_count>`\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) |const| |
  45. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  46. | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`duplicate<class_PackedVector3Array_method_duplicate>`\ (\ ) |
  47. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  48. | :ref:`bool<class_bool>` | :ref:`erase<class_PackedVector3Array_method_erase>`\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) |
  49. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  50. | |void| | :ref:`fill<class_PackedVector3Array_method_fill>`\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) |
  51. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  52. | :ref:`int<class_int>` | :ref:`find<class_PackedVector3Array_method_find>`\ (\ value\: :ref:`Vector3<class_Vector3>`, from\: :ref:`int<class_int>` = 0\ ) |const| |
  53. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  54. | :ref:`Vector3<class_Vector3>` | :ref:`get<class_PackedVector3Array_method_get>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  55. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`bool<class_bool>` | :ref:`has<class_PackedVector3Array_method_has>`\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) |const| |
  57. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`int<class_int>` | :ref:`insert<class_PackedVector3Array_method_insert>`\ (\ at_index\: :ref:`int<class_int>`, value\: :ref:`Vector3<class_Vector3>`\ ) |
  59. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`bool<class_bool>` | :ref:`is_empty<class_PackedVector3Array_method_is_empty>`\ (\ ) |const| |
  61. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`bool<class_bool>` | :ref:`push_back<class_PackedVector3Array_method_push_back>`\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) |
  63. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  64. | |void| | :ref:`remove_at<class_PackedVector3Array_method_remove_at>`\ (\ index\: :ref:`int<class_int>`\ ) |
  65. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  66. | :ref:`int<class_int>` | :ref:`resize<class_PackedVector3Array_method_resize>`\ (\ new_size\: :ref:`int<class_int>`\ ) |
  67. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  68. | |void| | :ref:`reverse<class_PackedVector3Array_method_reverse>`\ (\ ) |
  69. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  70. | :ref:`int<class_int>` | :ref:`rfind<class_PackedVector3Array_method_rfind>`\ (\ value\: :ref:`Vector3<class_Vector3>`, from\: :ref:`int<class_int>` = -1\ ) |const| |
  71. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  72. | |void| | :ref:`set<class_PackedVector3Array_method_set>`\ (\ index\: :ref:`int<class_int>`, value\: :ref:`Vector3<class_Vector3>`\ ) |
  73. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  74. | :ref:`int<class_int>` | :ref:`size<class_PackedVector3Array_method_size>`\ (\ ) |const| |
  75. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  76. | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`slice<class_PackedVector3Array_method_slice>`\ (\ begin\: :ref:`int<class_int>`, end\: :ref:`int<class_int>` = 2147483647\ ) |const| |
  77. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  78. | |void| | :ref:`sort<class_PackedVector3Array_method_sort>`\ (\ ) |
  79. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  80. | :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`to_byte_array<class_PackedVector3Array_method_to_byte_array>`\ (\ ) |const| |
  81. +-----------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
  82. .. rst-class:: classref-reftable-group
  83. Operators
  84. ---------
  85. .. table::
  86. :widths: auto
  87. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  88. | :ref:`bool<class_bool>` | :ref:`operator !=<class_PackedVector3Array_operator_neq_PackedVector3Array>`\ (\ right\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) |
  89. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  90. | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`operator *<class_PackedVector3Array_operator_mul_Transform3D>`\ (\ right\: :ref:`Transform3D<class_Transform3D>`\ ) |
  91. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  92. | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`operator +<class_PackedVector3Array_operator_sum_PackedVector3Array>`\ (\ right\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) |
  93. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  94. | :ref:`bool<class_bool>` | :ref:`operator ==<class_PackedVector3Array_operator_eq_PackedVector3Array>`\ (\ right\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) |
  95. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  96. | :ref:`Vector3<class_Vector3>` | :ref:`operator []<class_PackedVector3Array_operator_idx_int>`\ (\ index\: :ref:`int<class_int>`\ ) |
  97. +-----------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------+
  98. .. rst-class:: classref-section-separator
  99. ----
  100. .. rst-class:: classref-descriptions-group
  101. Constructor Descriptions
  102. ------------------------
  103. .. _class_PackedVector3Array_constructor_PackedVector3Array:
  104. .. rst-class:: classref-constructor
  105. :ref:`PackedVector3Array<class_PackedVector3Array>` **PackedVector3Array**\ (\ ) :ref:`🔗<class_PackedVector3Array_constructor_PackedVector3Array>`
  106. Constructs an empty **PackedVector3Array**.
  107. .. rst-class:: classref-item-separator
  108. ----
  109. .. rst-class:: classref-constructor
  110. :ref:`PackedVector3Array<class_PackedVector3Array>` **PackedVector3Array**\ (\ from\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ )
  111. Constructs a **PackedVector3Array** as a copy of the given **PackedVector3Array**.
  112. .. rst-class:: classref-item-separator
  113. ----
  114. .. rst-class:: classref-constructor
  115. :ref:`PackedVector3Array<class_PackedVector3Array>` **PackedVector3Array**\ (\ from\: :ref:`Array<class_Array>`\ )
  116. Constructs a new **PackedVector3Array**. Optionally, you can pass in a generic :ref:`Array<class_Array>` that will be converted.
  117. \ **Note:** When initializing a **PackedVector3Array** with elements, it must be initialized with an :ref:`Array<class_Array>` of :ref:`Vector3<class_Vector3>` values:
  118. ::
  119. var array = PackedVector3Array([Vector3(12, 34, 56), Vector3(78, 90, 12)])
  120. .. rst-class:: classref-section-separator
  121. ----
  122. .. rst-class:: classref-descriptions-group
  123. Method Descriptions
  124. -------------------
  125. .. _class_PackedVector3Array_method_append:
  126. .. rst-class:: classref-method
  127. :ref:`bool<class_bool>` **append**\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) :ref:`🔗<class_PackedVector3Array_method_append>`
  128. Appends an element at the end of the array (alias of :ref:`push_back()<class_PackedVector3Array_method_push_back>`).
  129. .. rst-class:: classref-item-separator
  130. ----
  131. .. _class_PackedVector3Array_method_append_array:
  132. .. rst-class:: classref-method
  133. |void| **append_array**\ (\ array\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) :ref:`🔗<class_PackedVector3Array_method_append_array>`
  134. Appends a **PackedVector3Array** at the end of this array.
  135. .. rst-class:: classref-item-separator
  136. ----
  137. .. _class_PackedVector3Array_method_bsearch:
  138. .. rst-class:: classref-method
  139. :ref:`int<class_int>` **bsearch**\ (\ value\: :ref:`Vector3<class_Vector3>`, before\: :ref:`bool<class_bool>` = true\ ) :ref:`🔗<class_PackedVector3Array_method_bsearch>`
  140. 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.
  141. \ **Note:** Calling :ref:`bsearch()<class_PackedVector3Array_method_bsearch>` on an unsorted array results in unexpected behavior.
  142. \ **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.
  143. .. rst-class:: classref-item-separator
  144. ----
  145. .. _class_PackedVector3Array_method_clear:
  146. .. rst-class:: classref-method
  147. |void| **clear**\ (\ ) :ref:`🔗<class_PackedVector3Array_method_clear>`
  148. Clears the array. This is equivalent to using :ref:`resize()<class_PackedVector3Array_method_resize>` with a size of ``0``.
  149. .. rst-class:: classref-item-separator
  150. ----
  151. .. _class_PackedVector3Array_method_count:
  152. .. rst-class:: classref-method
  153. :ref:`int<class_int>` **count**\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) |const| :ref:`🔗<class_PackedVector3Array_method_count>`
  154. Returns the number of times an element is in the array.
  155. \ **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.
  156. .. rst-class:: classref-item-separator
  157. ----
  158. .. _class_PackedVector3Array_method_duplicate:
  159. .. rst-class:: classref-method
  160. :ref:`PackedVector3Array<class_PackedVector3Array>` **duplicate**\ (\ ) :ref:`🔗<class_PackedVector3Array_method_duplicate>`
  161. Creates a copy of the array, and returns it.
  162. .. rst-class:: classref-item-separator
  163. ----
  164. .. _class_PackedVector3Array_method_erase:
  165. .. rst-class:: classref-method
  166. :ref:`bool<class_bool>` **erase**\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) :ref:`🔗<class_PackedVector3Array_method_erase>`
  167. 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_PackedVector3Array_method_remove_at>` instead.
  168. \ **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.
  169. .. rst-class:: classref-item-separator
  170. ----
  171. .. _class_PackedVector3Array_method_fill:
  172. .. rst-class:: classref-method
  173. |void| **fill**\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) :ref:`🔗<class_PackedVector3Array_method_fill>`
  174. Assigns the given value to all elements in the array. This can typically be used together with :ref:`resize()<class_PackedVector3Array_method_resize>` to create an array with a given size and initialized elements.
  175. .. rst-class:: classref-item-separator
  176. ----
  177. .. _class_PackedVector3Array_method_find:
  178. .. rst-class:: classref-method
  179. :ref:`int<class_int>` **find**\ (\ value\: :ref:`Vector3<class_Vector3>`, from\: :ref:`int<class_int>` = 0\ ) |const| :ref:`🔗<class_PackedVector3Array_method_find>`
  180. Searches the array for a value and returns its index or ``-1`` if not found. Optionally, the initial search index can be passed.
  181. \ **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.
  182. .. rst-class:: classref-item-separator
  183. ----
  184. .. _class_PackedVector3Array_method_get:
  185. .. rst-class:: classref-method
  186. :ref:`Vector3<class_Vector3>` **get**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_PackedVector3Array_method_get>`
  187. Returns the :ref:`Vector3<class_Vector3>` at the given ``index`` in the array. If ``index`` out-of-bounds or negative, this method fails and returns ``Vector3(0, 0, 0)``.
  188. 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.
  189. .. rst-class:: classref-item-separator
  190. ----
  191. .. _class_PackedVector3Array_method_has:
  192. .. rst-class:: classref-method
  193. :ref:`bool<class_bool>` **has**\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) |const| :ref:`🔗<class_PackedVector3Array_method_has>`
  194. Returns ``true`` if the array contains ``value``.
  195. \ **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.
  196. .. rst-class:: classref-item-separator
  197. ----
  198. .. _class_PackedVector3Array_method_insert:
  199. .. rst-class:: classref-method
  200. :ref:`int<class_int>` **insert**\ (\ at_index\: :ref:`int<class_int>`, value\: :ref:`Vector3<class_Vector3>`\ ) :ref:`🔗<class_PackedVector3Array_method_insert>`
  201. 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()``).
  202. .. rst-class:: classref-item-separator
  203. ----
  204. .. _class_PackedVector3Array_method_is_empty:
  205. .. rst-class:: classref-method
  206. :ref:`bool<class_bool>` **is_empty**\ (\ ) |const| :ref:`🔗<class_PackedVector3Array_method_is_empty>`
  207. Returns ``true`` if the array is empty.
  208. .. rst-class:: classref-item-separator
  209. ----
  210. .. _class_PackedVector3Array_method_push_back:
  211. .. rst-class:: classref-method
  212. :ref:`bool<class_bool>` **push_back**\ (\ value\: :ref:`Vector3<class_Vector3>`\ ) :ref:`🔗<class_PackedVector3Array_method_push_back>`
  213. Inserts a :ref:`Vector3<class_Vector3>` at the end.
  214. .. rst-class:: classref-item-separator
  215. ----
  216. .. _class_PackedVector3Array_method_remove_at:
  217. .. rst-class:: classref-method
  218. |void| **remove_at**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PackedVector3Array_method_remove_at>`
  219. Removes an element from the array by index.
  220. .. rst-class:: classref-item-separator
  221. ----
  222. .. _class_PackedVector3Array_method_resize:
  223. .. rst-class:: classref-method
  224. :ref:`int<class_int>` **resize**\ (\ new_size\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PackedVector3Array_method_resize>`
  225. 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_PackedVector3Array_method_resize>` once and assigning the new values is faster than adding new elements one by one.
  226. 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_PackedVector3Array_method_size>` to find the actual size of the array after resize.
  227. .. rst-class:: classref-item-separator
  228. ----
  229. .. _class_PackedVector3Array_method_reverse:
  230. .. rst-class:: classref-method
  231. |void| **reverse**\ (\ ) :ref:`🔗<class_PackedVector3Array_method_reverse>`
  232. Reverses the order of the elements in the array.
  233. .. rst-class:: classref-item-separator
  234. ----
  235. .. _class_PackedVector3Array_method_rfind:
  236. .. rst-class:: classref-method
  237. :ref:`int<class_int>` **rfind**\ (\ value\: :ref:`Vector3<class_Vector3>`, from\: :ref:`int<class_int>` = -1\ ) |const| :ref:`🔗<class_PackedVector3Array_method_rfind>`
  238. 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.
  239. \ **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.
  240. .. rst-class:: classref-item-separator
  241. ----
  242. .. _class_PackedVector3Array_method_set:
  243. .. rst-class:: classref-method
  244. |void| **set**\ (\ index\: :ref:`int<class_int>`, value\: :ref:`Vector3<class_Vector3>`\ ) :ref:`🔗<class_PackedVector3Array_method_set>`
  245. Changes the :ref:`Vector3<class_Vector3>` at the given index.
  246. .. rst-class:: classref-item-separator
  247. ----
  248. .. _class_PackedVector3Array_method_size:
  249. .. rst-class:: classref-method
  250. :ref:`int<class_int>` **size**\ (\ ) |const| :ref:`🔗<class_PackedVector3Array_method_size>`
  251. Returns the number of elements in the array.
  252. .. rst-class:: classref-item-separator
  253. ----
  254. .. _class_PackedVector3Array_method_slice:
  255. .. rst-class:: classref-method
  256. :ref:`PackedVector3Array<class_PackedVector3Array>` **slice**\ (\ begin\: :ref:`int<class_int>`, end\: :ref:`int<class_int>` = 2147483647\ ) |const| :ref:`🔗<class_PackedVector3Array_method_slice>`
  257. Returns the slice of the **PackedVector3Array**, from ``begin`` (inclusive) to ``end`` (exclusive), as a new **PackedVector3Array**.
  258. 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())``).
  259. 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)``).
  260. .. rst-class:: classref-item-separator
  261. ----
  262. .. _class_PackedVector3Array_method_sort:
  263. .. rst-class:: classref-method
  264. |void| **sort**\ (\ ) :ref:`🔗<class_PackedVector3Array_method_sort>`
  265. Sorts the elements of the array in ascending order.
  266. \ **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.
  267. .. rst-class:: classref-item-separator
  268. ----
  269. .. _class_PackedVector3Array_method_to_byte_array:
  270. .. rst-class:: classref-method
  271. :ref:`PackedByteArray<class_PackedByteArray>` **to_byte_array**\ (\ ) |const| :ref:`🔗<class_PackedVector3Array_method_to_byte_array>`
  272. Returns a :ref:`PackedByteArray<class_PackedByteArray>` with each vector encoded as bytes.
  273. .. rst-class:: classref-section-separator
  274. ----
  275. .. rst-class:: classref-descriptions-group
  276. Operator Descriptions
  277. ---------------------
  278. .. _class_PackedVector3Array_operator_neq_PackedVector3Array:
  279. .. rst-class:: classref-operator
  280. :ref:`bool<class_bool>` **operator !=**\ (\ right\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) :ref:`🔗<class_PackedVector3Array_operator_neq_PackedVector3Array>`
  281. Returns ``true`` if contents of the arrays differ.
  282. .. rst-class:: classref-item-separator
  283. ----
  284. .. _class_PackedVector3Array_operator_mul_Transform3D:
  285. .. rst-class:: classref-operator
  286. :ref:`PackedVector3Array<class_PackedVector3Array>` **operator ***\ (\ right\: :ref:`Transform3D<class_Transform3D>`\ ) :ref:`🔗<class_PackedVector3Array_operator_mul_Transform3D>`
  287. Returns a new **PackedVector3Array** with all vectors in this array inversely transformed (multiplied) by the given :ref:`Transform3D<class_Transform3D>` transformation matrix, under the assumption that the transformation basis is orthonormal (i.e. rotation/reflection is fine, scaling/skew is not).
  288. \ ``array * transform`` is equivalent to ``transform.inverse() * array``. See :ref:`Transform3D.inverse()<class_Transform3D_method_inverse>`.
  289. For transforming by inverse of an affine transformation (e.g. with scaling) ``transform.affine_inverse() * array`` can be used instead. See :ref:`Transform3D.affine_inverse()<class_Transform3D_method_affine_inverse>`.
  290. .. rst-class:: classref-item-separator
  291. ----
  292. .. _class_PackedVector3Array_operator_sum_PackedVector3Array:
  293. .. rst-class:: classref-operator
  294. :ref:`PackedVector3Array<class_PackedVector3Array>` **operator +**\ (\ right\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) :ref:`🔗<class_PackedVector3Array_operator_sum_PackedVector3Array>`
  295. Returns a new **PackedVector3Array** with contents of ``right`` added at the end of this array. For better performance, consider using :ref:`append_array()<class_PackedVector3Array_method_append_array>` instead.
  296. .. rst-class:: classref-item-separator
  297. ----
  298. .. _class_PackedVector3Array_operator_eq_PackedVector3Array:
  299. .. rst-class:: classref-operator
  300. :ref:`bool<class_bool>` **operator ==**\ (\ right\: :ref:`PackedVector3Array<class_PackedVector3Array>`\ ) :ref:`🔗<class_PackedVector3Array_operator_eq_PackedVector3Array>`
  301. Returns ``true`` if contents of both arrays are the same, i.e. they have all equal :ref:`Vector3<class_Vector3>`\ s at the corresponding indices.
  302. .. rst-class:: classref-item-separator
  303. ----
  304. .. _class_PackedVector3Array_operator_idx_int:
  305. .. rst-class:: classref-operator
  306. :ref:`Vector3<class_Vector3>` **operator []**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_PackedVector3Array_operator_idx_int>`
  307. Returns the :ref:`Vector3<class_Vector3>` 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.
  308. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  309. .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
  310. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  311. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  312. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  313. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  314. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  315. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  316. .. |void| replace:: :abbr:`void (No return value.)`