Attention: Here be dragons

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

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¶

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¶

StringName animation = &""

void set_animation(value: StringName)
StringName get_animation()

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

LoopMode loop_mode

void set_loop_mode(value: LoopMode)
LoopMode get_loop_mode()

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

PlayMode play_mode = 0

void set_play_mode(value: PlayMode)
PlayMode get_play_mode()

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.

User-contributed notes

Please read the User-contributed notes policy before submitting a comment.