godotengine
/
godot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add LOTS of missing docs

This commit is contained in:
Tomasz Chabora 2020-03-03 19:21:21 +01:00
parent 951ecc4f79
commit e103f21a40
59 changed files with 332 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/classes/AnimatedSprite.xml
View File

@ -61,8 +61,10 @@
If [code]true[/code], the [member animation] is currently playing.
</member>
<member name="shininess" type="float" setter="set_shininess" getter="get_shininess" default="1.0">
Strength of the specular light effect of this [AnimatedSprite].
</member>
<member name="specular_color" type="Color" setter="set_specular_color" getter="get_specular_color" default="Color( 1, 1, 1, 1 )">
The color of the specular light effect.
</member>
<member name="speed_scale" type="float" setter="set_speed_scale" getter="get_speed_scale" default="1.0">
The animation speed is multiplied by this value.

29
doc/classes/Animation.xml
View File

@ -14,7 +14,7 @@
animation.track_insert_key(track_index, 0.0, 0)
animation.track_insert_key(track_index, 0.5, 100)
[/codeblock]
Animations are just data containers, and must be added to nodes such as an [AnimationPlayer] to be played back.
Animations are just data containers, and must be added to nodes such as an [AnimationPlayer] to be played back. Animation tracks have different types, each with its own set of dedicated methods. Check [enum TrackType] to see available types.
</description>
<tutorials>
<link>https://docs.godotengine.org/en/latest/tutorials/animation/index.html</link>
@ -39,6 +39,7 @@
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Returns the animation name at the key identified by [code]key_idx[/code]. The [code]track_idx[/code] must be the index of an Animation Track.
</description>
</method>
<method name="animation_track_insert_key">
@ -51,6 +52,7 @@
<argument index="2" name="animation" type="StringName">
</argument>
<description>
Inserts a key with value [code]animation[/code] at the given [code]time[/code] (in seconds). The [code]track_idx[/code] must be the index of an Animation Track.
</description>
</method>
<method name="animation_track_set_key_animation">
@ -63,6 +65,7 @@
<argument index="2" name="animation" type="StringName">
</argument>
<description>
Sets the key identified by [code]key_idx[/code] to value [code]animation[/code]. The [code]track_idx[/code] must be the index of an Animation Track.
</description>
</method>
<method name="audio_track_get_key_end_offset" qualifiers="const">
@ -73,6 +76,8 @@
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Returns the end offset of the key identified by [code]key_idx[/code]. The [code]track_idx[/code] must be the index of an Audio Track.
End offset is the number of seconds cut off at the ending of the audio stream.
</description>
</method>
<method name="audio_track_get_key_start_offset" qualifiers="const">
@ -83,6 +88,8 @@
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Returns the start offset of the key identified by [code]key_idx[/code]. The [code]track_idx[/code] must be the index of an Audio Track.
Start offset is the number of seconds cut off at the beginning of the audio stream.
</description>
</method>
<method name="audio_track_get_key_stream" qualifiers="const">
@ -93,6 +100,7 @@
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Returns the audio stream of the key identified by [code]key_idx[/code]. The [code]track_idx[/code] must be the index of an Audio Track.
</description>
</method>
<method name="audio_track_insert_key">
@ -109,6 +117,8 @@
<argument index="4" name="end_offset" type="float" default="0">
</argument>
<description>
Inserts an Audio Track key at the given [code]time[/code] in seconds. The [code]track_idx[/code] must be the index of an Audio Track.
[code]stream[/code] is the [AudioStream] resource to play. [code]start_offset[/code] is the number of seconds cut off at the beginning of the audio stream, while [code]end_offset[/code] is at the ending.
</description>
</method>
<method name="audio_track_set_key_end_offset">
@ -121,6 +131,7 @@
<argument index="2" name="offset" type="float">
</argument>
<description>
Sets the end offset of the key identified by [code]key_idx[/code] to value [code]offset[/code]. The [code]track_idx[/code] must be the index of an Audio Track.
</description>
</method>
<method name="audio_track_set_key_start_offset">
@ -133,6 +144,7 @@
<argument index="2" name="offset" type="float">
</argument>
<description>
Sets the start offset of the key identified by [code]key_idx[/code] to value [code]offset[/code]. The [code]track_idx[/code] must be the index of an Audio Track.
</description>
</method>
<method name="audio_track_set_key_stream">
@ -145,6 +157,7 @@
<argument index="2" name="stream" type="Resource">
</argument>
<description>
Sets the stream of the key identified by [code]key_idx[/code] to value [code]offset[/code]. The [code]track_idx[/code] must be the index of an Audio Track.
</description>
</method>
<method name="bezier_track_get_key_in_handle" qualifiers="const">
@ -155,6 +168,7 @@
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Returns the in handle of the key identified by [code]key_idx[/code]. The [code]track_idx[/code] must be the index of a Bezier Track.
</description>
</method>
<method name="bezier_track_get_key_out_handle" qualifiers="const">
@ -165,6 +179,7 @@
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Returns the out handle of the key identified by [code]key_idx[/code]. The [code]track_idx[/code] must be the index of a Bezier Track.
</description>
</method>
<method name="bezier_track_get_key_value" qualifiers="const">
@ -175,6 +190,7 @@
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Returns the value of the key identified by [code]key_idx[/code]. The [code]track_idx[/code] must be the index of a Bezier Track.
</description>
</method>
<method name="bezier_track_insert_key">
@ -191,6 +207,8 @@
<argument index="4" name="out_handle" type="Vector2" default="Vector2( 0, 0 )">
</argument>
<description>
Inserts a Bezier Track key at the given [code]time[/code] in seconds. The [code]track_idx[/code] must be the index of a Bezier Track.
[code]in_handle[/code] is the left-side weight of the added Bezier curve point, [code]out_handle[/code] is the right-side one, while [code]value[/code] is the actual value at this point.
</description>
</method>
<method name="bezier_track_interpolate" qualifiers="const">
@ -201,6 +219,7 @@
<argument index="1" name="time" type="float">
</argument>
<description>
Returns the interpolated value at the given [code]time[/code] (in seconds). The [code]track_idx[/code] must be the index of a Bezier Track.
</description>
</method>
<method name="bezier_track_set_key_in_handle">
@ -213,6 +232,7 @@
<argument index="2" name="in_handle" type="Vector2">
</argument>
<description>
Sets the in handle of the key identified by [code]key_idx[/code] to value [code]in_handle[/code]. The [code]track_idx[/code] must be the index of a Bezier Track.
</description>
</method>
<method name="bezier_track_set_key_out_handle">
@ -225,6 +245,7 @@
<argument index="2" name="out_handle" type="Vector2">
</argument>
<description>
Sets the out handle of the key identified by [code]key_idx[/code] to value [code]out_handle[/code]. The [code]track_idx[/code] must be the index of a Bezier Track.
</description>
</method>
<method name="bezier_track_set_key_value">
@ -237,6 +258,7 @@
<argument index="2" name="value" type="float">
</argument>
<description>
Sets the value of the key identified by [code]key_idx[/code] to the given value. The [code]track_idx[/code] must be the index of a Bezier Track.
</description>
</method>
<method name="clear">
@ -675,6 +697,7 @@
<signals>
<signal name="tracks_changed">
<description>
Emitted when there's a change in the list of tracks, e.g. tracks are added, moved or have changed paths.
</description>
</signal>
</signals>
@ -689,10 +712,13 @@
Method tracks call functions with given arguments per key.
</constant>
<constant name="TYPE_BEZIER" value="3" enum="TrackType">
Bezier tracks are used to interpolate a value using custom curves. They can also be used to animate sub-properties of vectors and colors (e.g. alpha value of a [Color]).
</constant>
<constant name="TYPE_AUDIO" value="4" enum="TrackType">
Audio tracks are used to play an audio stream with either type of [AudioStreamPlayer]. The stream can be trimmed and previewed in the animation.
</constant>
<constant name="TYPE_ANIMATION" value="5" enum="TrackType">
Animation tracks play animations in other [AnimationPlayer] nodes.
</constant>
<constant name="INTERPOLATION_NEAREST" value="0" enum="InterpolationType">
No interpolation (nearest value).
@ -713,6 +739,7 @@
Update at the keyframes.
</constant>
<constant name="UPDATE_CAPTURE" value="3" enum="UpdateMode">
Same as linear interpolation, but also interpolates from the current value (i.e. dynamically at runtime) if the first key isn't at 0 seconds.
</constant>
</constants>
</class>

