diff options
Diffstat (limited to 'doc/classes/AnimationNode.xml')
| -rw-r--r-- | doc/classes/AnimationNode.xml | 211 |
1 files changed, 81 insertions, 130 deletions
diff --git a/doc/classes/AnimationNode.xml b/doc/classes/AnimationNode.xml index 8204b456d9..173ff43d2a 100644 --- a/doc/classes/AnimationNode.xml +++ b/doc/classes/AnimationNode.xml @@ -11,192 +11,143 @@ <link title="AnimationTree">https://docs.godotengine.org/en/latest/tutorials/animation/animation_tree.html</link> </tutorials> <methods> - <method name="add_input"> - <return type="void"> - </return> - <argument index="0" name="name" type="String"> - </argument> + <method name="_get_caption" qualifiers="virtual const"> + <return type="String" /> <description> - Adds an input to the node. This is only useful for nodes created for use in an [AnimationNodeBlendTree]. + Gets the text caption for this node (used by some editors). </description> </method> - <method name="blend_animation"> - <return type="void"> - </return> - <argument index="0" name="animation" type="StringName"> - </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> + <method name="_get_child_by_name" qualifiers="virtual const"> + <return type="AnimationNode" /> + <argument index="0" name="name" type="StringName" /> <description> - 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. + Gets a child node by index (used by editors inheriting from [AnimationRootNode]). </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> + <method name="_get_child_nodes" qualifiers="virtual const"> + <return type="Dictionary" /> <description> - 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). + Gets all children nodes in order as a [code]name: node[/code] dictionary. Only useful when inheriting [AnimationRootNode]. </description> </method> - <method name="blend_node"> - <return type="float"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> - <argument index="1" name="node" type="AnimationNode"> - </argument> - <argument index="2" name="time" type="float"> - </argument> - <argument index="3" name="seek" type="bool"> - </argument> - <argument index="4" name="blend" type="float"> - </argument> - <argument index="5" name="filter" type="int" enum="AnimationNode.FilterAction" default="0"> - </argument> - <argument index="6" name="optimize" type="bool" default="true"> - </argument> + <method name="_get_parameter_default_value" qualifiers="virtual const"> + <return type="Variant" /> + <argument index="0" name="parameter" type="StringName" /> <description> - 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. + 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. </description> </method> - <method name="get_caption" qualifiers="virtual"> - <return type="String"> - </return> + <method name="_get_parameter_list" qualifiers="virtual const"> + <return type="Array" /> <description> - Gets the text caption for this node (used by some editors). + 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]. </description> </method> - <method name="get_child_by_name" qualifiers="virtual"> - <return type="Object"> - </return> - <argument index="0" name="name" type="String"> - </argument> + <method name="_has_filter" qualifiers="virtual const"> + <return type="bool" /> <description> - Gets a child node by index (used by editors inheriting from [AnimationRootNode]). + Returns [code]true[/code] whether you want the blend tree editor to display filter editing on this node. </description> </method> - <method name="get_child_nodes" qualifiers="virtual"> - <return type="Dictionary"> - </return> + <method name="_process" qualifiers="virtual const"> + <return type="float" /> + <argument index="0" name="time" type="float" /> + <argument index="1" name="seek" type="bool" /> <description> - Gets all children nodes in order as a [code]name: node[/code] dictionary. Only useful when inheriting [AnimationRootNode]. + 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). </description> </method> - <method name="get_input_count" qualifiers="const"> - <return type="int"> - </return> + <method name="add_input"> + <return type="void" /> + <argument index="0" name="name" type="String" /> <description> - Amount of inputs in this node, only useful for nodes that go into [AnimationNodeBlendTree]. + Adds an input to the node. This is only useful for nodes created for use in an [AnimationNodeBlendTree]. </description> </method> - <method name="get_input_name"> - <return type="String"> - </return> - <argument index="0" name="input" type="int"> - </argument> + <method name="blend_animation"> + <return type="void" /> + <argument index="0" name="animation" type="StringName" /> + <argument index="1" name="time" type="float" /> + <argument index="2" name="delta" type="float" /> + <argument index="3" name="seeked" type="bool" /> + <argument index="4" name="blend" type="float" /> <description> - Gets the name of an input by index. + 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. </description> </method> - <method name="get_parameter" qualifiers="const"> - <return type="Variant"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> + <method name="blend_input"> + <return type="float" /> + <argument index="0" name="input_index" type="int" /> + <argument index="1" name="time" type="float" /> + <argument index="2" name="seek" type="bool" /> + <argument index="3" name="blend" type="float" /> + <argument index="4" name="filter" type="int" enum="AnimationNode.FilterAction" default="0" /> + <argument index="5" name="optimize" type="bool" default="true" /> <description> - Gets the value of a parameter. Parameters are custom local memory used for your nodes, given a resource can be reused in multiple trees. + 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). </description> </method> - <method name="get_parameter_default_value" qualifiers="virtual"> - <return type="Variant"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> + <method name="blend_node"> + <return type="float" /> + <argument index="0" name="name" type="StringName" /> + <argument index="1" name="node" type="AnimationNode" /> + <argument index="2" name="time" type="float" /> + <argument index="3" name="seek" type="bool" /> + <argument index="4" name="blend" type="float" /> + <argument index="5" name="filter" type="int" enum="AnimationNode.FilterAction" default="0" /> + <argument index="6" name="optimize" type="bool" default="true" /> <description> - 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. + 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. </description> </method> - <method name="get_parameter_list" qualifiers="virtual"> - <return type="Array"> - </return> + <method name="get_input_count" qualifiers="const"> + <return type="int" /> <description> - 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]. + Amount of inputs in this node, only useful for nodes that go into [AnimationNodeBlendTree]. </description> </method> - <method name="has_filter" qualifiers="virtual"> - <return type="bool"> - </return> + <method name="get_input_name"> + <return type="String" /> + <argument index="0" name="input" type="int" /> <description> - Returns [code]true[/code] whether you want the blend tree editor to display filter editing on this node. + Gets the name of an input by index. </description> </method> - <method name="is_path_filtered" qualifiers="const"> - <return type="bool"> - </return> - <argument index="0" name="path" type="NodePath"> - </argument> + <method name="get_parameter" qualifiers="const"> + <return type="Variant" /> + <argument index="0" name="name" type="StringName" /> <description> - Returns [code]true[/code] whether a given path is filtered. + Gets the value of a parameter. Parameters are custom local memory used for your nodes, given a resource can be reused in multiple trees. </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> + <method name="is_path_filtered" qualifiers="const"> + <return type="bool" /> + <argument index="0" name="path" type="NodePath" /> <description> - 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). + Returns [code]true[/code] whether a given path is filtered. </description> </method> <method name="remove_input"> - <return type="void"> - </return> - <argument index="0" name="index" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="index" type="int" /> <description> Removes an input, call this only when inactive. </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> + <return type="void" /> + <argument index="0" name="path" type="NodePath" /> + <argument index="1" name="enable" type="bool" /> <description> Adds or removes a path for the filter. </description> </method> <method name="set_parameter"> - <return type="void"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> - <argument index="1" name="value" type="Variant"> - </argument> + <return type="void" /> + <argument index="0" name="name" type="StringName" /> + <argument index="1" name="value" type="Variant" /> <description> Sets a custom parameter. These are used as local storage, because resources can be reused across the tree or scenes. </description> |