跳转至

AnimatedSprite

继承

Node2D

简要描述

使用多个纹理进行动画处理的精灵(Sprite)节点。

描述

使用SpriteFrames资源创建动画,可以在编辑器中通过SpriteFrames面板对其进行配置。

成员

类型 属性名 默认值
String 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 speed_scale 1.0

方法

返回值类型 方法名称
bool is_playing() const
void play(anim: String = "", backwards: bool = false)
void stop()

信号

  • animation_finished

动画结束时(播放最后一帧时)发出。如果动画播放会循环播放,则每到最后一帧都会发送一次信号。


  • frame_changed

frame更改时发出。


常量

成员说明

  • String animation
Default "default"
setter set_animation(value)
getter get_animation
  • bool centered
Default true
setter set_centered(value)
getter is_centered
  • bool flip_h
Default false
setter set_flip_h(value)
getter is_flipped_h
  • bool flip_v
Default false
setter set_flip_v(value)
getter is_flipped_v
  • int frame
Default 0
setter set_frame(value)
getter get_frame
  • SpriteFrames frames
setter set_sprite_frames(value)
getter get_sprite_frames
  • Vector2 offset
Default Vector2( 0, 0 )
setter set_offset(value)
getter get_offset
  • bool playing
Default false
setter _set_playing(value)
getter _is_playing
  • float speed_scale
Default 1.0
setter set_speed_scale(value)
getter get_speed_scale

方法说明

  • is_playing is_playing() const

如果当前正在播放动画,则返回true


  • play play(anim: String = "", backwards: bool = false)

播放名为anim的动画。如果没有提供anim,则播放当前动画。如果backwardstrue,则动画将被倒放。


  • stop stop()

停止当前动画(不重置帧计数器)。