AnimationNodeOneShot

继承： AnimationNodeSync < AnimationNode < Resource < RefCounted < Object

在 AnimationNodeBlendTree 中播放一次动画。

描述

添加到 AnimationNodeBlendTree 的资源。这个动画节点将执行子动画并在完成后返回。可以自定义淡入和淡出的混合时间以及过滤器。

在设置请求并更改动画播放后，一次性节点会在下一个处理帧中通过将其 request 值设置为 ONE_SHOT_REQUEST_NONE 来自动清除请求。

GDScriptC#

  1. # 播放连接到 “shot” 端口的子动画。
  2. animation_tree.set("parameters/OneShot/request", AnimationNodeOneShot.ONE_SHOT_REQUEST_FIRE)
  3. # 替代语法（与上述结果相同）。
  4. animation_tree["parameters/OneShot/request"] = AnimationNodeOneShot.ONE_SHOT_REQUEST_FIRE
  6. # 中止连接到 “shot” 端口的子动画。
  7. animation_tree.set("parameters/OneShot/request", AnimationNodeOneShot.ONE_SHOT_REQUEST_ABORT)
  8. # 替代语法（与上述结果相同）。
  9. animation_tree["parameters/OneShot/request"] = AnimationNodeOneShot.ONE_SHOT_REQUEST_FADE_OUT
  11. # 使用淡出的方法中止连接到 “shot”端口的子动画。
  12. animation_tree.set("parameters/OneShot/request", AnimationNodeOneShot.ONE_SHOT_REQUEST_FADE_OUT)
  13. # 替代语法（与上述结果相同）。
  14. animation_tree["parameters/OneShot/request"] = AnimationNodeOneShot.ONE_SHOT_REQUEST_FADE_OUT
  16. # 获取当前状态（只读）。
  17. animation_tree.get("parameters/OneShot/active"))
  18. # 替代语法（与上述结果相同）。
  19. animation_tree["parameters/OneShot/active"]
  21. # 获取当前内部状态（只读）。
  22. animation_tree.get("parameters/OneShot/internal_active")
  23. # 替代语法（与上述结果相同）。
  24. animation_tree["parameters/OneShot/internal_active"]
  1. // 播放连接到 “shot” 端口的子动画。
  2. animationTree.Set("parameters/OneShot/request", (int)AnimationNodeOneShot.OneShotRequest.Fire);
  4. // 中止连接到 “shot” 端口的子动画。
  5. animationTree.Set("parameters/OneShot/request", (int)AnimationNodeOneShot.OneShotRequest.Abort);
  7. // 使用淡出的方法中止连接到 “shot”端口的子动画。
  8. animationTree.Set("parameters/OneShot/request", (int)AnimationNodeOneShot.OneShotRequest.FadeOut);
  10. // 获取当前状态（只读）。
  11. animationTree.Get("parameters/OneShot/active");
  13. // 获取当前内部状态（只读）。
  14. animationTree.Get("parameters/OneShot/internal_active");

教程

属性

bool

autorestart

false

float

autorestart_delay

1.0

float

autorestart_random_delay

0.0

Curve

fadein_curve

float

fadein_time

0.0

Curve

fadeout_curve

float

fadeout_time

0.0

MixMode

mix_mode

0

枚举

enum OneShotRequest:

OneShotRequest ONE_SHOT_REQUEST_NONE = 0

请求的默认状态。未完成任何操作。

OneShotRequest ONE_SHOT_REQUEST_FIRE = 1

播放连接到“shot”端口的动画的请求。

OneShotRequest ONE_SHOT_REQUEST_ABORT = 2

停止连接到“shot”端口的动画的请求。

OneShotRequest ONE_SHOT_REQUEST_FADE_OUT = 3

淡出连接到“shot”端口的动画的请求。

enum MixMode:

MixMode MIX_MODE_BLEND = 0

混合两个动画。另请参见 AnimationNodeBlend2。

MixMode MIX_MODE_ADD = 1

以相加方式混合两个动画。另请参阅 AnimationNodeAdd2。

属性说明

bool autorestart = false

  • void set_autorestart ( bool value )

  • bool has_autorestart ( )

如果为 true，子动画结束后会自动重新开始。

换句话说，要开始自动重启，必须使用 ONE_SHOT_REQUEST_FIRE 请求播放一次动画。ONE_SHOT_REQUEST_ABORT 请求停止自动重启，但它不会禁用 autorestart 本身。因此，ONE_SHOT_REQUEST_FIRE 请求将再次开始自动重启。

float autorestart_delay = 1.0

  • void set_autorestart_delay ( float value )

  • float get_autorestart_delay ( )

触发自动重启的延迟时间，以秒为单位。

float autorestart_random_delay = 0.0

  • void set_autorestart_random_delay ( float value )

  • float get_autorestart_random_delay ( )

如果 autorestart 为 true，则介于0和此值之间的随机附加延迟（以秒为单位）将添加到 autorestart_delay。

Curve fadein_curve

  • void set_fadein_curve ( Curve value )

  • Curve get_fadein_curve ( )

确定如何缓动动画之间的淡入淡出。如果为空，过渡将是线性的。

float fadein_time = 0.0

  • void set_fadein_time ( float value )

  • float get_fadein_time ( )

淡入持续时间。例如，将此属性设置为 1.0，对于 5 秒长的动画，将在动画期间产生从 0 秒开始到 1 秒结束的交叉淡入淡出。

Curve fadeout_curve

  • void set_fadeout_curve ( Curve value )

  • Curve get_fadeout_curve ( )

确定如何缓动动画之间的淡入淡出。如果为空，过渡将是线性的。

float fadeout_time = 0.0

  • void set_fadeout_time ( float value )

  • float get_fadeout_time ( )

淡出持续时间。例如，将此属性设置为 1.0，对于 5 秒长的动画，将产生从 4 秒开始到 5 秒结束的交叉淡入淡出。

MixMode mix_mode = 0

混合类型。

Previous Next

© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.