Attention: Here be dragons (unstable version)

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Redot.

Checking the stable version of the documentation...

AnimationNodeAnimation

Inherits: AnimationRootNode < AnimationNode < Resource < RefCounted < Object

An input animation for an AnimationNodeBlendTree.

Description

A resource to add to an AnimationNodeBlendTree. Only has one output port using the animation property. Used as an input for AnimationNodes that blend animations together.

Tutorials

Properties

bool

advance_on_start

false

StringName

animation

&""

LoopMode

loop_mode

PlayMode

play_mode

0

float

start_offset

bool

stretch_time_scale

float

timeline_length

bool

use_custom_timeline

false

Enumerations

enum PlayMode: 🔗

PlayMode PLAY_MODE_FORWARD = 0

Plays animation in forward direction.

PlayMode PLAY_MODE_BACKWARD = 1

Plays animation in backward direction.

Property Descriptions

bool advance_on_start = false 🔗

  • void set_advance_on_start(value: bool)

  • bool is_advance_on_start()

If true, on receiving a request to play an animation from the start, the first frame is not drawn, but only processed, and playback starts from the next frame.

See also the notes of AnimationPlayer.play.

StringName animation = &"" 🔗

Animation to use as an output. It is one of the animations provided by AnimationTree.anim_player.

LoopMode loop_mode 🔗

If use_custom_timeline is true, override the loop settings of the original Animation resource with the value.

Note: If the Animation.loop_mode isn't set to looping, the Animation.track_set_interpolation_loop_wrap option will not be respected. If you cannot get the expected behavior, consider duplicating the Animation resource and changing the loop settings.

PlayMode play_mode = 0 🔗

Determines the playback direction of the animation.

float start_offset 🔗

  • void set_start_offset(value: float)

  • float get_start_offset()

If use_custom_timeline is true, offset the start position of the animation.

This is useful for adjusting which foot steps first in 3D walking animations.

bool stretch_time_scale 🔗

  • void set_stretch_time_scale(value: bool)

  • bool is_stretching_time_scale()

If true, scales the time so that the length specified in timeline_length is one cycle.

This is useful for matching the periods of walking and running animations.

If false, the original animation length is respected. If you set the loop to loop_mode, the animation will loop in timeline_length.

float timeline_length 🔗

  • void set_timeline_length(value: float)

  • float get_timeline_length()

If use_custom_timeline is true, offset the start position of the animation.

bool use_custom_timeline = false 🔗

  • void set_use_custom_timeline(value: bool)

  • bool is_using_custom_timeline()

If true, AnimationNode provides an animation based on the Animation resource with some parameters adjusted.