Merge pull request #36773 from KoBeWi/thats_a_lotta_docs

Add LOTS of missing docs

1 files changed, 28 insertions, 1 deletions

diff --git a/doc/classes/Animation.xml b/doc/classes/Animation.xml
index 0926ef9855..09811d5617 100644
--- a/doc/classes/Animation.xml
+++ b/doc/classes/Animation.xml
@@ -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>