class_animationmixer.rst 56 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/AnimationMixer.xml.
  6. .. _class_AnimationMixer:
  7. AnimationMixer
  8. ==============
  9. **Inherits:** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. **Inherited By:** :ref:`AnimationPlayer<class_AnimationPlayer>`, :ref:`AnimationTree<class_AnimationTree>`
  11. Base class for :ref:`AnimationPlayer<class_AnimationPlayer>` and :ref:`AnimationTree<class_AnimationTree>`.
  12. .. rst-class:: classref-introduction-group
  13. Description
  14. -----------
  15. Base class for :ref:`AnimationPlayer<class_AnimationPlayer>` and :ref:`AnimationTree<class_AnimationTree>` to manage animation lists. It also has general properties and methods for playback and blending.
  16. After instantiating the playback information data within the extended class, the blending is processed by the **AnimationMixer**.
  17. .. rst-class:: classref-introduction-group
  18. Tutorials
  19. ---------
  20. - `Migrating Animations from Godot 4.0 to 4.3 <https://godotengine.org/article/migrating-animations-from-godot-4-0-to-4-3/>`__
  21. .. rst-class:: classref-reftable-group
  22. Properties
  23. ----------
  24. .. table::
  25. :widths: auto
  26. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  27. | :ref:`bool<class_bool>` | :ref:`active<class_AnimationMixer_property_active>` | ``true`` |
  28. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  29. | :ref:`int<class_int>` | :ref:`audio_max_polyphony<class_AnimationMixer_property_audio_max_polyphony>` | ``32`` |
  30. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  31. | :ref:`AnimationCallbackModeDiscrete<enum_AnimationMixer_AnimationCallbackModeDiscrete>` | :ref:`callback_mode_discrete<class_AnimationMixer_property_callback_mode_discrete>` | ``1`` |
  32. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  33. | :ref:`AnimationCallbackModeMethod<enum_AnimationMixer_AnimationCallbackModeMethod>` | :ref:`callback_mode_method<class_AnimationMixer_property_callback_mode_method>` | ``0`` |
  34. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  35. | :ref:`AnimationCallbackModeProcess<enum_AnimationMixer_AnimationCallbackModeProcess>` | :ref:`callback_mode_process<class_AnimationMixer_property_callback_mode_process>` | ``1`` |
  36. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  37. | :ref:`bool<class_bool>` | :ref:`deterministic<class_AnimationMixer_property_deterministic>` | ``false`` |
  38. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  39. | :ref:`bool<class_bool>` | :ref:`reset_on_save<class_AnimationMixer_property_reset_on_save>` | ``true`` |
  40. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  41. | :ref:`NodePath<class_NodePath>` | :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` | ``NodePath("")`` |
  42. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  43. | :ref:`NodePath<class_NodePath>` | :ref:`root_node<class_AnimationMixer_property_root_node>` | ``NodePath("..")`` |
  44. +-----------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+--------------------+
  45. .. rst-class:: classref-reftable-group
  46. Methods
  47. -------
  48. .. table::
  49. :widths: auto
  50. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  51. | :ref:`Variant<class_Variant>` | :ref:`_post_process_key_value<class_AnimationMixer_private_method__post_process_key_value>`\ (\ animation\: :ref:`Animation<class_Animation>`, track\: :ref:`int<class_int>`, value\: :ref:`Variant<class_Variant>`, object_id\: :ref:`int<class_int>`, object_sub_idx\: :ref:`int<class_int>`\ ) |virtual| |const| |
  52. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  53. | :ref:`Error<enum_@GlobalScope_Error>` | :ref:`add_animation_library<class_AnimationMixer_method_add_animation_library>`\ (\ name\: :ref:`StringName<class_StringName>`, library\: :ref:`AnimationLibrary<class_AnimationLibrary>`\ ) |
  54. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  55. | |void| | :ref:`advance<class_AnimationMixer_method_advance>`\ (\ delta\: :ref:`float<class_float>`\ ) |
  56. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  57. | |void| | :ref:`capture<class_AnimationMixer_method_capture>`\ (\ name\: :ref:`StringName<class_StringName>`, duration\: :ref:`float<class_float>`, trans_type\: :ref:`TransitionType<enum_Tween_TransitionType>` = 0, ease_type\: :ref:`EaseType<enum_Tween_EaseType>` = 0\ ) |
  58. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  59. | |void| | :ref:`clear_caches<class_AnimationMixer_method_clear_caches>`\ (\ ) |
  60. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  61. | :ref:`StringName<class_StringName>` | :ref:`find_animation<class_AnimationMixer_method_find_animation>`\ (\ animation\: :ref:`Animation<class_Animation>`\ ) |const| |
  62. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  63. | :ref:`StringName<class_StringName>` | :ref:`find_animation_library<class_AnimationMixer_method_find_animation_library>`\ (\ animation\: :ref:`Animation<class_Animation>`\ ) |const| |
  64. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  65. | :ref:`Animation<class_Animation>` | :ref:`get_animation<class_AnimationMixer_method_get_animation>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
  66. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  67. | :ref:`AnimationLibrary<class_AnimationLibrary>` | :ref:`get_animation_library<class_AnimationMixer_method_get_animation_library>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
  68. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  69. | :ref:`Array<class_Array>`\[:ref:`StringName<class_StringName>`\] | :ref:`get_animation_library_list<class_AnimationMixer_method_get_animation_library_list>`\ (\ ) |const| |
  70. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  71. | :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`get_animation_list<class_AnimationMixer_method_get_animation_list>`\ (\ ) |const| |
  72. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  73. | :ref:`Vector3<class_Vector3>` | :ref:`get_root_motion_position<class_AnimationMixer_method_get_root_motion_position>`\ (\ ) |const| |
  74. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  75. | :ref:`Vector3<class_Vector3>` | :ref:`get_root_motion_position_accumulator<class_AnimationMixer_method_get_root_motion_position_accumulator>`\ (\ ) |const| |
  76. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  77. | :ref:`Quaternion<class_Quaternion>` | :ref:`get_root_motion_rotation<class_AnimationMixer_method_get_root_motion_rotation>`\ (\ ) |const| |
  78. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  79. | :ref:`Quaternion<class_Quaternion>` | :ref:`get_root_motion_rotation_accumulator<class_AnimationMixer_method_get_root_motion_rotation_accumulator>`\ (\ ) |const| |
  80. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  81. | :ref:`Vector3<class_Vector3>` | :ref:`get_root_motion_scale<class_AnimationMixer_method_get_root_motion_scale>`\ (\ ) |const| |
  82. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  83. | :ref:`Vector3<class_Vector3>` | :ref:`get_root_motion_scale_accumulator<class_AnimationMixer_method_get_root_motion_scale_accumulator>`\ (\ ) |const| |
  84. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  85. | :ref:`bool<class_bool>` | :ref:`has_animation<class_AnimationMixer_method_has_animation>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
  86. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  87. | :ref:`bool<class_bool>` | :ref:`has_animation_library<class_AnimationMixer_method_has_animation_library>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
  88. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  89. | |void| | :ref:`remove_animation_library<class_AnimationMixer_method_remove_animation_library>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |
  90. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  91. | |void| | :ref:`rename_animation_library<class_AnimationMixer_method_rename_animation_library>`\ (\ name\: :ref:`StringName<class_StringName>`, newname\: :ref:`StringName<class_StringName>`\ ) |
  92. +------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  93. .. rst-class:: classref-section-separator
  94. ----
  95. .. rst-class:: classref-descriptions-group
  96. Signals
  97. -------
  98. .. _class_AnimationMixer_signal_animation_finished:
  99. .. rst-class:: classref-signal
  100. **animation_finished**\ (\ anim_name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_AnimationMixer_signal_animation_finished>`
  101. Notifies when an animation finished playing.
  102. \ **Note:** This signal is not emitted if an animation is looping.
  103. .. rst-class:: classref-item-separator
  104. ----
  105. .. _class_AnimationMixer_signal_animation_libraries_updated:
  106. .. rst-class:: classref-signal
  107. **animation_libraries_updated**\ (\ ) :ref:`🔗<class_AnimationMixer_signal_animation_libraries_updated>`
  108. Notifies when the animation libraries have changed.
  109. .. rst-class:: classref-item-separator
  110. ----
  111. .. _class_AnimationMixer_signal_animation_list_changed:
  112. .. rst-class:: classref-signal
  113. **animation_list_changed**\ (\ ) :ref:`🔗<class_AnimationMixer_signal_animation_list_changed>`
  114. Notifies when an animation list is changed.
  115. .. rst-class:: classref-item-separator
  116. ----
  117. .. _class_AnimationMixer_signal_animation_started:
  118. .. rst-class:: classref-signal
  119. **animation_started**\ (\ anim_name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_AnimationMixer_signal_animation_started>`
  120. Notifies when an animation starts playing.
  121. .. rst-class:: classref-item-separator
  122. ----
  123. .. _class_AnimationMixer_signal_caches_cleared:
  124. .. rst-class:: classref-signal
  125. **caches_cleared**\ (\ ) :ref:`🔗<class_AnimationMixer_signal_caches_cleared>`
  126. Notifies when the caches have been cleared, either automatically, or manually via :ref:`clear_caches<class_AnimationMixer_method_clear_caches>`.
  127. .. rst-class:: classref-item-separator
  128. ----
  129. .. _class_AnimationMixer_signal_mixer_applied:
  130. .. rst-class:: classref-signal
  131. **mixer_applied**\ (\ ) :ref:`🔗<class_AnimationMixer_signal_mixer_applied>`
  132. Notifies when the blending result related have been applied to the target objects.
  133. .. rst-class:: classref-item-separator
  134. ----
  135. .. _class_AnimationMixer_signal_mixer_updated:
  136. .. rst-class:: classref-signal
  137. **mixer_updated**\ (\ ) :ref:`🔗<class_AnimationMixer_signal_mixer_updated>`
  138. Notifies when the property related process have been updated.
  139. .. rst-class:: classref-section-separator
  140. ----
  141. .. rst-class:: classref-descriptions-group
  142. Enumerations
  143. ------------
  144. .. _enum_AnimationMixer_AnimationCallbackModeProcess:
  145. .. rst-class:: classref-enumeration
  146. enum **AnimationCallbackModeProcess**: :ref:`🔗<enum_AnimationMixer_AnimationCallbackModeProcess>`
  147. .. _class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_PROCESS_PHYSICS:
  148. .. rst-class:: classref-enumeration-constant
  149. :ref:`AnimationCallbackModeProcess<enum_AnimationMixer_AnimationCallbackModeProcess>` **ANIMATION_CALLBACK_MODE_PROCESS_PHYSICS** = ``0``
  150. Process animation during physics frames (see :ref:`Node.NOTIFICATION_INTERNAL_PHYSICS_PROCESS<class_Node_constant_NOTIFICATION_INTERNAL_PHYSICS_PROCESS>`). This is especially useful when animating physics bodies.
  151. .. _class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_PROCESS_IDLE:
  152. .. rst-class:: classref-enumeration-constant
  153. :ref:`AnimationCallbackModeProcess<enum_AnimationMixer_AnimationCallbackModeProcess>` **ANIMATION_CALLBACK_MODE_PROCESS_IDLE** = ``1``
  154. Process animation during process frames (see :ref:`Node.NOTIFICATION_INTERNAL_PROCESS<class_Node_constant_NOTIFICATION_INTERNAL_PROCESS>`).
  155. .. _class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_PROCESS_MANUAL:
  156. .. rst-class:: classref-enumeration-constant
  157. :ref:`AnimationCallbackModeProcess<enum_AnimationMixer_AnimationCallbackModeProcess>` **ANIMATION_CALLBACK_MODE_PROCESS_MANUAL** = ``2``
  158. Do not process animation. Use :ref:`advance<class_AnimationMixer_method_advance>` to process the animation manually.
  159. .. rst-class:: classref-item-separator
  160. ----
  161. .. _enum_AnimationMixer_AnimationCallbackModeMethod:
  162. .. rst-class:: classref-enumeration
  163. enum **AnimationCallbackModeMethod**: :ref:`🔗<enum_AnimationMixer_AnimationCallbackModeMethod>`
  164. .. _class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_METHOD_DEFERRED:
  165. .. rst-class:: classref-enumeration-constant
  166. :ref:`AnimationCallbackModeMethod<enum_AnimationMixer_AnimationCallbackModeMethod>` **ANIMATION_CALLBACK_MODE_METHOD_DEFERRED** = ``0``
  167. Batch method calls during the animation process, then do the calls after events are processed. This avoids bugs involving deleting nodes or modifying the AnimationPlayer while playing.
  168. .. _class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_METHOD_IMMEDIATE:
  169. .. rst-class:: classref-enumeration-constant
  170. :ref:`AnimationCallbackModeMethod<enum_AnimationMixer_AnimationCallbackModeMethod>` **ANIMATION_CALLBACK_MODE_METHOD_IMMEDIATE** = ``1``
  171. Make method calls immediately when reached in the animation.
  172. .. rst-class:: classref-item-separator
  173. ----
  174. .. _enum_AnimationMixer_AnimationCallbackModeDiscrete:
  175. .. rst-class:: classref-enumeration
  176. enum **AnimationCallbackModeDiscrete**: :ref:`🔗<enum_AnimationMixer_AnimationCallbackModeDiscrete>`
  177. .. _class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_DISCRETE_DOMINANT:
  178. .. rst-class:: classref-enumeration-constant
  179. :ref:`AnimationCallbackModeDiscrete<enum_AnimationMixer_AnimationCallbackModeDiscrete>` **ANIMATION_CALLBACK_MODE_DISCRETE_DOMINANT** = ``0``
  180. An :ref:`Animation.UPDATE_DISCRETE<class_Animation_constant_UPDATE_DISCRETE>` track value takes precedence when blending :ref:`Animation.UPDATE_CONTINUOUS<class_Animation_constant_UPDATE_CONTINUOUS>` or :ref:`Animation.UPDATE_CAPTURE<class_Animation_constant_UPDATE_CAPTURE>` track values and :ref:`Animation.UPDATE_DISCRETE<class_Animation_constant_UPDATE_DISCRETE>` track values.
  181. .. _class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_DISCRETE_RECESSIVE:
  182. .. rst-class:: classref-enumeration-constant
  183. :ref:`AnimationCallbackModeDiscrete<enum_AnimationMixer_AnimationCallbackModeDiscrete>` **ANIMATION_CALLBACK_MODE_DISCRETE_RECESSIVE** = ``1``
  184. An :ref:`Animation.UPDATE_CONTINUOUS<class_Animation_constant_UPDATE_CONTINUOUS>` or :ref:`Animation.UPDATE_CAPTURE<class_Animation_constant_UPDATE_CAPTURE>` track value takes precedence when blending the :ref:`Animation.UPDATE_CONTINUOUS<class_Animation_constant_UPDATE_CONTINUOUS>` or :ref:`Animation.UPDATE_CAPTURE<class_Animation_constant_UPDATE_CAPTURE>` track values and the :ref:`Animation.UPDATE_DISCRETE<class_Animation_constant_UPDATE_DISCRETE>` track values. This is the default behavior for :ref:`AnimationPlayer<class_AnimationPlayer>`.
  185. .. _class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_DISCRETE_FORCE_CONTINUOUS:
  186. .. rst-class:: classref-enumeration-constant
  187. :ref:`AnimationCallbackModeDiscrete<enum_AnimationMixer_AnimationCallbackModeDiscrete>` **ANIMATION_CALLBACK_MODE_DISCRETE_FORCE_CONTINUOUS** = ``2``
  188. Always treat the :ref:`Animation.UPDATE_DISCRETE<class_Animation_constant_UPDATE_DISCRETE>` track value as :ref:`Animation.UPDATE_CONTINUOUS<class_Animation_constant_UPDATE_CONTINUOUS>` with :ref:`Animation.INTERPOLATION_NEAREST<class_Animation_constant_INTERPOLATION_NEAREST>`. This is the default behavior for :ref:`AnimationTree<class_AnimationTree>`.
  189. If a value track has un-interpolatable type key values, it is internally converted to use :ref:`ANIMATION_CALLBACK_MODE_DISCRETE_RECESSIVE<class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_DISCRETE_RECESSIVE>` with :ref:`Animation.UPDATE_DISCRETE<class_Animation_constant_UPDATE_DISCRETE>`.
  190. Un-interpolatable type list:
  191. - :ref:`@GlobalScope.TYPE_NIL<class_@GlobalScope_constant_TYPE_NIL>`\
  192. - :ref:`@GlobalScope.TYPE_NODE_PATH<class_@GlobalScope_constant_TYPE_NODE_PATH>`\
  193. - :ref:`@GlobalScope.TYPE_RID<class_@GlobalScope_constant_TYPE_RID>`\
  194. - :ref:`@GlobalScope.TYPE_OBJECT<class_@GlobalScope_constant_TYPE_OBJECT>`\
  195. - :ref:`@GlobalScope.TYPE_CALLABLE<class_@GlobalScope_constant_TYPE_CALLABLE>`\
  196. - :ref:`@GlobalScope.TYPE_SIGNAL<class_@GlobalScope_constant_TYPE_SIGNAL>`\
  197. - :ref:`@GlobalScope.TYPE_DICTIONARY<class_@GlobalScope_constant_TYPE_DICTIONARY>`\
  198. - :ref:`@GlobalScope.TYPE_PACKED_BYTE_ARRAY<class_@GlobalScope_constant_TYPE_PACKED_BYTE_ARRAY>`\
  199. \ :ref:`@GlobalScope.TYPE_BOOL<class_@GlobalScope_constant_TYPE_BOOL>` and :ref:`@GlobalScope.TYPE_INT<class_@GlobalScope_constant_TYPE_INT>` are treated as :ref:`@GlobalScope.TYPE_FLOAT<class_@GlobalScope_constant_TYPE_FLOAT>` during blending and rounded when the result is retrieved.
  200. It is same for arrays and vectors with them such as :ref:`@GlobalScope.TYPE_PACKED_INT32_ARRAY<class_@GlobalScope_constant_TYPE_PACKED_INT32_ARRAY>` or :ref:`@GlobalScope.TYPE_VECTOR2I<class_@GlobalScope_constant_TYPE_VECTOR2I>`, they are treated as :ref:`@GlobalScope.TYPE_PACKED_FLOAT32_ARRAY<class_@GlobalScope_constant_TYPE_PACKED_FLOAT32_ARRAY>` or :ref:`@GlobalScope.TYPE_VECTOR2<class_@GlobalScope_constant_TYPE_VECTOR2>`. Also note that for arrays, the size is also interpolated.
  201. \ :ref:`@GlobalScope.TYPE_STRING<class_@GlobalScope_constant_TYPE_STRING>` and :ref:`@GlobalScope.TYPE_STRING_NAME<class_@GlobalScope_constant_TYPE_STRING_NAME>` are interpolated between character codes and lengths, but note that there is a difference in algorithm between interpolation between keys and interpolation by blending.
  202. .. rst-class:: classref-section-separator
  203. ----
  204. .. rst-class:: classref-descriptions-group
  205. Property Descriptions
  206. ---------------------
  207. .. _class_AnimationMixer_property_active:
  208. .. rst-class:: classref-property
  209. :ref:`bool<class_bool>` **active** = ``true`` :ref:`🔗<class_AnimationMixer_property_active>`
  210. .. rst-class:: classref-property-setget
  211. - |void| **set_active**\ (\ value\: :ref:`bool<class_bool>`\ )
  212. - :ref:`bool<class_bool>` **is_active**\ (\ )
  213. If ``true``, the **AnimationMixer** will be processing.
  214. .. rst-class:: classref-item-separator
  215. ----
  216. .. _class_AnimationMixer_property_audio_max_polyphony:
  217. .. rst-class:: classref-property
  218. :ref:`int<class_int>` **audio_max_polyphony** = ``32`` :ref:`🔗<class_AnimationMixer_property_audio_max_polyphony>`
  219. .. rst-class:: classref-property-setget
  220. - |void| **set_audio_max_polyphony**\ (\ value\: :ref:`int<class_int>`\ )
  221. - :ref:`int<class_int>` **get_audio_max_polyphony**\ (\ )
  222. The number of possible simultaneous sounds for each of the assigned AudioStreamPlayers.
  223. For example, if this value is ``32`` and the animation has two audio tracks, the two :ref:`AudioStreamPlayer<class_AudioStreamPlayer>`\ s assigned can play simultaneously up to ``32`` voices each.
  224. .. rst-class:: classref-item-separator
  225. ----
  226. .. _class_AnimationMixer_property_callback_mode_discrete:
  227. .. rst-class:: classref-property
  228. :ref:`AnimationCallbackModeDiscrete<enum_AnimationMixer_AnimationCallbackModeDiscrete>` **callback_mode_discrete** = ``1`` :ref:`🔗<class_AnimationMixer_property_callback_mode_discrete>`
  229. .. rst-class:: classref-property-setget
  230. - |void| **set_callback_mode_discrete**\ (\ value\: :ref:`AnimationCallbackModeDiscrete<enum_AnimationMixer_AnimationCallbackModeDiscrete>`\ )
  231. - :ref:`AnimationCallbackModeDiscrete<enum_AnimationMixer_AnimationCallbackModeDiscrete>` **get_callback_mode_discrete**\ (\ )
  232. Ordinarily, tracks can be set to :ref:`Animation.UPDATE_DISCRETE<class_Animation_constant_UPDATE_DISCRETE>` to update infrequently, usually when using nearest interpolation.
  233. However, when blending with :ref:`Animation.UPDATE_CONTINUOUS<class_Animation_constant_UPDATE_CONTINUOUS>` several results are considered. The :ref:`callback_mode_discrete<class_AnimationMixer_property_callback_mode_discrete>` specify it explicitly. See also :ref:`AnimationCallbackModeDiscrete<enum_AnimationMixer_AnimationCallbackModeDiscrete>`.
  234. To make the blended results look good, it is recommended to set this to :ref:`ANIMATION_CALLBACK_MODE_DISCRETE_FORCE_CONTINUOUS<class_AnimationMixer_constant_ANIMATION_CALLBACK_MODE_DISCRETE_FORCE_CONTINUOUS>` to update every frame during blending. Other values exist for compatibility and they are fine if there is no blending, but not so, may produce artifacts.
  235. .. rst-class:: classref-item-separator
  236. ----
  237. .. _class_AnimationMixer_property_callback_mode_method:
  238. .. rst-class:: classref-property
  239. :ref:`AnimationCallbackModeMethod<enum_AnimationMixer_AnimationCallbackModeMethod>` **callback_mode_method** = ``0`` :ref:`🔗<class_AnimationMixer_property_callback_mode_method>`
  240. .. rst-class:: classref-property-setget
  241. - |void| **set_callback_mode_method**\ (\ value\: :ref:`AnimationCallbackModeMethod<enum_AnimationMixer_AnimationCallbackModeMethod>`\ )
  242. - :ref:`AnimationCallbackModeMethod<enum_AnimationMixer_AnimationCallbackModeMethod>` **get_callback_mode_method**\ (\ )
  243. The call mode used for "Call Method" tracks.
  244. .. rst-class:: classref-item-separator
  245. ----
  246. .. _class_AnimationMixer_property_callback_mode_process:
  247. .. rst-class:: classref-property
  248. :ref:`AnimationCallbackModeProcess<enum_AnimationMixer_AnimationCallbackModeProcess>` **callback_mode_process** = ``1`` :ref:`🔗<class_AnimationMixer_property_callback_mode_process>`
  249. .. rst-class:: classref-property-setget
  250. - |void| **set_callback_mode_process**\ (\ value\: :ref:`AnimationCallbackModeProcess<enum_AnimationMixer_AnimationCallbackModeProcess>`\ )
  251. - :ref:`AnimationCallbackModeProcess<enum_AnimationMixer_AnimationCallbackModeProcess>` **get_callback_mode_process**\ (\ )
  252. The process notification in which to update animations.
  253. .. rst-class:: classref-item-separator
  254. ----
  255. .. _class_AnimationMixer_property_deterministic:
  256. .. rst-class:: classref-property
  257. :ref:`bool<class_bool>` **deterministic** = ``false`` :ref:`🔗<class_AnimationMixer_property_deterministic>`
  258. .. rst-class:: classref-property-setget
  259. - |void| **set_deterministic**\ (\ value\: :ref:`bool<class_bool>`\ )
  260. - :ref:`bool<class_bool>` **is_deterministic**\ (\ )
  261. If ``true``, the blending uses the deterministic algorithm. The total weight is not normalized and the result is accumulated with an initial value (``0`` or a ``"RESET"`` animation if present).
  262. This means that if the total amount of blending is ``0.0``, the result is equal to the ``"RESET"`` animation.
  263. If the number of tracks between the blended animations is different, the animation with the missing track is treated as if it had the initial value.
  264. If ``false``, The blend does not use the deterministic algorithm. The total weight is normalized and always ``1.0``. If the number of tracks between the blended animations is different, nothing is done about the animation that is missing a track.
  265. \ **Note:** In :ref:`AnimationTree<class_AnimationTree>`, the blending with :ref:`AnimationNodeAdd2<class_AnimationNodeAdd2>`, :ref:`AnimationNodeAdd3<class_AnimationNodeAdd3>`, :ref:`AnimationNodeSub2<class_AnimationNodeSub2>` or the weight greater than ``1.0`` may produce unexpected results.
  266. For example, if :ref:`AnimationNodeAdd2<class_AnimationNodeAdd2>` blends two nodes with the amount ``1.0``, then total weight is ``2.0`` but it will be normalized to make the total amount ``1.0`` and the result will be equal to :ref:`AnimationNodeBlend2<class_AnimationNodeBlend2>` with the amount ``0.5``.
  267. .. rst-class:: classref-item-separator
  268. ----
  269. .. _class_AnimationMixer_property_reset_on_save:
  270. .. rst-class:: classref-property
  271. :ref:`bool<class_bool>` **reset_on_save** = ``true`` :ref:`🔗<class_AnimationMixer_property_reset_on_save>`
  272. .. rst-class:: classref-property-setget
  273. - |void| **set_reset_on_save_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
  274. - :ref:`bool<class_bool>` **is_reset_on_save_enabled**\ (\ )
  275. This is used by the editor. If set to ``true``, the scene will be saved with the effects of the reset animation (the animation with the key ``"RESET"``) applied as if it had been seeked to time 0, with the editor keeping the values that the scene had before saving.
  276. This makes it more convenient to preview and edit animations in the editor, as changes to the scene will not be saved as long as they are set in the reset animation.
  277. .. rst-class:: classref-item-separator
  278. ----
  279. .. _class_AnimationMixer_property_root_motion_track:
  280. .. rst-class:: classref-property
  281. :ref:`NodePath<class_NodePath>` **root_motion_track** = ``NodePath("")`` :ref:`🔗<class_AnimationMixer_property_root_motion_track>`
  282. .. rst-class:: classref-property-setget
  283. - |void| **set_root_motion_track**\ (\ value\: :ref:`NodePath<class_NodePath>`\ )
  284. - :ref:`NodePath<class_NodePath>` **get_root_motion_track**\ (\ )
  285. 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. The :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` uses the same format as :ref:`Animation.track_set_path<class_Animation_method_track_set_path>`, but note that a bone must be specified.
  286. If the track has type :ref:`Animation.TYPE_POSITION_3D<class_Animation_constant_TYPE_POSITION_3D>`, :ref:`Animation.TYPE_ROTATION_3D<class_Animation_constant_TYPE_ROTATION_3D>`, or :ref:`Animation.TYPE_SCALE_3D<class_Animation_constant_TYPE_SCALE_3D>` the transformation will be canceled visually, and the animation will appear to stay in place. See also :ref:`get_root_motion_position<class_AnimationMixer_method_get_root_motion_position>`, :ref:`get_root_motion_rotation<class_AnimationMixer_method_get_root_motion_rotation>`, :ref:`get_root_motion_scale<class_AnimationMixer_method_get_root_motion_scale>`, and :ref:`RootMotionView<class_RootMotionView>`.
  287. .. rst-class:: classref-item-separator
  288. ----
  289. .. _class_AnimationMixer_property_root_node:
  290. .. rst-class:: classref-property
  291. :ref:`NodePath<class_NodePath>` **root_node** = ``NodePath("..")`` :ref:`🔗<class_AnimationMixer_property_root_node>`
  292. .. rst-class:: classref-property-setget
  293. - |void| **set_root_node**\ (\ value\: :ref:`NodePath<class_NodePath>`\ )
  294. - :ref:`NodePath<class_NodePath>` **get_root_node**\ (\ )
  295. The node which node path references will travel from.
  296. .. rst-class:: classref-section-separator
  297. ----
  298. .. rst-class:: classref-descriptions-group
  299. Method Descriptions
  300. -------------------
  301. .. _class_AnimationMixer_private_method__post_process_key_value:
  302. .. rst-class:: classref-method
  303. :ref:`Variant<class_Variant>` **_post_process_key_value**\ (\ animation\: :ref:`Animation<class_Animation>`, track\: :ref:`int<class_int>`, value\: :ref:`Variant<class_Variant>`, object_id\: :ref:`int<class_int>`, object_sub_idx\: :ref:`int<class_int>`\ ) |virtual| |const| :ref:`🔗<class_AnimationMixer_private_method__post_process_key_value>`
  304. A virtual function for processing after getting a key during playback.
  305. .. rst-class:: classref-item-separator
  306. ----
  307. .. _class_AnimationMixer_method_add_animation_library:
  308. .. rst-class:: classref-method
  309. :ref:`Error<enum_@GlobalScope_Error>` **add_animation_library**\ (\ name\: :ref:`StringName<class_StringName>`, library\: :ref:`AnimationLibrary<class_AnimationLibrary>`\ ) :ref:`🔗<class_AnimationMixer_method_add_animation_library>`
  310. Adds ``library`` to the animation player, under the key ``name``.
  311. AnimationMixer has a global library by default with an empty string as key. For adding an animation to the global library:
  312. .. tabs::
  313. .. code-tab:: gdscript
  314. var global_library = mixer.get_animation_library("")
  315. global_library.add_animation("animation_name", animation_resource)
  316. .. rst-class:: classref-item-separator
  317. ----
  318. .. _class_AnimationMixer_method_advance:
  319. .. rst-class:: classref-method
  320. |void| **advance**\ (\ delta\: :ref:`float<class_float>`\ ) :ref:`🔗<class_AnimationMixer_method_advance>`
  321. Manually advance the animations by the specified time (in seconds).
  322. .. rst-class:: classref-item-separator
  323. ----
  324. .. _class_AnimationMixer_method_capture:
  325. .. rst-class:: classref-method
  326. |void| **capture**\ (\ name\: :ref:`StringName<class_StringName>`, duration\: :ref:`float<class_float>`, trans_type\: :ref:`TransitionType<enum_Tween_TransitionType>` = 0, ease_type\: :ref:`EaseType<enum_Tween_EaseType>` = 0\ ) :ref:`🔗<class_AnimationMixer_method_capture>`
  327. If the animation track specified by ``name`` has an option :ref:`Animation.UPDATE_CAPTURE<class_Animation_constant_UPDATE_CAPTURE>`, stores current values of the objects indicated by the track path as a cache. If there is already a captured cache, the old cache is discarded.
  328. After this it will interpolate with current animation blending result during the playback process for the time specified by ``duration``, working like a crossfade.
  329. You can specify ``trans_type`` as the curve for the interpolation. For better results, it may be appropriate to specify :ref:`Tween.TRANS_LINEAR<class_Tween_constant_TRANS_LINEAR>` for cases where the first key of the track begins with a non-zero value or where the key value does not change, and :ref:`Tween.TRANS_QUAD<class_Tween_constant_TRANS_QUAD>` for cases where the key value changes linearly.
  330. .. rst-class:: classref-item-separator
  331. ----
  332. .. _class_AnimationMixer_method_clear_caches:
  333. .. rst-class:: classref-method
  334. |void| **clear_caches**\ (\ ) :ref:`🔗<class_AnimationMixer_method_clear_caches>`
  335. **AnimationMixer** caches animated nodes. It may not notice if a node disappears; :ref:`clear_caches<class_AnimationMixer_method_clear_caches>` forces it to update the cache again.
  336. .. rst-class:: classref-item-separator
  337. ----
  338. .. _class_AnimationMixer_method_find_animation:
  339. .. rst-class:: classref-method
  340. :ref:`StringName<class_StringName>` **find_animation**\ (\ animation\: :ref:`Animation<class_Animation>`\ ) |const| :ref:`🔗<class_AnimationMixer_method_find_animation>`
  341. Returns the key of ``animation`` or an empty :ref:`StringName<class_StringName>` if not found.
  342. .. rst-class:: classref-item-separator
  343. ----
  344. .. _class_AnimationMixer_method_find_animation_library:
  345. .. rst-class:: classref-method
  346. :ref:`StringName<class_StringName>` **find_animation_library**\ (\ animation\: :ref:`Animation<class_Animation>`\ ) |const| :ref:`🔗<class_AnimationMixer_method_find_animation_library>`
  347. Returns the key for the :ref:`AnimationLibrary<class_AnimationLibrary>` that contains ``animation`` or an empty :ref:`StringName<class_StringName>` if not found.
  348. .. rst-class:: classref-item-separator
  349. ----
  350. .. _class_AnimationMixer_method_get_animation:
  351. .. rst-class:: classref-method
  352. :ref:`Animation<class_Animation>` **get_animation**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_animation>`
  353. Returns the :ref:`Animation<class_Animation>` with the key ``name``. If the animation does not exist, ``null`` is returned and an error is logged.
  354. .. rst-class:: classref-item-separator
  355. ----
  356. .. _class_AnimationMixer_method_get_animation_library:
  357. .. rst-class:: classref-method
  358. :ref:`AnimationLibrary<class_AnimationLibrary>` **get_animation_library**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_animation_library>`
  359. Returns the first :ref:`AnimationLibrary<class_AnimationLibrary>` with key ``name`` or ``null`` if not found.
  360. To get the **AnimationMixer**'s global animation library, use ``get_animation_library("")``.
  361. .. rst-class:: classref-item-separator
  362. ----
  363. .. _class_AnimationMixer_method_get_animation_library_list:
  364. .. rst-class:: classref-method
  365. :ref:`Array<class_Array>`\[:ref:`StringName<class_StringName>`\] **get_animation_library_list**\ (\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_animation_library_list>`
  366. Returns the list of stored library keys.
  367. .. rst-class:: classref-item-separator
  368. ----
  369. .. _class_AnimationMixer_method_get_animation_list:
  370. .. rst-class:: classref-method
  371. :ref:`PackedStringArray<class_PackedStringArray>` **get_animation_list**\ (\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_animation_list>`
  372. Returns the list of stored animation keys.
  373. .. rst-class:: classref-item-separator
  374. ----
  375. .. _class_AnimationMixer_method_get_root_motion_position:
  376. .. rst-class:: classref-method
  377. :ref:`Vector3<class_Vector3>` **get_root_motion_position**\ (\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_root_motion_position>`
  378. Retrieve the motion delta of position with the :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` as a :ref:`Vector3<class_Vector3>` that can be used elsewhere.
  379. If :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` is not a path to a track of type :ref:`Animation.TYPE_POSITION_3D<class_Animation_constant_TYPE_POSITION_3D>`, returns ``Vector3(0, 0, 0)``.
  380. See also :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` and :ref:`RootMotionView<class_RootMotionView>`.
  381. The most basic example is applying position to :ref:`CharacterBody3D<class_CharacterBody3D>`:
  382. .. tabs::
  383. .. code-tab:: gdscript
  384. var current_rotation: Quaternion
  385. func _process(delta):
  386. if Input.is_action_just_pressed("animate"):
  387. current_rotation = get_quaternion()
  388. state_machine.travel("Animate")
  389. var velocity: Vector3 = current_rotation * animation_tree.get_root_motion_position() / delta
  390. set_velocity(velocity)
  391. move_and_slide()
  392. By using this in combination with :ref:`get_root_motion_rotation_accumulator<class_AnimationMixer_method_get_root_motion_rotation_accumulator>`, you can apply the root motion position more correctly to account for the rotation of the node.
  393. .. tabs::
  394. .. code-tab:: gdscript
  395. func _process(delta):
  396. if Input.is_action_just_pressed("animate"):
  397. state_machine.travel("Animate")
  398. set_quaternion(get_quaternion() * animation_tree.get_root_motion_rotation())
  399. var velocity: Vector3 = (animation_tree.get_root_motion_rotation_accumulator().inverse() * get_quaternion()) * animation_tree.get_root_motion_position() / delta
  400. set_velocity(velocity)
  401. move_and_slide()
  402. .. rst-class:: classref-item-separator
  403. ----
  404. .. _class_AnimationMixer_method_get_root_motion_position_accumulator:
  405. .. rst-class:: classref-method
  406. :ref:`Vector3<class_Vector3>` **get_root_motion_position_accumulator**\ (\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_root_motion_position_accumulator>`
  407. Retrieve the blended value of the position tracks with the :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` as a :ref:`Vector3<class_Vector3>` that can be used elsewhere.
  408. This is useful in cases where you want to respect the initial key values of the animation.
  409. For example, if an animation with only one key ``Vector3(0, 0, 0)`` is played in the previous frame and then an animation with only one key ``Vector3(1, 0, 1)`` is played in the next frame, the difference can be calculated as follows:
  410. .. tabs::
  411. .. code-tab:: gdscript
  412. var prev_root_motion_position_accumulator: Vector3
  413. func _process(delta):
  414. if Input.is_action_just_pressed("animate"):
  415. state_machine.travel("Animate")
  416. var current_root_motion_position_accumulator: Vector3 = animation_tree.get_root_motion_position_accumulator()
  417. var difference: Vector3 = current_root_motion_position_accumulator - prev_root_motion_position_accumulator
  418. prev_root_motion_position_accumulator = current_root_motion_position_accumulator
  419. transform.origin += difference
  420. However, if the animation loops, an unintended discrete change may occur, so this is only useful for some simple use cases.
  421. .. rst-class:: classref-item-separator
  422. ----
  423. .. _class_AnimationMixer_method_get_root_motion_rotation:
  424. .. rst-class:: classref-method
  425. :ref:`Quaternion<class_Quaternion>` **get_root_motion_rotation**\ (\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_root_motion_rotation>`
  426. Retrieve the motion delta of rotation with the :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` as a :ref:`Quaternion<class_Quaternion>` that can be used elsewhere.
  427. If :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` is not a path to a track of type :ref:`Animation.TYPE_ROTATION_3D<class_Animation_constant_TYPE_ROTATION_3D>`, returns ``Quaternion(0, 0, 0, 1)``.
  428. See also :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` and :ref:`RootMotionView<class_RootMotionView>`.
  429. The most basic example is applying rotation to :ref:`CharacterBody3D<class_CharacterBody3D>`:
  430. .. tabs::
  431. .. code-tab:: gdscript
  432. func _process(delta):
  433. if Input.is_action_just_pressed("animate"):
  434. state_machine.travel("Animate")
  435. set_quaternion(get_quaternion() * animation_tree.get_root_motion_rotation())
  436. .. rst-class:: classref-item-separator
  437. ----
  438. .. _class_AnimationMixer_method_get_root_motion_rotation_accumulator:
  439. .. rst-class:: classref-method
  440. :ref:`Quaternion<class_Quaternion>` **get_root_motion_rotation_accumulator**\ (\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_root_motion_rotation_accumulator>`
  441. Retrieve the blended value of the rotation tracks with the :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` as a :ref:`Quaternion<class_Quaternion>` that can be used elsewhere.
  442. This is necessary to apply the root motion position correctly, taking rotation into account. See also :ref:`get_root_motion_position<class_AnimationMixer_method_get_root_motion_position>`.
  443. Also, this is useful in cases where you want to respect the initial key values of the animation.
  444. For example, if an animation with only one key ``Quaternion(0, 0, 0, 1)`` is played in the previous frame and then an animation with only one key ``Quaternion(0, 0.707, 0, 0.707)`` is played in the next frame, the difference can be calculated as follows:
  445. .. tabs::
  446. .. code-tab:: gdscript
  447. var prev_root_motion_rotation_accumulator: Quaternion
  448. func _process(delta):
  449. if Input.is_action_just_pressed("animate"):
  450. state_machine.travel("Animate")
  451. var current_root_motion_rotation_accumulator: Quaternion = animation_tree.get_root_motion_rotation_accumulator()
  452. var difference: Quaternion = prev_root_motion_rotation_accumulator.inverse() * current_root_motion_rotation_accumulator
  453. prev_root_motion_rotation_accumulator = current_root_motion_rotation_accumulator
  454. transform.basis *= Basis(difference)
  455. However, if the animation loops, an unintended discrete change may occur, so this is only useful for some simple use cases.
  456. .. rst-class:: classref-item-separator
  457. ----
  458. .. _class_AnimationMixer_method_get_root_motion_scale:
  459. .. rst-class:: classref-method
  460. :ref:`Vector3<class_Vector3>` **get_root_motion_scale**\ (\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_root_motion_scale>`
  461. Retrieve the motion delta of scale with the :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` as a :ref:`Vector3<class_Vector3>` that can be used elsewhere.
  462. If :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` is not a path to a track of type :ref:`Animation.TYPE_SCALE_3D<class_Animation_constant_TYPE_SCALE_3D>`, returns ``Vector3(0, 0, 0)``.
  463. See also :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` and :ref:`RootMotionView<class_RootMotionView>`.
  464. The most basic example is applying scale to :ref:`CharacterBody3D<class_CharacterBody3D>`:
  465. .. tabs::
  466. .. code-tab:: gdscript
  467. var current_scale: Vector3 = Vector3(1, 1, 1)
  468. var scale_accum: Vector3 = Vector3(1, 1, 1)
  469. func _process(delta):
  470. if Input.is_action_just_pressed("animate"):
  471. current_scale = get_scale()
  472. scale_accum = Vector3(1, 1, 1)
  473. state_machine.travel("Animate")
  474. scale_accum += animation_tree.get_root_motion_scale()
  475. set_scale(current_scale * scale_accum)
  476. .. rst-class:: classref-item-separator
  477. ----
  478. .. _class_AnimationMixer_method_get_root_motion_scale_accumulator:
  479. .. rst-class:: classref-method
  480. :ref:`Vector3<class_Vector3>` **get_root_motion_scale_accumulator**\ (\ ) |const| :ref:`🔗<class_AnimationMixer_method_get_root_motion_scale_accumulator>`
  481. Retrieve the blended value of the scale tracks with the :ref:`root_motion_track<class_AnimationMixer_property_root_motion_track>` as a :ref:`Vector3<class_Vector3>` that can be used elsewhere.
  482. For example, if an animation with only one key ``Vector3(1, 1, 1)`` is played in the previous frame and then an animation with only one key ``Vector3(2, 2, 2)`` is played in the next frame, the difference can be calculated as follows:
  483. .. tabs::
  484. .. code-tab:: gdscript
  485. var prev_root_motion_scale_accumulator: Vector3
  486. func _process(delta):
  487. if Input.is_action_just_pressed("animate"):
  488. state_machine.travel("Animate")
  489. var current_root_motion_scale_accumulator: Vector3 = animation_tree.get_root_motion_scale_accumulator()
  490. var difference: Vector3 = current_root_motion_scale_accumulator - prev_root_motion_scale_accumulator
  491. prev_root_motion_scale_accumulator = current_root_motion_scale_accumulator
  492. transform.basis = transform.basis.scaled(difference)
  493. However, if the animation loops, an unintended discrete change may occur, so this is only useful for some simple use cases.
  494. .. rst-class:: classref-item-separator
  495. ----
  496. .. _class_AnimationMixer_method_has_animation:
  497. .. rst-class:: classref-method
  498. :ref:`bool<class_bool>` **has_animation**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_AnimationMixer_method_has_animation>`
  499. Returns ``true`` if the **AnimationMixer** stores an :ref:`Animation<class_Animation>` with key ``name``.
  500. .. rst-class:: classref-item-separator
  501. ----
  502. .. _class_AnimationMixer_method_has_animation_library:
  503. .. rst-class:: classref-method
  504. :ref:`bool<class_bool>` **has_animation_library**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_AnimationMixer_method_has_animation_library>`
  505. Returns ``true`` if the **AnimationMixer** stores an :ref:`AnimationLibrary<class_AnimationLibrary>` with key ``name``.
  506. .. rst-class:: classref-item-separator
  507. ----
  508. .. _class_AnimationMixer_method_remove_animation_library:
  509. .. rst-class:: classref-method
  510. |void| **remove_animation_library**\ (\ name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_AnimationMixer_method_remove_animation_library>`
  511. Removes the :ref:`AnimationLibrary<class_AnimationLibrary>` associated with the key ``name``.
  512. .. rst-class:: classref-item-separator
  513. ----
  514. .. _class_AnimationMixer_method_rename_animation_library:
  515. .. rst-class:: classref-method
  516. |void| **rename_animation_library**\ (\ name\: :ref:`StringName<class_StringName>`, newname\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_AnimationMixer_method_rename_animation_library>`
  517. Moves the :ref:`AnimationLibrary<class_AnimationLibrary>` associated with the key ``name`` to the key ``newname``.
  518. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  519. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  520. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  521. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  522. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  523. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  524. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  525. .. |void| replace:: :abbr:`void (No return value.)`