godot/modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml

220 lines
10 KiB
XML
Raw Normal View History

<?xml version="1.0" encoding="UTF-8" ?>
2020-02-01 01:03:48 +00:00
<class name="VisualScriptBuiltinFunc" inherits="VisualScriptNode" version="4.0">
<brief_description>
A Visual Script node used to call built-in functions.
</brief_description>
<description>
A built-in function used inside a [VisualScript]. It is usually a math function or an utility function.
See also [@GDScript], for the same functions in the GDScript language.
</description>
<tutorials>
</tutorials>
<members>
<member name="function" type="int" setter="set_func" getter="get_func" enum="VisualScriptBuiltinFunc.BuiltinFunc" default="0">
The function to be executed.
</member>
</members>
<constants>
2017-11-24 22:16:30 +00:00
<constant name="MATH_SIN" value="0" enum="BuiltinFunc">
Return the sine of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_COS" value="1" enum="BuiltinFunc">
Return the cosine of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_TAN" value="2" enum="BuiltinFunc">
Return the tangent of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_SINH" value="3" enum="BuiltinFunc">
Return the hyperbolic sine of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_COSH" value="4" enum="BuiltinFunc">
Return the hyperbolic cosine of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_TANH" value="5" enum="BuiltinFunc">
Return the hyperbolic tangent of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_ASIN" value="6" enum="BuiltinFunc">
Return the arc sine of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_ACOS" value="7" enum="BuiltinFunc">
Return the arc cosine of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_ATAN" value="8" enum="BuiltinFunc">
Return the arc tangent of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_ATAN2" value="9" enum="BuiltinFunc">
Return the arc tangent of the input, using the signs of both parameters to determine the exact angle.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_SQRT" value="10" enum="BuiltinFunc">
Return the square root of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_FMOD" value="11" enum="BuiltinFunc">
Return the remainder of one input divided by the other, using floating-point numbers.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_FPOSMOD" value="12" enum="BuiltinFunc">
Return the positive remainder of one input divided by the other, using floating-point numbers.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_FLOOR" value="13" enum="BuiltinFunc">
Return the input rounded down.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_CEIL" value="14" enum="BuiltinFunc">
Return the input rounded up.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_ROUND" value="15" enum="BuiltinFunc">
Return the input rounded to the nearest integer.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_ABS" value="16" enum="BuiltinFunc">
Return the absolute value of the input.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_SIGN" value="17" enum="BuiltinFunc">
Return the sign of the input, turning it into 1, -1, or 0. Useful to determine if the input is positive or negative.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_POW" value="18" enum="BuiltinFunc">
Return the input raised to a given power.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_LOG" value="19" enum="BuiltinFunc">
Return the natural logarithm of the input. Note that this is not the typical base-10 logarithm function calculators use.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_EXP" value="20" enum="BuiltinFunc">
Return the mathematical constant [b]e[/b] raised to the specified power of the input. [b]e[/b] has an approximate value of 2.71828.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_ISNAN" value="21" enum="BuiltinFunc">
Return whether the input is NaN (Not a Number) or not. NaN is usually produced by dividing 0 by 0, though other ways exist.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_ISINF" value="22" enum="BuiltinFunc">
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.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_EASE" value="23" enum="BuiltinFunc">
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.
</constant>
<constant name="MATH_STEP_DECIMALS" value="24" enum="BuiltinFunc">
Return the number of digit places after the decimal that the first non-zero digit occurs.
</constant>
2021-01-04 13:33:44 +00:00
<constant name="MATH_SNAPPED" value="25" enum="BuiltinFunc">
Return the input snapped to a given step.
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_LERP" value="26" enum="BuiltinFunc">
Return a number linearly interpolated between the first two inputs, based on the third input. Uses the formula [code]a + (a - b) * t[/code].
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_INVERSE_LERP" value="27" enum="BuiltinFunc">
2017-10-21 10:02:08 +00:00
</constant>
2017-11-24 22:16:30 +00:00
<constant name="MATH_RANGE_LERP" value="28" enum="BuiltinFunc">
2017-10-21 10:02:08 +00:00
</constant>
<constant name="MATH_MOVE_TOWARD" value="29" enum="BuiltinFunc">
Moves the number toward a value, based on the third input.
</constant>
<constant name="MATH_RANDOMIZE" value="30" enum="BuiltinFunc">
Randomize the seed (or the internal state) of the random number generator. Current implementation reseeds using a number based on time.
</constant>
<constant name="MATH_RANDI" value="31" enum="BuiltinFunc">
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.
</constant>
<constant name="MATH_RANDF" value="32" enum="BuiltinFunc">
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.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_RANDI_RANGE" value="33" enum="BuiltinFunc">
Return a random 32-bit integer value between the two inputs.
</constant>
<constant name="MATH_RANDF_RANGE" value="34" enum="BuiltinFunc">
Return a random floating-point value between the two inputs.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_RANDFN" value="35" enum="BuiltinFunc">
Returns a normally-distributed pseudo-random number, using Box-Muller transform with the specified mean and a standard deviation. This is also called Gaussian distribution.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_SEED" value="36" enum="BuiltinFunc">
Set the seed for the random number generator.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_RANDSEED" value="37" enum="BuiltinFunc">
Return a random value from the given seed, along with the new seed.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_DEG2RAD" value="38" enum="BuiltinFunc">
Convert the input from degrees to radians.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_RAD2DEG" value="39" enum="BuiltinFunc">
Convert the input from radians to degrees.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_LINEAR2DB" value="40" enum="BuiltinFunc">
Convert the input from linear volume to decibel volume.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_DB2LINEAR" value="41" enum="BuiltinFunc">
Convert the input from decibel volume to linear volume.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_WRAP" value="42" enum="BuiltinFunc">
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_WRAPF" value="43" enum="BuiltinFunc">
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_PINGPONG" value="44" enum="BuiltinFunc">
2021-10-15 13:25:00 +00:00
Return the [code]value[/code] wrapped between [code]0[/code] and the [code]length[/code]. If the limit is reached, the next value the function returned is decreased to the [code]0[/code] side or increased to the [code]length[/code] side (like a triangle wave). If [code]length[/code] is less than zero, it becomes positive.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="LOGIC_MAX" value="45" enum="BuiltinFunc">
Return the greater of the two numbers, also known as their maximum.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="LOGIC_MIN" value="46" enum="BuiltinFunc">
Return the lesser of the two numbers, also known as their minimum.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="LOGIC_CLAMP" value="47" enum="BuiltinFunc">
Return the input clamped inside the given range, ensuring the result is never outside it. Equivalent to [code]min(max(input, range_low), range_high)[/code].
</constant>
2021-06-21 09:58:31 +00:00
<constant name="LOGIC_NEAREST_PO2" value="48" enum="BuiltinFunc">
Return the nearest power of 2 to the input.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="OBJ_WEAKREF" value="49" enum="BuiltinFunc">
Create a [WeakRef] from the input.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TYPE_CONVERT" value="50" enum="BuiltinFunc">
Convert between types.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TYPE_OF" value="51" enum="BuiltinFunc">
Return the type of the input as an integer. Check [enum Variant.Type] for the integers that might be returned.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TYPE_EXISTS" value="52" enum="BuiltinFunc">
Checks if a type is registered in the [ClassDB].
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TEXT_CHAR" value="53" enum="BuiltinFunc">
Return a character with the given ascii value.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TEXT_STR" value="54" enum="BuiltinFunc">
Convert the input to a string.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TEXT_PRINT" value="55" enum="BuiltinFunc">
Print the given string to the output window.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TEXT_PRINTERR" value="56" enum="BuiltinFunc">
Print the given string to the standard error output.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TEXT_PRINTRAW" value="57" enum="BuiltinFunc">
Print the given string to the standard output, without adding a newline.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TEXT_PRINT_VERBOSE" value="58" enum="BuiltinFunc">
</constant>
2021-06-21 09:58:31 +00:00
<constant name="VAR_TO_STR" value="59" enum="BuiltinFunc">
Serialize a [Variant] to a string.
</constant>
2021-06-21 09:58:31 +00:00
<constant name="STR_TO_VAR" value="60" enum="BuiltinFunc">
Deserialize a [Variant] from a string serialized using [constant VAR_TO_STR].
</constant>
2021-06-21 09:58:31 +00:00
<constant name="VAR_TO_BYTES" value="61" enum="BuiltinFunc">
Serialize a [Variant] to a [PackedByteArray].
</constant>
2021-06-21 09:58:31 +00:00
<constant name="BYTES_TO_VAR" value="62" enum="BuiltinFunc">
Deserialize a [Variant] from a [PackedByteArray] serialized using [constant VAR_TO_BYTES].
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_SMOOTHSTEP" value="63" enum="BuiltinFunc">
Return a number smoothly interpolated between the first two inputs, based on the third input. Similar to [constant MATH_LERP], but interpolates faster at the beginning and slower at the end. Using Hermite interpolation formula:
2019-03-19 11:39:43 +00:00
[codeblock]
var t = clamp((weight - from) / (to - from), 0.0, 1.0)
return t * t * (3.0 - 2.0 * t)
[/codeblock]
2019-07-22 10:24:14 +00:00
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_POSMOD" value="64" enum="BuiltinFunc">
2019-03-19 11:39:43 +00:00
</constant>
2021-06-21 09:58:31 +00:00
<constant name="MATH_LERP_ANGLE" value="65" enum="BuiltinFunc">
</constant>
2021-06-21 09:58:31 +00:00
<constant name="TEXT_ORD" value="66" enum="BuiltinFunc">
</constant>
2021-06-21 09:58:31 +00:00
<constant name="FUNC_MAX" value="67" enum="BuiltinFunc">
Represents the size of the [enum BuiltinFunc] enum.
</constant>
</constants>
</class>