2022-04-07 19:49:28 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-07-06 16:08:05 +08:00
<class name= "AnimationLibrary" inherits= "Resource" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2022-04-07 19:49:28 +08:00
<brief_description >
2022-07-14 02:16:38 +08:00
Container for [Animation] resources.
2022-04-07 19:49:28 +08:00
</brief_description>
<description >
2022-07-14 02:16:38 +08:00
An animation library stores a set of animations accessible through [StringName] keys, for use with [AnimationPlayer] nodes.
2022-04-07 19:49:28 +08:00
</description>
<tutorials >
2022-07-14 02:16:38 +08:00
<link title= "Animation tutorial index" > $DOCS_URL/tutorials/animation/index.html</link>
2022-04-07 19:49:28 +08:00
</tutorials>
<methods >
<method name= "add_animation" >
<return type= "int" enum= "Error" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "StringName" />
<param index= "1" name= "animation" type= "Animation" />
2022-04-07 19:49:28 +08:00
<description >
2022-09-30 20:23:36 +08:00
Adds the [param animation] to the library, accessible by the key [param name].
2022-04-07 19:49:28 +08:00
</description>
</method>
<method name= "get_animation" qualifiers= "const" >
<return type= "Animation" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "StringName" />
2022-04-07 19:49:28 +08:00
<description >
2022-08-29 14:18:01 +08:00
Returns the [Animation] with the key [param name]. If the animation does not exist, [code]null[/code] is returned and an error is logged.
2022-04-07 19:49:28 +08:00
</description>
</method>
<method name= "get_animation_list" qualifiers= "const" >
<return type= "StringName[]" />
<description >
2022-07-14 02:16:38 +08:00
Returns the keys for the [Animation]s stored in the library.
2022-04-07 19:49:28 +08:00
</description>
</method>
<method name= "has_animation" qualifiers= "const" >
<return type= "bool" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "StringName" />
2022-04-07 19:49:28 +08:00
<description >
2022-07-14 02:16:38 +08:00
Returns [code]true[/code] if the library stores an [Animation] with [param name] as the key.
2022-04-07 19:49:28 +08:00
</description>
</method>
<method name= "remove_animation" >
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "StringName" />
2022-04-07 19:49:28 +08:00
<description >
2022-07-14 02:16:38 +08:00
Removes the [Animation] with the key [param name].
2022-04-07 19:49:28 +08:00
</description>
</method>
<method name= "rename_animation" >
<return type= "void" />
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "StringName" />
<param index= "1" name= "newname" type= "StringName" />
2022-04-07 19:49:28 +08:00
<description >
2022-07-14 02:16:38 +08:00
Changes the key of the [Animation] associated with the key [param name] to [param newname].
2022-04-07 19:49:28 +08:00
</description>
</method>
</methods>
<signals >
<signal name= "animation_added" >
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "StringName" />
2022-04-07 19:49:28 +08:00
<description >
2022-07-14 02:16:38 +08:00
Emitted when an [Animation] is added, under the key [param name].
2022-04-07 19:49:28 +08:00
</description>
</signal>
2022-06-12 09:14:40 +08:00
<signal name= "animation_changed" >
<param index= "0" name= "name" type= "StringName" />
<description >
Emitted when there's a change in one of the animations, e.g. tracks are added, moved or have changed paths. [param name] is the key of the animation that was changed.
See also [signal Resource.changed], which this acts as a relay for.
</description>
</signal>
2022-04-07 19:49:28 +08:00
<signal name= "animation_removed" >
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "StringName" />
2022-04-07 19:49:28 +08:00
<description >
2022-07-14 02:16:38 +08:00
Emitted when an [Animation] stored with the key [param name] is removed.
2022-04-07 19:49:28 +08:00
</description>
</signal>
<signal name= "animation_renamed" >
2022-08-07 02:11:48 +08:00
<param index= "0" name= "name" type= "StringName" />
<param index= "1" name= "to_name" type= "StringName" />
2022-04-07 19:49:28 +08:00
<description >
2022-07-14 02:16:38 +08:00
Emitted when the key for an [Animation] is changed, from [param name] to [param to_name].
2022-04-07 19:49:28 +08:00
</description>
</signal>
</signals>
</class>