Files
godot-docs/classes/class_@gdscript.rst
2016-08-10 21:33:38 +02:00

575 lines
41 KiB
ReStructuredText

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
.. _class_@GDScript:
@GDScript
=========
**Category:** Core
Brief Description
-----------------
Built-in GDScript functions.
Member Functions
----------------
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :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 **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`abs<class_@GDScript_abs>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`acos<class_@GDScript_acos>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`asin<class_@GDScript_asin>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`assert<class_@GDScript_assert>` **(** :ref:`bool<class_bool>` condition **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`atan<class_@GDScript_atan>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`atan2<class_@GDScript_atan2>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_variant>` | :ref:`bytes2var<class_@GDScript_bytes2var>` **(** :ref:`RawArray<class_rawarray>` bytes **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`ceil<class_@GDScript_ceil>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`clamp<class_@GDScript_clamp>` **(** :ref:`float<class_float>` val, :ref:`float<class_float>` min, :ref:`float<class_float>` max **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Object<class_object>` | :ref:`convert<class_@GDScript_convert>` **(** :ref:`Variant<class_variant>` what, :ref:`int<class_int>` type **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`cos<class_@GDScript_cos>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`cosh<class_@GDScript_cosh>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`db2linear<class_@GDScript_db2linear>` **(** :ref:`float<class_float>` db **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`decimals<class_@GDScript_decimals>` **(** :ref:`float<class_float>` step **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`dectime<class_@GDScript_dectime>` **(** :ref:`float<class_float>` value, :ref:`float<class_float>` amount, :ref:`float<class_float>` step **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`deg2rad<class_@GDScript_deg2rad>` **(** :ref:`float<class_float>` deg **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Object<class_object>` | :ref:`dict2inst<class_@GDScript_dict2inst>` **(** :ref:`Dictionary<class_dictionary>` dict **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`ease<class_@GDScript_ease>` **(** :ref:`float<class_float>` s, :ref:`float<class_float>` curve **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`exp<class_@GDScript_exp>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`floor<class_@GDScript_floor>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`fmod<class_@GDScript_fmod>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`fposmod<class_@GDScript_fposmod>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`FuncRef<class_funcref>` | :ref:`funcref<class_@GDScript_funcref>` **(** :ref:`Object<class_object>` instance, :ref:`String<class_string>` funcname **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`hash<class_@GDScript_hash>` **(** :ref:`Variant<class_variant>` var:Variant **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Dictionary<class_dictionary>` | :ref:`inst2dict<class_@GDScript_inst2dict>` **(** :ref:`Object<class_object>` inst **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Object<class_object>` | :ref:`instance_from_id<class_@GDScript_instance_from_id>` **(** :ref:`int<class_int>` instance_id **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`is_inf<class_@GDScript_is_inf>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`is_nan<class_@GDScript_is_nan>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`lerp<class_@GDScript_lerp>` **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to, :ref:`float<class_float>` weight **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`linear2db<class_@GDScript_linear2db>` **(** :ref:`float<class_float>` nrg **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Resource<class_resource>` | :ref:`load<class_@GDScript_load>` **(** :ref:`String<class_string>` path **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`log<class_@GDScript_log>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`max<class_@GDScript_max>` **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`min<class_@GDScript_min>` **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`nearest_po2<class_@GDScript_nearest_po2>` **(** :ref:`int<class_int>` val **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`pow<class_@GDScript_pow>` **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Resource<class_resource>` | :ref:`preload<class_@GDScript_preload>` **(** :ref:`String<class_string>` path **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`print<class_@GDScript_print>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`print_stack<class_@GDScript_print_stack>` **(** **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`printerr<class_@GDScript_printerr>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`printraw<class_@GDScript_printraw>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`prints<class_@GDScript_prints>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`printt<class_@GDScript_printt>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`rad2deg<class_@GDScript_rad2deg>` **(** :ref:`float<class_float>` rad **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`rand_range<class_@GDScript_rand_range>` **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Array<class_array>` | :ref:`rand_seed<class_@GDScript_rand_seed>` **(** :ref:`int<class_int>` seed **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`randf<class_@GDScript_randf>` **(** **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`randi<class_@GDScript_randi>` **(** **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`randomize<class_@GDScript_randomize>` **(** **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Array<class_array>` | :ref:`range<class_@GDScript_range>` **(** :ref:`Variant<class_variant>` ... **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`round<class_@GDScript_round>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Nil<class_nil>` | :ref:`seed<class_@GDScript_seed>` **(** :ref:`int<class_int>` seed **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`sign<class_@GDScript_sign>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`sin<class_@GDScript_sin>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`sinh<class_@GDScript_sinh>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`sqrt<class_@GDScript_sqrt>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`stepify<class_@GDScript_stepify>` **(** :ref:`float<class_float>` s, :ref:`float<class_float>` step **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_string>` | :ref:`str<class_@GDScript_str>` **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_variant>` | :ref:`str2var<class_@GDScript_str2var>` **(** :ref:`String<class_string>` string **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`tan<class_@GDScript_tan>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`tanh<class_@GDScript_tanh>` **(** :ref:`float<class_float>` s **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`type_exists<class_@GDScript_type_exists>` **(** :ref:`String<class_string>` type **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`typeof<class_@GDScript_typeof>` **(** :ref:`Variant<class_variant>` what **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`RawArray<class_rawarray>` | :ref:`var2bytes<class_@GDScript_var2bytes>` **(** :ref:`Variant<class_variant>` var **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_string>` | :ref:`var2str<class_@GDScript_var2str>` **(** :ref:`Variant<class_variant>` var **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`WeakRef<class_weakref>` | :ref:`weakref<class_@GDScript_weakref>` **(** :ref:`Object<class_object>` obj **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`GDFunctionState<class_gdfunctionstate>` | :ref:`yield<class_@GDScript_yield>` **(** :ref:`Object<class_object>` object, :ref:`String<class_string>` signal **)** |
+------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------+
Numeric Constants
-----------------
- **PI** = **3.141593** --- Constant that represents how many times the diameter of a circumference fits around it's perimeter.
Description
-----------
This contains the list of built-in gdscript functions. Mostly math functions and other utilities. Everything else is expanded by objects.
Member Function Description
---------------------------
.. _class_@GDScript_Color8:
- :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 **)**
Make a color from red, green, blue and alpha. Arguments can range from 0 to 255.
.. _class_@GDScript_abs:
- :ref:`float<class_float>` **abs** **(** :ref:`float<class_float>` s **)**
Remove sign (works for integer and float).
.. _class_@GDScript_acos:
- :ref:`float<class_float>` **acos** **(** :ref:`float<class_float>` s **)**
Arc-cosine.
.. _class_@GDScript_asin:
- :ref:`float<class_float>` **asin** **(** :ref:`float<class_float>` s **)**
Arc-sine.
.. _class_@GDScript_assert:
- :ref:`Nil<class_nil>` **assert** **(** :ref:`bool<class_bool>` condition **)**
Assert that the condition is true. If the condition is false, generates an error.
.. _class_@GDScript_atan:
- :ref:`float<class_float>` **atan** **(** :ref:`float<class_float>` s **)**
Arc-tangent.
.. _class_@GDScript_atan2:
- :ref:`float<class_float>` **atan2** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
Arc-tangent that takes a 2D vector as argument, returns the full -pi to +pi range.
.. _class_@GDScript_bytes2var:
- :ref:`Variant<class_variant>` **bytes2var** **(** :ref:`RawArray<class_rawarray>` bytes **)**
Decode a byte array back to a value.
.. _class_@GDScript_ceil:
- :ref:`float<class_float>` **ceil** **(** :ref:`float<class_float>` s **)**
Ceiling (rounds up to nearest integer).
.. _class_@GDScript_clamp:
- :ref:`float<class_float>` **clamp** **(** :ref:`float<class_float>` val, :ref:`float<class_float>` min, :ref:`float<class_float>` max **)**
Clamp both values to a range.
.. _class_@GDScript_convert:
- :ref:`Object<class_object>` **convert** **(** :ref:`Variant<class_variant>` what, :ref:`int<class_int>` type **)**
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>`.
.. _class_@GDScript_cos:
- :ref:`float<class_float>` **cos** **(** :ref:`float<class_float>` s **)**
Standard cosine function.
.. _class_@GDScript_cosh:
- :ref:`float<class_float>` **cosh** **(** :ref:`float<class_float>` s **)**
Hyperbolic cosine.
.. _class_@GDScript_db2linear:
- :ref:`float<class_float>` **db2linear** **(** :ref:`float<class_float>` db **)**
Convert from decibels to linear energy (audio).
.. _class_@GDScript_decimals:
- :ref:`float<class_float>` **decimals** **(** :ref:`float<class_float>` step **)**
Return the amount of decimals in the floating point value.
.. _class_@GDScript_dectime:
- :ref:`float<class_float>` **dectime** **(** :ref:`float<class_float>` value, :ref:`float<class_float>` amount, :ref:`float<class_float>` step **)**
Decreases time by a specified amount.
.. _class_@GDScript_deg2rad:
- :ref:`float<class_float>` **deg2rad** **(** :ref:`float<class_float>` deg **)**
Convert from degrees to radians.
.. _class_@GDScript_dict2inst:
- :ref:`Object<class_object>` **dict2inst** **(** :ref:`Dictionary<class_dictionary>` dict **)**
Convert a previously converted instances to dictionary back into an instance. Useful for deserializing.
.. _class_@GDScript_ease:
- :ref:`float<class_float>` **ease** **(** :ref:`float<class_float>` s, :ref:`float<class_float>` curve **)**
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.
.. _class_@GDScript_exp:
- :ref:`float<class_float>` **exp** **(** :ref:`float<class_float>` s **)**
Exponential logarithm.
.. _class_@GDScript_floor:
- :ref:`float<class_float>` **floor** **(** :ref:`float<class_float>` s **)**
Floor (rounds down to nearest integer).
.. _class_@GDScript_fmod:
- :ref:`float<class_float>` **fmod** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
Module (remainder of x/y).
.. _class_@GDScript_fposmod:
- :ref:`float<class_float>` **fposmod** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
Module (remainder of x/y) that wraps equally in positive and negative.
.. _class_@GDScript_funcref:
- :ref:`FuncRef<class_funcref>` **funcref** **(** :ref:`Object<class_object>` instance, :ref:`String<class_string>` funcname **)**
Return a reference to the specified function.
.. _class_@GDScript_hash:
- :ref:`int<class_int>` **hash** **(** :ref:`Variant<class_variant>` var:Variant **)**
Hash the variable passed and return an integer.
.. _class_@GDScript_inst2dict:
- :ref:`Dictionary<class_dictionary>` **inst2dict** **(** :ref:`Object<class_object>` inst **)**
Convert a script class instance to a dictionary (useful for serializing).
.. _class_@GDScript_instance_from_id:
- :ref:`Object<class_object>` **instance_from_id** **(** :ref:`int<class_int>` instance_id **)**
Get an object by its ID.
.. _class_@GDScript_is_inf:
- :ref:`float<class_float>` **is_inf** **(** :ref:`float<class_float>` s **)**
.. _class_@GDScript_is_nan:
- :ref:`float<class_float>` **is_nan** **(** :ref:`float<class_float>` s **)**
.. _class_@GDScript_lerp:
- :ref:`float<class_float>` **lerp** **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to, :ref:`float<class_float>` weight **)**
Linear interpolates between two values by a normalized value.
.. _class_@GDScript_linear2db:
- :ref:`float<class_float>` **linear2db** **(** :ref:`float<class_float>` nrg **)**
Convert from linear energy to decibels (audio).
.. _class_@GDScript_load:
- :ref:`Resource<class_resource>` **load** **(** :ref:`String<class_string>` path **)**
Load a resource from the filesystem, pass a valid path as argument.
.. _class_@GDScript_log:
- :ref:`float<class_float>` **log** **(** :ref:`float<class_float>` s **)**
Natural logarithm.
.. _class_@GDScript_max:
- :ref:`float<class_float>` **max** **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)**
Return the maximum of two values.
.. _class_@GDScript_min:
- :ref:`float<class_float>` **min** **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b **)**
Return the minimum of two values.
.. _class_@GDScript_nearest_po2:
- :ref:`int<class_int>` **nearest_po2** **(** :ref:`int<class_int>` val **)**
Return the nearest larger power of 2 for an integer.
.. _class_@GDScript_pow:
- :ref:`float<class_float>` **pow** **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y **)**
Power function, x elevate to y.
.. _class_@GDScript_preload:
- :ref:`Resource<class_resource>` **preload** **(** :ref:`String<class_string>` path **)**
Preload a resource from the filesystem. The resource is loaded during script parsing.
.. _class_@GDScript_print:
- :ref:`Nil<class_nil>` **print** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
Print one or more arguments to strings in the best way possible to a console line.
.. _class_@GDScript_print_stack:
- :ref:`Nil<class_nil>` **print_stack** **(** **)**
Print a stack track at code location, only works when running with debugger turned on.
.. _class_@GDScript_printerr:
- :ref:`Nil<class_nil>` **printerr** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
Print one or more arguments to strings in the best way possible to standard error line.
.. _class_@GDScript_printraw:
- :ref:`Nil<class_nil>` **printraw** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
Print one or more arguments to strings in the best way possible to console. No newline is added at the end.
.. _class_@GDScript_prints:
- :ref:`Nil<class_nil>` **prints** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
Print one or more arguments to the console with a space between each argument.
.. _class_@GDScript_printt:
- :ref:`Nil<class_nil>` **printt** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
Print one or more arguments to the console with a tab between each argument.
.. _class_@GDScript_rad2deg:
- :ref:`float<class_float>` **rad2deg** **(** :ref:`float<class_float>` rad **)**
Convert from radians to degrees.
.. _class_@GDScript_rand_range:
- :ref:`float<class_float>` **rand_range** **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to **)**
Random range, any floating point value between 'from' and 'to'
.. _class_@GDScript_rand_seed:
- :ref:`Array<class_array>` **rand_seed** **(** :ref:`int<class_int>` seed **)**
Random from seed, pass a seed and an array with both number and new seed is returned.
.. _class_@GDScript_randf:
- :ref:`float<class_float>` **randf** **(** **)**
Random value (0 to 1 float).
.. _class_@GDScript_randi:
- :ref:`int<class_int>` **randi** **(** **)**
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.
.. _class_@GDScript_randomize:
- :ref:`Nil<class_nil>` **randomize** **(** **)**
Reset the seed of the random number generator with a new, different one.
.. _class_@GDScript_range:
- :ref:`Array<class_array>` **range** **(** :ref:`Variant<class_variant>` ... **)**
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).
.. _class_@GDScript_round:
- :ref:`float<class_float>` **round** **(** :ref:`float<class_float>` s **)**
Round to nearest integer.
.. _class_@GDScript_seed:
- :ref:`Nil<class_nil>` **seed** **(** :ref:`int<class_int>` seed **)**
Set seed for the random number generator.
.. _class_@GDScript_sign:
- :ref:`float<class_float>` **sign** **(** :ref:`float<class_float>` s **)**
Return sign (-1 or +1).
.. _class_@GDScript_sin:
- :ref:`float<class_float>` **sin** **(** :ref:`float<class_float>` s **)**
Standard sine function.
.. _class_@GDScript_sinh:
- :ref:`float<class_float>` **sinh** **(** :ref:`float<class_float>` s **)**
Hyperbolic sine.
.. _class_@GDScript_sqrt:
- :ref:`float<class_float>` **sqrt** **(** :ref:`float<class_float>` s **)**
Square root.
.. _class_@GDScript_stepify:
- :ref:`float<class_float>` **stepify** **(** :ref:`float<class_float>` s, :ref:`float<class_float>` step **)**
Snap float value to a given step.
.. _class_@GDScript_str:
- :ref:`String<class_string>` **str** **(** :ref:`Variant<class_variant>` what, :ref:`Variant<class_variant>` ... **)**
Convert one or more arguments to strings in the best way possible.
.. _class_@GDScript_str2var:
- :ref:`Variant<class_variant>` **str2var** **(** :ref:`String<class_string>` string **)**
Convert a formatted string that was returned by :ref:`var2str<class_@GDScript_var2str>` to the original value.
.. _class_@GDScript_tan:
- :ref:`float<class_float>` **tan** **(** :ref:`float<class_float>` s **)**
Standard tangent function.
.. _class_@GDScript_tanh:
- :ref:`float<class_float>` **tanh** **(** :ref:`float<class_float>` s **)**
Hyperbolic tangent.
.. _class_@GDScript_type_exists:
- :ref:`bool<class_bool>` **type_exists** **(** :ref:`String<class_string>` type **)**
.. _class_@GDScript_typeof:
- :ref:`int<class_int>` **typeof** **(** :ref:`Variant<class_variant>` what **)**
Return the internal type of the given Variant object, using the TYPE\_\* enum in :ref:`@Global Scope<class_@global scope>`.
.. _class_@GDScript_var2bytes:
- :ref:`RawArray<class_rawarray>` **var2bytes** **(** :ref:`Variant<class_variant>` var **)**
Encode a variable value to a byte array.
.. _class_@GDScript_var2str:
- :ref:`String<class_string>` **var2str** **(** :ref:`Variant<class_variant>` var **)**
Convert a value to a formatted string that can later be parsed using :ref:`str2var<class_@GDScript_str2var>`.
.. _class_@GDScript_weakref:
- :ref:`WeakRef<class_weakref>` **weakref** **(** :ref:`Object<class_object>` obj **)**
Return a weak reference to an object.
.. _class_@GDScript_yield:
- :ref:`GDFunctionState<class_gdfunctionstate>` **yield** **(** :ref:`Object<class_object>` object, :ref:`String<class_string>` signal **)**
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.
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.