18
doc/classes/AnimationNodeBlendTree.xml
View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeBlendTree" inherits="AnimationRootNode" version="4.0">
<brief_description>
[AnimationTree] node resource that contains many blend type nodes.
</brief_description>
<description>
This node may contain a sub-tree of any other blend type nodes, such as mix, blend2, blend3, one shot, etc. This is one of the most commonly used roots.
</description>
<tutorials>
<link>https://docs.godotengine.org/en/latest/tutorials/animation/animation_tree.html</link>
@ -18,6 +20,7 @@
<argument index="2" name="position" type="Vector2" default="Vector2( 0, 0 )">
</argument>
<description>
Adds an [AnimationNode] at the given [code]position[/code]. The [code]name[/code] is used to identify the created sub-node later.
</description>
</method>
<method name="connect_node">
@ -30,6 +33,7 @@
<argument index="2" name="output_node" type="StringName">
</argument>
<description>
Connects the output of an [AnimationNode] as input for another [AnimationNode], at the input port specified by [code]input_index[/code].
</description>
</method>
<method name="disconnect_node">
@ -40,6 +44,7 @@
<argument index="1" name="input_index" type="int">
</argument>
<description>
Disconnects the node connected to the specified input.
</description>
</method>
<method name="get_node" qualifiers="const">
@ -48,6 +53,7 @@
<argument index="0" name="name" type="StringName">
</argument>
<description>
Returns the sub-node with the specified [code]name[/code].
</description>
</method>
<method name="get_node_position" qualifiers="const">
@ -56,6 +62,7 @@
<argument index="0" name="name" type="StringName">
</argument>
<description>
Returns the position of the sub-node with the specified [code]name[/code].
</description>
</method>
<method name="has_node" qualifiers="const">
@ -64,6 +71,7 @@
<argument index="0" name="name" type="StringName">
</argument>
<description>
Returns [code]true[/code] if a sub-node with specified [code]name[/code] exists.
</description>
</method>
<method name="remove_node">
@ -72,6 +80,7 @@
<argument index="0" name="name" type="StringName">
</argument>
<description>
Removes a sub-node.
</description>
</method>
<method name="rename_node">
@ -82,6 +91,7 @@
<argument index="1" name="new_name" type="StringName">
</argument>
<description>
Changes the name of a sub-node.
</description>
</method>
<method name="set_node_position">
@ -92,25 +102,33 @@
<argument index="1" name="position" type="Vector2">
</argument>
<description>
Modifies the position of a sub-node.
</description>
</method>
</methods>
<members>
<member name="graph_offset" type="Vector2" setter="set_graph_offset" getter="get_graph_offset" default="Vector2( 0, 0 )">
The global offset of all sub-nodes.
</member>
</members>
<constants>
<constant name="CONNECTION_OK" value="0">
The connection was successful.
</constant>
<constant name="CONNECTION_ERROR_NO_INPUT" value="1">
The input node is [code]null[/code].
</constant>
<constant name="CONNECTION_ERROR_NO_INPUT_INDEX" value="2">
The specified input port is out of range.
</constant>
<constant name="CONNECTION_ERROR_NO_OUTPUT" value="3">
The output node is [code]null[/code].
</constant>
<constant name="CONNECTION_ERROR_SAME_NODE" value="4">
Input and output nodes are the same.
</constant>
<constant name="CONNECTION_ERROR_CONNECTION_EXISTS" value="5">
The specified connection already exists.
</constant>
</constants>
</class>

5
doc/classes/AnimationNodeOneShot.xml
View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeOneShot" inherits="AnimationNode" version="4.0">
<brief_description>
Plays an animation once in [AnimationNodeBlendTree].
</brief_description>
<description>
A resource to add to an [AnimationNodeBlendTree]. This node will execute a sub-animation and return once it finishes. Blend times for fading in and out can be customized, as well as filters.
</description>
<tutorials>
<link>https://docs.godotengine.org/en/latest/tutorials/animation/animation_tree.html</link>
@ -25,10 +27,13 @@
</methods>
<members>
<member name="autorestart" type="bool" setter="set_autorestart" getter="has_autorestart" default="false">
If [code]true[/code], the sub-animation will restart automatically after finishing.
</member>
<member name="autorestart_delay" type="float" setter="set_autorestart_delay" getter="get_autorestart_delay" default="1.0">
The delay after which the automatic restart is triggered, in seconds.
</member>
<member name="autorestart_random_delay" type="float" setter="set_autorestart_random_delay" getter="get_autorestart_random_delay" default="0.0">
If [member autorestart] is [code]true[/code], a random additional delay (in seconds) between 0 and this value will be added to [member autorestart_delay].
</member>
<member name="fadein_time" type="float" setter="set_fadein_time" getter="get_fadein_time" default="0.1">
</member>

1
doc/classes/AnimationNodeOutput.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeOutput" inherits="AnimationNode" version="4.0">
<brief_description>
Generic output node to be added to [AnimationNodeBlendTree].
</brief_description>
<description>
</description>

2
doc/classes/AnimationNodeTimeScale.xml
View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeTimeScale" inherits="AnimationNode" version="4.0">
<brief_description>
A time-scaling animation node to be used with [AnimationTree].
</brief_description>
<description>
Allows scaling the speed of the animation (or reversing it) in any children nodes. Setting it to 0 will pause the animation.
</description>
<tutorials>
<link>https://docs.godotengine.org/en/latest/tutorials/animation/animation_tree.html</link>

2
doc/classes/AnimationNodeTimeSeek.xml
View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeTimeSeek" inherits="AnimationNode" version="4.0">
<brief_description>
A time-seeking animation node to be used with [AnimationTree].
</brief_description>
<description>
This node can be used to cause a seek command to happen to any sub-children of the graph. After setting the time, this value returns to -1.
</description>
<tutorials>
<link>https://docs.godotengine.org/en/latest/tutorials/animation/animation_tree.html</link>

4
doc/classes/AnimationNodeTransition.xml
View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeTransition" inherits="AnimationNode" version="4.0">
<brief_description>
A generic animation transition node for [AnimationTree].
</brief_description>
<description>
Simple state machine for cases which don't require a more advanced [AnimationNodeStateMachine]. Animations can be connected to the inputs and transition times can be specified.
</description>
<tutorials>
<link>https://docs.godotengine.org/en/latest/tutorials/animation/animation_tree.html</link>
@ -47,8 +49,10 @@
</methods>
<members>
<member name="input_count" type="int" setter="set_enabled_inputs" getter="get_enabled_inputs" default="0">
The number of available input ports for this node.
</member>
<member name="xfade_time" type="float" setter="set_cross_fade_time" getter="get_cross_fade_time" default="0.0">
Cross-fading time (in seconds) between each animation connected to the inputs.
</member>
</members>
<constants>

9
doc/classes/AnimationTree.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationTree" inherits="Node" version="4.0">
<brief_description>
A node to be used for advanced animation transitions in an [AnimationPlayer].
</brief_description>
<description>
</description>
@ -15,6 +16,7 @@
<argument index="0" name="delta" type="float">
</argument>
<description>
Manually advance the animations by the specified time (in seconds).
</description>
</method>
<method name="get_root_motion_transform" qualifiers="const">
@ -36,22 +38,29 @@
</methods>
<members>
<member name="active" type="bool" setter="set_active" getter="is_active" default="false">
If [code]true[/code], the [AnimationTree] will be processing.
</member>
<member name="anim_player" type="NodePath" setter="set_animation_player" getter="get_animation_player" default="NodePath(&quot;&quot;)">
The path to the [AnimationPlayer] used for animating.
</member>
<member name="process_mode" type="int" setter="set_process_mode" getter="get_process_mode" enum="AnimationTree.AnimationProcessMode" default="1">
The process mode of this [AnimationTree]. See [enum AnimationProcessMode] for available modes.
</member>
<member name="root_motion_track" type="NodePath" setter="set_root_motion_track" getter="get_root_motion_track" default="NodePath(&quot;&quot;)">
</member>
<member name="tree_root" type="AnimationNode" setter="set_tree_root" getter="get_tree_root">
The root animation node of this [AnimationTree]. See [AnimationNode].
</member>
</members>
<constants>
<constant name="ANIMATION_PROCESS_PHYSICS" value="0" enum="AnimationProcessMode">
The animations will progress during the physics frame (i.e. [method Node._physics_process]).
</constant>
<constant name="ANIMATION_PROCESS_IDLE" value="1" enum="AnimationProcessMode">
The animations will progress during the idle frame (i.e. [method Node._process]).
</constant>
<constant name="ANIMATION_PROCESS_MANUAL" value="2" enum="AnimationProcessMode">
The animations will only progress manually (see [method advance]).
</constant>
</constants>
</class>

