mirror of
https://github.com/godotengine/godot.git
synced 2024-12-15 10:12:40 +08:00
b68dd2e189
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.
222 lines
11 KiB
XML
222 lines
11 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="VisualScriptBuiltinFunc" inherits="VisualScriptNode" version="4.0" 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>
|
|
<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">
|
|
Returns the sine of the input.
|
|
</constant>
|
|
<constant name="MATH_COS" value="1" enum="BuiltinFunc">
|
|
Returns the cosine of the input.
|
|
</constant>
|
|
<constant name="MATH_TAN" value="2" enum="BuiltinFunc">
|
|
Returns the tangent of the input.
|
|
</constant>
|
|
<constant name="MATH_SINH" value="3" enum="BuiltinFunc">
|
|
Returns the hyperbolic sine of the input.
|
|
</constant>
|
|
<constant name="MATH_COSH" value="4" enum="BuiltinFunc">
|
|
Returns the hyperbolic cosine of the input.
|
|
</constant>
|
|
<constant name="MATH_TANH" value="5" enum="BuiltinFunc">
|
|
Returns the hyperbolic tangent of the input.
|
|
</constant>
|
|
<constant name="MATH_ASIN" value="6" enum="BuiltinFunc">
|
|
Returns the arc sine of the input.
|
|
</constant>
|
|
<constant name="MATH_ACOS" value="7" enum="BuiltinFunc">
|
|
Returns the arc cosine of the input.
|
|
</constant>
|
|
<constant name="MATH_ATAN" value="8" enum="BuiltinFunc">
|
|
Returns the arc tangent of the input.
|
|
</constant>
|
|
<constant name="MATH_ATAN2" value="9" enum="BuiltinFunc">
|
|
Returns 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">
|
|
Returns the square root of the input.
|
|
</constant>
|
|
<constant name="MATH_FMOD" value="11" enum="BuiltinFunc">
|
|
Returns the remainder of one input divided by the other, using floating-point numbers.
|
|
</constant>
|
|
<constant name="MATH_FPOSMOD" value="12" enum="BuiltinFunc">
|
|
Returns the positive remainder of one input divided by the other, using floating-point numbers.
|
|
</constant>
|
|
<constant name="MATH_FLOOR" value="13" enum="BuiltinFunc">
|
|
Returns the input rounded down.
|
|
</constant>
|
|
<constant name="MATH_CEIL" value="14" enum="BuiltinFunc">
|
|
Returns the input rounded up.
|
|
</constant>
|
|
<constant name="MATH_ROUND" value="15" enum="BuiltinFunc">
|
|
Returns the input rounded to the nearest integer.
|
|
</constant>
|
|
<constant name="MATH_ABS" value="16" enum="BuiltinFunc">
|
|
Returns the absolute value of the input.
|
|
</constant>
|
|
<constant name="MATH_SIGN" value="17" enum="BuiltinFunc">
|
|
Returns 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">
|
|
Returns the input raised to a given power.
|
|
</constant>
|
|
<constant name="MATH_LOG" value="19" enum="BuiltinFunc">
|
|
Returns 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">
|
|
Returns 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">
|
|
Returns 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">
|
|
Returns 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_STEP_DECIMALS" value="24" enum="BuiltinFunc">
|
|
Returns the number of digit places after the decimal that the first non-zero digit occurs.
|
|
</constant>
|
|
<constant name="MATH_SNAPPED" value="25" enum="BuiltinFunc">
|
|
Returns the input snapped to a given step.
|
|
</constant>
|
|
<constant name="MATH_LERP" value="26" enum="BuiltinFunc">
|
|
Returns 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_CUBIC_INTERPOLATE" value="27" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="MATH_INVERSE_LERP" value="28" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="MATH_RANGE_LERP" value="29" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="MATH_MOVE_TOWARD" value="30" enum="BuiltinFunc">
|
|
Moves the number toward a value, based on the third input.
|
|
</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_RANDI" value="32" enum="BuiltinFunc">
|
|
Returns 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">
|
|
Returns 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_RANDI_RANGE" value="34" enum="BuiltinFunc">
|
|
Returns a random 32-bit integer value between the two inputs.
|
|
</constant>
|
|
<constant name="MATH_RANDF_RANGE" value="35" enum="BuiltinFunc">
|
|
Returns a random floating-point value between the two inputs.
|
|
</constant>
|
|
<constant name="MATH_RANDFN" value="36" 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>
|
|
<constant name="MATH_SEED" value="37" enum="BuiltinFunc">
|
|
Set the seed for the random number generator.
|
|
</constant>
|
|
<constant name="MATH_RANDSEED" value="38" enum="BuiltinFunc">
|
|
Returns a random value from the given seed, along with the new seed.
|
|
</constant>
|
|
<constant name="MATH_DEG2RAD" value="39" enum="BuiltinFunc">
|
|
Convert the input from degrees to radians.
|
|
</constant>
|
|
<constant name="MATH_RAD2DEG" value="40" enum="BuiltinFunc">
|
|
Convert the input from radians to degrees.
|
|
</constant>
|
|
<constant name="MATH_LINEAR2DB" value="41" enum="BuiltinFunc">
|
|
Convert the input from linear volume to decibel volume.
|
|
</constant>
|
|
<constant name="MATH_DB2LINEAR" value="42" enum="BuiltinFunc">
|
|
Convert the input from decibel volume to linear volume.
|
|
</constant>
|
|
<constant name="MATH_WRAP" value="43" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="MATH_WRAPF" value="44" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="MATH_PINGPONG" value="45" enum="BuiltinFunc">
|
|
Returns 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>
|
|
<constant name="LOGIC_MAX" value="46" enum="BuiltinFunc">
|
|
Returns the greater of the two numbers, also known as their maximum.
|
|
</constant>
|
|
<constant name="LOGIC_MIN" value="47" enum="BuiltinFunc">
|
|
Returns the lesser of the two numbers, also known as their minimum.
|
|
</constant>
|
|
<constant name="LOGIC_CLAMP" value="48" enum="BuiltinFunc">
|
|
Returns 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="49" enum="BuiltinFunc">
|
|
Returns the nearest power of 2 to the input.
|
|
</constant>
|
|
<constant name="OBJ_WEAKREF" value="50" enum="BuiltinFunc">
|
|
Create a [WeakRef] from the input.
|
|
</constant>
|
|
<constant name="TYPE_CONVERT" value="51" enum="BuiltinFunc">
|
|
Convert between types.
|
|
</constant>
|
|
<constant name="TYPE_OF" value="52" enum="BuiltinFunc">
|
|
Returns 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">
|
|
Returns 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="TEXT_PRINT_VERBOSE" value="59" enum="BuiltinFunc">
|
|
</constant>
|
|
<constant name="VAR_TO_STR" value="60" enum="BuiltinFunc">
|
|
Serialize a [Variant] to a string.
|
|
</constant>
|
|
<constant name="STR_TO_VAR" value="61" enum="BuiltinFunc">
|
|
Deserialize a [Variant] from a string serialized using [constant VAR_TO_STR].
|
|
</constant>
|
|
<constant name="VAR_TO_BYTES" value="62" enum="BuiltinFunc">
|
|
Serialize a [Variant] to a [PackedByteArray].
|
|
</constant>
|
|
<constant name="BYTES_TO_VAR" value="63" enum="BuiltinFunc">
|
|
Deserialize a [Variant] from a [PackedByteArray] serialized using [constant VAR_TO_BYTES].
|
|
</constant>
|
|
<constant name="MATH_SMOOTHSTEP" value="64" enum="BuiltinFunc">
|
|
Returns 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>
|