class_visualscriptbuiltinfunc.rst 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637
  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/3.6/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/3.6/modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml.
  6. .. _class_VisualScriptBuiltinFunc:
  7. VisualScriptBuiltinFunc
  8. =======================
  9. **Inherits:** :ref:`VisualScriptNode<class_VisualScriptNode>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  10. A Visual Script node used to call built-in functions.
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. A built-in function used inside a :ref:`VisualScript<class_VisualScript>`. It is usually a math function or an utility function.
  15. See also :ref:`@GDScript<class_@GDScript>`, for the same functions in the GDScript language.
  16. .. rst-class:: classref-reftable-group
  17. Properties
  18. ----------
  19. .. table::
  20. :widths: auto
  21. +--------------------------------------------------------------+------------------------------------------------------------------+-------+
  22. | :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` | :ref:`function<class_VisualScriptBuiltinFunc_property_function>` | ``0`` |
  23. +--------------------------------------------------------------+------------------------------------------------------------------+-------+
  24. .. rst-class:: classref-section-separator
  25. ----
  26. .. rst-class:: classref-descriptions-group
  27. Enumerations
  28. ------------
  29. .. _enum_VisualScriptBuiltinFunc_BuiltinFunc:
  30. .. rst-class:: classref-enumeration
  31. enum **BuiltinFunc**:
  32. .. _class_VisualScriptBuiltinFunc_constant_MATH_SIN:
  33. .. rst-class:: classref-enumeration-constant
  34. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_SIN** = ``0``
  35. Return the sine of the input.
  36. .. _class_VisualScriptBuiltinFunc_constant_MATH_COS:
  37. .. rst-class:: classref-enumeration-constant
  38. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_COS** = ``1``
  39. Return the cosine of the input.
  40. .. _class_VisualScriptBuiltinFunc_constant_MATH_TAN:
  41. .. rst-class:: classref-enumeration-constant
  42. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_TAN** = ``2``
  43. Return the tangent of the input.
  44. .. _class_VisualScriptBuiltinFunc_constant_MATH_SINH:
  45. .. rst-class:: classref-enumeration-constant
  46. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_SINH** = ``3``
  47. Return the hyperbolic sine of the input.
  48. .. _class_VisualScriptBuiltinFunc_constant_MATH_COSH:
  49. .. rst-class:: classref-enumeration-constant
  50. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_COSH** = ``4``
  51. Return the hyperbolic cosine of the input.
  52. .. _class_VisualScriptBuiltinFunc_constant_MATH_TANH:
  53. .. rst-class:: classref-enumeration-constant
  54. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_TANH** = ``5``
  55. Return the hyperbolic tangent of the input.
  56. .. _class_VisualScriptBuiltinFunc_constant_MATH_ASIN:
  57. .. rst-class:: classref-enumeration-constant
  58. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_ASIN** = ``6``
  59. Return the arc sine of the input.
  60. .. _class_VisualScriptBuiltinFunc_constant_MATH_ACOS:
  61. .. rst-class:: classref-enumeration-constant
  62. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_ACOS** = ``7``
  63. Return the arc cosine of the input.
  64. .. _class_VisualScriptBuiltinFunc_constant_MATH_ATAN:
  65. .. rst-class:: classref-enumeration-constant
  66. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_ATAN** = ``8``
  67. Return the arc tangent of the input.
  68. .. _class_VisualScriptBuiltinFunc_constant_MATH_ATAN2:
  69. .. rst-class:: classref-enumeration-constant
  70. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_ATAN2** = ``9``
  71. Return the arc tangent of the input, using the signs of both parameters to determine the exact angle.
  72. .. _class_VisualScriptBuiltinFunc_constant_MATH_SQRT:
  73. .. rst-class:: classref-enumeration-constant
  74. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_SQRT** = ``10``
  75. Return the square root of the input.
  76. .. _class_VisualScriptBuiltinFunc_constant_MATH_FMOD:
  77. .. rst-class:: classref-enumeration-constant
  78. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_FMOD** = ``11``
  79. Return the remainder of one input divided by the other, using floating-point numbers.
  80. .. _class_VisualScriptBuiltinFunc_constant_MATH_FPOSMOD:
  81. .. rst-class:: classref-enumeration-constant
  82. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_FPOSMOD** = ``12``
  83. Return the positive remainder of one input divided by the other, using floating-point numbers.
  84. .. _class_VisualScriptBuiltinFunc_constant_MATH_FLOOR:
  85. .. rst-class:: classref-enumeration-constant
  86. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_FLOOR** = ``13``
  87. Return the input rounded down.
  88. .. _class_VisualScriptBuiltinFunc_constant_MATH_CEIL:
  89. .. rst-class:: classref-enumeration-constant
  90. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_CEIL** = ``14``
  91. Return the input rounded up.
  92. .. _class_VisualScriptBuiltinFunc_constant_MATH_ROUND:
  93. .. rst-class:: classref-enumeration-constant
  94. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_ROUND** = ``15``
  95. Return the input rounded to the nearest integer.
  96. .. _class_VisualScriptBuiltinFunc_constant_MATH_ABS:
  97. .. rst-class:: classref-enumeration-constant
  98. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_ABS** = ``16``
  99. Return the absolute value of the input.
  100. .. _class_VisualScriptBuiltinFunc_constant_MATH_SIGN:
  101. .. rst-class:: classref-enumeration-constant
  102. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_SIGN** = ``17``
  103. Return the sign of the input, turning it into 1, -1, or 0. Useful to determine if the input is positive or negative.
  104. .. _class_VisualScriptBuiltinFunc_constant_MATH_POW:
  105. .. rst-class:: classref-enumeration-constant
  106. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_POW** = ``18``
  107. Return the input raised to a given power.
  108. .. _class_VisualScriptBuiltinFunc_constant_MATH_LOG:
  109. .. rst-class:: classref-enumeration-constant
  110. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_LOG** = ``19``
  111. Return the natural logarithm of the input. Note that this is not the typical base-10 logarithm function calculators use.
  112. .. _class_VisualScriptBuiltinFunc_constant_MATH_EXP:
  113. .. rst-class:: classref-enumeration-constant
  114. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_EXP** = ``20``
  115. Return the mathematical constant **e** raised to the specified power of the input. **e** has an approximate value of 2.71828.
  116. .. _class_VisualScriptBuiltinFunc_constant_MATH_ISNAN:
  117. .. rst-class:: classref-enumeration-constant
  118. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_ISNAN** = ``21``
  119. Return whether the input is NaN (Not a Number) or not. NaN is usually produced by dividing 0 by 0, though other ways exist.
  120. .. _class_VisualScriptBuiltinFunc_constant_MATH_ISINF:
  121. .. rst-class:: classref-enumeration-constant
  122. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_ISINF** = ``22``
  123. Return whether the input is an infinite floating-point number or not. Infinity is usually produced by dividing a number by 0, though other ways exist.
  124. .. _class_VisualScriptBuiltinFunc_constant_MATH_EASE:
  125. .. rst-class:: classref-enumeration-constant
  126. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_EASE** = ``23``
  127. 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.
  128. .. _class_VisualScriptBuiltinFunc_constant_MATH_DECIMALS:
  129. .. rst-class:: classref-enumeration-constant
  130. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_DECIMALS** = ``24``
  131. Return the number of digit places after the decimal that the first non-zero digit occurs.
  132. .. _class_VisualScriptBuiltinFunc_constant_MATH_STEPIFY:
  133. .. rst-class:: classref-enumeration-constant
  134. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_STEPIFY** = ``25``
  135. Return the input snapped to a given step.
  136. .. _class_VisualScriptBuiltinFunc_constant_MATH_LERP:
  137. .. rst-class:: classref-enumeration-constant
  138. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_LERP** = ``26``
  139. Return a number linearly interpolated between the first two inputs, based on the third input. Uses the formula ``a + (a - b) * t``.
  140. .. _class_VisualScriptBuiltinFunc_constant_MATH_INVERSE_LERP:
  141. .. rst-class:: classref-enumeration-constant
  142. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_INVERSE_LERP** = ``27``
  143. .. _class_VisualScriptBuiltinFunc_constant_MATH_RANGE_LERP:
  144. .. rst-class:: classref-enumeration-constant
  145. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_RANGE_LERP** = ``28``
  146. .. _class_VisualScriptBuiltinFunc_constant_MATH_MOVE_TOWARD:
  147. .. rst-class:: classref-enumeration-constant
  148. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_MOVE_TOWARD** = ``29``
  149. Moves the number toward a value, based on the third input.
  150. .. _class_VisualScriptBuiltinFunc_constant_MATH_DECTIME:
  151. .. rst-class:: classref-enumeration-constant
  152. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_DECTIME** = ``30``
  153. Return the result of ``value`` decreased by ``step`` \* ``amount``.
  154. .. _class_VisualScriptBuiltinFunc_constant_MATH_RANDOMIZE:
  155. .. rst-class:: classref-enumeration-constant
  156. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_RANDOMIZE** = ``31``
  157. Randomize the seed (or the internal state) of the random number generator. Current implementation reseeds using a number based on time.
  158. .. _class_VisualScriptBuiltinFunc_constant_MATH_RAND:
  159. .. rst-class:: classref-enumeration-constant
  160. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_RAND** = ``32``
  161. Return a random 32 bits integer value. To obtain a random value between 0 to N (where N is smaller than 2^32 - 1), you can use it with the remainder function.
  162. .. _class_VisualScriptBuiltinFunc_constant_MATH_RANDF:
  163. .. rst-class:: classref-enumeration-constant
  164. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_RANDF** = ``33``
  165. Return a random floating-point value between 0 and 1. To obtain a random value between 0 to N, you can use it with multiplication.
  166. .. _class_VisualScriptBuiltinFunc_constant_MATH_RANDOM:
  167. .. rst-class:: classref-enumeration-constant
  168. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_RANDOM** = ``34``
  169. Return a random floating-point value between the two inputs.
  170. .. _class_VisualScriptBuiltinFunc_constant_MATH_SEED:
  171. .. rst-class:: classref-enumeration-constant
  172. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_SEED** = ``35``
  173. Set the seed for the random number generator.
  174. .. _class_VisualScriptBuiltinFunc_constant_MATH_RANDSEED:
  175. .. rst-class:: classref-enumeration-constant
  176. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_RANDSEED** = ``36``
  177. Return a random value from the given seed, along with the new seed.
  178. .. _class_VisualScriptBuiltinFunc_constant_MATH_DEG2RAD:
  179. .. rst-class:: classref-enumeration-constant
  180. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_DEG2RAD** = ``37``
  181. Convert the input from degrees to radians.
  182. .. _class_VisualScriptBuiltinFunc_constant_MATH_RAD2DEG:
  183. .. rst-class:: classref-enumeration-constant
  184. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_RAD2DEG** = ``38``
  185. Convert the input from radians to degrees.
  186. .. _class_VisualScriptBuiltinFunc_constant_MATH_LINEAR2DB:
  187. .. rst-class:: classref-enumeration-constant
  188. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_LINEAR2DB** = ``39``
  189. Convert the input from linear volume to decibel volume.
  190. .. _class_VisualScriptBuiltinFunc_constant_MATH_DB2LINEAR:
  191. .. rst-class:: classref-enumeration-constant
  192. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_DB2LINEAR** = ``40``
  193. Convert the input from decibel volume to linear volume.
  194. .. _class_VisualScriptBuiltinFunc_constant_MATH_POLAR2CARTESIAN:
  195. .. rst-class:: classref-enumeration-constant
  196. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_POLAR2CARTESIAN** = ``41``
  197. Converts a 2D point expressed in the polar coordinate system (a distance from the origin ``r`` and an angle ``th``) to the cartesian coordinate system (X and Y axis).
  198. .. _class_VisualScriptBuiltinFunc_constant_MATH_CARTESIAN2POLAR:
  199. .. rst-class:: classref-enumeration-constant
  200. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_CARTESIAN2POLAR** = ``42``
  201. Converts a 2D point expressed in the cartesian coordinate system (X and Y axis) to the polar coordinate system (a distance from the origin and an angle).
  202. .. _class_VisualScriptBuiltinFunc_constant_MATH_WRAP:
  203. .. rst-class:: classref-enumeration-constant
  204. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_WRAP** = ``43``
  205. .. _class_VisualScriptBuiltinFunc_constant_MATH_WRAPF:
  206. .. rst-class:: classref-enumeration-constant
  207. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_WRAPF** = ``44``
  208. .. _class_VisualScriptBuiltinFunc_constant_LOGIC_MAX:
  209. .. rst-class:: classref-enumeration-constant
  210. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **LOGIC_MAX** = ``45``
  211. Return the greater of the two numbers, also known as their maximum.
  212. .. _class_VisualScriptBuiltinFunc_constant_LOGIC_MIN:
  213. .. rst-class:: classref-enumeration-constant
  214. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **LOGIC_MIN** = ``46``
  215. Return the lesser of the two numbers, also known as their minimum.
  216. .. _class_VisualScriptBuiltinFunc_constant_LOGIC_CLAMP:
  217. .. rst-class:: classref-enumeration-constant
  218. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **LOGIC_CLAMP** = ``47``
  219. Return the input clamped inside the given range, ensuring the result is never outside it. Equivalent to ``min(max(input, range_low), range_high)``.
  220. .. _class_VisualScriptBuiltinFunc_constant_LOGIC_NEAREST_PO2:
  221. .. rst-class:: classref-enumeration-constant
  222. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **LOGIC_NEAREST_PO2** = ``48``
  223. Return the nearest power of 2 to the input.
  224. .. _class_VisualScriptBuiltinFunc_constant_OBJ_WEAKREF:
  225. .. rst-class:: classref-enumeration-constant
  226. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **OBJ_WEAKREF** = ``49``
  227. Create a :ref:`WeakRef<class_WeakRef>` from the input.
  228. .. _class_VisualScriptBuiltinFunc_constant_FUNC_FUNCREF:
  229. .. rst-class:: classref-enumeration-constant
  230. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **FUNC_FUNCREF** = ``50``
  231. Create a :ref:`FuncRef<class_FuncRef>` from the input.
  232. .. _class_VisualScriptBuiltinFunc_constant_TYPE_CONVERT:
  233. .. rst-class:: classref-enumeration-constant
  234. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TYPE_CONVERT** = ``51``
  235. Convert between types.
  236. .. _class_VisualScriptBuiltinFunc_constant_TYPE_OF:
  237. .. rst-class:: classref-enumeration-constant
  238. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TYPE_OF** = ``52``
  239. Return the type of the input as an integer. Check :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` for the integers that might be returned.
  240. .. _class_VisualScriptBuiltinFunc_constant_TYPE_EXISTS:
  241. .. rst-class:: classref-enumeration-constant
  242. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TYPE_EXISTS** = ``53``
  243. Checks if a type is registered in the :ref:`ClassDB<class_ClassDB>`.
  244. .. _class_VisualScriptBuiltinFunc_constant_TEXT_CHAR:
  245. .. rst-class:: classref-enumeration-constant
  246. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TEXT_CHAR** = ``54``
  247. Return a character with the given ascii value.
  248. .. _class_VisualScriptBuiltinFunc_constant_TEXT_STR:
  249. .. rst-class:: classref-enumeration-constant
  250. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TEXT_STR** = ``55``
  251. Convert the input to a string.
  252. .. _class_VisualScriptBuiltinFunc_constant_TEXT_PRINT:
  253. .. rst-class:: classref-enumeration-constant
  254. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TEXT_PRINT** = ``56``
  255. Print the given string to the output window.
  256. .. _class_VisualScriptBuiltinFunc_constant_TEXT_PRINTERR:
  257. .. rst-class:: classref-enumeration-constant
  258. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TEXT_PRINTERR** = ``57``
  259. Print the given string to the standard error output.
  260. .. _class_VisualScriptBuiltinFunc_constant_TEXT_PRINTRAW:
  261. .. rst-class:: classref-enumeration-constant
  262. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TEXT_PRINTRAW** = ``58``
  263. Print the given string to the standard output, without adding a newline.
  264. .. _class_VisualScriptBuiltinFunc_constant_VAR_TO_STR:
  265. .. rst-class:: classref-enumeration-constant
  266. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **VAR_TO_STR** = ``59``
  267. Serialize a :ref:`Variant<class_Variant>` to a string.
  268. .. _class_VisualScriptBuiltinFunc_constant_STR_TO_VAR:
  269. .. rst-class:: classref-enumeration-constant
  270. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **STR_TO_VAR** = ``60``
  271. Deserialize a :ref:`Variant<class_Variant>` from a string serialized using :ref:`VAR_TO_STR<class_VisualScriptBuiltinFunc_constant_VAR_TO_STR>`.
  272. .. _class_VisualScriptBuiltinFunc_constant_VAR_TO_BYTES:
  273. .. rst-class:: classref-enumeration-constant
  274. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **VAR_TO_BYTES** = ``61``
  275. Serialize a :ref:`Variant<class_Variant>` to a :ref:`PoolByteArray<class_PoolByteArray>`.
  276. .. _class_VisualScriptBuiltinFunc_constant_BYTES_TO_VAR:
  277. .. rst-class:: classref-enumeration-constant
  278. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **BYTES_TO_VAR** = ``62``
  279. Deserialize a :ref:`Variant<class_Variant>` from a :ref:`PoolByteArray<class_PoolByteArray>` serialized using :ref:`VAR_TO_BYTES<class_VisualScriptBuiltinFunc_constant_VAR_TO_BYTES>`.
  280. .. _class_VisualScriptBuiltinFunc_constant_COLORN:
  281. .. rst-class:: classref-enumeration-constant
  282. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **COLORN** = ``63``
  283. Return the :ref:`Color<class_Color>` with the given name and alpha ranging from 0 to 1.
  284. \ **Note:** Names are defined in ``color_names.inc``.
  285. .. _class_VisualScriptBuiltinFunc_constant_MATH_SMOOTHSTEP:
  286. .. rst-class:: classref-enumeration-constant
  287. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_SMOOTHSTEP** = ``64``
  288. Return a number smoothly interpolated between the first two inputs, based on the third input. Similar to :ref:`MATH_LERP<class_VisualScriptBuiltinFunc_constant_MATH_LERP>`, but interpolates faster at the beginning and slower at the end. Using Hermite interpolation formula:
  289. ::
  290. var t = clamp((weight - from) / (to - from), 0.0, 1.0)
  291. return t * t * (3.0 - 2.0 * t)
  292. .. _class_VisualScriptBuiltinFunc_constant_MATH_POSMOD:
  293. .. rst-class:: classref-enumeration-constant
  294. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_POSMOD** = ``65``
  295. .. _class_VisualScriptBuiltinFunc_constant_MATH_LERP_ANGLE:
  296. .. rst-class:: classref-enumeration-constant
  297. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **MATH_LERP_ANGLE** = ``66``
  298. .. _class_VisualScriptBuiltinFunc_constant_TEXT_ORD:
  299. .. rst-class:: classref-enumeration-constant
  300. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **TEXT_ORD** = ``67``
  301. .. _class_VisualScriptBuiltinFunc_constant_FUNC_MAX:
  302. .. rst-class:: classref-enumeration-constant
  303. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **FUNC_MAX** = ``68``
  304. Represents the size of the :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` enum.
  305. .. rst-class:: classref-section-separator
  306. ----
  307. .. rst-class:: classref-descriptions-group
  308. Property Descriptions
  309. ---------------------
  310. .. _class_VisualScriptBuiltinFunc_property_function:
  311. .. rst-class:: classref-property
  312. :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **function** = ``0``
  313. .. rst-class:: classref-property-setget
  314. - void **set_func** **(** :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` value **)**
  315. - :ref:`BuiltinFunc<enum_VisualScriptBuiltinFunc_BuiltinFunc>` **get_func** **(** **)**
  316. The function to be executed.
  317. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  318. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  319. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  320. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`