1
doc/classes/ArrayMesh.xml
View File

@ -70,6 +70,7 @@
<return type="void">
</return>
<description>
Removes all surfaces from this [ArrayMesh].
</description>
</method>
<method name="get_blend_shape_count" qualifiers="const">

6
doc/classes/AudioEffectRecord.xml
View File

@ -1,22 +1,26 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AudioEffectRecord" inherits="AudioEffect" version="4.0">
<brief_description>
Audio effect used for recording sound from a microphone.
</brief_description>
<description>
</description>
<tutorials>
<link>https://docs.godotengine.org/en/latest/tutorials/audio/recording_with_microphone.html</link>
</tutorials>
<methods>
<method name="get_recording" qualifiers="const">
<return type="AudioStreamSample">
</return>
<description>
Returns the recorded sample.
</description>
</method>
<method name="is_recording_active" qualifiers="const">
<return type="bool">
</return>
<description>
Returns whether the recording is active or not.
</description>
</method>
<method name="set_recording_active">
@ -25,11 +29,13 @@
<argument index="0" name="record" type="bool">
</argument>
<description>
If [code]true[/code], the sound will be recorded. Note that restarting the recording will remove the previously recorded sample.
</description>
</method>
</methods>
<members>
<member name="format" type="int" setter="set_format" getter="get_format" enum="AudioStreamSample.Format" default="1">
Specifies the format in which the sample will be recorded. See [enum AudioStreamSample.Format] for available formats.
</member>
</members>
<constants>

11
doc/classes/BaseMaterial3D.xml
View File

@ -67,6 +67,7 @@
<argument index="1" name="texture" type="Texture2D">
</argument>
<description>
Sets the texture for the slot specified by [code]param[/code]. See [enum TextureParam] for available slots.
</description>
</method>
</methods>
@ -425,8 +426,10 @@
Represents the size of the [enum TextureParam] enum.
</constant>
<constant name="TEXTURE_FILTER_NEAREST" value="0" enum="TextureFilter">
The texture filter reads from the nearest pixel only. The simplest and fastest method of filtering, but the texture will look pixelized.
</constant>
<constant name="TEXTURE_FILTER_LINEAR" value="1" enum="TextureFilter">
The texture filter blends between the nearest four pixels. Use this for most cases where you want to avoid a pixelated style.
</constant>
<constant name="TEXTURE_FILTER_NEAREST_WITH_MIPMAPS" value="2" enum="TextureFilter">
</constant>
@ -437,6 +440,7 @@
<constant name="TEXTURE_FILTER_LINEAR_WITH_MIPMAPS_ANISOTROPIC" value="5" enum="TextureFilter">
</constant>
<constant name="TEXTURE_FILTER_MAX" value="6" enum="TextureFilter">
Represents the size of the [enum TextureFilter] enum.
</constant>
<constant name="DETAIL_UV_1" value="0" enum="DetailUV">
Use [code]UV[/code] with the detail texture.
@ -445,22 +449,29 @@
Use [code]UV2[/code] with the detail texture.
</constant>
<constant name="TRANSPARENCY_DISABLED" value="0" enum="Transparency">
The material will not use transparency.
</constant>
<constant name="TRANSPARENCY_ALPHA" value="1" enum="Transparency">
The material will use the texture's alpha values for transparency.
</constant>
<constant name="TRANSPARENCY_ALPHA_SCISSOR" value="2" enum="Transparency">
</constant>
<constant name="TRANSPARENCY_ALPHA_DEPTH_PRE_PASS" value="3" enum="Transparency">
</constant>
<constant name="TRANSPARENCY_MAX" value="4" enum="Transparency">
Represents the size of the [enum Transparency] enum.
</constant>
<constant name="SHADING_MODE_UNSHADED" value="0" enum="ShadingMode">
The object will not receive shadows.
</constant>
<constant name="SHADING_MODE_PER_PIXEL" value="1" enum="ShadingMode">
The object will be shaded per pixel. Useful for realistic shading effect.
</constant>
<constant name="SHADING_MODE_PER_VERTEX" value="2" enum="ShadingMode">
The object will be shaded per vertex. Useful when you want cheaper shaders and do not care about visual quality.
</constant>
<constant name="SHADING_MODE_MAX" value="3" enum="ShadingMode">
Represents the size of the [enum ShadingMode] enum.
</constant>
<constant name="FEATURE_EMISSION" value="0" enum="Feature">
Constant for setting [member emission_enabled].

18
doc/classes/Callable.xml
View File

@ -1,8 +1,20 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="Callable" version="4.0">
<brief_description>
An object representing a method in a certain object that can be called.
</brief_description>
<description>
[Callable] is a first class object which can be held in variables and passed to functions. It represents a given method in an [Object], and is typically used for signal callbacks.
[b]Example:[/b]
[codeblock]
var callable = Callable(self, "print_args")
func print_args(arg1, arg2, arg3 = ""):
prints(arg1, arg2, arg3)
func test():
callable.call("hello", "world") # Prints "hello world".
callable.call(Vector2.UP, 42, callable) # Prints "(0, -1) 42 Node(Node.gd)::print_args".
callable.call("invalid") # Invalid call, should have at least 2 arguments.
[/codeblock]
</description>
<tutorials>
</tutorials>
@ -15,36 +27,42 @@
<argument index="1" name="method_name" type="StringName">
</argument>
<description>
Creates a new [Callable] for the method called [code]method_name[/code] in the specified [code]object[/code].
</description>
</method>
<method name="call" qualifiers="vararg">
<return type="Variant">
</return>
<description>
Calls the method represented by this [Callable]. Arguments can be passed and should match the method's signature.
</description>
</method>
<method name="call_deferred" qualifiers="vararg">
<return type="void">
</return>
<description>
Calls the method represented by this [Callable] in deferred mode, i.e. during the idle frame. Arguments can be passed and should match the method's signature.
</description>
</method>
<method name="get_method">
<return type="StringName">
</return>
<description>
Returns the name of the method represented by this [Callable].
</description>
</method>
<method name="get_object">
<return type="Object">
</return>
<description>
Returns the object on which this [Callable] is called.
</description>
</method>
<method name="get_object_id">
<return type="int">
</return>
<description>
Returns the ID of this [Callable]'s object (see [method Object.get_instance_id]).
</description>
</method>
<method name="hash">

9
doc/classes/CanvasItem.xml
View File

