godotengine
/
godot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
godot/doc/classes/Animation.xml

453 lines
15 KiB
XML
Raw Normal View History

Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
doc: Update version string in XML
2018-01-13 10:43:06 +00:00
<class name="Animation" inherits="Resource" category="Core" version="3.0-rc1">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
<brief_description>
Contains data used to animate everything in the engine.
</brief_description>
<description>
An Animation resource contains data used to animate everything in the engine. Animations are divided into tracks, and each track must be linked to a node. The state of that node can be changed through time, by adding timed keys (events) to the track.
Animations are just data containers, and must be added to odes such as an [AnimationPlayer] or [AnimationTreePlayer] to be played back.
</description>
<tutorials>
doc: Replace some more "val" with "value" + sync
2018-01-17 09:43:23 +00:00
http://docs.godotengine.org/en/3.0/learning/features/animation/index.html
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
</tutorials>
<demos>
</demos>
<methods>
<method name="add_track">
<return type="int">
</return>
<argument index="0" name="type" type="int" enum="Animation.TrackType">
</argument>
Rename pos to position in user facing methods and variables Rename user facing methods and variables as well as the corresponding C++ methods according to the folloming changes: * pos -> position * rot -> rotation * loc -> location C++ variables are left as is.
2017-09-10 13:37:49 +00:00
<argument index="1" name="at_position" type="int" default="-1">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
</argument>
<description>
Add a track to the Animation. The track type must be specified as any of the values in the TYPE_* enumeration.
</description>
</method>
<method name="clear">
<return type="void">
</return>
<description>
Clear the animation (clear all tracks and reset all).
</description>
</method>
doc: Sync classref with current source
2017-12-09 23:43:30 +00:00
<method name="copy_track">
<return type="void">
</return>
<argument index="0" name="track" type="int">
</argument>
<argument index="1" name="to_animation" type="Animation">
</argument>
<description>
[DOCS] Animation, CanvasItem, Curve3D, Curve
2017-12-11 19:05:26 +00:00
Adds a new track that is a copy of the given track from [code]to_animation[/code].
doc: Sync classref with current source
2017-12-09 23:43:30 +00:00
</description>
</method>
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
<method name="find_track" qualifiers="const">
<return type="int">
</return>
<argument index="0" name="path" type="NodePath">
</argument>
<description>
Return the index of the specified track. If the track is not found, return -1.
</description>
</method>
<method name="get_track_count" qualifiers="const">
<return type="int">
</return>
<description>
Return the amount of tracks in the animation.
</description>
</method>
<method name="method_track_get_key_indices" qualifiers="const">
<return type="PoolIntArray">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="time_sec" type="float">
</argument>
<argument index="2" name="delta" type="float">
</argument>
<description>
Return all the key indices of a method track, given a position and delta time.
</description>
</method>
<method name="method_track_get_name" qualifiers="const">
<return type="String">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Return the method name of a method track.
</description>
</method>
<method name="method_track_get_params" qualifiers="const">
<return type="Array">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Return the arguments values to be called on a method track for a given key in a given track.
</description>
</method>
<method name="remove_track">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Remove a track by specifying the track index.
</description>
</method>
<method name="track_find_key" qualifiers="const">
<return type="int">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="time" type="float">
</argument>
<argument index="2" name="exact" type="bool" default="false">
</argument>
<description>
Find the key index by time in a given track. Optionally, only find it if the exact time is given.
</description>
</method>
<method name="track_get_interpolation_loop_wrap" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
[DOCS] Animation methods desc 100%
2017-12-05 02:40:30 +00:00
Returns [code]true[/code] if the track at [code]idx[/code] wraps the interpolation loop. Default value: [code]true[/code].
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name="track_get_interpolation_type" qualifiers="const">
<return type="int" enum="Animation.InterpolationType">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Return the interpolation type of a given track, from the INTERPOLATION_* enum.
</description>
</method>
<method name="track_get_key_count" qualifiers="const">
<return type="int">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Return the amount of keys in a given track.
</description>
</method>
<method name="track_get_key_time" qualifiers="const">
<return type="float">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Return the time at which the key is located.
</description>
</method>
<method name="track_get_key_transition" qualifiers="const">
<return type="float">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Return the transition curve (easing) for a specific key (see built-in math function "ease").
</description>
</method>
<method name="track_get_key_value" qualifiers="const">
<return type="Variant">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Return the value of a given key in a given track.
</description>
</method>
<method name="track_get_path" qualifiers="const">
<return type="NodePath">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Get the path of a track. for more information on the path format, see [method track_set_path]
</description>
</method>
<method name="track_get_type" qualifiers="const">
<return type="int" enum="Animation.TrackType">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Get the type of a track.
</description>
</method>
<method name="track_insert_key">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="time" type="float">
</argument>
<argument index="2" name="key" type="Variant">
</argument>
<argument index="3" name="transition" type="float" default="1">
</argument>
<description>
Insert a generic key in a given track.
</description>
</method>
doc: Sync classref with current source
2017-12-09 23:43:30 +00:00
<method name="track_is_enabled" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
[DOCS] Animation, CanvasItem, Curve3D, Curve
2017-12-11 19:05:26 +00:00
Returns [code]true[/code] if the track at index [code]idx[/code] is enabled.
doc: Sync classref with current source
2017-12-09 23:43:30 +00:00
</description>
</method>
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
<method name="track_is_imported" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Return true if the given track is imported. Else, return false.
</description>
</method>
<method name="track_move_down">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Move a track down.
</description>
</method>
<method name="track_move_up">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Move a track up.
</description>
</method>
<method name="track_remove_key">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="key_idx" type="int">
</argument>
<description>
Remove a key by index in a given track.
</description>
</method>
Rename pos to position in user facing methods and variables Rename user facing methods and variables as well as the corresponding C++ methods according to the folloming changes: * pos -> position * rot -> rotation * loc -> location C++ variables are left as is.
2017-09-10 13:37:49 +00:00
<method name="track_remove_key_at_position">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
Rename pos to position in user facing methods and variables Rename user facing methods and variables as well as the corresponding C++ methods according to the folloming changes: * pos -> position * rot -> rotation * loc -> location C++ variables are left as is.
2017-09-10 13:37:49 +00:00
<argument index="1" name="position" type="float">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
</argument>
<description>
Remove a key by position (seconds) in a given track.
</description>
</method>
doc: Sync classref with current source
2017-12-09 23:43:30 +00:00
<method name="track_set_enabled">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="enabled" type="bool">
</argument>
<description>
Bind TextEdit.deselect and update documentation
2017-12-16 19:34:16 +00:00
Enables/disables the given track. Tracks are enabled by default.
doc: Sync classref with current source
2017-12-09 23:43:30 +00:00
</description>
</method>
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
<method name="track_set_imported">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="imported" type="bool">
</argument>
<description>
Set the given track as imported or not.
</description>
</method>
<method name="track_set_interpolation_loop_wrap">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="interpolation" type="bool">
</argument>
<description>
[DOCS] Animation methods desc 100%
2017-12-05 02:40:30 +00:00
If [code]true[/code] the track at [code]idx[/code] wraps the interpolation loop.
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
</description>
</method>
<method name="track_set_interpolation_type">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="interpolation" type="int" enum="Animation.InterpolationType">
</argument>
<description>
Set the interpolation type of a given track, from the INTERPOLATION_* enum.
</description>
</method>
<method name="track_set_key_transition">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="key_idx" type="int">
</argument>
<argument index="2" name="transition" type="float">
</argument>
<description>
Set the transition curve (easing) for a specific key (see built-in math function "ease").
</description>
</method>
<method name="track_set_key_value">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="key" type="int">
</argument>
<argument index="2" name="value" type="Variant">
</argument>
<description>
Set the value of an existing key.
</description>
</method>
<method name="track_set_path">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="path" type="NodePath">
</argument>
<description>
Set the path of a track. 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. Tracks that control properties or bones must append their name after the path, separated by ":". Example: "character/skeleton:ankle" or "character/mesh:transform/local"
</description>
</method>
<method name="transform_track_insert_key">
<return type="int">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="time" type="float">
</argument>
doc: Sync classref with current source [ci skip]
2017-09-23 08:59:35 +00:00
<argument index="2" name="location" type="Vector3">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
</argument>
doc: Sync classref with current source [ci skip]
2017-09-23 08:59:35 +00:00
<argument index="3" name="rotation" type="Quat">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
</argument>
<argument index="4" name="scale" type="Vector3">
</argument>
<description>
Insert a transform key for a transform track.
</description>
</method>
<method name="transform_track_interpolate" qualifiers="const">
<return type="Array">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="time_sec" type="float">
</argument>
<description>
Return the interpolated value of a transform track at a given time (in seconds). An array consisting of 3 elements: position ([Vector3]), rotation ([Quat]) and scale ([Vector3]).
</description>
</method>
<method name="value_track_get_key_indices" qualifiers="const">
<return type="PoolIntArray">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="time_sec" type="float">
</argument>
<argument index="2" name="delta" type="float">
</argument>
<description>
Return all the key indices of a value track, given a position and delta time.
</description>
</method>
<method name="value_track_get_update_mode" qualifiers="const">
<return type="int" enum="Animation.UpdateMode">
</return>
<argument index="0" name="idx" type="int">
</argument>
<description>
Return the update mode of a value track.
</description>
</method>
<method name="value_track_set_update_mode">
<return type="void">
</return>
<argument index="0" name="idx" type="int">
</argument>
<argument index="1" name="mode" type="int" enum="Animation.UpdateMode">
</argument>
<description>
Set the update mode (UPDATE_*) of a value track.
</description>
</method>
</methods>
Update docs [ci skip]
2018-01-11 22:38:35 +00:00
<members>
<member name="length" type="float" setter="set_length" getter="get_length">
The total length of the animation (in seconds). Note that length is not delimited by the last key, as this one may be before or after the end to ensure correct interpolation and looping.
</member>
<member name="loop" type="bool" setter="set_loop" getter="has_loop">
A flag indicating that the animation must loop. This is uses for correct interpolation of animation cycles, and for hinting the player that it must restart the animation.
</member>
<member name="step" type="float" setter="set_step" getter="get_step">
The animation step value.
</member>
</members>
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
<constants>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="TYPE_VALUE" value="0" enum="TrackType">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
Value tracks set values in node properties, but only those which can be Interpolated.
</constant>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="TYPE_TRANSFORM" value="1" enum="TrackType">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
Transform tracks are used to change node local transforms or skeleton pose bones. Transitions are Interpolated.
</constant>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="TYPE_METHOD" value="2" enum="TrackType">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
Method tracks call functions with given arguments per key.
</constant>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="INTERPOLATION_NEAREST" value="0" enum="InterpolationType">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
No interpolation (nearest value).
</constant>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="INTERPOLATION_LINEAR" value="1" enum="InterpolationType">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
Linear interpolation.
</constant>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="INTERPOLATION_CUBIC" value="2" enum="InterpolationType">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
Cubic interpolation.
</constant>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="UPDATE_CONTINUOUS" value="0" enum="UpdateMode">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
Update between keyframes.
</constant>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="UPDATE_DISCRETE" value="1" enum="UpdateMode">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
Update at the keyframes and hold the value.
</constant>
doc: Fix enum tags thanks to 2bc6db6
2017-11-24 22:16:30 +00:00
<constant name="UPDATE_TRIGGER" value="2" enum="UpdateMode">
Changed the doc class generation to individual files per class. It is also possible to save module files in module directories and the build system will recognize them.
2017-09-12 20:42:36 +00:00
Update at the keyframes.
</constant>
</constants>
</class>