summaryrefslogtreecommitdiff
path: root/modules/visual_script/doc_classes/VisualScriptBuiltinFunc.xml
blob: 1ac5768755f4bf9c39cd139172a109d3a3f798c4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
<?xml version="1.0" encoding="UTF-8" ?>
<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>
		<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_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_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">
			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="32" 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="33" enum="BuiltinFunc">
			Returns a random 32-bit integer value between the two inputs.
		</constant>
		<constant name="MATH_RANDF_RANGE" value="34" enum="BuiltinFunc">
			Returns a random floating-point value between the two inputs.
		</constant>
		<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>
		<constant name="MATH_SEED" value="36" enum="BuiltinFunc">
			Set the seed for the random number generator.
		</constant>
		<constant name="MATH_RANDSEED" value="37" enum="BuiltinFunc">
			Returns a random value from the given seed, along with the new seed.
		</constant>
		<constant name="MATH_DEG2RAD" value="38" enum="BuiltinFunc">
			Convert the input from degrees to radians.
		</constant>
		<constant name="MATH_RAD2DEG" value="39" enum="BuiltinFunc">
			Convert the input from radians to degrees.
		</constant>
		<constant name="MATH_LINEAR2DB" value="40" enum="BuiltinFunc">
			Convert the input from linear volume to decibel volume.
		</constant>
		<constant name="MATH_DB2LINEAR" value="41" enum="BuiltinFunc">
			Convert the input from decibel volume to linear volume.
		</constant>
		<constant name="MATH_WRAP" value="42" enum="BuiltinFunc">
		</constant>
		<constant name="MATH_WRAPF" value="43" enum="BuiltinFunc">
		</constant>
		<constant name="MATH_PINGPONG" value="44" 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="45" enum="BuiltinFunc">
			Returns the greater of the two numbers, also known as their maximum.
		</constant>
		<constant name="LOGIC_MIN" value="46" enum="BuiltinFunc">
			Returns the lesser of the two numbers, also known as their minimum.
		</constant>
		<constant name="LOGIC_CLAMP" value="47" 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="48" enum="BuiltinFunc">
			Returns 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="TYPE_CONVERT" value="50" enum="BuiltinFunc">
			Convert between types.
		</constant>
		<constant name="TYPE_OF" value="51" 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="52" enum="BuiltinFunc">
			Checks if a type is registered in the [ClassDB].
		</constant>
		<constant name="TEXT_CHAR" value="53" enum="BuiltinFunc">
			Returns a character with the given ascii value.
		</constant>
		<constant name="TEXT_STR" value="54" enum="BuiltinFunc">
			Convert the input to a string.
		</constant>
		<constant name="TEXT_PRINT" value="55" enum="BuiltinFunc">
			Print the given string to the output window.
		</constant>
		<constant name="TEXT_PRINTERR" value="56" enum="BuiltinFunc">
			Print the given string to the standard error output.
		</constant>
		<constant name="TEXT_PRINTRAW" value="57" enum="BuiltinFunc">
			Print the given string to the standard output, without adding a newline.
		</constant>
		<constant name="TEXT_PRINT_VERBOSE" value="58" enum="BuiltinFunc">
		</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 [PackedByteArray].
		</constant>
		<constant name="BYTES_TO_VAR" value="62" enum="BuiltinFunc">
			Deserialize a [Variant] from a [PackedByteArray] serialized using [constant VAR_TO_BYTES].
		</constant>
		<constant name="MATH_SMOOTHSTEP" value="63" 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="64" enum="BuiltinFunc">
		</constant>
		<constant name="MATH_LERP_ANGLE" value="65" enum="BuiltinFunc">
		</constant>
		<constant name="TEXT_ORD" value="66" enum="BuiltinFunc">
		</constant>
		<constant name="FUNC_MAX" value="67" enum="BuiltinFunc">
			Represents the size of the [enum BuiltinFunc] enum.
		</constant>
	</constants>
</class>