[email protected] 41 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
  3. .. _class_@GDScript:
  4. @GDScript
  5. =========
  6. **Category:** Core
  7. Brief Description
  8. -----------------
  9. Built-in GDScript functions.
  10. Member Functions
  11. ----------------
  12. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  13. | :ref:`Color<class_color>` | :ref:`Color8<class_@GDScript_Color8>` **(** :ref:`int<class_int>` r8, :ref:`int<class_int>` g8, :ref:`int<class_int>` b8, :ref:`int<class_int>` a8 **)** |
  14. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  15. | :ref:`float<class_float>` | :ref:`abs<class_@GDScript_abs>` **(** :ref:`float<class_float>` s **)** |
  16. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  17. | :ref:`float<class_float>` | :ref:`acos<class_@GDScript_acos>` **(** :ref:`float<class_float>` s **)** |
  18. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  19. | :ref:`float<class_float>` | :ref:`asin<class_@GDScript_asin>` **(** :ref:`float<class_float>` s **)** |
  20. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  21. | :ref:`Nil<class_nil>` | :ref:`assert<class_@GDScript_assert>` **(** :ref:`bool<class_bool>` condition **)** |
  22. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  23. | :ref:`float<class_float>` | :ref:`atan<class_@GDScript_atan>` **(** :ref:`float<class_float>` s **)** |
  24. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  25. | :ref:`float<class_float>` | :ref:`atan2<class_@GDScript_atan2>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
  26. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  27. | :ref:`Variant<class_variant>` | :ref:`bytes2var<class_@GDScript_bytes2var>` **(** :ref:`RawArray<class_rawarray>` bytes **)** |
  28. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  29. | :ref:`float<class_float>` | :ref:`ceil<class_@GDScript_ceil>` **(** :ref:`float<class_float>` s **)** |
  30. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  31. | :ref:`float<class_float>` | :ref:`clamp<class_@GDScript_clamp>` **(** :ref:`float<class_float>` val, :ref:`float<class_float>` min, :ref:`float<class_float>` max **)** |
  32. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  33. | :ref:`Object<class_object>` | :ref:`convert<class_@GDScript_convert>` **(** :ref:`Variant<class_variant>` what, :ref:`int<class_int>` type **)** |
  34. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  35. | :ref:`float<class_float>` | :ref:`cos<class_@GDScript_cos>` **(** :ref:`float<class_float>` s **)** |
  36. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  37. | :ref:`float<class_float>` | :ref:`cosh<class_@GDScript_cosh>` **(** :ref:`float<class_float>` s **)** |
  38. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  39. | :ref:`float<class_float>` | :ref:`db2linear<class_@GDScript_db2linear>` **(** :ref:`float<class_float>` db **)** |
  40. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  41. | :ref:`float<class_float>` | :ref:`decimals<class_@GDScript_decimals>` **(** :ref:`float<class_float>` step **)** |
  42. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  43. | :ref:`float<class_float>` | :ref:`dectime<class_@GDScript_dectime>` **(** :ref:`float<class_float>` value, :ref:`float<class_float>` amount, :ref:`float<class_float>` step **)** |
  44. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  45. | :ref:`float<class_float>` | :ref:`deg2rad<class_@GDScript_deg2rad>` **(** :ref:`float<class_float>` deg **)** |
  46. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  47. | :ref:`Object<class_object>` | :ref:`dict2inst<class_@GDScript_dict2inst>` **(** :ref:`Dictionary<class_dictionary>` dict **)** |
  48. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  49. | :ref:`float<class_float>` | :ref:`ease<class_@GDScript_ease>` **(** :ref:`float<class_float>` s, :ref:`float<class_float>` curve **)** |
  50. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  51. | :ref:`float<class_float>` | :ref:`exp<class_@GDScript_exp>` **(** :ref:`float<class_float>` s **)** |
  52. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  53. | :ref:`float<class_float>` | :ref:`floor<class_@GDScript_floor>` **(** :ref:`float<class_float>` s **)** |
  54. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  55. | :ref:`float<class_float>` | :ref:`fmod<class_@GDScript_fmod>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
  56. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  57. | :ref:`float<class_float>` | :ref:`fposmod<class_@GDScript_fposmod>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
  58. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  59. | :ref:`FuncRef<class_funcref>` | :ref:`funcref<class_@GDScript_funcref>` **(** :ref:`Object<class_object>` instance, :ref:`String<class_string>` funcname **)** |
  60. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  61. | :ref:`int<class_int>` | :ref:`hash<class_@GDScript_hash>` **(** :ref:`Variant<class_variant>` var:Variant **)** |
  62. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  63. | :ref:`Dictionary<class_dictionary>` | :ref:`inst2dict<class_@GDScript_inst2dict>` **(** :ref:`Object<class_object>` inst **)** |
  64. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  65. | :ref:`Object<class_object>` | :ref:`instance_from_id<class_@GDScript_instance_from_id>` **(** :ref:`int<class_int>` instance_id **)** |
  66. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  67. | :ref:`float<class_float>` | :ref:`is_inf<class_@GDScript_is_inf>` **(** :ref:`float<class_float>` s **)** |
  68. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  69. | :ref:`float<class_float>` | :ref:`is_nan<class_@GDScript_is_nan>` **(** :ref:`float<class_float>` s **)** |
  70. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  71. | :ref:`float<class_float>` | :ref:`lerp<class_@GDScript_lerp>` **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to, :ref:`float<class_float>` weight **)** |
  72. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  73. | :ref:`float<class_float>` | :ref:`linear2db<class_@GDScript_linear2db>` **(** :ref:`float<class_float>` nrg **)** |
  74. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  75. | :ref:`Resource<class_resource>` | :ref:`load<class_@GDScript_load>` **(** :ref:`String<class_string>` path **)** |
  76. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  77. | :ref:`float<class_float>` | :ref:`log<class_@GDScript_log>` **(** :ref:`float<class_float>` s **)** |
  78. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  79. | :ref:`float<class_float>` | :ref:`max<class_@GDScript_max>` **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)** |
  80. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  81. | :ref:`float<class_float>` | :ref:`min<class_@GDScript_min>` **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)** |
  82. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  83. | :ref:`int<class_int>` | :ref:`nearest_po2<class_@GDScript_nearest_po2>` **(** :ref:`int<class_int>` val **)** |
  84. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  85. | :ref:`float<class_float>` | :ref:`pow<class_@GDScript_pow>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
  86. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  87. | :ref:`Resource<class_resource>` | :ref:`preload<class_@GDScript_preload>` **(** :ref:`String<class_string>` path **)** |
  88. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  89. | :ref:`Nil<class_nil>` | :ref:`print<class_@GDScript_print>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
  90. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  91. | :ref:`Nil<class_nil>` | :ref:`print_stack<class_@GDScript_print_stack>` **(** **)** |
  92. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  93. | :ref:`Nil<class_nil>` | :ref:`printerr<class_@GDScript_printerr>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
  94. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  95. | :ref:`Nil<class_nil>` | :ref:`printraw<class_@GDScript_printraw>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
  96. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  97. | :ref:`Nil<class_nil>` | :ref:`prints<class_@GDScript_prints>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
  98. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  99. | :ref:`Nil<class_nil>` | :ref:`printt<class_@GDScript_printt>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
  100. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  101. | :ref:`float<class_float>` | :ref:`rad2deg<class_@GDScript_rad2deg>` **(** :ref:`float<class_float>` rad **)** |
  102. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  103. | :ref:`float<class_float>` | :ref:`rand_range<class_@GDScript_rand_range>` **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to **)** |
  104. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  105. | :ref:`Array<class_array>` | :ref:`rand_seed<class_@GDScript_rand_seed>` **(** :ref:`int<class_int>` seed **)** |
  106. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  107. | :ref:`float<class_float>` | :ref:`randf<class_@GDScript_randf>` **(** **)** |
  108. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  109. | :ref:`int<class_int>` | :ref:`randi<class_@GDScript_randi>` **(** **)** |
  110. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  111. | :ref:`Nil<class_nil>` | :ref:`randomize<class_@GDScript_randomize>` **(** **)** |
  112. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  113. | :ref:`Array<class_array>` | :ref:`range<class_@GDScript_range>` **(** :ref:`Variant<class_variant>` ... **)** |
  114. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  115. | :ref:`float<class_float>` | :ref:`round<class_@GDScript_round>` **(** :ref:`float<class_float>` s **)** |
  116. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  117. | :ref:`Nil<class_nil>` | :ref:`seed<class_@GDScript_seed>` **(** :ref:`int<class_int>` seed **)** |
  118. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  119. | :ref:`float<class_float>` | :ref:`sign<class_@GDScript_sign>` **(** :ref:`float<class_float>` s **)** |
  120. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  121. | :ref:`float<class_float>` | :ref:`sin<class_@GDScript_sin>` **(** :ref:`float<class_float>` s **)** |
  122. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  123. | :ref:`float<class_float>` | :ref:`sinh<class_@GDScript_sinh>` **(** :ref:`float<class_float>` s **)** |
  124. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  125. | :ref:`float<class_float>` | :ref:`sqrt<class_@GDScript_sqrt>` **(** :ref:`float<class_float>` s **)** |
  126. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  127. | :ref:`float<class_float>` | :ref:`stepify<class_@GDScript_stepify>` **(** :ref:`float<class_float>` s, :ref:`float<class_float>` step **)** |
  128. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  129. | :ref:`String<class_string>` | :ref:`str<class_@GDScript_str>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
  130. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  131. | :ref:`Variant<class_variant>` | :ref:`str2var<class_@GDScript_str2var>` **(** :ref:`String<class_string>` string **)** |
  132. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  133. | :ref:`float<class_float>` | :ref:`tan<class_@GDScript_tan>` **(** :ref:`float<class_float>` s **)** |
  134. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  135. | :ref:`float<class_float>` | :ref:`tanh<class_@GDScript_tanh>` **(** :ref:`float<class_float>` s **)** |
  136. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  137. | :ref:`bool<class_bool>` | :ref:`type_exists<class_@GDScript_type_exists>` **(** :ref:`String<class_string>` type **)** |
  138. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  139. | :ref:`int<class_int>` | :ref:`typeof<class_@GDScript_typeof>` **(** :ref:`Variant<class_variant>` what **)** |
  140. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  141. | :ref:`RawArray<class_rawarray>` | :ref:`var2bytes<class_@GDScript_var2bytes>` **(** :ref:`Variant<class_variant>` var **)** |
  142. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  143. | :ref:`String<class_string>` | :ref:`var2str<class_@GDScript_var2str>` **(** :ref:`Variant<class_variant>` var **)** |
  144. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  145. | :ref:`WeakRef<class_weakref>` | :ref:`weakref<class_@GDScript_weakref>` **(** :ref:`Object<class_object>` obj **)** |
  146. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  147. | :ref:`GDFunctionState<class_gdfunctionstate>` | :ref:`yield<class_@GDScript_yield>` **(** :ref:`Object<class_object>` object, :ref:`String<class_string>` signal **)** |
  148. +------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
  149. Numeric Constants
  150. -----------------
  151. - **PI** = **3.141593** --- Constant that represents how many times the diameter of a circumference fits around its perimeter.
  152. Description
  153. -----------
  154. This contains the list of built-in gdscript functions. Mostly math functions and other utilities. Everything else is expanded by objects.
  155. Member Function Description
  156. ---------------------------
  157. .. _class_@GDScript_Color8:
  158. - :ref:`Color<class_color>` **Color8** **(** :ref:`int<class_int>` r8, :ref:`int<class_int>` g8, :ref:`int<class_int>` b8, :ref:`int<class_int>` a8 **)**
  159. Make a color from red, green, blue and alpha. Arguments can range from 0 to 255.
  160. .. _class_@GDScript_abs:
  161. - :ref:`float<class_float>` **abs** **(** :ref:`float<class_float>` s **)**
  162. Remove sign (works for integer and float).
  163. .. _class_@GDScript_acos:
  164. - :ref:`float<class_float>` **acos** **(** :ref:`float<class_float>` s **)**
  165. Arc-cosine.
  166. .. _class_@GDScript_asin:
  167. - :ref:`float<class_float>` **asin** **(** :ref:`float<class_float>` s **)**
  168. Arc-sine.
  169. .. _class_@GDScript_assert:
  170. - :ref:`Nil<class_nil>` **assert** **(** :ref:`bool<class_bool>` condition **)**
  171. Assert that the condition is true. If the condition is false, generates an error.
  172. .. _class_@GDScript_atan:
  173. - :ref:`float<class_float>` **atan** **(** :ref:`float<class_float>` s **)**
  174. Arc-tangent.
  175. .. _class_@GDScript_atan2:
  176. - :ref:`float<class_float>` **atan2** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
  177. Arc-tangent that takes a 2D vector as argument, returns the full -pi to +pi range.
  178. .. _class_@GDScript_bytes2var:
  179. - :ref:`Variant<class_variant>` **bytes2var** **(** :ref:`RawArray<class_rawarray>` bytes **)**
  180. Decode a byte array back to a value.
  181. .. _class_@GDScript_ceil:
  182. - :ref:`float<class_float>` **ceil** **(** :ref:`float<class_float>` s **)**
  183. Ceiling (rounds up to nearest integer).
  184. .. _class_@GDScript_clamp:
  185. - :ref:`float<class_float>` **clamp** **(** :ref:`float<class_float>` val, :ref:`float<class_float>` min, :ref:`float<class_float>` max **)**
  186. Clamp both values to a range.
  187. .. _class_@GDScript_convert:
  188. - :ref:`Object<class_object>` **convert** **(** :ref:`Variant<class_variant>` what, :ref:`int<class_int>` type **)**
  189. Convert from a type to another in the best way possible. The "type" parameter uses the enum TYPE\_\* in :ref:`@Global Scope<class_@global scope>`.
  190. .. _class_@GDScript_cos:
  191. - :ref:`float<class_float>` **cos** **(** :ref:`float<class_float>` s **)**
  192. Standard cosine function.
  193. .. _class_@GDScript_cosh:
  194. - :ref:`float<class_float>` **cosh** **(** :ref:`float<class_float>` s **)**
  195. Hyperbolic cosine.
  196. .. _class_@GDScript_db2linear:
  197. - :ref:`float<class_float>` **db2linear** **(** :ref:`float<class_float>` db **)**
  198. Convert from decibels to linear energy (audio).
  199. .. _class_@GDScript_decimals:
  200. - :ref:`float<class_float>` **decimals** **(** :ref:`float<class_float>` step **)**
  201. Return the amount of decimals in the floating point value.
  202. .. _class_@GDScript_dectime:
  203. - :ref:`float<class_float>` **dectime** **(** :ref:`float<class_float>` value, :ref:`float<class_float>` amount, :ref:`float<class_float>` step **)**
  204. Decreases time by a specified amount.
  205. .. _class_@GDScript_deg2rad:
  206. - :ref:`float<class_float>` **deg2rad** **(** :ref:`float<class_float>` deg **)**
  207. Convert from degrees to radians.
  208. .. _class_@GDScript_dict2inst:
  209. - :ref:`Object<class_object>` **dict2inst** **(** :ref:`Dictionary<class_dictionary>` dict **)**
  210. Convert a previously converted instances to dictionary back into an instance. Useful for deserializing.
  211. .. _class_@GDScript_ease:
  212. - :ref:`float<class_float>` **ease** **(** :ref:`float<class_float>` s, :ref:`float<class_float>` curve **)**
  213. Easing function, based on exponent. 0 is constant, 1 is linear, 0 to 1 is ease-in, 1+ is ease out. Negative values are in-out/out in.
  214. .. _class_@GDScript_exp:
  215. - :ref:`float<class_float>` **exp** **(** :ref:`float<class_float>` s **)**
  216. Exponential logarithm.
  217. .. _class_@GDScript_floor:
  218. - :ref:`float<class_float>` **floor** **(** :ref:`float<class_float>` s **)**
  219. Floor (rounds down to nearest integer).
  220. .. _class_@GDScript_fmod:
  221. - :ref:`float<class_float>` **fmod** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
  222. Module (remainder of x/y).
  223. .. _class_@GDScript_fposmod:
  224. - :ref:`float<class_float>` **fposmod** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
  225. Module (remainder of x/y) that wraps equally in positive and negative.
  226. .. _class_@GDScript_funcref:
  227. - :ref:`FuncRef<class_funcref>` **funcref** **(** :ref:`Object<class_object>` instance, :ref:`String<class_string>` funcname **)**
  228. Return a reference to the specified function.
  229. .. _class_@GDScript_hash:
  230. - :ref:`int<class_int>` **hash** **(** :ref:`Variant<class_variant>` var:Variant **)**
  231. Hash the variable passed and return an integer.
  232. .. _class_@GDScript_inst2dict:
  233. - :ref:`Dictionary<class_dictionary>` **inst2dict** **(** :ref:`Object<class_object>` inst **)**
  234. Convert a script class instance to a dictionary (useful for serializing).
  235. .. _class_@GDScript_instance_from_id:
  236. - :ref:`Object<class_object>` **instance_from_id** **(** :ref:`int<class_int>` instance_id **)**
  237. Get an object by its ID.
  238. .. _class_@GDScript_is_inf:
  239. - :ref:`float<class_float>` **is_inf** **(** :ref:`float<class_float>` s **)**
  240. .. _class_@GDScript_is_nan:
  241. - :ref:`float<class_float>` **is_nan** **(** :ref:`float<class_float>` s **)**
  242. .. _class_@GDScript_lerp:
  243. - :ref:`float<class_float>` **lerp** **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to, :ref:`float<class_float>` weight **)**
  244. Linear interpolates between two values by a normalized value.
  245. .. _class_@GDScript_linear2db:
  246. - :ref:`float<class_float>` **linear2db** **(** :ref:`float<class_float>` nrg **)**
  247. Convert from linear energy to decibels (audio).
  248. .. _class_@GDScript_load:
  249. - :ref:`Resource<class_resource>` **load** **(** :ref:`String<class_string>` path **)**
  250. Load a resource from the filesystem, pass a valid path as argument.
  251. .. _class_@GDScript_log:
  252. - :ref:`float<class_float>` **log** **(** :ref:`float<class_float>` s **)**
  253. Natural logarithm.
  254. .. _class_@GDScript_max:
  255. - :ref:`float<class_float>` **max** **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)**
  256. Return the maximum of two values.
  257. .. _class_@GDScript_min:
  258. - :ref:`float<class_float>` **min** **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)**
  259. Return the minimum of two values.
  260. .. _class_@GDScript_nearest_po2:
  261. - :ref:`int<class_int>` **nearest_po2** **(** :ref:`int<class_int>` val **)**
  262. Return the nearest larger power of 2 for an integer.
  263. .. _class_@GDScript_pow:
  264. - :ref:`float<class_float>` **pow** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
  265. Power function, x elevate to y.
  266. .. _class_@GDScript_preload:
  267. - :ref:`Resource<class_resource>` **preload** **(** :ref:`String<class_string>` path **)**
  268. Preload a resource from the filesystem. The resource is loaded during script parsing.
  269. .. _class_@GDScript_print:
  270. - :ref:`Nil<class_nil>` **print** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
  271. Print one or more arguments to strings in the best way possible to a console line.
  272. .. _class_@GDScript_print_stack:
  273. - :ref:`Nil<class_nil>` **print_stack** **(** **)**
  274. Print a stack track at code location, only works when running with debugger turned on.
  275. .. _class_@GDScript_printerr:
  276. - :ref:`Nil<class_nil>` **printerr** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
  277. Print one or more arguments to strings in the best way possible to standard error line.
  278. .. _class_@GDScript_printraw:
  279. - :ref:`Nil<class_nil>` **printraw** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
  280. Print one or more arguments to strings in the best way possible to console. No newline is added at the end.
  281. .. _class_@GDScript_prints:
  282. - :ref:`Nil<class_nil>` **prints** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
  283. Print one or more arguments to the console with a space between each argument.
  284. .. _class_@GDScript_printt:
  285. - :ref:`Nil<class_nil>` **printt** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
  286. Print one or more arguments to the console with a tab between each argument.
  287. .. _class_@GDScript_rad2deg:
  288. - :ref:`float<class_float>` **rad2deg** **(** :ref:`float<class_float>` rad **)**
  289. Convert from radians to degrees.
  290. .. _class_@GDScript_rand_range:
  291. - :ref:`float<class_float>` **rand_range** **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to **)**
  292. Random range, any floating point value between 'from' and 'to'
  293. .. _class_@GDScript_rand_seed:
  294. - :ref:`Array<class_array>` **rand_seed** **(** :ref:`int<class_int>` seed **)**
  295. Random from seed, pass a seed and an array with both number and new seed is returned.
  296. .. _class_@GDScript_randf:
  297. - :ref:`float<class_float>` **randf** **(** **)**
  298. Random value (0 to 1 float).
  299. .. _class_@GDScript_randi:
  300. - :ref:`int<class_int>` **randi** **(** **)**
  301. Random 32 bits value (integer). To obtain a value from 0 to N, you can use remainder, like (for random from 0 to 19): randi() % 20.
  302. .. _class_@GDScript_randomize:
  303. - :ref:`Nil<class_nil>` **randomize** **(** **)**
  304. Reset the seed of the random number generator with a new, different one.
  305. .. _class_@GDScript_range:
  306. - :ref:`Array<class_array>` **range** **(** :ref:`Variant<class_variant>` ... **)**
  307. Return an array with the given range. Range can be 1 argument N (0 to N-1), two arguments (initial, final-1) or three arguments (initial, final-1, increment).
  308. .. _class_@GDScript_round:
  309. - :ref:`float<class_float>` **round** **(** :ref:`float<class_float>` s **)**
  310. Round to nearest integer.
  311. .. _class_@GDScript_seed:
  312. - :ref:`Nil<class_nil>` **seed** **(** :ref:`int<class_int>` seed **)**
  313. Set seed for the random number generator.
  314. .. _class_@GDScript_sign:
  315. - :ref:`float<class_float>` **sign** **(** :ref:`float<class_float>` s **)**
  316. Return sign (-1 or +1).
  317. .. _class_@GDScript_sin:
  318. - :ref:`float<class_float>` **sin** **(** :ref:`float<class_float>` s **)**
  319. Standard sine function.
  320. .. _class_@GDScript_sinh:
  321. - :ref:`float<class_float>` **sinh** **(** :ref:`float<class_float>` s **)**
  322. Hyperbolic sine.
  323. .. _class_@GDScript_sqrt:
  324. - :ref:`float<class_float>` **sqrt** **(** :ref:`float<class_float>` s **)**
  325. Square root.
  326. .. _class_@GDScript_stepify:
  327. - :ref:`float<class_float>` **stepify** **(** :ref:`float<class_float>` s, :ref:`float<class_float>` step **)**
  328. Snap float value to a given step.
  329. .. _class_@GDScript_str:
  330. - :ref:`String<class_string>` **str** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
  331. Convert one or more arguments to strings in the best way possible.
  332. .. _class_@GDScript_str2var:
  333. - :ref:`Variant<class_variant>` **str2var** **(** :ref:`String<class_string>` string **)**
  334. Convert a formatted string that was returned by :ref:`var2str<class_@GDScript_var2str>` to the original value.
  335. .. _class_@GDScript_tan:
  336. - :ref:`float<class_float>` **tan** **(** :ref:`float<class_float>` s **)**
  337. Standard tangent function.
  338. .. _class_@GDScript_tanh:
  339. - :ref:`float<class_float>` **tanh** **(** :ref:`float<class_float>` s **)**
  340. Hyperbolic tangent.
  341. .. _class_@GDScript_type_exists:
  342. - :ref:`bool<class_bool>` **type_exists** **(** :ref:`String<class_string>` type **)**
  343. .. _class_@GDScript_typeof:
  344. - :ref:`int<class_int>` **typeof** **(** :ref:`Variant<class_variant>` what **)**
  345. Return the internal type of the given Variant object, using the TYPE\_\* enum in :ref:`@Global Scope<class_@global scope>`.
  346. .. _class_@GDScript_var2bytes:
  347. - :ref:`RawArray<class_rawarray>` **var2bytes** **(** :ref:`Variant<class_variant>` var **)**
  348. Encode a variable value to a byte array.
  349. .. _class_@GDScript_var2str:
  350. - :ref:`String<class_string>` **var2str** **(** :ref:`Variant<class_variant>` var **)**
  351. Convert a value to a formatted string that can later be parsed using :ref:`str2var<class_@GDScript_str2var>`.
  352. .. _class_@GDScript_weakref:
  353. - :ref:`WeakRef<class_weakref>` **weakref** **(** :ref:`Object<class_object>` obj **)**
  354. Return a weak reference to an object.
  355. .. _class_@GDScript_yield:
  356. - :ref:`GDFunctionState<class_gdfunctionstate>` **yield** **(** :ref:`Object<class_object>` object, :ref:`String<class_string>` signal **)**
  357. Stop the function execution and return the current state. Call :ref:`GDFunctionState.resume<class_GDFunctionState_resume>` on the state to resume execution. This invalidates the state.
  358. Returns anything that was passed to the resume function call. If passed an object and a signal, the execution is resumed when the object's signal is emmited.