Tweak `@GlobalScope` functions documentation overall
Generally: - Made use of [param] more frequently; - Link to other classes' documentation more often; - Improve and add more examples; - Ensure that multiple comments of an codeblock example are spaced out equally for better readability; - Made the writing style closer to how the rest of the documentation is formatted; - Ensure these are called "functions", not "methods". - Fixed a few typos. - Touched up a few cases of zero being written as "zero" or "0" where "0" or "0.0" would be more appropriate. - Removed mentions of "(real)". In 3.x, this was associated with floats, because TYPE_FLOAT was called TYPE_REAL. More specifically: - Every type-safe version of a function (such as `ceili` has a consistent final note ("A type-safe version of [method ceil], returning a [int]"). - Added more details to `randomize`, `seed`. - Corrected `floori()`'s description. It's not the same as `int()`. This was not correct behavior and has been fixed.
This commit is contained in:
parent
28f642097a
commit
474edca100
|
@ -16,7 +16,7 @@
|
||||||
<return type="Variant" />
|
<return type="Variant" />
|
||||||
<param index="0" name="x" type="Variant" />
|
<param index="0" name="x" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Returns the absolute value of a [Variant] parameter [param x] (i.e. non-negative value). Variant types [int], [float] (real), [Vector2], [Vector2i], [Vector3] and [Vector3i] are supported.
|
Returns the absolute value of a [Variant] parameter [param x] (i.e. non-negative value). Variant types [int], [float], [Vector2], [Vector2i], [Vector3] and [Vector3i] are supported.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var a = abs(-1)
|
var a = abs(-1)
|
||||||
# a is 1
|
# a is 1
|
||||||
|
@ -114,7 +114,7 @@
|
||||||
<param index="3" name="end" type="float" />
|
<param index="3" name="end" type="float" />
|
||||||
<param index="4" name="t" type="float" />
|
<param index="4" name="t" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns the point at the given [param t] on a one-dimnesional [url=https://en.wikipedia.org/wiki/B%C3%A9zier_curve]Bezier curve[/url] defined by the given [param control_1], [param control_2], and [param end] points.
|
Returns the point at the given [param t] on a one-dimensional [url=https://en.wikipedia.org/wiki/B%C3%A9zier_curve]Bezier curve[/url] defined by the given [param control_1], [param control_2], and [param end] points.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="bytes_to_var">
|
<method name="bytes_to_var">
|
||||||
|
@ -143,7 +143,7 @@
|
||||||
i = ceil(1.001) # i is 2.0
|
i = ceil(1.001) # i is 2.0
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
See also [method floor], [method round], and [method snapped].
|
See also [method floor], [method round], and [method snapped].
|
||||||
[b]Note:[/b] For better type safety, you can use [method ceilf], [method ceili], [method Vector2.ceil], [method Vector3.ceil] or [method Vector4.ceil] instead.
|
[b]Note:[/b] For better type safety, see [method ceilf], [method ceili], [method Vector2.ceil], [method Vector3.ceil] and [method Vector4.ceil].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="ceilf">
|
<method name="ceilf">
|
||||||
|
@ -151,7 +151,7 @@
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Rounds [param x] upward (towards positive infinity), returning the smallest whole number that is not less than [param x].
|
Rounds [param x] upward (towards positive infinity), returning the smallest whole number that is not less than [param x].
|
||||||
A type-safe version of [method ceil], specialzied in floats.
|
A type-safe version of [method ceil], returning a [float].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="ceili">
|
<method name="ceili">
|
||||||
|
@ -159,7 +159,7 @@
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Rounds [param x] upward (towards positive infinity), returning the smallest whole number that is not less than [param x].
|
Rounds [param x] upward (towards positive infinity), returning the smallest whole number that is not less than [param x].
|
||||||
A type-safe version of [method ceil] that returns integer.
|
A type-safe version of [method ceil], returning an [int].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="clamp">
|
<method name="clamp">
|
||||||
|
@ -168,7 +168,7 @@
|
||||||
<param index="1" name="min" type="Variant" />
|
<param index="1" name="min" type="Variant" />
|
||||||
<param index="2" name="max" type="Variant" />
|
<param index="2" name="max" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Clamps the [Variant] [param value] and returns a value not less than [param min] and not more than [param max]. Variant types [int], [float] (real), [Vector2], [Vector2i], [Vector3] and [Vector3i] are supported.
|
Clamps the [param value], returning a [Variant] not less than [param min] and not more than [param max]. Variant types [int], [float], [Vector2], [Vector2i], [Vector3] and [Vector3i] are supported.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var a = clamp(-10, -1, 5)
|
var a = clamp(-10, -1, 5)
|
||||||
# a is -1
|
# a is -1
|
||||||
|
@ -196,15 +196,13 @@
|
||||||
<param index="1" name="min" type="float" />
|
<param index="1" name="min" type="float" />
|
||||||
<param index="2" name="max" type="float" />
|
<param index="2" name="max" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Clamps the float [param value] and returns a value not less than [param min] and not more than [param max].
|
Clamps the [param value], returning a [float] not less than [param min] and not more than [param max].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var speed = 42.1
|
var speed = 42.1
|
||||||
# a is 20.0
|
var a = clampf(speed, 1.0, 20.5) # a is 20.5
|
||||||
var a = clampf(speed, 1.0, 20.0)
|
|
||||||
|
|
||||||
speed = -10.0
|
speed = -10.0
|
||||||
# a is -1.0
|
var b = clampf(speed, -1.0, 1.0) # b is -1.0
|
||||||
a = clampf(speed, -1.0, 1.0)
|
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -214,15 +212,13 @@
|
||||||
<param index="1" name="min" type="int" />
|
<param index="1" name="min" type="int" />
|
||||||
<param index="2" name="max" type="int" />
|
<param index="2" name="max" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Clamps the integer [param value] and returns a value not less than [param min] and not more than [param max].
|
Clamps the [param value], returning an [int] not less than [param min] and not more than [param max].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var speed = 42
|
var speed = 42
|
||||||
# a is 20
|
var a = clampi(speed, 1, 20) # a is 20
|
||||||
var a = clampi(speed, 1, 20)
|
|
||||||
|
|
||||||
speed = -10
|
speed = -10
|
||||||
# a is -1
|
var b = clampi(speed, -1, 1) # b is -1
|
||||||
a = clampi(speed, -1, 1)
|
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -244,8 +240,7 @@
|
||||||
<description>
|
<description>
|
||||||
Returns the hyperbolic cosine of [param x] in radians.
|
Returns the hyperbolic cosine of [param x] in radians.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
# Prints 1.543081
|
print(cosh(1)) # Prints 1.543081
|
||||||
print(cosh(1))
|
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -257,7 +252,7 @@
|
||||||
<param index="3" name="post" type="float" />
|
<param index="3" name="post" type="float" />
|
||||||
<param index="4" name="weight" type="float" />
|
<param index="4" name="weight" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Cubic interpolates between two values by the factor defined in [param weight] with pre and post values.
|
Cubic interpolates between two values by the factor defined in [param weight] with [param pre] and [param post] values.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="cubic_interpolate_angle">
|
<method name="cubic_interpolate_angle">
|
||||||
|
@ -268,7 +263,7 @@
|
||||||
<param index="3" name="post" type="float" />
|
<param index="3" name="post" type="float" />
|
||||||
<param index="4" name="weight" type="float" />
|
<param index="4" name="weight" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Cubic interpolates between two rotation values with shortest path by the factor defined in [param weight] with pre and post values. See also [method lerp_angle].
|
Cubic interpolates between two rotation values with shortest path by the factor defined in [param weight] with [param pre] and [param post] values. See also [method lerp_angle].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="cubic_interpolate_angle_in_time">
|
<method name="cubic_interpolate_angle_in_time">
|
||||||
|
@ -282,7 +277,7 @@
|
||||||
<param index="6" name="pre_t" type="float" />
|
<param index="6" name="pre_t" type="float" />
|
||||||
<param index="7" name="post_t" type="float" />
|
<param index="7" name="post_t" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Cubic interpolates between two rotation values with shortest path by the factor defined in [param weight] with pre and post values. See also [method lerp_angle].
|
Cubic interpolates between two rotation values with shortest path by the factor defined in [param weight] with [param pre] and [param post] values. See also [method lerp_angle].
|
||||||
It can perform smoother interpolation than [code]cubic_interpolate()[/code] by the time values.
|
It can perform smoother interpolation than [code]cubic_interpolate()[/code] by the time values.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -297,8 +292,8 @@
|
||||||
<param index="6" name="pre_t" type="float" />
|
<param index="6" name="pre_t" type="float" />
|
||||||
<param index="7" name="post_t" type="float" />
|
<param index="7" name="post_t" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Cubic interpolates between two values by the factor defined in [param weight] with pre and post values.
|
Cubic interpolates between two values by the factor defined in [param weight] with [param pre] and [param post] values.
|
||||||
It can perform smoother interpolation than [code]cubic_interpolate()[/code] by the time values.
|
It can perform smoother interpolation than [method cubic_interpolate] by the time values.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="db_to_linear">
|
<method name="db_to_linear">
|
||||||
|
@ -314,8 +309,7 @@
|
||||||
<description>
|
<description>
|
||||||
Converts an angle expressed in degrees to radians.
|
Converts an angle expressed in degrees to radians.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
# r is 3.141593
|
var r = deg_to_rad(180) # r is 3.141593
|
||||||
var r = deg_to_rad(180)
|
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -342,7 +336,13 @@
|
||||||
<return type="String" />
|
<return type="String" />
|
||||||
<param index="0" name="error" type="int" />
|
<param index="0" name="error" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Returns a human-readable name for the given error code.
|
Returns a human-readable name for the given [enum Error] code.
|
||||||
|
[codeblock]
|
||||||
|
print(OK) # Prints 0
|
||||||
|
print(error_string(OK)) # Prints OK
|
||||||
|
print(error_string(ERR_BUSY)) # Prints Busy
|
||||||
|
print(error_string(ERR_OUT_OF_MEMORY)) # Prints Out of memory
|
||||||
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="exp">
|
<method name="exp">
|
||||||
|
@ -363,13 +363,11 @@
|
||||||
<description>
|
<description>
|
||||||
Rounds [param x] downward (towards negative infinity), returning the largest whole number that is not more than [param x]. Supported types: [int], [float], [Vector2], [Vector3], [Vector4].
|
Rounds [param x] downward (towards negative infinity), returning the largest whole number that is not more than [param x]. Supported types: [int], [float], [Vector2], [Vector3], [Vector4].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
# a is 2.0
|
var a = floor(2.99) # a is 2.0
|
||||||
var a = floor(2.99)
|
a = floor(-2.99) # a is -3.0
|
||||||
# a is -3.0
|
|
||||||
a = floor(-2.99)
|
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
See also [method ceil], [method round], and [method snapped].
|
See also [method ceil], [method round], and [method snapped].
|
||||||
[b]Note:[/b] For better type safety, you can use [method floorf], [method floori], [method Vector2.floor], [method Vector3.floor] or [method Vector4.floor] instead.
|
[b]Note:[/b] For better type safety, see [method floorf], [method floori], [method Vector2.floor], [method Vector3.floor] and [method Vector4.floor].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="floorf">
|
<method name="floorf">
|
||||||
|
@ -377,7 +375,7 @@
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Rounds [param x] downward (towards negative infinity), returning the largest whole number that is not more than [param x].
|
Rounds [param x] downward (towards negative infinity), returning the largest whole number that is not more than [param x].
|
||||||
A type-safe version of [method floor], specialzied in floats.
|
A type-safe version of [method floor], returning a [float].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="floori">
|
<method name="floori">
|
||||||
|
@ -385,7 +383,8 @@
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Rounds [param x] downward (towards negative infinity), returning the largest whole number that is not more than [param x].
|
Rounds [param x] downward (towards negative infinity), returning the largest whole number that is not more than [param x].
|
||||||
Equivalent of doing [code]int(x)[/code].
|
A type-safe version of [method floor], returning an [int].
|
||||||
|
[b]Note:[/b] This function is [i]not[/i] the same as [code]int(x)[/code], which rounds towards 0.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="fmod">
|
<method name="fmod">
|
||||||
|
@ -393,10 +392,9 @@
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<param index="1" name="y" type="float" />
|
<param index="1" name="y" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns the floating-point remainder of [code]x/y[/code], keeping the sign of [param x].
|
Returns the floating-point remainder of [param x] divided by [param y], keeping the sign of [param x].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
# Remainder is 1.5
|
var remainder = fmod(7, 5.5) # remainder is 1.5
|
||||||
var remainder = fmod(7, 5.5)
|
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
For the integer remainder operation, use the [code]%[/code] operator.
|
For the integer remainder operation, use the [code]%[/code] operator.
|
||||||
</description>
|
</description>
|
||||||
|
@ -406,21 +404,23 @@
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<param index="1" name="y" type="float" />
|
<param index="1" name="y" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns the floating-point modulus of [code]x/y[/code] that wraps equally in positive and negative.
|
Returns the floating-point modulus of [param x] divided by [param y], wrapping equally in positive and negative.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
|
print(" (x) (fmod(x, 1.5)) (fposmod(x, 1.5))")
|
||||||
for i in 7:
|
for i in 7:
|
||||||
var x = 0.5 * i - 1.5
|
var x = i * 0.5 - 1.5
|
||||||
print("%4.1f %4.1f %4.1f" % [x, fmod(x, 1.5), fposmod(x, 1.5)])
|
print("%4.1f %4.1f | %4.1f" % [x, fmod(x, 1.5), fposmod(x, 1.5)])
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
Produces:
|
Produces:
|
||||||
[codeblock]
|
[codeblock]
|
||||||
-1.5 -0.0 0.0
|
(x) (fmod(x, 1.5)) (fposmod(x, 1.5))
|
||||||
-1.0 -1.0 0.5
|
-1.5 -0.0 | 0.0
|
||||||
-0.5 -0.5 1.0
|
-1.0 -1.0 | 0.5
|
||||||
0.0 0.0 0.0
|
-0.5 -0.5 | 1.0
|
||||||
0.5 0.5 0.5
|
0.0 0.0 | 0.0
|
||||||
1.0 1.0 1.0
|
0.5 0.5 | 0.5
|
||||||
1.5 0.0 0.0
|
1.0 1.0 | 1.0
|
||||||
|
1.5 0.0 | 0.0
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -428,7 +428,7 @@
|
||||||
<return type="int" />
|
<return type="int" />
|
||||||
<param index="0" name="variable" type="Variant" />
|
<param index="0" name="variable" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Returns the integer hash of the variable passed.
|
Returns the integer hash of the passed [param variable].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
print(hash("a")) # Prints 177670
|
print(hash("a")) # Prints 177670
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
|
@ -438,7 +438,7 @@
|
||||||
<return type="Object" />
|
<return type="Object" />
|
||||||
<param index="0" name="instance_id" type="int" />
|
<param index="0" name="instance_id" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Returns the Object that corresponds to [param instance_id]. All Objects have a unique instance ID.
|
Returns the [Object] that corresponds to [param instance_id]. All Objects have a unique instance ID. See also [method Object.get_instance_id].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var foo = "bar"
|
var foo = "bar"
|
||||||
func _ready():
|
func _ready():
|
||||||
|
@ -458,12 +458,13 @@
|
||||||
[codeblock]
|
[codeblock]
|
||||||
# The interpolation ratio in the `lerp()` call below is 0.75.
|
# The interpolation ratio in the `lerp()` call below is 0.75.
|
||||||
var middle = lerp(20, 30, 0.75)
|
var middle = lerp(20, 30, 0.75)
|
||||||
# `middle` is now 27.5.
|
# middle is now 27.5.
|
||||||
|
|
||||||
# Now, we pretend to have forgotten the original ratio and want to get it back.
|
# Now, we pretend to have forgotten the original ratio and want to get it back.
|
||||||
var ratio = inverse_lerp(20, 30, 27.5)
|
var ratio = inverse_lerp(20, 30, 27.5)
|
||||||
# `ratio` is now 0.75.
|
# ratio is now 0.75.
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
See also [method lerp] which performs the reverse of this operation, and [method remap] to map a continuous series of values to another.
|
See also [method lerp], which performs the reverse of this operation, and [method remap] to map a continuous series of values to another.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="is_equal_approx">
|
<method name="is_equal_approx">
|
||||||
|
@ -472,7 +473,7 @@
|
||||||
<param index="1" name="b" type="float" />
|
<param index="1" name="b" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns [code]true[/code] if [param a] and [param b] are approximately equal to each other.
|
Returns [code]true[/code] if [param a] and [param b] are approximately equal to each other.
|
||||||
Here, approximately equal means that [param a] and [param b] are within a small internal epsilon of each other, which scales with the magnitude of the numbers.
|
Here, "approximately equal" means that [param a] and [param b] are within a small internal epsilon of each other, which scales with the magnitude of the numbers.
|
||||||
Infinity values of the same sign are considered equal.
|
Infinity values of the same sign are considered equal.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -480,7 +481,7 @@
|
||||||
<return type="bool" />
|
<return type="bool" />
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns whether [param x] is an infinity value (either positive infinity or negative infinity).
|
Returns [code]true[/code] if [param x] is either positive infinity or negative infinity.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="is_instance_id_valid">
|
<method name="is_instance_id_valid">
|
||||||
|
@ -494,14 +495,14 @@
|
||||||
<return type="bool" />
|
<return type="bool" />
|
||||||
<param index="0" name="instance" type="Variant" />
|
<param index="0" name="instance" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Returns whether [param instance] is a valid object (e.g. has not been deleted from memory).
|
Returns [code]true[/code] if [param instance] is a valid Object (e.g. has not been deleted from memory).
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="is_nan">
|
<method name="is_nan">
|
||||||
<return type="bool" />
|
<return type="bool" />
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns whether [param x] is a NaN ("Not a Number" or invalid) value.
|
Returns [code]true[/code] if [param x] is a NaN ("Not a Number" or invalid) value.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="is_zero_approx">
|
<method name="is_zero_approx">
|
||||||
|
@ -509,7 +510,7 @@
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns [code]true[/code] if [param x] is zero or almost zero.
|
Returns [code]true[/code] if [param x] is zero or almost zero.
|
||||||
This method is faster than using [method is_equal_approx] with one value as zero.
|
This function is faster than using [method is_equal_approx] with one value as zero.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="lerp">
|
<method name="lerp">
|
||||||
|
@ -518,13 +519,13 @@
|
||||||
<param index="1" name="to" type="Variant" />
|
<param index="1" name="to" type="Variant" />
|
||||||
<param index="2" name="weight" type="Variant" />
|
<param index="2" name="weight" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Linearly interpolates between two values by the factor defined in [param weight]. To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. Use [method clamp] on the result of [method lerp] if this is not desired.
|
Linearly interpolates between two values by the factor defined in [param weight]. To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. If this is not desired, use [method clamp] on the result of this function.
|
||||||
Both [param from] and [param to] must have matching types. Supported types: [float], [Vector2], [Vector3], [Vector4], [Color], [Quaternion], [Basis].
|
Both [param from] and [param to] must be the same type. Supported types: [float], [Vector2], [Vector3], [Vector4], [Color], [Quaternion], [Basis].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
lerp(0, 4, 0.75) # Returns 3.0
|
lerp(0, 4, 0.75) # Returns 3.0
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
See also [method inverse_lerp] which performs the reverse of this operation. To perform eased interpolation with [method lerp], combine it with [method ease] or [method smoothstep]. See also [method remap] to map a continuous series of values to another.
|
See also [method inverse_lerp] which performs the reverse of this operation. To perform eased interpolation with [method lerp], combine it with [method ease] or [method smoothstep]. See also [method remap] to map a continuous series of values to another.
|
||||||
[b]Note:[/b] For better type safety, you can use [method lerpf], [method Vector2.lerp], [method Vector3.lerp], [method Vector4.lerp], [method Color.lerp], [method Quaternion.slerp] or [method Basis.slerp] instead.
|
[b]Note:[/b] For better type safety, use [method lerpf], [method Vector2.lerp], [method Vector3.lerp], [method Vector4.lerp], [method Color.lerp], [method Quaternion.slerp] or [method Basis.slerp].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="lerp_angle">
|
<method name="lerp_angle">
|
||||||
|
@ -533,7 +534,7 @@
|
||||||
<param index="1" name="to" type="float" />
|
<param index="1" name="to" type="float" />
|
||||||
<param index="2" name="weight" type="float" />
|
<param index="2" name="weight" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Linearly interpolates between two angles (in radians) by a normalized value.
|
Linearly interpolates between two angles (in radians) by a [param weight] value between 0.0 and 1.0.
|
||||||
Similar to [method lerp], but interpolates correctly when the angles wrap around [constant @GDScript.TAU]. To perform eased interpolation with [method lerp_angle], combine it with [method ease] or [method smoothstep].
|
Similar to [method lerp], but interpolates correctly when the angles wrap around [constant @GDScript.TAU]. To perform eased interpolation with [method lerp_angle], combine it with [method ease] or [method smoothstep].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
extends Sprite
|
extends Sprite
|
||||||
|
@ -544,7 +545,7 @@
|
||||||
rotation = lerp_angle(min_angle, max_angle, elapsed)
|
rotation = lerp_angle(min_angle, max_angle, elapsed)
|
||||||
elapsed += delta
|
elapsed += delta
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
[b]Note:[/b] This method lerps through the shortest path between [param from] and [param to]. However, when these two angles are approximately [code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not obvious which way they lerp due to floating-point precision errors. For example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise.
|
[b]Note:[/b] This function lerps through the shortest path between [param from] and [param to]. However, when these two angles are approximately [code]PI + k * TAU[/code] apart for any integer [code]k[/code], it's not obvious which way they lerp due to floating-point precision errors. For example, [code]lerp_angle(0, PI, weight)[/code] lerps counter-clockwise, while [code]lerp_angle(0, PI + 5 * TAU, weight)[/code] lerps clockwise.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="lerpf">
|
<method name="lerpf">
|
||||||
|
@ -553,7 +554,7 @@
|
||||||
<param index="1" name="to" type="float" />
|
<param index="1" name="to" type="float" />
|
||||||
<param index="2" name="weight" type="float" />
|
<param index="2" name="weight" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Linearly interpolates between two values by the factor defined in [param weight]. To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i].
|
Linearly interpolates between two values by the factor defined in [param weight]. To perform interpolation, [param weight] should be between [code]0.0[/code] and [code]1.0[/code] (inclusive). However, values outside this range are allowed and can be used to perform [i]extrapolation[/i]. If this is not desired, use [method clampf] on the result of this function.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
lerp(0, 4, 0.75) # Returns 3.0
|
lerp(0, 4, 0.75) # Returns 3.0
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
|
@ -577,7 +578,7 @@
|
||||||
<return type="float" />
|
<return type="float" />
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Natural logarithm. The amount of time needed to reach a certain level of continuous growth.
|
Returns the natural logarithm of [param x]. This is the amount of time needed to reach a certain level of continuous growth.
|
||||||
[b]Note:[/b] This is not the same as the "log" function on most calculators, which uses a base 10 logarithm.
|
[b]Note:[/b] This is not the same as the "log" function on most calculators, which uses a base 10 logarithm.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
log(10) # Returns 2.302585
|
log(10) # Returns 2.302585
|
||||||
|
@ -588,7 +589,7 @@
|
||||||
<method name="max" qualifiers="vararg">
|
<method name="max" qualifiers="vararg">
|
||||||
<return type="Variant" />
|
<return type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Returns the maximum of the given values. This method can take any number of arguments.
|
Returns the maximum of the given values. This function can take any number of arguments.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
max(1, 7, 3, -6, 5) # Returns 7
|
max(1, 7, 3, -6, 5) # Returns 7
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
|
@ -599,7 +600,7 @@
|
||||||
<param index="0" name="a" type="float" />
|
<param index="0" name="a" type="float" />
|
||||||
<param index="1" name="b" type="float" />
|
<param index="1" name="b" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns the maximum of two float values.
|
Returns the maximum of two [float] values.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
maxf(3.6, 24) # Returns 24.0
|
maxf(3.6, 24) # Returns 24.0
|
||||||
maxf(-3.99, -4) # Returns -3.99
|
maxf(-3.99, -4) # Returns -3.99
|
||||||
|
@ -611,7 +612,7 @@
|
||||||
<param index="0" name="a" type="int" />
|
<param index="0" name="a" type="int" />
|
||||||
<param index="1" name="b" type="int" />
|
<param index="1" name="b" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Returns the maximum of two int values.
|
Returns the maximum of two [int] values.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
maxi(1, 2) # Returns 2
|
maxi(1, 2) # Returns 2
|
||||||
maxi(-3, -4) # Returns -3
|
maxi(-3, -4) # Returns -3
|
||||||
|
@ -621,7 +622,7 @@
|
||||||
<method name="min" qualifiers="vararg">
|
<method name="min" qualifiers="vararg">
|
||||||
<return type="Variant" />
|
<return type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Returns the minimum of the given values. This method can take any number of arguments.
|
Returns the minimum of the given values. This function can take any number of arguments.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
min(1, 7, 3, -6, 5) # Returns -6
|
min(1, 7, 3, -6, 5) # Returns -6
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
|
@ -632,7 +633,7 @@
|
||||||
<param index="0" name="a" type="float" />
|
<param index="0" name="a" type="float" />
|
||||||
<param index="1" name="b" type="float" />
|
<param index="1" name="b" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns the minimum of two float values.
|
Returns the minimum of two [float] values.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
minf(3.6, 24) # Returns 3.6
|
minf(3.6, 24) # Returns 3.6
|
||||||
minf(-3.99, -4) # Returns -4.0
|
minf(-3.99, -4) # Returns -4.0
|
||||||
|
@ -644,7 +645,7 @@
|
||||||
<param index="0" name="a" type="int" />
|
<param index="0" name="a" type="int" />
|
||||||
<param index="1" name="b" type="int" />
|
<param index="1" name="b" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Returns the minimum of two int values.
|
Returns the minimum of two [int] values.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
mini(1, 2) # Returns 1
|
mini(1, 2) # Returns 1
|
||||||
mini(-3, -4) # Returns -4
|
mini(-3, -4) # Returns -4
|
||||||
|
@ -670,17 +671,17 @@
|
||||||
<return type="int" />
|
<return type="int" />
|
||||||
<param index="0" name="value" type="int" />
|
<param index="0" name="value" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Returns the nearest equal or larger power of 2 for integer [param value].
|
Returns the nearest equal or larger power of 2 for the integer [param value].
|
||||||
In other words, returns the smallest value [code]a[/code] where [code]a = pow(2, n)[/code] such that [code]value <= a[/code] for some non-negative integer [code]n[/code].
|
In other words, returns the smallest value [code]a[/code] where [code]a = pow(2, n)[/code] such that [code]value <= a[/code] for some non-negative integer [code]n[/code].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
nearest_po2(3) # Returns 4
|
nearest_po2(3) # Returns 4
|
||||||
nearest_po2(4) # Returns 4
|
nearest_po2(4) # Returns 4
|
||||||
nearest_po2(5) # Returns 8
|
nearest_po2(5) # Returns 8
|
||||||
|
|
||||||
nearest_po2(0) # Returns 0 (this may not be what you expect)
|
nearest_po2(0) # Returns 0 (this may not be expected)
|
||||||
nearest_po2(-1) # Returns 0 (this may not be what you expect)
|
nearest_po2(-1) # Returns 0 (this may not be expected)
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
[b]Warning:[/b] Due to the way it is implemented, this function returns [code]0[/code] rather than [code]1[/code] for non-positive values of [param value] (in reality, 1 is the smallest integer power of 2).
|
[b]Warning:[/b] Due to the way it is implemented, this function returns [code]0[/code] rather than [code]1[/code] for negative values of [param value] (in reality, 1 is the smallest integer power of 2).
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="pingpong">
|
<method name="pingpong">
|
||||||
|
@ -688,18 +689,18 @@
|
||||||
<param index="0" name="value" type="float" />
|
<param index="0" name="value" type="float" />
|
||||||
<param index="1" name="length" type="float" />
|
<param index="1" name="length" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns the [param value] wrapped between [code]0[/code] and the [param length]. If the limit is reached, the next value the function returned is decreased to the [code]0[/code] side or increased to the [param length] side (like a triangle wave). If [param length] is less than zero, it becomes positive.
|
Wraps [param value] between [code]0[/code] and the [param length]. If the limit is reached, the next value the function returns is decreased to the [code]0[/code] side or increased to the [param length] side (like a triangle wave). If [param length] is less than zero, it becomes positive.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
pingpong(-3.0, 3.0) # Returns 3
|
pingpong(-3.0, 3.0) # Returns 3.0
|
||||||
pingpong(-2.0, 3.0) # Returns 2
|
pingpong(-2.0, 3.0) # Returns 2.0
|
||||||
pingpong(-1.0, 3.0) # Returns 1
|
pingpong(-1.0, 3.0) # Returns 1.0
|
||||||
pingpong(0.0, 3.0) # Returns 0
|
pingpong(0.0, 3.0) # Returns 0.0
|
||||||
pingpong(1.0, 3.0) # Returns 1
|
pingpong(1.0, 3.0) # Returns 1.0
|
||||||
pingpong(2.0, 3.0) # Returns 2
|
pingpong(2.0, 3.0) # Returns 2.0
|
||||||
pingpong(3.0, 3.0) # Returns 3
|
pingpong(3.0, 3.0) # Returns 3.0
|
||||||
pingpong(4.0, 3.0) # Returns 2
|
pingpong(4.0, 3.0) # Returns 2.0
|
||||||
pingpong(5.0, 3.0) # Returns 1
|
pingpong(5.0, 3.0) # Returns 1.0
|
||||||
pingpong(6.0, 3.0) # Returns 0
|
pingpong(6.0, 3.0) # Returns 0.0
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -708,20 +709,22 @@
|
||||||
<param index="0" name="x" type="int" />
|
<param index="0" name="x" type="int" />
|
||||||
<param index="1" name="y" type="int" />
|
<param index="1" name="y" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Returns the integer modulus of [code]x/y[/code] that wraps equally in positive and negative.
|
Returns the integer modulus of [param x] divided by [param y] that wraps equally in positive and negative.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
|
print("#(i) (i % 3) (posmod(i, 3))")
|
||||||
for i in range(-3, 4):
|
for i in range(-3, 4):
|
||||||
print("%2d %2d %2d" % [i, i % 3, posmod(i, 3)])
|
print("%2d %2d | %2d" % [i, i % 3, posmod(i, 3)])
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
Produces:
|
Produces:
|
||||||
[codeblock]
|
[codeblock]
|
||||||
-3 0 0
|
(i) (i % 3) (posmod(i, 3))
|
||||||
-2 -2 1
|
-3 0 | 0
|
||||||
-1 -1 2
|
-2 -2 | 1
|
||||||
0 0 0
|
-1 -1 | 2
|
||||||
1 1 1
|
0 0 | 0
|
||||||
2 2 2
|
1 1 | 1
|
||||||
3 0 0
|
2 2 | 2
|
||||||
|
3 0 | 0
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -731,6 +734,7 @@
|
||||||
<param index="1" name="exp" type="float" />
|
<param index="1" name="exp" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns the result of [param base] raised to the power of [param exp].
|
Returns the result of [param base] raised to the power of [param exp].
|
||||||
|
In GDScript, this is the equivalent of the [code]**[/code] operator.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
pow(2, 5) # Returns 32
|
pow(2, 5) # Returns 32
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
|
@ -743,7 +747,7 @@
|
||||||
var a = [1, 2, 3]
|
var a = [1, 2, 3]
|
||||||
print("a", "b", a) # Prints ab[1, 2, 3]
|
print("a", "b", a) # Prints ab[1, 2, 3]
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
[b]Note:[/b] Consider using [method push_error] and [method push_warning] to print error and warning messages instead of [method print]. This distinguishes them from print messages used for debugging purposes, while also displaying a stack trace when an error or warning is printed.
|
[b]Note:[/b] Consider using [method push_error] and [method push_warning] to print error and warning messages instead of [method print] or [method print_rich]. This distinguishes them from print messages used for debugging purposes, while also displaying a stack trace when an error or warning is printed.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="print_rich" qualifiers="vararg">
|
<method name="print_rich" qualifiers="vararg">
|
||||||
|
@ -771,11 +775,12 @@
|
||||||
</method>
|
</method>
|
||||||
<method name="printraw" qualifiers="vararg">
|
<method name="printraw" qualifiers="vararg">
|
||||||
<description>
|
<description>
|
||||||
Prints one or more arguments to strings in the best way possible to console. No newline is added at the end.
|
Prints one or more arguments to strings in the best way possible to console. Unlike [method print], no newline is automatically added at the end.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
printraw("A")
|
printraw("A")
|
||||||
printraw("B")
|
printraw("B")
|
||||||
# Prints AB
|
printraw("C")
|
||||||
|
# Prints ABC
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
[b]Note:[/b] Due to limitations with Godot's built-in console, this only prints to the terminal. If you need to print in the editor, use another method, such as [method print].
|
[b]Note:[/b] Due to limitations with Godot's built-in console, this only prints to the terminal. If you need to print in the editor, use another method, such as [method print].
|
||||||
</description>
|
</description>
|
||||||
|
@ -802,7 +807,7 @@
|
||||||
[codeblock]
|
[codeblock]
|
||||||
push_error("test error") # Prints "test error" to debugger and terminal as error call
|
push_error("test error") # Prints "test error" to debugger and terminal as error call
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
[b]Note:[/b] Errors printed this way will not pause project execution. To print an error message and pause project execution in debug builds, use [code]assert(false, "test error")[/code] instead.
|
[b]Note:[/b] This function does not pause project execution. To print an error message and pause project execution in debug builds, use [code]assert(false, "test error")[/code] instead.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="push_warning" qualifiers="vararg">
|
<method name="push_warning" qualifiers="vararg">
|
||||||
|
@ -820,6 +825,8 @@
|
||||||
Converts an angle expressed in radians to degrees.
|
Converts an angle expressed in radians to degrees.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
rad_to_deg(0.523599) # Returns 30
|
rad_to_deg(0.523599) # Returns 30
|
||||||
|
rad_to_deg(PI) # Returns 180
|
||||||
|
rad_to_deg(PI * 2) # Returns 360
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -827,7 +834,14 @@
|
||||||
<return type="PackedInt64Array" />
|
<return type="PackedInt64Array" />
|
||||||
<param index="0" name="seed" type="int" />
|
<param index="0" name="seed" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Random from seed: pass a [param seed], and an array with both number and new seed is returned. "Seed" here refers to the internal state of the pseudo random number generator. The internal state of the current implementation is 64 bits.
|
Given a [param seed], returns a [PackedInt64Array] of size [code]2[/code], where its first element is the randomised [int] value, and the second element is the same as [param seed]. Passing the same [param seed] consistently returns the same array.
|
||||||
|
[b]Note:[/b] "Seed" here refers to the internal state of the pseudo random number generator, currently implemented as a 64 bit integer.
|
||||||
|
[codeblock]
|
||||||
|
var a = rand_from_seed(4)
|
||||||
|
|
||||||
|
print(a[0]) # Prints 2879024997
|
||||||
|
print(a[1]) # Prints 4
|
||||||
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="randf">
|
<method name="randf">
|
||||||
|
@ -844,9 +858,10 @@
|
||||||
<param index="0" name="from" type="float" />
|
<param index="0" name="from" type="float" />
|
||||||
<param index="1" name="to" type="float" />
|
<param index="1" name="to" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns a random floating point value on the interval between [param from] and [param to] (inclusive).
|
Returns a random floating point value between [param from] and [param to] (inclusive).
|
||||||
[codeblock]
|
[codeblock]
|
||||||
prints(randf_range(-10, 10), randf_range(-10, 10)) # Prints e.g. -3.844535 7.45315
|
randf_range(0, 20.5) # Returns e.g. 7.45315
|
||||||
|
randf_range(-10, 10) # Returns e.g. -3.844535
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -877,15 +892,15 @@
|
||||||
<description>
|
<description>
|
||||||
Returns a random signed 32-bit integer between [param from] and [param to] (inclusive). If [param to] is lesser than [param from], they are swapped.
|
Returns a random signed 32-bit integer between [param from] and [param to] (inclusive). If [param to] is lesser than [param from], they are swapped.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
print(randi_range(0, 1)) # Prints 0 or 1
|
randi_range(0, 1) # Returns either 0 or 1
|
||||||
print(randi_range(-10, 1000)) # Prints any number from -10 to 1000
|
randi_range(-10, 1000) # Returns random integer between -10 and 1000
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="randomize">
|
<method name="randomize">
|
||||||
<description>
|
<description>
|
||||||
Randomizes the seed (or the internal state) of the random number generator. Current implementation reseeds using a number based on time.
|
Randomizes the seed (or the internal state) of the random number generator. The current implementation uses a number based on the device's time.
|
||||||
[b]Note:[/b] This method is called automatically when the project is run. If you need to fix the seed to have reproducible results, use [method seed] to initialize the random number generator.
|
[b]Note:[/b] This function is called automatically when the project is run. If you need to fix the seed to have consistent, reproducible results, use [method seed] to initialize the random number generator.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="remap">
|
<method name="remap">
|
||||||
|
@ -896,63 +911,67 @@
|
||||||
<param index="3" name="ostart" type="float" />
|
<param index="3" name="ostart" type="float" />
|
||||||
<param index="4" name="ostop" type="float" />
|
<param index="4" name="ostop" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Maps a [param value] from range [code][istart, istop][/code] to [code][ostart, ostop][/code]. See also [method lerp] and [method inverse_lerp]. If [param value] is outside [code][istart, istop][/code], then the resulting value will also be outside [code][ostart, ostop][/code]. Use [method clamp] on the result of [method remap] if this is not desired.
|
Maps a [param value] from range [code][istart, istop][/code] to [code][ostart, ostop][/code]. See also [method lerp] and [method inverse_lerp]. If [param value] is outside [code][istart, istop][/code], then the resulting value will also be outside [code][ostart, ostop][/code]. If this is not desired, use [method clamp] on the result of this function.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
remap(75, 0, 100, -1, 1) # Returns 0.5
|
remap(75, 0, 100, -1, 1) # Returns 0.5
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
For complex use cases where you need multiple ranges, consider using [Curve] or [Gradient] instead.
|
For complex use cases where multiple ranges are needed, consider using [Curve] or [Gradient] instead.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="rid_allocate_id">
|
<method name="rid_allocate_id">
|
||||||
<return type="int" />
|
<return type="int" />
|
||||||
<description>
|
<description>
|
||||||
Allocate a unique ID which can be used by the implementation to construct a RID. This is used mainly from native extensions to implement servers.
|
Allocates a unique ID which can be used by the implementation to construct a RID. This is used mainly from native extensions to implement servers.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="rid_from_int64">
|
<method name="rid_from_int64">
|
||||||
<return type="RID" />
|
<return type="RID" />
|
||||||
<param index="0" name="base" type="int" />
|
<param index="0" name="base" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Create a RID from an int64. This is used mainly from native extensions to build servers.
|
Creates a RID from a [param base]. This is used mainly from native extensions to build servers.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="round">
|
<method name="round">
|
||||||
<return type="Variant" />
|
<return type="Variant" />
|
||||||
<param index="0" name="x" type="Variant" />
|
<param index="0" name="x" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Rounds [param x] to the nearest whole number, with halfway cases rounded away from zero. Supported types: [int], [float], [Vector2], [Vector3], [Vector4].
|
Rounds [param x] to the nearest whole number, with halfway cases rounded away from 0. Supported types: [int], [float], [Vector2], [Vector3], [Vector4].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
round(2.4) # Returns 2
|
round(2.4) # Returns 2
|
||||||
round(2.5) # Returns 3
|
round(2.5) # Returns 3
|
||||||
round(2.6) # Returns 3
|
round(2.6) # Returns 3
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
See also [method floor], [method ceil], and [method snapped].
|
See also [method floor], [method ceil], and [method snapped].
|
||||||
[b]Note:[/b] For better type safety, you can use [method roundf], [method roundi], [method Vector2.round], [method Vector3.round] or [method Vector4.round] instead.
|
[b]Note:[/b] For better type safety, use [method roundf], [method roundi], [method Vector2.round], [method Vector3.round] or [method Vector4.round], instead.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="roundf">
|
<method name="roundf">
|
||||||
<return type="float" />
|
<return type="float" />
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Rounds [param x] to the nearest whole number, with halfway cases rounded away from zero.
|
Rounds [param x] to the nearest whole number, with halfway cases rounded away from 0.
|
||||||
A type-safe version of [method round], specialzied in floats.
|
A type-safe version of [method round], returning a [float].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="roundi">
|
<method name="roundi">
|
||||||
<return type="int" />
|
<return type="int" />
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Rounds [param x] to the nearest whole number, with halfway cases rounded away from zero.
|
Rounds [param x] to the nearest whole number, with halfway cases rounded away from 0.
|
||||||
A type-safe version of [method round] that returns integer.
|
A type-safe version of [method round], returning an [int].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="seed">
|
<method name="seed">
|
||||||
<param index="0" name="base" type="int" />
|
<param index="0" name="base" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Sets seed for the random number generator.
|
Sets the seed for the random number generator to [param base]. Setting the seed manually can ensure consistent, repeatable results for most random functions.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var my_seed = "Godot Rocks"
|
var my_seed = "Godot Rocks".hash()
|
||||||
seed(my_seed.hash())
|
seed(my_seed)
|
||||||
|
var a = randf() + randi()
|
||||||
|
seed(my_seed)
|
||||||
|
var b = randf() + randi()
|
||||||
|
# a and b are now identical
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -960,7 +979,7 @@
|
||||||
<return type="Variant" />
|
<return type="Variant" />
|
||||||
<param index="0" name="x" type="Variant" />
|
<param index="0" name="x" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Returns the sign of [param x] as same type of [Variant] as [param x] with each component being -1, 0 and 1 for each negative, zero and positive values respectivelu. Variant types [int], [float] (real), [Vector2], [Vector2i], [Vector3] and [Vector3i] are supported.
|
Returns the sign of [param x] as same type of [Variant] as [param x] with each component being -1, 0 and 1 for each negative, zero and positive values respectively. Variant types [int], [float], [Vector2], [Vector2i], [Vector3] and [Vector3i] are supported.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
sign(-6.0) # Returns -1
|
sign(-6.0) # Returns -1
|
||||||
sign(0.0) # Returns 0
|
sign(0.0) # Returns 0
|
||||||
|
@ -974,11 +993,11 @@
|
||||||
<return type="float" />
|
<return type="float" />
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Returns the sign of [param x] as a float: -1.0 or 1.0. Returns 0.0 if [param x] is 0.
|
Returns the sign of [param x] as a [float]: -1.0 or 1.0. Returns 0.0 if [param x] is 0.0.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
sign(-6.0) # Returns -1.0
|
sign(-6.5) # Returns -1.0
|
||||||
sign(0.0) # Returns 0.0
|
sign(0.0) # Returns 0.0
|
||||||
sign(6.0) # Returns 1.0
|
sign(6.5) # Returns 1.0
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -986,7 +1005,7 @@
|
||||||
<return type="int" />
|
<return type="int" />
|
||||||
<param index="0" name="x" type="int" />
|
<param index="0" name="x" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Returns the sign of [param x] as an integer: -1 or 1. Returns 0 if [param x] is 0.
|
Returns the sign of [param x] as an [int]: -1 or 1. Returns 0 if [param x] is 0.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
sign(-6) # Returns -1
|
sign(-6) # Returns -1
|
||||||
sign(0) # Returns 0
|
sign(0) # Returns 0
|
||||||
|
@ -1040,7 +1059,7 @@
|
||||||
<param index="0" name="x" type="float" />
|
<param index="0" name="x" type="float" />
|
||||||
<param index="1" name="step" type="float" />
|
<param index="1" name="step" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Snaps float value [param x] to a given [param step]. This can also be used to round a floating point number to an arbitrary number of decimals.
|
Snaps the float value [param x] to a given [param step]. This can also be used to round a floating point number to an arbitrary number of decimals.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
snapped(100, 32) # Returns 96
|
snapped(100, 32) # Returns 96
|
||||||
snapped(3.14159, 0.01) # Returns 3.14
|
snapped(3.14159, 0.01) # Returns 3.14
|
||||||
|
@ -1055,8 +1074,10 @@
|
||||||
Returns the square root of [param x], where [param x] is a non-negative number.
|
Returns the square root of [param x], where [param x] is a non-negative number.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
sqrt(9) # Returns 3
|
sqrt(9) # Returns 3
|
||||||
|
sqrt(10.24) # Returns 3.2
|
||||||
|
sqrt(-1) # Returns NaN
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
[b]Note:[/b] Negative values of [param x] return NaN. If you need negative inputs, use [code]System.Numerics.Complex[/code] in C#.
|
[b]Note:[/b] Negative values of [param x] return NaN ("Not a Number"). in C#, if you need negative inputs, use [code]System.Numerics.Complex[/code].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="step_decimals">
|
<method name="step_decimals">
|
||||||
|
@ -1065,29 +1086,26 @@
|
||||||
<description>
|
<description>
|
||||||
Returns the position of the first non-zero digit, after the decimal point. Note that the maximum return value is 10, which is a design decision in the implementation.
|
Returns the position of the first non-zero digit, after the decimal point. Note that the maximum return value is 10, which is a design decision in the implementation.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
# n is 0
|
var n = step_decimals(5) # n is 0
|
||||||
var n = step_decimals(5)
|
n = step_decimals(1.0005) # n is 4
|
||||||
# n is 4
|
n = step_decimals(0.000000005) # n is 9
|
||||||
n = step_decimals(1.0005)
|
|
||||||
# n is 9
|
|
||||||
n = step_decimals(0.000000005)
|
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="str" qualifiers="vararg">
|
<method name="str" qualifiers="vararg">
|
||||||
<return type="String" />
|
<return type="String" />
|
||||||
<description>
|
<description>
|
||||||
Converts one or more arguments of any type to string in the best way possible.
|
Converts one or more arguments of any [Variant] type to [String] in the best way possible.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="str_to_var">
|
<method name="str_to_var">
|
||||||
<return type="Variant" />
|
<return type="Variant" />
|
||||||
<param index="0" name="string" type="String" />
|
<param index="0" name="string" type="String" />
|
||||||
<description>
|
<description>
|
||||||
Converts a formatted [param string] that was returned by [method var_to_str] to the original value.
|
Converts a formatted [param string] that was returned by [method var_to_str] to the original [Variant].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var a = '{ "a": 1, "b": 2 }'
|
var a = '{ "a": 1, "b": 2 }' # a is a String
|
||||||
var b = str_to_var(a)
|
var b = str_to_var(a) # b is a Dictionary
|
||||||
print(b["a"]) # Prints 1
|
print(b["a"]) # Prints 1
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
|
@ -1117,7 +1135,7 @@
|
||||||
<return type="int" />
|
<return type="int" />
|
||||||
<param index="0" name="variable" type="Variant" />
|
<param index="0" name="variable" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Returns the internal type of the given Variant object, using the [enum Variant.Type] values.
|
Returns the internal type of the given [param variable], using the [enum Variant.Type] values.
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var json = JSON.new()
|
var json = JSON.new()
|
||||||
json.parse('["a", "b", "c"]')
|
json.parse('["a", "b", "c"]')
|
||||||
|
@ -1141,19 +1159,19 @@
|
||||||
<return type="PackedByteArray" />
|
<return type="PackedByteArray" />
|
||||||
<param index="0" name="variable" type="Variant" />
|
<param index="0" name="variable" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Encodes a [Variant] value to a byte array. Encoding objects is allowed (and can potentially include code). Deserialization can be done with [method bytes_to_var_with_objects].
|
Encodes a [Variant] value to a byte array. Encoding objects is allowed (and can potentially include executable code). Deserialization can be done with [method bytes_to_var_with_objects].
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="var_to_str">
|
<method name="var_to_str">
|
||||||
<return type="String" />
|
<return type="String" />
|
||||||
<param index="0" name="variable" type="Variant" />
|
<param index="0" name="variable" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Converts a Variant [param variable] to a formatted string that can later be parsed using [method str_to_var].
|
Converts a [Variant] [param variable] to a formatted [String] that can then be parsed using [method str_to_var].
|
||||||
[codeblock]
|
[codeblock]
|
||||||
a = { "a": 1, "b": 2 }
|
a = { "a": 1, "b": 2 }
|
||||||
print(var_to_str(a))
|
print(var_to_str(a))
|
||||||
[/codeblock]
|
[/codeblock]
|
||||||
prints
|
Prints:
|
||||||
[codeblock]
|
[codeblock]
|
||||||
{
|
{
|
||||||
"a": 1,
|
"a": 1,
|
||||||
|
@ -1166,7 +1184,7 @@
|
||||||
<return type="Variant" />
|
<return type="Variant" />
|
||||||
<param index="0" name="obj" type="Variant" />
|
<param index="0" name="obj" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Returns a weak reference to an object, or [code]null[/code] if the argument is invalid.
|
Returns a weak reference to an object, or [code]null[/code] if [param obj] is invalid.
|
||||||
A weak reference to an object is not enough to keep the object alive: when the only remaining references to a referent are weak references, garbage collection is free to destroy the referent and reuse its memory for something else. However, until the object is actually destroyed the weak reference may return the object even if there are no strong references to it.
|
A weak reference to an object is not enough to keep the object alive: when the only remaining references to a referent are weak references, garbage collection is free to destroy the referent and reuse its memory for something else. However, until the object is actually destroyed the weak reference may return the object even if there are no strong references to it.
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
|
@ -1176,9 +1194,8 @@
|
||||||
<param index="1" name="min" type="Variant" />
|
<param index="1" name="min" type="Variant" />
|
||||||
<param index="2" name="max" type="Variant" />
|
<param index="2" name="max" type="Variant" />
|
||||||
<description>
|
<description>
|
||||||
Wraps the [Variant] [param value] between [param min] and [param max].
|
Wraps the [Variant] [param value] between [param min] and [param max]. Can be used for creating loop-alike behavior or infinite surfaces.
|
||||||
Usable for creating loop-alike behavior or infinite surfaces.
|
Variant types [int] and [float] are supported. If any of the arguments is [float] this function returns a [float], otherwise it returns an [int].
|
||||||
Variant types [int] and [float] (real) are supported. If any of the argument is [float] the result will be [float], otherwise it is [int].
|
|
||||||
[codeblock]
|
[codeblock]
|
||||||
var a = wrap(4, 5, 10)
|
var a = wrap(4, 5, 10)
|
||||||
# a is 9 (int)
|
# a is 9 (int)
|
||||||
|
@ -1197,8 +1214,7 @@
|
||||||
<param index="1" name="min" type="float" />
|
<param index="1" name="min" type="float" />
|
||||||
<param index="2" name="max" type="float" />
|
<param index="2" name="max" type="float" />
|
||||||
<description>
|
<description>
|
||||||
Wraps float [param value] between [param min] and [param max].
|
Wraps the float [param value] between [param min] and [param max]. Can be used for creating loop-alike behavior or infinite surfaces.
|
||||||
Usable for creating loop-alike behavior or infinite surfaces.
|
|
||||||
[codeblock]
|
[codeblock]
|
||||||
# Infinite loop between 5.0 and 9.9
|
# Infinite loop between 5.0 and 9.9
|
||||||
value = wrapf(value + 0.1, 5.0, 10.0)
|
value = wrapf(value + 0.1, 5.0, 10.0)
|
||||||
|
@ -1221,8 +1237,7 @@
|
||||||
<param index="1" name="min" type="int" />
|
<param index="1" name="min" type="int" />
|
||||||
<param index="2" name="max" type="int" />
|
<param index="2" name="max" type="int" />
|
||||||
<description>
|
<description>
|
||||||
Wraps integer [param value] between [param min] and [param max].
|
Wraps the integer [param value] between [param min] and [param max]. Can be used for creating loop-alike behavior or infinite surfaces.
|
||||||
Usable for creating loop-alike behavior or infinite surfaces.
|
|
||||||
[codeblock]
|
[codeblock]
|
||||||
# Infinite loop between 5 and 9
|
# Infinite loop between 5 and 9
|
||||||
frame = wrapi(frame + 1, 5, 10)
|
frame = wrapi(frame + 1, 5, 10)
|
||||||
|
@ -2864,7 +2879,7 @@
|
||||||
Variable is of type [int].
|
Variable is of type [int].
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="TYPE_FLOAT" value="3" enum="Variant.Type">
|
<constant name="TYPE_FLOAT" value="3" enum="Variant.Type">
|
||||||
Variable is of type [float] (real).
|
Variable is of type [float].
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="TYPE_STRING" value="4" enum="Variant.Type">
|
<constant name="TYPE_STRING" value="4" enum="Variant.Type">
|
||||||
Variable is of type [String].
|
Variable is of type [String].
|
||||||
|
|
Loading…
Reference in New Issue