@ -656,10 +656,13 @@
The [CanvasItem] has exited the canvas.
</constant>
<constant name="TEXTURE_FILTER_PARENT_NODE" value="0" enum="TextureFilter">
The [CanvasItem] will inherit the filter from its parent.
</constant>
<constant name="TEXTURE_FILTER_NEAREST" value="1" enum="TextureFilter">
The texture filter reads from the nearest pixel only. The simplest and fastest method of filtering. Useful for pixel art.
</constant>
<constant name="TEXTURE_FILTER_LINEAR" value="2" enum="TextureFilter">
The texture filter blends between the nearest four pixels. Use this for most cases where you want to avoid a pixelated style.
</constant>
<constant name="TEXTURE_FILTER_NEAREST_WITH_MIPMAPS" value="3" enum="TextureFilter">
</constant>
@ -670,16 +673,22 @@
<constant name="TEXTURE_FILTER_LINEAR_WITH_MIPMAPS_ANISOTROPIC" value="6" enum="TextureFilter">
</constant>
<constant name="TEXTURE_FILTER_MAX" value="7" enum="TextureFilter">
Represents the size of the [enum TextureFilter] enum.
</constant>
<constant name="TEXTURE_REPEAT_PARENT_NODE" value="0" enum="TextureRepeat">
The [CanvasItem] will inherit the filter from its parent.
</constant>
<constant name="TEXTURE_REPEAT_DISABLED" value="1" enum="TextureRepeat">
Texture will not repeat.
</constant>
<constant name="TEXTURE_REPEAT_ENABLED" value="2" enum="TextureRepeat">
Texture will repeat normally.
</constant>
<constant name="TEXTURE_REPEAT_MIRROR" value="3" enum="TextureRepeat">
Texture will repeat in a 2x2 tiled mode, where elements at even positions are mirrored.
</constant>
<constant name="TEXTURE_REPEAT_MAX" value="4" enum="TextureRepeat">
Represents the size of the [enum TextureRepeat] enum.
</constant>
</constants>
</class>

1
doc/classes/CollisionPolygon2D.xml
View File

@ -21,6 +21,7 @@
If [code]true[/code], only edges that face up, relative to [CollisionPolygon2D]'s rotation, will collide with other objects.
</member>
<member name="one_way_collision_margin" type="float" setter="set_one_way_collision_margin" getter="get_one_way_collision_margin" default="1.0">
The margin used for one-way collision (in pixels). Higher values will make the shape thicker, and work better for colliders that enter the polygon at a high velocity.
</member>
<member name="polygon" type="PackedVector2Array" setter="set_polygon" getter="get_polygon" default="PackedVector2Array( )">
The polygon's list of vertices. The final point will be connected to the first. The returned value is a clone of the [PackedVector2Array], not a reference.

2
doc/classes/CollisionShape2D.xml
View File

@ -19,7 +19,7 @@
Sets whether this collision shape should only detect collision on one side (top or bottom).
</member>
<member name="one_way_collision_margin" type="float" setter="set_one_way_collision_margin" getter="get_one_way_collision_margin" default="1.0">
The margin used for one-way collision (in pixels).
The margin used for one-way collision (in pixels). Higher values will make the shape thicker, and work better for colliders that enter the shape at a high velocity.
</member>
<member name="shape" type="Shape2D" setter="set_shape" getter="get_shape">
The actual shape owned by this collision shape.

8
doc/classes/ColorPicker.xml
View File

@ -88,26 +88,34 @@
</constants>
<theme_items>
<theme_item name="add_preset" type="Texture2D">
The icon for the "Add Preset" button.
</theme_item>
<theme_item name="color_hue" type="Texture2D">
Custom texture for the hue selection slider on the right.
</theme_item>
<theme_item name="color_sample" type="Texture2D">
</theme_item>
<theme_item name="h_width" type="int" default="30">
The width of the hue selection slider.
</theme_item>
<theme_item name="label_width" type="int" default="10">
</theme_item>
<theme_item name="margin" type="int" default="4">
The margin around the [ColorPicker].
</theme_item>
<theme_item name="overbright_indicator" type="Texture2D">
The indicator used to signalize that the color value is outside the 0-1 range.
</theme_item>
<theme_item name="preset_bg" type="Texture2D">
</theme_item>
<theme_item name="screen_picker" type="Texture2D">
The icon for the screen color picker button.
</theme_item>
<theme_item name="sv_height" type="int" default="256">
The height of the saturation-value selection box.
</theme_item>
<theme_item name="sv_width" type="int" default="256">
The width of the saturation-value selection box.
</theme_item>
</theme_items>
</class>

3
doc/classes/EditorExportPlugin.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="EditorExportPlugin" inherits="Reference" version="4.0">
<brief_description>
A script that is executed when exporting projects.
</brief_description>
<description>
</description>
@ -19,12 +20,14 @@
<argument index="3" name="flags" type="int">
</argument>
<description>
Virtual method to be overridden by the user. It is called when the export starts and provides all information about the export.
</description>
</method>
<method name="_export_end" qualifiers="virtual">
<return type="void">
</return>
<description>
Virtual method to be overridden by the user. Called when the export is finished.
</description>
</method>
<method name="_export_file" qualifiers="virtual">

1
doc/classes/EditorFileDialog.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="EditorFileDialog" inherits="ConfirmationDialog" version="4.0">
<brief_description>
A modified version of [FileDialog] used by the editor.
</brief_description>
<description>
</description>

1
doc/classes/EditorFileSystem.xml
View File

@ -75,6 +75,7 @@
<return type="void">
</return>
<description>
Scans the script files and updates the list of custom class names.
</description>
</method>
</methods>

1
doc/classes/Environment.xml
View File

@ -191,6 +191,7 @@
<member name="reflected_light_source" type="int" setter="set_reflection_source" getter="get_reflection_source" enum="Environment.ReflectionSource" default="0">
</member>
<member name="sky" type="Sky" setter="set_sky" getter="get_sky">
The [Sky] resource used for this [Environment].
</member>
<member name="sky_custom_fov" type="float" setter="set_sky_custom_fov" getter="get_sky_custom_fov" default="0.0">
</member>

6
doc/classes/FileDialog.xml
View File

@ -133,16 +133,22 @@
</constants>
<theme_items>
<theme_item name="files_disabled" type="Color" default="Color( 0, 0, 0, 0.7 )">
The color tint for disabled files (when the [FileDialog] is used in open folder mode).
</theme_item>
<theme_item name="folder" type="Texture2D">
Custom icon for folders.
</theme_item>
<theme_item name="folder_icon_modulate" type="Color" default="Color( 1, 1, 1, 1 )">
The color modulation applied to the folder icon.
</theme_item>
<theme_item name="parent_folder" type="Texture2D">
Custom icon for the parent folder arrow.
</theme_item>
<theme_item name="reload" type="Texture2D">
Custom icon for the reload button.
</theme_item>
<theme_item name="toggle_hidden" type="Texture2D">
Custom icon for the toggle hidden button.
</theme_item>
</theme_items>
</class>

1
doc/classes/Font.xml
View File

@ -85,6 +85,7 @@
<argument index="1" name="width" type="float">
</argument>
<description>
Returns the size that the string would have with word wrapping enabled with a fixed [code]width[/code].
</description>
</method>
<method name="has_outline" qualifiers="const">

11
doc/classes/GraphEdit.xml
View File

@ -303,26 +303,37 @@
<theme_item name="bezier_len_pos" type="int" default="80">
</theme_item>
<theme_item name="bg" type="StyleBox">
The background drawn under the grid.
</theme_item>
<theme_item name="grid_major" type="Color" default="Color( 1, 1, 1, 0.2 )">
Color of major grid lines.
</theme_item>
<theme_item name="grid_minor" type="Color" default="Color( 1, 1, 1, 0.05 )">
Color of minor grid lines.
</theme_item>
<theme_item name="minus" type="Texture2D">
The icon for the zoom out button.
</theme_item>
<theme_item name="more" type="Texture2D">
The icon for the zoom in button.
</theme_item>
<theme_item name="port_grab_distance_horizontal" type="int" default="48">
The horizontal range within which a port can be grabbed (on both sides).
</theme_item>
<theme_item name="port_grab_distance_vertical" type="int" default="6">
The vertical range within which a port can be grabbed (on both sides).
</theme_item>
<theme_item name="reset" type="Texture2D">
The icon for the zoom reset button.
</theme_item>
<theme_item name="selection_fill" type="Color" default="Color( 1, 1, 1, 0.3 )">
The fill color of the selection rectangle.
</theme_item>
<theme_item name="selection_stroke" type="Color" default="Color( 1, 1, 1, 0.8 )">
The outline color of the selection rectangle.
</theme_item>
<theme_item name="snap" type="Texture2D">
The icon for the snap toggle button.
</theme_item>
</theme_items>
</class>

17
doc/classes/GraphNode.xml
View File

