AnimatedSprite

Inherits: Node2D < CanvasItem < Node < Object

Sprite node that can use multiple textures for animation.

Description

Animations are created using a SpriteFrames resource, which can be configured in the editor via the SpriteFrames panel.

Properties

StringName

animation

@"default"

bool

centered

true

bool

flip_h

false

bool

flip_v

false

int

frame

0

SpriteFrames

frames

Vector2

offset

Vector2( 0, 0 )

bool

playing

false

float

shininess

1.0

Color

specular_color

Color( 1, 1, 1, 1 )

float

speed_scale

1.0

Methods

bool

is_playing ( ) const

void

play ( StringName anim=@"", bool backwards=false )

void

stop ( )

Signals

  • animation_finished ( )

Emitted when the animation is finished (when it plays the last frame). If the animation is looping, this signal is emitted every time the last frame is drawn.


  • frame_changed ( )

Emitted when frame changed.

Property Descriptions

Default

@"default"

Setter

set_animation(value)

Getter

get_animation()

The current animation from the frames resource. If this value changes, the frame counter is reset.


Default

true

Setter

set_centered(value)

Getter

is_centered()

If true, texture will be centered.


Default

false

Setter

set_flip_h(value)

Getter

is_flipped_h()

If true, texture is flipped horizontally.


Default

false

Setter

set_flip_v(value)

Getter

is_flipped_v()

If true, texture is flipped vertically.


Default

0

Setter

set_frame(value)

Getter

get_frame()

The displayed animation frame's index.


Setter

set_sprite_frames(value)

Getter

get_sprite_frames()

The SpriteFrames resource containing the animation(s).


Default

Vector2( 0, 0 )

Setter

set_offset(value)

Getter

get_offset()

The texture's drawing offset.


Default

false

If true, the animation is currently playing.


Default

1.0

Setter

set_shininess(value)

Getter

get_shininess()

Strength of the specular light effect of this AnimatedSprite.


Default

Color( 1, 1, 1, 1 )

Setter

set_specular_color(value)

Getter

get_specular_color()

The color of the specular light effect.


Default

1.0

Setter

set_speed_scale(value)

Getter

get_speed_scale()

The animation speed is multiplied by this value.

Method Descriptions

  • bool is_playing ( ) const

Returns true if an animation is currently being played.


Plays the animation named anim. If no anim is provided, the current animation is played. If backwards is true, the animation will be played in reverse.


  • void stop ( )

Stops the current animation (does not reset the frame counter).