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...

AnimatedSprite3D¶

Inherits: SpriteBase3D < GeometryInstance3D < VisualInstance3D < Node3D < Node < Object

2D sprite node in 3D world, that can use multiple 2D textures for animation.

Description¶

AnimatedSprite3D is similar to the Sprite3D node, except it carries multiple textures as animation sprite_frames. Animations are created using a SpriteFrames resource, which allows you to import image files (or a folder containing said files) to provide the animation frames for the sprite. The SpriteFrames resource can be configured in the editor via the SpriteFrames bottom panel.

Tutorials¶

2D Sprite animation (also applies to 3D)

Properties¶

StringName	animation	`&"default"`
String	autoplay	`""`
int	frame	`0`
float	frame_progress	`0.0`
float	speed_scale	`1.0`
SpriteFrames	sprite_frames

Methods¶

float	get_playing_speed ( ) const
bool	is_playing ( ) const
void	pause ( )
void	play ( StringName name=&"", float custom_speed=1.0, bool from_end=false )
void	play_backwards ( StringName name=&"" )
void	set_frame_and_progress ( int frame, float progress )
void	stop ( )

Signals¶

animation_changed ( )

Emitted when animation changes.

animation_finished ( )

Emitted when the animation reaches the end, or the start if it is played in reverse. When the animation finishes, it pauses the playback.

animation_looped ( )

Emitted when the animation loops.

frame_changed ( )

Emitted when frame changes.

sprite_frames_changed ( )

Emitted when sprite_frames changes.

Property Descriptions¶

StringName animation = &"default"

void set_animation ( StringName value )
StringName get_animation ( )

The current animation from the sprite_frames resource. If this value is changed, the frame counter and the frame_progress are reset.

String autoplay = ""