@ -253,42 +253,59 @@
</constants>
<theme_items>
<theme_item name="breakpoint" type="StyleBox">
The background used when [member overlay] is set to [constant OVERLAY_BREAKPOINT].
</theme_item>
<theme_item name="close" type="Texture2D">
The icon for the close button, visible when [member show_close] is enabled.
</theme_item>
<theme_item name="close_color" type="Color" default="Color( 0, 0, 0, 1 )">
The color modulation applied to the close button icon.
</theme_item>
<theme_item name="close_offset" type="int" default="18">
The vertical offset of the close button.
</theme_item>
<theme_item name="comment" type="StyleBox">
The [StyleBox] used when [member comment] is enabled.
</theme_item>
<theme_item name="commentfocus" type="StyleBox">
The [StyleBox] used when [member comment] is enabled and the [GraphNode] is focused.
</theme_item>
<theme_item name="defaultfocus" type="StyleBox">
</theme_item>
<theme_item name="defaultframe" type="StyleBox">
</theme_item>
<theme_item name="frame" type="StyleBox">
The default background for [GraphNode].
</theme_item>
<theme_item name="port" type="Texture2D">
The icon used for representing ports.
</theme_item>
<theme_item name="port_offset" type="int" default="3">
Horizontal offset for the ports.
</theme_item>
<theme_item name="position" type="StyleBox">
The background used when [member overlay] is set to [constant OVERLAY_POSITION].
</theme_item>
<theme_item name="resizer" type="Texture2D">
The icon used for resizer, visible when [member resizable] is enabled.
</theme_item>
<theme_item name="resizer_color" type="Color" default="Color( 0, 0, 0, 1 )">
The color modulation applied to the resizer icon.
</theme_item>
<theme_item name="selectedframe" type="StyleBox">
The background used when the [GraphNode] is selected.
</theme_item>
<theme_item name="separation" type="int" default="1">
The vertical distance between ports.
</theme_item>
<theme_item name="title_color" type="Color" default="Color( 0, 0, 0, 1 )">
Color of the title text.
</theme_item>
<theme_item name="title_font" type="Font">
Font used for the title text.
</theme_item>
<theme_item name="title_offset" type="int" default="20">
Vertical offset of the title text.
</theme_item>
</theme_items>
</class>

2
doc/classes/GridContainer.xml
View File

@ -20,8 +20,10 @@
</constants>
<theme_items>
<theme_item name="hseparation" type="int" default="4">
The horizontal separation of children nodes.
</theme_item>
<theme_item name="vseparation" type="int" default="4">
The vertical separation of children nodes.
</theme_item>
</theme_items>
</class>

2
doc/classes/HSeparator.xml
View File

@ -14,8 +14,10 @@
</constants>
<theme_items>
<theme_item name="separation" type="int" default="4">
The height of the area covered by the separator. Effectively works like a minimum height.
</theme_item>
<theme_item name="separator" type="StyleBox">
The style for the separator line. Works best with [StyleBoxLine].
</theme_item>
</theme_items>
</class>

6
doc/classes/HSlider.xml
View File

@ -14,16 +14,22 @@
</constants>
<theme_items>
<theme_item name="grabber" type="Texture2D">
The texture for the grabber (the draggable element).
</theme_item>
<theme_item name="grabber_area" type="StyleBox">
The background of the area to the left of the grabber.
</theme_item>
<theme_item name="grabber_disabled" type="Texture2D">
The texture for the grabber when it's disabled.
</theme_item>
<theme_item name="grabber_highlight" type="Texture2D">
The texture for the grabber when it's focused.
</theme_item>
<theme_item name="slider" type="StyleBox">
The background for the whole slider. Determines the height of the [code]grabber_area[/code].
</theme_item>
<theme_item name="tick" type="Texture2D">
The texture for the ticks, visible when [member Slider.tick_count] is greater than 0.
</theme_item>
</theme_items>
</class>

3
doc/classes/HSplitContainer.xml
View File

@ -14,12 +14,15 @@
</constants>
<theme_items>
<theme_item name="autohide" type="int" default="1">
Boolean value. If 1 ([code]true[/code]), the grabber will hide automatically when it isn't under the cursor. If 0 ([code]false[/code]), it's always visible.
</theme_item>
<theme_item name="bg" type="StyleBox">
</theme_item>
<theme_item name="grabber" type="Texture2D">
The icon used for the grabber drawn in the middle area.
</theme_item>
<theme_item name="separation" type="int" default="12">
The space between sides of the container.
</theme_item>
</theme_items>
</class>

4
doc/classes/HingeJoint.xml
View File

@ -15,6 +15,7 @@
<argument index="0" name="flag" type="int" enum="HingeJoint.Flag">
</argument>
<description>
Returns the value of the specified flag.
</description>
</method>
<method name="get_param" qualifiers="const">
@ -23,6 +24,7 @@
<argument index="0" name="param" type="int" enum="HingeJoint.Param">
</argument>
<description>
Returns the value of the specified parameter.
</description>
</method>
<method name="set_flag">
@ -33,6 +35,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
If [code]true[/code], enables the specified flag.
</description>
</method>
<method name="set_param">
@ -43,6 +46,7 @@
<argument index="1" name="value" type="float">
</argument>
<description>
Sets the value of the specified parameter.
</description>
</method>
</methods>

1
doc/classes/ImageTexture.xml
View File

@ -42,6 +42,7 @@
<argument index="1" name="immediate" type="bool" default="false">
</argument>
<description>
Replaces the texture's data with a new [code]image[/code]. If [code]immediate[/code] is [code]true[/code], it will take effect immediately after the call.
</description>
</method>
</methods>

2
doc/classes/InputEventGesture.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="InputEventGesture" inherits="InputEventWithModifiers" version="4.0">
<brief_description>
Base class for touch control gestures.
</brief_description>
<description>
</description>
@ -10,6 +11,7 @@
</methods>
<members>
<member name="position" type="Vector2" setter="set_position" getter="get_position" default="Vector2( 0, 0 )">
The local gesture position relative to the [Viewport]. If used in [method Control._gui_input], the position is relative to the current [Control] that received this gesture.
</member>
</members>
<constants>

2
doc/classes/MultiMesh.xml
View File

@ -125,8 +125,10 @@
Format of transform used to transform mesh, either 2D or 3D.
</member>
<member name="use_colors" type="bool" setter="set_use_colors" getter="is_using_colors" default="false">
If [code]true[/code], the [MultiMesh] will use color data (see [member color_array]).
</member>
<member name="use_custom_data" type="bool" setter="set_use_custom_data" getter="is_using_custom_data" default="false">
If [code]true[/code], the [MultiMesh] will use custom data (see [member custom_data_array]).
</member>
<member name="visible_instance_count" type="int" setter="set_visible_instance_count" getter="get_visible_instance_count" default="-1">
Limits the number of instances drawn, -1 draws all instances. Changing this does not change the sizes of the buffers.

1
doc/classes/PackedDataContainerRef.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="PackedDataContainerRef" inherits="Reference" version="4.0">
<brief_description>
Reference version of [PackedDataContainer].
</brief_description>
<description>
</description>

1
doc/classes/Panel.xml
View File

@ -14,6 +14,7 @@
</constants>
<theme_items>
<theme_item name="panel" type="StyleBox">
The style of this [Panel].
</theme_item>
</theme_items>
</class>

1
doc/classes/PanelContainer.xml
View File

@ -17,6 +17,7 @@
</constants>
<theme_items>
<theme_item name="panel" type="StyleBox">
The style of [PanelContainer]'s background.
</theme_item>
</theme_items>
</class>

2
doc/classes/PinJoint.xml
View File

@ -15,6 +15,7 @@
<argument index="0" name="param" type="int" enum="PinJoint.Param">
</argument>
<description>
Returns the value of the specified parameter.
</description>
</method>
<method name="set_param">
@ -25,6 +26,7 @@
<argument index="1" name="value" type="float">
</argument>
<description>
Sets the value of the specified parameter.
</description>
</method>
</methods>

8
doc/classes/Polygon2D.xml
View File

