2022-03-15 13:29:32 +01:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-10-12 01:59:32 +02:00
<class name= "AnimationNodeBlendTree" inherits= "AnimationRootNode" version= "4.2" >
2022-03-15 13:29:32 +01:00
<brief_description >
[AnimationTree] node resource that contains many blend type nodes.
</brief_description>
<description >
2022-03-21 11:02:40 +01:00
This node may contain a sub-tree of any other blend type nodes, such as [AnimationNodeTransition], [AnimationNodeBlend2], [AnimationNodeBlend3], [AnimationNodeOneShot], etc. This is one of the most commonly used roots.
An [AnimationNodeOutput] node named [code]output[/code] is created by default.
2022-03-15 13:29:32 +01:00
</description>
<tutorials >
2023-08-29 22:33:15 +02:00
<link > $DOCS_URL/tutorials/animation/animation_tree.md</link>
2022-03-15 13:29:32 +01:00
</tutorials>
<methods >
<method name= "add_node" >
<return type= "void" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "name" type= "StringName" />
2022-03-15 13:29:32 +01:00
<argument index= "1" name= "node" type= "AnimationNode" />
<argument index= "2" name= "position" type= "Vector2" default= "Vector2( 0, 0 )" />
<description >
2023-12-21 00:48:25 +01:00
Adds an [AnimationNode] at the given [code]position[/code]. The [code]name[/code] is used to identify the created sub-node later.
2022-03-15 13:29:32 +01:00
</description>
</method>
<method name= "connect_node" >
<return type= "void" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "input_node" type= "StringName" />
2022-03-15 13:29:32 +01:00
<argument index= "1" name= "input_index" type= "int" />
2022-03-24 01:22:45 +01:00
<argument index= "2" name= "output_node" type= "StringName" />
2022-03-15 13:29:32 +01:00
<description >
2023-12-21 00:48:25 +01:00
Connects the output of an [AnimationNode] as input for another [AnimationNode], at the input port specified by [code]input_index[/code].
2022-03-15 13:29:32 +01:00
</description>
</method>
<method name= "disconnect_node" >
<return type= "void" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "input_node" type= "StringName" />
2022-03-15 13:29:32 +01:00
<argument index= "1" name= "input_index" type= "int" />
<description >
2023-12-21 00:48:25 +01:00
Disconnects the node connected to the specified input.
2022-03-15 13:29:32 +01:00
</description>
</method>
<method name= "get_node" qualifiers= "const" >
<return type= "AnimationNode" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "name" type= "StringName" />
2022-03-15 13:29:32 +01:00
<description >
2023-12-21 00:48:25 +01:00
Returns the sub-node with the specified [code]name[/code].
2022-03-15 13:29:32 +01:00
</description>
</method>
<method name= "get_node_position" qualifiers= "const" >
<return type= "Vector2" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "name" type= "StringName" />
2022-03-15 13:29:32 +01:00
<description >
2023-12-21 00:48:25 +01:00
Returns the position of the sub-node with the specified [code]name[/code].
2022-03-15 13:29:32 +01:00
</description>
</method>
<method name= "has_node" qualifiers= "const" >
<return type= "bool" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "name" type= "StringName" />
2022-03-15 13:29:32 +01:00
<description >
2023-12-21 00:48:25 +01:00
Returns [code]true[/code] if a sub-node with specified [code]name[/code] exists.
2022-03-15 13:29:32 +01:00
</description>
</method>
<method name= "remove_node" >
<return type= "void" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "name" type= "StringName" />
2022-03-15 13:29:32 +01:00
<description >
2023-12-21 00:48:25 +01:00
Removes a sub-node.
2022-03-15 13:29:32 +01:00
</description>
</method>
<method name= "rename_node" >
<return type= "void" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "name" type= "StringName" />
<argument index= "1" name= "new_name" type= "StringName" />
2022-03-15 13:29:32 +01:00
<description >
2023-12-21 00:48:25 +01:00
Changes the name of a sub-node.
2022-03-15 13:29:32 +01:00
</description>
</method>
<method name= "set_node_position" >
<return type= "void" />
2022-03-24 01:22:45 +01:00
<argument index= "0" name= "name" type= "StringName" />
2022-03-15 13:29:32 +01:00
<argument index= "1" name= "position" type= "Vector2" />
<description >
2023-12-21 00:48:25 +01:00
Modifies the position of a sub-node.
2022-03-15 13:29:32 +01:00
</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>