Merge pull request #37026 from akien-mga/3.2-cherrypicks

Add LOTS of missing docs
This commit is contained in:
Rémi Verschelde 2020-03-13 17:57:43 +01:00 committed by GitHub
commit 809dc1a12a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
47 changed files with 262 additions and 2 deletions

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] or [AnimationTreePlayer] to be played back.
Animations are just data containers, and must be added to nodes such as an [AnimationPlayer] or [AnimationTreePlayer] 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="String">
</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="String">
</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>

View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeBlendTree" inherits="AnimationRootNode" version="3.2">
<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="String">
</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="String">
</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="String">
</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="String">
</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="String">
</argument>
<description>
Removes a sub-node.
</description>
</method>
<method name="rename_node">
@ -82,6 +91,7 @@
<argument index="1" name="new_name" type="String">
</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>

View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeOneShot" inherits="AnimationNode" version="3.2">
<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>

View File

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

View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeTimeScale" inherits="AnimationNode" version="3.2">
<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>

View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeTimeSeek" inherits="AnimationNode" version="3.2">
<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>

View File

@ -1,8 +1,10 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationNodeTransition" inherits="AnimationNode" version="3.2">
<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>

View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AnimationTree" inherits="Node" version="3.2">
<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>

View File

@ -1,22 +1,26 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="AudioEffectRecord" inherits="AudioEffect" version="3.2">
<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>

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="PoolVector2Array" setter="set_polygon" getter="get_polygon" default="PoolVector2Array( )">
The polygon's list of vertices. The final point will be connected to the first. The returned value is a clone of the [PoolVector2Array], not a reference.

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.

View File

@ -88,26 +88,34 @@
</constants>
<theme_items>
<theme_item name="add_preset" type="Texture">
The icon for the "Add Preset" button.
</theme_item>
<theme_item name="color_hue" type="Texture">
Custom texture for the hue selection slider on the right.
</theme_item>
<theme_item name="color_sample" type="Texture">
</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="Texture">
The indicator used to signalize that the color value is outside the 0-1 range.
</theme_item>
<theme_item name="preset_bg" type="Texture">
</theme_item>
<theme_item name="screen_picker" type="Texture">
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>

View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="EditorExportPlugin" inherits="Reference" version="3.2">
<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">

View File

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

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>

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="Texture">
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="Texture">
Custom icon for the parent folder arrow.
</theme_item>
<theme_item name="reload" type="Texture">
Custom icon for the reload button.
</theme_item>
<theme_item name="toggle_hidden" type="Texture">
Custom icon for the toggle hidden button.
</theme_item>
</theme_items>
</class>

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">

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="Texture">
The icon for the zoom out button.
</theme_item>
<theme_item name="more" type="Texture">
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="Texture">
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="Texture">
The icon for the snap toggle button.
</theme_item>
</theme_items>
</class>

View File

@ -252,42 +252,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="Texture">
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="Texture">
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="Texture">
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>

View File

@ -21,8 +21,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>

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>

View File

@ -14,16 +14,22 @@
</constants>
<theme_items>
<theme_item name="grabber" type="Texture">
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="Texture">
The texture for the grabber when it's disabled.
</theme_item>
<theme_item name="grabber_highlight" type="Texture">
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="Texture">
The texture for the ticks, visible when [member Slider.tick_count] is greater than 0.
</theme_item>
</theme_items>
</class>

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="Texture">
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>

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>

View File

@ -1,6 +1,7 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="InputEventGesture" inherits="InputEventWithModifiers" version="3.2">
<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>

View File

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

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>

View File

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

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>

View File

@ -18,12 +18,14 @@
<argument index="1" name="weights" type="PoolRealArray">
</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">
@ -32,12 +34,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">
@ -46,6 +50,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">
@ -54,6 +59,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">
@ -64,6 +70,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">
@ -74,6 +81,7 @@
<argument index="1" name="weights" type="PoolRealArray">
</argument>
<description>
Sets the weight values for the specified bone.
</description>
</method>
</methods>

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>

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>

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>

View File

@ -38,30 +38,35 @@
<argument index="0" name="property" type="String">
</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">

View File

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

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>

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.

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>

View File

@ -187,40 +187,56 @@
</constants>
<theme_items>
<theme_item name="decrement" type="Texture">
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="Texture">
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="Texture">
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="Texture">
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="label_valign_bg" type="int" default="2">
</theme_item>
<theme_item name="label_valign_fg" type="int" default="0">
</theme_item>
<theme_item name="menu" type="Texture">
The icon for the menu button (see [method set_popup]).
</theme_item>
<theme_item name="menu_highlight" type="Texture">
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_item name="top_margin" type="int" default="24">
</theme_item>

View File

@ -262,28 +262,40 @@
</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="Texture">
The icon for the close button (see [member tab_close_display_policy]).
</theme_item>
<theme_item name="decrement" type="Texture">
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="Texture">
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="Texture">
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="Texture">
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="label_valign_bg" type="int" default="2">
</theme_item>
@ -292,10 +304,13 @@
<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_item name="top_margin" type="int" default="24">
</theme_item>

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">

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>

View File

@ -18,16 +18,22 @@
</constants>
<theme_items>
<theme_item name="grabber" type="Texture">
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="Texture">
The texture for the grabber when it's disabled.
</theme_item>
<theme_item name="grabber_highlight" type="Texture">
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="Texture">
The texture for the ticks, visible when [member Slider.tick_count] is greater than 0.
</theme_item>
</theme_items>
</class>

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="Texture">
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>

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,20 +188,25 @@
<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>
</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.

View File

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

View File

@ -29,22 +29,31 @@
</constants>
<theme_items>
<theme_item name="close" type="Texture">
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="Texture">
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>