@ -17,12 +17,14 @@
<argument index="1" name="weights" type="PackedFloat32Array">
</argument>
<description>
Adds a bone with the specified [code]path[/code] and [code]weights[/code].
</description>
</method>
<method name="clear_bones">
<return type="void">
</return>
<description>
Removes all bones from this [Polygon2D].
</description>
</method>
<method name="erase_bone">
@ -31,12 +33,14 @@
<argument index="0" name="index" type="int">
</argument>
<description>
Removes the specified bone from this [Polygon2D].
</description>
</method>
<method name="get_bone_count" qualifiers="const">
<return type="int">
</return>
<description>
Returns the number of bones in this [Polygon2D].
</description>
</method>
<method name="get_bone_path" qualifiers="const">
@ -45,6 +49,7 @@
<argument index="0" name="index" type="int">
</argument>
<description>
Returns the path to the node associated with the specified bone.
</description>
</method>
<method name="get_bone_weights" qualifiers="const">
@ -53,6 +58,7 @@
<argument index="0" name="index" type="int">
</argument>
<description>
Returns the height values of the specified bone.
</description>
</method>
<method name="set_bone_path">
@ -63,6 +69,7 @@
<argument index="1" name="path" type="NodePath">
</argument>
<description>
Sets the path to the node associated with the specified bone.
</description>
</method>
<method name="set_bone_weights">
@ -73,6 +80,7 @@
<argument index="1" name="weights" type="PackedFloat32Array">
</argument>
<description>
Sets the weight values for the specified bone.
</description>
</method>
</methods>

1
doc/classes/PopupPanel.xml
View File

@ -14,6 +14,7 @@
</constants>
<theme_items>
<theme_item name="panel" type="StyleBox">
The background panel style of this [PopupPanel].
</theme_item>
</theme_items>
</class>

5
doc/classes/ProgressBar.xml
View File

@ -21,14 +21,19 @@
</constants>
<theme_items>
<theme_item name="bg" type="StyleBox">
The style of the background.
</theme_item>
<theme_item name="fg" type="StyleBox">
The style of the progress (i.e. the part that fills the bar).
</theme_item>
<theme_item name="font" type="Font">
Font used to draw the fill percentage if [member percent_visible] is [code]true[/code].
</theme_item>
<theme_item name="font_color" type="Color" default="Color( 0.94, 0.94, 0.94, 1 )">
The color of the text.
</theme_item>
<theme_item name="font_color_shadow" type="Color" default="Color( 0, 0, 0, 1 )">
The color of the text's shadow.
</theme_item>
</theme_items>
</class>

9
doc/classes/ResourceLoader.xml
View File

@ -74,6 +74,8 @@
<argument index="0" name="path" type="String">
</argument>
<description>
Returns the resource loaded by [method load_threaded_request].
If this is called before the loading thread is done (i.e. [method load_threaded_get_status] is not [constant THREAD_LOAD_LOADED]), the calling thread will be blocked until the resource has finished loading.
</description>
</method>
<method name="load_threaded_get_status">
@ -84,6 +86,8 @@
<argument index="1" name="progress" type="Array" default="[ ]">
</argument>
<description>
Returns the status of a threaded loading operation started with [method load_threaded_request] for the resource at [code]path[/code]. See [enum ThreadLoadStatus] for possible return values.
An array variable can optionally be passed via [code]progress[/code], and will return a one-element array containing the percentage of completion of the threaded loading.
</description>
</method>
<method name="load_threaded_request">
@ -96,6 +100,7 @@
<argument index="2" name="use_sub_threads" type="bool" default="false">
</argument>
<description>
Loads the resource using threads. If [code]use_sub_threads[/code] is [code]true[/code], multiple threads will be used to load the resource, which makes loading faster, but may affect the main thread (and thus cause game slowdowns).
</description>
</method>
<method name="set_abort_on_missing_resources">
@ -110,12 +115,16 @@
</methods>
<constants>
<constant name="THREAD_LOAD_INVALID_RESOURCE" value="0" enum="ThreadLoadStatus">
The resource is invalid, or has not been loaded with [method load_threaded_request].
</constant>
<constant name="THREAD_LOAD_IN_PROGRESS" value="1" enum="ThreadLoadStatus">
The resource is still being loaded.
</constant>
<constant name="THREAD_LOAD_FAILED" value="2" enum="ThreadLoadStatus">
Some error occurred during loading and it failed.
</constant>
<constant name="THREAD_LOAD_LOADED" value="3" enum="ThreadLoadStatus">
The resource was loaded successfully and can be accessed via [method load_threaded_get].
</constant>
</constants>
</class>

17
doc/classes/RichTextLabel.xml
View File

@ -409,38 +409,55 @@
</constants>
<theme_items>
<theme_item name="bold_font" type="Font">
The font used for bold text.
</theme_item>
<theme_item name="bold_italics_font" type="Font">
The font used for bold italics text.
</theme_item>
<theme_item name="default_color" type="Color" default="Color( 1, 1, 1, 1 )">
The default text color.
</theme_item>
<theme_item name="focus" type="StyleBox">
The background The background used when the [RichTextLabel] is focused.
</theme_item>
<theme_item name="font_color_selected" type="Color" default="Color( 0.49, 0.49, 0.49, 1 )">
The color of selected text, used when [member selection_enabled] is [code]true[/code].
</theme_item>
<theme_item name="font_color_shadow" type="Color" default="Color( 0, 0, 0, 0 )">
The color of the font's shadow.
</theme_item>
<theme_item name="italics_font" type="Font">
The font used for italics text.
</theme_item>
<theme_item name="line_separation" type="int" default="1">
The vertical space between lines.
</theme_item>
<theme_item name="mono_font" type="Font">
The font used for monospace text.
</theme_item>
<theme_item name="normal" type="StyleBox">
The normal background for the [RichTextLabel].
</theme_item>
<theme_item name="normal_font" type="Font">
The default text font.
</theme_item>
<theme_item name="selection_color" type="Color" default="Color( 0.1, 0.1, 1, 0.8 )">
The color of the selection box.
</theme_item>
<theme_item name="shadow_as_outline" type="int" default="0">
Boolean value. If 1 ([code]true[/code]), the shadow will be displayed around the whole text as an outline.
</theme_item>
<theme_item name="shadow_offset_x" type="int" default="1">
The horizontal offset of the font's shadow.
</theme_item>
<theme_item name="shadow_offset_y" type="int" default="1">
The vertical offset of the font's shadow.
</theme_item>
<theme_item name="table_hseparation" type="int" default="3">
The horizontal separation of elements in a table.
</theme_item>
<theme_item name="table_vseparation" type="int" default="3">
The vertical separation of elements in a table.
</theme_item>
</theme_items>
</class>

5
doc/classes/Script.xml
View File

@ -38,30 +38,35 @@
<argument index="0" name="property" type="StringName">
</argument>
<description>
Returns the default value of the specified property.
</description>
</method>
<method name="get_script_constant_map">
<return type="Dictionary">
</return>
<description>
Returns a dictionary containing constant names and their values.
</description>
</method>
<method name="get_script_method_list">
<return type="Array">
</return>
<description>
Returns the list of methods in this [Script].
</description>
</method>
<method name="get_script_property_list">
<return type="Array">
</return>
<description>
Returns the list of properties in this [Script].
</description>
</method>
<method name="get_script_signal_list">
<return type="Array">
</return>
<description>
Returns the list of user signals defined in this [Script].
</description>
</method>
<method name="has_script_signal" qualifiers="const">

1
doc/classes/ScriptEditor.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="ScriptEditor" inherits="PanelContainer" version="4.0">
<brief_description>
Godot editor's script editor.
</brief_description>
<description>
</description>

