2018-07-26 09:56:21 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
2021-04-26 11:14:51 +00:00
<class name= "AnimationTree" inherits= "Node" version= "3.4" >
2018-07-26 09:56:21 +00:00
<brief_description >
2020-03-03 18:21:21 +00:00
A node to be used for advanced animation transitions in an [AnimationPlayer].
2018-07-26 09:56:21 +00:00
</brief_description>
<description >
2020-06-02 04:03:05 +00:00
Note: When linked with an [AnimationPlayer], several properties and methods of the corresponding [AnimationPlayer] will not function as expected. Playback and transitions should be handled using only the [AnimationTree] and its constituent [AnimationNode](s). The [AnimationPlayer] node should be used solely for adding, deleting, and editing animations.
2018-07-26 09:56:21 +00:00
</description>
<tutorials >
2021-07-21 13:10:52 +00:00
<link title= "Using AnimationTree" > https://docs.godotengine.org/en/3.3/tutorials/animation/animation_tree.html</link>
2020-10-01 08:34:47 +00:00
<link title= "Third Person Shooter Demo" > https://godotengine.org/asset-library/asset/678</link>
2019-04-19 09:03:46 +00:00
</tutorials>
2018-07-26 09:56:21 +00:00
<methods >
2018-08-02 07:22:24 +00:00
<method name= "advance" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "delta" type= "float" />
2018-08-02 07:22:24 +00:00
<description >
2020-03-03 18:21:21 +00:00
Manually advance the animations by the specified time (in seconds).
2018-08-02 07:22:24 +00:00
</description>
</method>
2018-07-26 09:56:21 +00:00
<method name= "get_root_motion_transform" qualifiers= "const" >
2021-07-30 13:28:05 +00:00
<return type= "Transform" />
2018-07-26 09:56:21 +00:00
<description >
2021-07-21 13:10:52 +00:00
Retrieve the motion of the [member root_motion_track] as a [Transform] that can be used elsewhere. If [member root_motion_track] is not a path to a track of type [constant Animation.TYPE_TRANSFORM], returns an identity transformation. See also [member root_motion_track] and [RootMotionView].
2018-07-26 09:56:21 +00:00
</description>
</method>
2018-08-20 22:35:30 +00:00
<method name= "rename_parameter" >
2021-07-30 13:28:05 +00:00
<return type= "void" />
<argument index= "0" name= "old_name" type= "String" />
<argument index= "1" name= "new_name" type= "String" />
2018-08-20 22:35:30 +00:00
<description >
</description>
</method>
2018-07-26 09:56:21 +00:00
</methods>
<members >
2019-06-29 10:38:01 +00:00
<member name= "active" type= "bool" setter= "set_active" getter= "is_active" default= "false" >
2020-03-03 18:21:21 +00:00
If [code]true[/code], the [AnimationTree] will be processing.
2018-07-26 09:56:21 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "anim_player" type= "NodePath" setter= "set_animation_player" getter= "get_animation_player" default= "NodePath("")" >
2020-03-03 18:21:21 +00:00
The path to the [AnimationPlayer] used for animating.
2018-07-26 09:56:21 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "process_mode" type= "int" setter= "set_process_mode" getter= "get_process_mode" enum= "AnimationTree.AnimationProcessMode" default= "1" >
2020-03-03 18:21:21 +00:00
The process mode of this [AnimationTree]. See [enum AnimationProcessMode] for available modes.
2018-07-26 09:56:21 +00:00
</member>
2019-06-29 10:38:01 +00:00
<member name= "root_motion_track" type= "NodePath" setter= "set_root_motion_track" getter= "get_root_motion_track" default= "NodePath("")" >
2020-06-02 04:03:05 +00:00
The path to the Animation track used for root motion. Paths must be valid scene-tree paths to a node, and must be specified starting from the parent node of the node that will reproduce the animation. To specify a track that controls properties or bones, append its name after the path, separated by [code]":"[/code]. For example, [code]"character/skeleton:ankle"[/code] or [code]"character/mesh:transform/local"[/code].
2021-07-21 13:10:52 +00:00
If the track has type [constant Animation.TYPE_TRANSFORM], the transformation will be cancelled visually, and the animation will appear to stay in place. See also [method get_root_motion_transform] and [RootMotionView].
2018-07-26 09:56:21 +00:00
</member>
2019-07-15 18:42:47 +00:00
<member name= "tree_root" type= "AnimationNode" setter= "set_tree_root" getter= "get_tree_root" >
2020-03-03 18:21:21 +00:00
The root animation node of this [AnimationTree]. See [AnimationNode].
2018-07-26 09:56:21 +00:00
</member>
</members>
<constants >
<constant name= "ANIMATION_PROCESS_PHYSICS" value= "0" enum= "AnimationProcessMode" >
2020-03-03 18:21:21 +00:00
The animations will progress during the physics frame (i.e. [method Node._physics_process]).
2018-07-26 09:56:21 +00:00
</constant>
<constant name= "ANIMATION_PROCESS_IDLE" value= "1" enum= "AnimationProcessMode" >
2020-03-03 18:21:21 +00:00
The animations will progress during the idle frame (i.e. [method Node._process]).
2018-07-26 09:56:21 +00:00
</constant>
2018-08-02 07:22:24 +00:00
<constant name= "ANIMATION_PROCESS_MANUAL" value= "2" enum= "AnimationProcessMode" >
2020-03-03 18:21:21 +00:00
The animations will only progress manually (see [method advance]).
2018-08-02 07:22:24 +00:00
</constant>
2018-07-26 09:56:21 +00:00
</constants>
</class>