b087538119
This makes it easier to spot syntax errors when editing the class reference. The schema is referenced locally so validation can still work offline. Each class XML's schema conformance is also checked on GitHub Actions.
226 lines
11 KiB
XML
226 lines
11 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="VisualScriptBuiltinFunc" inherits="VisualScriptNode" version="3.5" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
|
|
<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>
|
|
<methods>
|
|
</methods>
|
|
<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>
|
|
<constant name="MATH_SIN" value="0" enum="BuiltinFunc">
|
|
Return the sine of the input.
|
|
</constant>
|
|
<constant name="MATH_COS" value="1" enum="BuiltinFunc">
|
|
Return the cosine of the input.
|
|
</constant>
|
|
<constant name="MATH_TAN" value="2" enum="BuiltinFunc">
|
|
Return the tangent of the input.
|
|
</constant>
|
|
<constant name="MATH_SINH" value="3" enum="BuiltinFunc">
|
|
Return the hyperbolic sine of the input.
|
|
</constant>
|
|
<constant name="MATH_COSH" value="4" enum="BuiltinFunc">
|
|
Return the hyperbolic cosine of the input.
|
|
</constant>
|
|
<constant name="MATH_TANH" value="5" enum="BuiltinFunc">
|
|
Return the hyperbolic tangent of the input.
|
|
</constant>
|
|
<constant name="MATH_ASIN" value="6" enum="BuiltinFunc">
|
|
Return the arc sine of the input.
|
|
</constant>
|
|
<constant name="MATH_ACOS" value="7" enum="BuiltinFunc">
|
|
Return the arc cosine of the input.
|
|
</constant>
|
|
<constant name="MATH_ATAN" value="8" enum="BuiltinFunc">
|
|
Return the arc tangent of the input.
|
|
</constant>
|
|
<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>
|
|
<constant name="MATH_SQRT" value="10" enum="BuiltinFunc">
|
|
Return the square root of the input.
|
|
</constant>
|
|
<constant name="MATH_FMOD" value="11" enum="BuiltinFunc">
|
|
Return the remainder of one input divided by the other, using floating-point numbers.
|
|
</constant>
|
|
<constant name="MATH_FPOSMOD" value="12" enum="BuiltinFunc">
|
|
Return the positive remainder of one input divided by the other, using floating-point numbers.
|
|
</constant>
|
|
<constant name="MATH_FLOOR" value="13" enum="BuiltinFunc">
|
|
Return the input rounded down.
|
|
</constant>
|
|
<constant name="MATH_CEIL" value="14" enum="BuiltinFunc">
|
|
Return the input rounded up.
|
|
</constant>
|
|
<constant name="MATH_ROUND" value="15" enum="BuiltinFunc">
|
|
Return the input rounded to the nearest integer.
|
|
</constant>
|
|
<constant name="MATH_ABS" value="16" enum="BuiltinFunc">
|
|
Return the absolute value of the input.
|
|
</constant>
|
|
<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>
|
|
<constant name="MATH_POW" value="18" enum="BuiltinFunc">
|
|
Return the input raised to a given power.
|
|
</constant>
|
|
<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>
|
|
<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>
|
|
<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>
|
|
<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>
|
|
<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_DECIMALS" value="24" enum="BuiltinFunc">
|
|
Return the number of digit places after the decimal that the first non-zero digit occurs.
|
|
</constant>
|
|
<constant name="MATH_STEPIFY" value="25" enum="BuiltinFunc">
|
|
Return the input snapped to a given step.
|
|
</constant>
|
|
<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>
|
|
<constant name="MATH_INVERSE_LERP" value="27" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="MATH_RANGE_LERP" value="28" enum="BuiltinFunc">
|
|
</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_DECTIME" value="30" enum="BuiltinFunc">
|
|
Return the result of [code]value[/code] decreased by [code]step[/code] * [code]amount[/code].
|
|
</constant>
|
|
<constant name="MATH_RANDOMIZE" value="31" 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_RAND" value="32" 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="33" 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>
|
|
<constant name="MATH_RANDOM" value="34" enum="BuiltinFunc">
|
|
Return a random floating-point value between the two inputs.
|
|
</constant>
|
|
<constant name="MATH_SEED" value="35" enum="BuiltinFunc">
|
|
Set the seed for the random number generator.
|
|
</constant>
|
|
<constant name="MATH_RANDSEED" value="36" enum="BuiltinFunc">
|
|
Return a random value from the given seed, along with the new seed.
|
|
</constant>
|
|
<constant name="MATH_DEG2RAD" value="37" enum="BuiltinFunc">
|
|
Convert the input from degrees to radians.
|
|
</constant>
|
|
<constant name="MATH_RAD2DEG" value="38" enum="BuiltinFunc">
|
|
Convert the input from radians to degrees.
|
|
</constant>
|
|
<constant name="MATH_LINEAR2DB" value="39" enum="BuiltinFunc">
|
|
Convert the input from linear volume to decibel volume.
|
|
</constant>
|
|
<constant name="MATH_DB2LINEAR" value="40" enum="BuiltinFunc">
|
|
Convert the input from decibel volume to linear volume.
|
|
</constant>
|
|
<constant name="MATH_POLAR2CARTESIAN" value="41" enum="BuiltinFunc">
|
|
Converts a 2D point expressed in the polar coordinate system (a distance from the origin [code]r[/code] and an angle [code]th[/code]) to the cartesian coordinate system (X and Y axis).
|
|
</constant>
|
|
<constant name="MATH_CARTESIAN2POLAR" value="42" enum="BuiltinFunc">
|
|
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).
|
|
</constant>
|
|
<constant name="MATH_WRAP" value="43" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="MATH_WRAPF" value="44" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="LOGIC_MAX" value="45" enum="BuiltinFunc">
|
|
Return the greater of the two numbers, also known as their maximum.
|
|
</constant>
|
|
<constant name="LOGIC_MIN" value="46" enum="BuiltinFunc">
|
|
Return the lesser of the two numbers, also known as their minimum.
|
|
</constant>
|
|
<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>
|
|
<constant name="LOGIC_NEAREST_PO2" value="48" enum="BuiltinFunc">
|
|
Return the nearest power of 2 to the input.
|
|
</constant>
|
|
<constant name="OBJ_WEAKREF" value="49" enum="BuiltinFunc">
|
|
Create a [WeakRef] from the input.
|
|
</constant>
|
|
<constant name="FUNC_FUNCREF" value="50" enum="BuiltinFunc">
|
|
Create a [FuncRef] from the input.
|
|
</constant>
|
|
<constant name="TYPE_CONVERT" value="51" enum="BuiltinFunc">
|
|
Convert between types.
|
|
</constant>
|
|
<constant name="TYPE_OF" value="52" enum="BuiltinFunc">
|
|
Return the type of the input as an integer. Check [enum Variant.Type] for the integers that might be returned.
|
|
</constant>
|
|
<constant name="TYPE_EXISTS" value="53" enum="BuiltinFunc">
|
|
Checks if a type is registered in the [ClassDB].
|
|
</constant>
|
|
<constant name="TEXT_CHAR" value="54" enum="BuiltinFunc">
|
|
Return a character with the given ascii value.
|
|
</constant>
|
|
<constant name="TEXT_STR" value="55" enum="BuiltinFunc">
|
|
Convert the input to a string.
|
|
</constant>
|
|
<constant name="TEXT_PRINT" value="56" enum="BuiltinFunc">
|
|
Print the given string to the output window.
|
|
</constant>
|
|
<constant name="TEXT_PRINTERR" value="57" enum="BuiltinFunc">
|
|
Print the given string to the standard error output.
|
|
</constant>
|
|
<constant name="TEXT_PRINTRAW" value="58" enum="BuiltinFunc">
|
|
Print the given string to the standard output, without adding a newline.
|
|
</constant>
|
|
<constant name="VAR_TO_STR" value="59" enum="BuiltinFunc">
|
|
Serialize a [Variant] to a string.
|
|
</constant>
|
|
<constant name="STR_TO_VAR" value="60" enum="BuiltinFunc">
|
|
Deserialize a [Variant] from a string serialized using [constant VAR_TO_STR].
|
|
</constant>
|
|
<constant name="VAR_TO_BYTES" value="61" enum="BuiltinFunc">
|
|
Serialize a [Variant] to a [PoolByteArray].
|
|
</constant>
|
|
<constant name="BYTES_TO_VAR" value="62" enum="BuiltinFunc">
|
|
Deserialize a [Variant] from a [PoolByteArray] serialized using [constant VAR_TO_BYTES].
|
|
</constant>
|
|
<constant name="COLORN" value="63" enum="BuiltinFunc">
|
|
Return the [Color] with the given name and alpha ranging from 0 to 1.
|
|
[b]Note:[/b] Names are defined in [code]color_names.inc[/code].
|
|
</constant>
|
|
<constant name="MATH_SMOOTHSTEP" value="64" 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:
|
|
[codeblock]
|
|
var t = clamp((weight - from) / (to - from), 0.0, 1.0)
|
|
return t * t * (3.0 - 2.0 * t)
|
|
[/codeblock]
|
|
</constant>
|
|
<constant name="MATH_POSMOD" value="65" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="MATH_LERP_ANGLE" value="66" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="TEXT_ORD" value="67" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="FUNC_MAX" value="68" enum="BuiltinFunc">
|
|
Represents the size of the [enum BuiltinFunc] enum.
|
|
</constant>
|
|
</constants>
|
|
</class>
|