10
doc/classes/Signal.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="Signal" version="4.0">
<brief_description>
Class representing a signal defined in an object.
</brief_description>
<description>
</description>
@ -15,6 +16,7 @@
<argument index="1" name="signal_name" type="StringName">
</argument>
<description>
Creates a new signal named [code]signal_name[/code] in the given object.
</description>
</method>
<method name="connect">
@ -27,6 +29,7 @@
<argument index="2" name="flags" type="int" default="0">
</argument>
<description>
Connects this signal to the specified [Callable], optionally providing binds and connection flags.
</description>
</method>
<method name="disconnect">
@ -35,36 +38,42 @@
<argument index="0" name="callable" type="Callable">
</argument>
<description>
Disconnects this signal from the specified [Callable].
</description>
</method>
<method name="emit" qualifiers="vararg">
<return type="void">
</return>
<description>
Emits this signal to all connected objects.
</description>
</method>
<method name="get_connections">
<return type="Array">
</return>
<description>
Returns the list of [Callable]s connected to this signal.
</description>
</method>
<method name="get_name">
<return type="StringName">
</return>
<description>
Returns the name of this signal.
</description>
</method>
<method name="get_object">
<return type="Object">
</return>
<description>
Returns the object emitting this signal.
</description>
</method>
<method name="get_object_id">
<return type="int">
</return>
<description>
Returns the ID of the object emitting this signal (see [method Object.get_instance_id]).
</description>
</method>
<method name="is_connected">
@ -73,6 +82,7 @@
<argument index="0" name="callable" type="Callable">
</argument>
<description>
Returns [code]true[/code] if the specified [Callable] is connected to this signal.
</description>
</method>
<method name="is_null">

3
doc/classes/Sprite.xml
View File

@ -68,10 +68,13 @@
The region of the atlas texture to display. [member region_enabled] must be [code]true[/code].
</member>
<member name="shininess" type="float" setter="set_shininess" getter="get_shininess" default="1.0">
Strength of the specular light effect of this [Sprite].
</member>
<member name="specular_color" type="Color" setter="set_specular_color" getter="get_specular_color" default="Color( 1, 1, 1, 1 )">
The color of the specular light effect.
</member>
<member name="specular_map" type="Texture2D" setter="set_specular_map" getter="get_specular_map">
The specular map is used for more control on the shininess effect.
</member>
<member name="texture" type="Texture2D" setter="set_texture" getter="get_texture">
[Texture2D] object to draw.

3
doc/classes/SpriteBase3D.xml
View File

@ -21,12 +21,14 @@
<argument index="0" name="flag" type="int" enum="SpriteBase3D.DrawFlags">
</argument>
<description>
Returns the value of the specified flag.
</description>
</method>
<method name="get_item_rect" qualifiers="const">
<return type="Rect2">
</return>
<description>
Returns the rectangle representing this sprite.
</description>
</method>
<method name="set_draw_flag">
@ -37,6 +39,7 @@
<argument index="1" name="enabled" type="bool">
</argument>
<description>
If [code]true[/code], the specified flag will be enabled.
</description>
</method>
</methods>

2
doc/classes/StreamPeerSSL.xml
View File

@ -72,11 +72,13 @@
A status representing a [StreamPeerSSL] that is disconnected.
</constant>
<constant name="STATUS_HANDSHAKING" value="1" enum="Status">
A status representing a [StreamPeerSSL] during handshaking.
</constant>
<constant name="STATUS_CONNECTED" value="2" enum="Status">
A status representing a [StreamPeerSSL] that is connected to a host.
</constant>
<constant name="STATUS_ERROR" value="3" enum="Status">
A status representing a [StreamPeerSSL] in error state.
</constant>
<constant name="STATUS_ERROR_HOSTNAME_MISMATCH" value="4" enum="Status">
An error status that shows a mismatch in the SSL certificate domain presented by the host and the domain requested for validation.

1
doc/classes/StreamTexture.xml
View File

@ -15,6 +15,7 @@
<argument index="0" name="path" type="String">
</argument>
<description>
Loads the texture from the given path.
</description>
</method>
</methods>

3
doc/classes/StringName.xml
View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="StringName" version="4.0">
<brief_description>
An optimized string type for unique names.
</brief_description>
<description>
[StringName]s are immutable strings designed for general-purpose represention of unique names. [StringName] ensures that only one instance of a given name exists (so two [StringName]s with the same value are the same object). Comparing them is much faster than with regular [String]s, because only the pointers are compared, not the whole strings.
</description>
<tutorials>
</tutorials>
@ -13,6 +15,7 @@
<argument index="0" name="from" type="String">
</argument>
<description>
Creates a new [StringName] from the given [String].
</description>
</method>
</methods>

16
doc/classes/TabContainer.xml
View File

@ -187,36 +187,52 @@
</constants>
<theme_items>
<theme_item name="decrement" type="Texture2D">
Icon for the left arrow button that appears when there are too many tabs to fit in the container width. When the button is disabled (i.e. the first tab is visible), it appears semi-transparent.
</theme_item>
<theme_item name="decrement_highlight" type="Texture2D">
Icon for the left arrow button that appears when there are too many tabs to fit in the container width. Used when the button is being hovered with the cursor.
</theme_item>
<theme_item name="font" type="Font">
The font used to draw tab names.
</theme_item>
<theme_item name="font_color_bg" type="Color" default="Color( 0.69, 0.69, 0.69, 1 )">
Font color of inactive tabs.
</theme_item>
<theme_item name="font_color_disabled" type="Color" default="Color( 0.9, 0.9, 0.9, 0.2 )">
Font color of disabled tabs.
</theme_item>
<theme_item name="font_color_fg" type="Color" default="Color( 0.94, 0.94, 0.94, 1 )">
Font color of the currently selected tab.
</theme_item>
<theme_item name="hseparation" type="int" default="4">
Horizontal separation between tabs.
</theme_item>
<theme_item name="increment" type="Texture2D">
Icon for the right arrow button that appears when there are too many tabs to fit in the container width. When the button is disabled (i.e. the last tab is visible) it appears semi-transparent.
</theme_item>
<theme_item name="increment_highlight" type="Texture2D">
Icon for the right arrow button that appears when there are too many tabs to fit in the container width. Used when the button is being hovered with the cursor.
</theme_item>
<theme_item name="menu" type="Texture2D">
The icon for the menu button (see [method set_popup]).
</theme_item>
<theme_item name="menu_highlight" type="Texture2D">
The icon for the menu button (see [method set_popup]) when it's being hovered with the cursor.
</theme_item>
<theme_item name="panel" type="StyleBox">
The style for the background fill.
</theme_item>
<theme_item name="side_margin" type="int" default="8">
The space at the left and right edges of the tab bar.
</theme_item>
<theme_item name="tab_bg" type="StyleBox">
The style of inactive tabs.
</theme_item>
<theme_item name="tab_disabled" type="StyleBox">
The style of disabled tabs.
</theme_item>
<theme_item name="tab_fg" type="StyleBox">
The style of the currently selected tab.
</theme_item>
</theme_items>
</class>

15
doc/classes/Tabs.xml
View File

@ -262,36 +262,51 @@
</constants>
<theme_items>
<theme_item name="button" type="StyleBox">
Background of the close button when it's being hovered with the cursor.
</theme_item>
<theme_item name="button_pressed" type="StyleBox">
Background of the close button when it's being pressed.
</theme_item>
<theme_item name="close" type="Texture2D">
The icon for the close button (see [member tab_close_display_policy]).
</theme_item>
<theme_item name="decrement" type="Texture2D">
Icon for the left arrow button that appears when there are too many tabs to fit in the container width. When the button is disabled (i.e. the first tab is visible), it appears semi-transparent.
</theme_item>
<theme_item name="decrement_highlight" type="Texture2D">
Icon for the left arrow button that appears when there are too many tabs to fit in the container width. Used when the button is being hovered with the cursor.
</theme_item>
<theme_item name="font" type="Font">
The font used to draw tab names.
</theme_item>
<theme_item name="font_color_bg" type="Color" default="Color( 0.69, 0.69, 0.69, 1 )">
Font color of inactive tabs.
</theme_item>
<theme_item name="font_color_disabled" type="Color" default="Color( 0.9, 0.9, 0.9, 0.2 )">
Font color of disabled tabs.
</theme_item>
<theme_item name="font_color_fg" type="Color" default="Color( 0.94, 0.94, 0.94, 1 )">
Font color of the currently selected tab.
</theme_item>
<theme_item name="hseparation" type="int" default="4">
The horizontal separation between the tabs.
</theme_item>
<theme_item name="increment" type="Texture2D">
Icon for the right arrow button that appears when there are too many tabs to fit in the container width. When the button is disabled (i.e. the last tab is visible) it appears semi-transparent.
</theme_item>
<theme_item name="increment_highlight" type="Texture2D">
Icon for the right arrow button that appears when there are too many tabs to fit in the container width. Used when the button is being hovered with the cursor.
</theme_item>
<theme_item name="panel" type="StyleBox">
</theme_item>
<theme_item name="tab_bg" type="StyleBox">
The style of an inactive tab.
</theme_item>
<theme_item name="tab_disabled" type="StyleBox">
The style of a disabled tab
</theme_item>
<theme_item name="tab_fg" type="StyleBox">
The style of the currently selected tab.
</theme_item>
</theme_items>
</class>

