[email protected] 41 KB

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