class_animationnodeoneshot.rst 7.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the AnimationNodeOneShot.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_AnimationNodeOneShot:
  6. AnimationNodeOneShot
  7. ====================
  8. **Inherits:** :ref:`AnimationNode<class_AnimationNode>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  9. Plays an animation once in :ref:`AnimationNodeBlendTree<class_AnimationNodeBlendTree>`.
  10. Description
  11. -----------
  12. A resource to add to an :ref:`AnimationNodeBlendTree<class_AnimationNodeBlendTree>`. This node will execute a sub-animation and return once it finishes. Blend times for fading in and out can be customized, as well as filters.
  13. Tutorials
  14. ---------
  15. - :doc:`../tutorials/animation/animation_tree`
  16. Properties
  17. ----------
  18. +---------------------------+-----------------------------------------------------------------------------------------------+-----------+
  19. | :ref:`bool<class_bool>` | :ref:`autorestart<class_AnimationNodeOneShot_property_autorestart>` | ``false`` |
  20. +---------------------------+-----------------------------------------------------------------------------------------------+-----------+
  21. | :ref:`float<class_float>` | :ref:`autorestart_delay<class_AnimationNodeOneShot_property_autorestart_delay>` | ``1.0`` |
  22. +---------------------------+-----------------------------------------------------------------------------------------------+-----------+
  23. | :ref:`float<class_float>` | :ref:`autorestart_random_delay<class_AnimationNodeOneShot_property_autorestart_random_delay>` | ``0.0`` |
  24. +---------------------------+-----------------------------------------------------------------------------------------------+-----------+
  25. | :ref:`float<class_float>` | :ref:`fadein_time<class_AnimationNodeOneShot_property_fadein_time>` | ``0.1`` |
  26. +---------------------------+-----------------------------------------------------------------------------------------------+-----------+
  27. | :ref:`float<class_float>` | :ref:`fadeout_time<class_AnimationNodeOneShot_property_fadeout_time>` | ``0.1`` |
  28. +---------------------------+-----------------------------------------------------------------------------------------------+-----------+
  29. | :ref:`bool<class_bool>` | :ref:`sync<class_AnimationNodeOneShot_property_sync>` | ``false`` |
  30. +---------------------------+-----------------------------------------------------------------------------------------------+-----------+
  31. Methods
  32. -------
  33. +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  34. | :ref:`MixMode<enum_AnimationNodeOneShot_MixMode>` | :ref:`get_mix_mode<class_AnimationNodeOneShot_method_get_mix_mode>` **(** **)** |const| |
  35. +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  36. | void | :ref:`set_mix_mode<class_AnimationNodeOneShot_method_set_mix_mode>` **(** :ref:`MixMode<enum_AnimationNodeOneShot_MixMode>` mode **)** |
  37. +---------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+
  38. Enumerations
  39. ------------
  40. .. _enum_AnimationNodeOneShot_MixMode:
  41. .. _class_AnimationNodeOneShot_constant_MIX_MODE_BLEND:
  42. .. _class_AnimationNodeOneShot_constant_MIX_MODE_ADD:
  43. enum **MixMode**:
  44. - **MIX_MODE_BLEND** = **0**
  45. - **MIX_MODE_ADD** = **1**
  46. Property Descriptions
  47. ---------------------
  48. .. _class_AnimationNodeOneShot_property_autorestart:
  49. - :ref:`bool<class_bool>` **autorestart**
  50. +-----------+------------------------+
  51. | *Default* | ``false`` |
  52. +-----------+------------------------+
  53. | *Setter* | set_autorestart(value) |
  54. +-----------+------------------------+
  55. | *Getter* | has_autorestart() |
  56. +-----------+------------------------+
  57. If ``true``, the sub-animation will restart automatically after finishing.
  58. ----
  59. .. _class_AnimationNodeOneShot_property_autorestart_delay:
  60. - :ref:`float<class_float>` **autorestart_delay**
  61. +-----------+------------------------------+
  62. | *Default* | ``1.0`` |
  63. +-----------+------------------------------+
  64. | *Setter* | set_autorestart_delay(value) |
  65. +-----------+------------------------------+
  66. | *Getter* | get_autorestart_delay() |
  67. +-----------+------------------------------+
  68. The delay after which the automatic restart is triggered, in seconds.
  69. ----
  70. .. _class_AnimationNodeOneShot_property_autorestart_random_delay:
  71. - :ref:`float<class_float>` **autorestart_random_delay**
  72. +-----------+-------------------------------------+
  73. | *Default* | ``0.0`` |
  74. +-----------+-------------------------------------+
  75. | *Setter* | set_autorestart_random_delay(value) |
  76. +-----------+-------------------------------------+
  77. | *Getter* | get_autorestart_random_delay() |
  78. +-----------+-------------------------------------+
  79. If :ref:`autorestart<class_AnimationNodeOneShot_property_autorestart>` is ``true``, a random additional delay (in seconds) between 0 and this value will be added to :ref:`autorestart_delay<class_AnimationNodeOneShot_property_autorestart_delay>`.
  80. ----
  81. .. _class_AnimationNodeOneShot_property_fadein_time:
  82. - :ref:`float<class_float>` **fadein_time**
  83. +-----------+------------------------+
  84. | *Default* | ``0.1`` |
  85. +-----------+------------------------+
  86. | *Setter* | set_fadein_time(value) |
  87. +-----------+------------------------+
  88. | *Getter* | get_fadein_time() |
  89. +-----------+------------------------+
  90. ----
  91. .. _class_AnimationNodeOneShot_property_fadeout_time:
  92. - :ref:`float<class_float>` **fadeout_time**
  93. +-----------+-------------------------+
  94. | *Default* | ``0.1`` |
  95. +-----------+-------------------------+
  96. | *Setter* | set_fadeout_time(value) |
  97. +-----------+-------------------------+
  98. | *Getter* | get_fadeout_time() |
  99. +-----------+-------------------------+
  100. ----
  101. .. _class_AnimationNodeOneShot_property_sync:
  102. - :ref:`bool<class_bool>` **sync**
  103. +-----------+---------------------+
  104. | *Default* | ``false`` |
  105. +-----------+---------------------+
  106. | *Setter* | set_use_sync(value) |
  107. +-----------+---------------------+
  108. | *Getter* | is_using_sync() |
  109. +-----------+---------------------+
  110. Method Descriptions
  111. -------------------
  112. .. _class_AnimationNodeOneShot_method_get_mix_mode:
  113. - :ref:`MixMode<enum_AnimationNodeOneShot_MixMode>` **get_mix_mode** **(** **)** |const|
  114. ----
  115. .. _class_AnimationNodeOneShot_method_set_mix_mode:
  116. - void **set_mix_mode** **(** :ref:`MixMode<enum_AnimationNodeOneShot_MixMode>` mode **)**
  117. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  118. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  119. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`