2018-07-26 11:56:21 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2021-03-23 13:40:34 +01:00
<class name= "AnimationNode" inherits= "Resource" version= "3.3" >
2018-07-26 11:56:21 +02:00
<brief_description >
2018-11-26 11:21:06 +01:00
Base resource for [AnimationTree] nodes.
2018-07-26 11:56:21 +02:00
</brief_description>
<description >
2019-06-22 01:04:47 +02:00
Base resource for [AnimationTree] nodes. In general, it's not used directly, but you can create custom ones with custom blending formulas.
2018-11-25 20:56:49 +01:00
Inherit this when creating nodes mainly for use in [AnimationNodeBlendTree], otherwise [AnimationRootNode] should be used instead.
2018-07-26 11:56:21 +02:00
</description>
<tutorials >
2021-03-26 10:43:43 +01:00
<link > https://docs.godotengine.org/en/3.3/tutorials/animation/animation_tree.html</link>
2018-07-26 11:56:21 +02:00
</tutorials>
<methods >
<method name= "add_input" >
<return type= "void" >
</return>
<argument index= "0" name= "name" type= "String" >
</argument>
<description >
2020-01-23 11:14:14 +01:00
Adds an input to the node. This is only useful for nodes created for use in an [AnimationNodeBlendTree].
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "blend_animation" >
<return type= "void" >
</return>
<argument index= "0" name= "animation" type= "String" >
</argument>
<argument index= "1" name= "time" type= "float" >
</argument>
<argument index= "2" name= "delta" type= "float" >
</argument>
<argument index= "3" name= "seeked" type= "bool" >
</argument>
<argument index= "4" name= "blend" type= "float" >
</argument>
<description >
2020-01-23 11:14:14 +01:00
Blend an animation by [code]blend[/code] amount (name must be valid in the linked [AnimationPlayer]). A [code]time[/code] and [code]delta[/code] may be passed, as well as whether [code]seek[/code] happened.
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "blend_input" >
<return type= "float" >
</return>
<argument index= "0" name= "input_index" type= "int" >
</argument>
<argument index= "1" name= "time" type= "float" >
</argument>
<argument index= "2" name= "seek" type= "bool" >
</argument>
<argument index= "3" name= "blend" type= "float" >
</argument>
<argument index= "4" name= "filter" type= "int" enum= "AnimationNode.FilterAction" default= "0" >
</argument>
<argument index= "5" name= "optimize" type= "bool" default= "true" >
</argument>
<description >
2020-01-23 11:14:14 +01:00
Blend an input. This is only useful for nodes created for an [AnimationNodeBlendTree]. The [code]time[/code] parameter is a relative delta, unless [code]seek[/code] is [code]true[/code], in which case it is absolute. A filter mode may be optionally passed (see [enum FilterAction] for options).
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "blend_node" >
<return type= "float" >
</return>
2018-08-21 00:35:30 +02:00
<argument index= "0" name= "name" type= "String" >
2018-07-26 11:56:21 +02:00
</argument>
2018-08-21 00:35:30 +02:00
<argument index= "1" name= "node" type= "AnimationNode" >
2018-07-26 11:56:21 +02:00
</argument>
2018-08-21 00:35:30 +02:00
<argument index= "2" name= "time" type= "float" >
2018-07-26 11:56:21 +02:00
</argument>
2018-08-21 00:35:30 +02:00
<argument index= "3" name= "seek" type= "bool" >
2018-07-26 11:56:21 +02:00
</argument>
2018-08-21 00:35:30 +02:00
<argument index= "4" name= "blend" type= "float" >
2018-07-26 11:56:21 +02:00
</argument>
2018-08-21 00:35:30 +02:00
<argument index= "5" name= "filter" type= "int" enum= "AnimationNode.FilterAction" default= "0" >
2018-07-26 11:56:21 +02:00
</argument>
2018-08-21 00:35:30 +02:00
<argument index= "6" name= "optimize" type= "bool" default= "true" >
2018-07-26 11:56:21 +02:00
</argument>
<description >
Fix misc. source comment typos
Found using `codespell -q 3 -S ./thirdparty,*.po -L ang,ba,cas,dof,doubleclick,fave,hist,leapyear,lod,nd,numer,ois,paket,seeked,sinc,switchs,te,uint -D ~/Projects/codespell/codespell_lib/data/dictionary.txt `
2019-09-19 20:36:39 +02:00
Blend another animation node (in case this node contains children animation nodes). This function is only useful if you inherit from [AnimationRootNode] instead, else editors will not display your node for addition.
2018-07-26 11:56:21 +02:00
</description>
</method>
2018-08-21 00:35:30 +02:00
<method name= "get_caption" qualifiers= "virtual" >
2018-07-26 11:56:21 +02:00
<return type= "String" >
</return>
<description >
2019-06-22 01:04:47 +02:00
Gets the text caption for this node (used by some editors).
2018-11-25 20:56:49 +01:00
</description>
</method>
<method name= "get_child_by_name" qualifiers= "virtual" >
<return type= "Object" >
</return>
<argument index= "0" name= "name" type= "String" >
</argument>
<description >
2019-06-22 01:04:47 +02:00
Gets a child node by index (used by editors inheriting from [AnimationRootNode]).
2018-11-25 20:56:49 +01:00
</description>
</method>
<method name= "get_child_nodes" qualifiers= "virtual" >
<return type= "Dictionary" >
</return>
<description >
2019-06-22 01:04:47 +02:00
Gets all children nodes in order as a [code]name: node[/code] dictionary. Only useful when inheriting [AnimationRootNode].
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "get_input_count" qualifiers= "const" >
<return type= "int" >
</return>
<description >
2019-01-07 10:02:04 +01:00
Amount of inputs in this node, only useful for nodes that go into [AnimationNodeBlendTree].
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "get_input_name" >
<return type= "String" >
</return>
<argument index= "0" name= "input" type= "int" >
</argument>
<description >
2019-06-22 01:04:47 +02:00
Gets the name of an input by index.
2018-07-26 11:56:21 +02:00
</description>
</method>
2018-08-21 00:35:30 +02:00
<method name= "get_parameter" qualifiers= "const" >
<return type= "Variant" >
2018-07-26 11:56:21 +02:00
</return>
2018-08-21 00:35:30 +02:00
<argument index= "0" name= "name" type= "String" >
</argument>
2018-07-26 11:56:21 +02:00
<description >
2019-06-22 01:04:47 +02:00
Gets the value of a parameter. Parameters are custom local memory used for your nodes, given a resource can be reused in multiple trees.
2018-11-25 20:56:49 +01:00
</description>
</method>
<method name= "get_parameter_default_value" qualifiers= "virtual" >
<return type= "Variant" >
</return>
<argument index= "0" name= "name" type= "String" >
</argument>
<description >
2019-06-22 01:04:47 +02:00
Gets the default value of a parameter. Parameters are custom local memory used for your nodes, given a resource can be reused in multiple trees.
2018-11-25 20:56:49 +01:00
</description>
</method>
<method name= "get_parameter_list" qualifiers= "virtual" >
<return type= "Array" >
</return>
<description >
2019-06-22 01:04:47 +02:00
Gets the property information for parameter. Parameters are custom local memory used for your nodes, given a resource can be reused in multiple trees. Format is similar to [method Object.get_property_list].
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "has_filter" qualifiers= "virtual" >
<return type= "String" >
</return>
<description >
2019-05-24 04:15:43 +02:00
Returns [code]true[/code] whether you want the blend tree editor to display filter editing on this node.
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "is_path_filtered" qualifiers= "const" >
<return type= "bool" >
</return>
<argument index= "0" name= "path" type= "NodePath" >
</argument>
<description >
2019-05-24 04:15:43 +02:00
Returns [code]true[/code] whether a given path is filtered.
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "process" qualifiers= "virtual" >
<return type= "void" >
</return>
<argument index= "0" name= "time" type= "float" >
</argument>
<argument index= "1" name= "seek" type= "bool" >
</argument>
<description >
2020-01-23 11:14:14 +01:00
User-defined callback called when a custom node is processed. The [code]time[/code] parameter is a relative delta, unless [code]seek[/code] is [code]true[/code], in which case it is absolute.
Here, call the [method blend_input], [method blend_node] or [method blend_animation] functions. You can also use [method get_parameter] and [method set_parameter] to modify local memory.
This function should return the time left for the current animation to finish (if unsure, pass the value from the main blend being called).
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "remove_input" >
<return type= "void" >
</return>
<argument index= "0" name= "index" type= "int" >
</argument>
<description >
2019-06-22 01:04:47 +02:00
Removes an input, call this only when inactive.
2018-07-26 11:56:21 +02:00
</description>
</method>
<method name= "set_filter_path" >
<return type= "void" >
</return>
<argument index= "0" name= "path" type= "NodePath" >
</argument>
<argument index= "1" name= "enable" type= "bool" >
</argument>
<description >
2019-06-22 01:04:47 +02:00
Adds or removes a path for the filter.
2018-07-26 11:56:21 +02:00
</description>
</method>
2018-08-21 00:35:30 +02:00
<method name= "set_parameter" >
2018-07-26 11:56:21 +02:00
<return type= "void" >
</return>
2018-08-21 00:35:30 +02:00
<argument index= "0" name= "name" type= "String" >
2018-07-26 11:56:21 +02:00
</argument>
2018-08-21 00:35:30 +02:00
<argument index= "1" name= "value" type= "Variant" >
2018-07-26 11:56:21 +02:00
</argument>
<description >
2019-06-22 01:04:47 +02:00
Sets a custom parameter. These are used as local storage, because resources can be reused across the tree or scenes.
2018-07-26 11:56:21 +02:00
</description>
</method>
</methods>
<members >
<member name= "filter_enabled" type= "bool" setter= "set_filter_enabled" getter= "is_filter_enabled" >
2020-01-02 02:08:19 +01:00
If [code]true[/code], filtering is enabled.
2018-07-26 11:56:21 +02:00
</member>
</members>
<signals >
<signal name= "removed_from_graph" >
<description >
2018-11-26 11:21:06 +01:00
Called when the node was removed from the graph.
2018-07-26 11:56:21 +02:00
</description>
</signal>
2018-08-21 00:35:30 +02:00
<signal name= "tree_changed" >
<description >
2019-06-04 02:01:24 +02:00
Emitted by nodes that inherit from this class and that have an internal tree when one of their nodes changes. The nodes that emit this signal are [AnimationNodeBlendSpace1D], [AnimationNodeBlendSpace2D], [AnimationNodeStateMachine], and [AnimationNodeBlendTree].
2018-08-21 00:35:30 +02:00
</description>
</signal>
2018-07-26 11:56:21 +02:00
</signals>
<constants >
<constant name= "FILTER_IGNORE" value= "0" enum= "FilterAction" >
2018-11-26 11:21:06 +01:00
Do not use filtering.
2018-07-26 11:56:21 +02:00
</constant>
<constant name= "FILTER_PASS" value= "1" enum= "FilterAction" >
2018-11-26 11:21:06 +01:00
Paths matching the filter will be allowed to pass.
2018-07-26 11:56:21 +02:00
</constant>
<constant name= "FILTER_STOP" value= "2" enum= "FilterAction" >
2018-11-26 11:21:06 +01:00
Paths matching the filter will be discarded.
2018-07-26 11:56:21 +02:00
</constant>
<constant name= "FILTER_BLEND" value= "3" enum= "FilterAction" >
2018-11-26 11:21:06 +01:00
Paths matching the filter will be blended (by the blend value).
2018-07-26 11:56:21 +02:00
</constant>
</constants>
</class>