1
doc/classes/Tree.xml
View File

@ -313,6 +313,7 @@
</signal>
<signal name="item_custom_button_pressed">
<description>
Emitted when a custom button is pressed (i.e. in a [constant TreeItem.CELL_MODE_CUSTOM] mode cell).
</description>
</signal>
<signal name="item_double_clicked">

2
doc/classes/VSeparator.xml
View File

@ -14,8 +14,10 @@
</constants>
<theme_items>
<theme_item name="separation" type="int" default="4">
The width of the area covered by the separator. Effectively works like a minimum width.
</theme_item>
<theme_item name="separator" type="StyleBox">
The style for the separator line. Works best with [StyleBoxLine] (remember to enable [member StyleBoxLine.vertical]).
</theme_item>
</theme_items>
</class>

6
doc/classes/VSlider.xml
View File

@ -18,16 +18,22 @@
</constants>
<theme_items>
<theme_item name="grabber" type="Texture2D">
The texture for the grabber (the draggable element).
</theme_item>
<theme_item name="grabber_area" type="StyleBox">
The background of the area below the grabber.
</theme_item>
<theme_item name="grabber_disabled" type="Texture2D">
The texture for the grabber when it's disabled.
</theme_item>
<theme_item name="grabber_highlight" type="Texture2D">
The texture for the grabber when it's focused.
</theme_item>
<theme_item name="slider" type="StyleBox">
The background for the whole slider. Determines the width of the [code]grabber_area[/code].
</theme_item>
<theme_item name="tick" type="Texture2D">
The texture for the ticks, visible when [member Slider.tick_count] is greater than 0.
</theme_item>
</theme_items>
</class>

3
doc/classes/VSplitContainer.xml
View File

@ -14,12 +14,15 @@
</constants>
<theme_items>
<theme_item name="autohide" type="int" default="1">
Boolean value. If 1 ([code]true[/code]), the grabber will hide automatically when it isn't under the cursor. If 0 ([code]false[/code]), it's always visible.
</theme_item>
<theme_item name="bg" type="StyleBox">
</theme_item>
<theme_item name="grabber" type="Texture2D">
The icon used for the grabber drawn in the middle area.
</theme_item>
<theme_item name="separation" type="int" default="12">
The space between sides of the container.
</theme_item>
</theme_items>
</class>

17
doc/classes/VisualShader.xml
View File

@ -22,6 +22,7 @@
<argument index="3" name="id" type="int">
</argument>
<description>
Adds the specified node to the shader.
</description>
</method>
<method name="can_connect_nodes" qualifiers="const">
@ -38,6 +39,7 @@
<argument index="4" name="to_port" type="int">
</argument>
<description>
Returns [code]true[/code] if the specified nodes and ports can be connected together.
</description>
</method>
<method name="connect_nodes">
@ -54,6 +56,7 @@
<argument index="4" name="to_port" type="int">
</argument>
<description>
Connects the specified nodes and ports.
</description>
</method>
<method name="connect_nodes_forced">
@ -70,6 +73,7 @@
<argument index="4" name="to_port" type="int">
</argument>
<description>
Connects the specified nodes and ports, even if they can't be connected. Such connection is invalid and will not function properly.
</description>
</method>
<method name="disconnect_nodes">
@ -86,6 +90,7 @@
<argument index="4" name="to_port" type="int">
</argument>
<description>
Connects the specified nodes and ports.
</description>
</method>
<method name="get_node" qualifiers="const">
@ -96,6 +101,7 @@
<argument index="1" name="id" type="int">
</argument>
<description>
Returns the shader node instance with specified [code]type[/code] and [code]id[/code].
</description>
</method>
<method name="get_node_connections" qualifiers="const">
@ -104,6 +110,7 @@
<argument index="0" name="type" type="int" enum="VisualShader.Type">
</argument>
<description>
Returns the list of connected nodes with the specified type.
</description>
</method>
<method name="get_node_list" qualifiers="const">
@ -112,6 +119,7 @@
<argument index="0" name="type" type="int" enum="VisualShader.Type">
</argument>
<description>
Returns the list of all nodes in the shader with the specified type.
</description>
</method>
<method name="get_node_position" qualifiers="const">
@ -122,6 +130,7 @@
<argument index="1" name="id" type="int">
</argument>
<description>
Returns the position of the specified node within the shader graph.
</description>
</method>
<method name="get_valid_node_id" qualifiers="const">
@ -146,6 +155,7 @@
<argument index="4" name="to_port" type="int">
</argument>
<description>
Returns [code]true[/code] if the specified node and port connection exist.
</description>
</method>
<method name="remove_node">
@ -156,6 +166,7 @@
<argument index="1" name="id" type="int">
</argument>
<description>
Removes the specified node from the shader.
</description>
</method>
<method name="set_mode">
@ -164,6 +175,7 @@
<argument index="0" name="mode" type="int" enum="Shader.Mode">
</argument>
<description>
Sets the mode of this shader.
</description>
</method>
<method name="set_node_position">
@ -176,22 +188,27 @@
<argument index="2" name="position" type="Vector2">
</argument>
<description>
Sets the position of the specified node.
</description>
</method>
</methods>
<members>
<member name="code" type="String" setter="set_code" getter="get_code" override="true" default="&quot;shader_type spatial;void vertex() {// Output:0}void fragment() {// Output:0}void light() {// Output:0}&quot;" />
<member name="graph_offset" type="Vector2" setter="set_graph_offset" getter="get_graph_offset" default="Vector2( 0, 0 )">
The offset vector of the whole graph.
</member>
<member name="version" type="String" setter="set_version" getter="get_version" default="&quot;&quot;">
</member>
</members>
<constants>
<constant name="TYPE_VERTEX" value="0" enum="Type">
A vertex shader, operating on vertices.
</constant>
<constant name="TYPE_FRAGMENT" value="1" enum="Type">
A fragment shader, operating on fragments (pixels).
</constant>
<constant name="TYPE_LIGHT" value="2" enum="Type">
A shader for light calculations.
</constant>
<constant name="TYPE_MAX" value="3" enum="Type">
Represents the size of the [enum Type] enum.

1
doc/classes/VisualShaderNode.xml
View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="VisualShaderNode" inherits="Resource" version="4.0">
<brief_description>
Base class for nodes in a visual shader graph.
</brief_description>
<description>
</description>

9
doc/classes/WindowDialog.xml
View File

@ -29,22 +29,31 @@
</constants>
<theme_items>
<theme_item name="close" type="Texture2D">
The icon for the close button.
</theme_item>
<theme_item name="close_h_ofs" type="int" default="18">
The horizontal offset of the close button.
</theme_item>
<theme_item name="close_highlight" type="Texture2D">
The icon used for the close button when it's hovered with the mouse cursor.
</theme_item>
<theme_item name="close_v_ofs" type="int" default="18">
The vertical offset of the close button.
</theme_item>
<theme_item name="panel" type="StyleBox">
The style for both the content background of the [WindowDialog] and the title bar.
</theme_item>
<theme_item name="scaleborder_size" type="int" default="4">
The thickness of the border that can be dragged when scaling the window (if [member resizable] is enabled).
</theme_item>
<theme_item name="title_color" type="Color" default="Color( 0, 0, 0, 1 )">
The color of the title text.
</theme_item>
<theme_item name="title_font" type="Font">
The font used to draw the title.
</theme_item>
<theme_item name="title_height" type="int" default="20">
The vertical offset of the title text.
</theme_item>
</theme_items>
</class>