Outdated documentation
This documentation page refers to Godot
4.3,
and may be outdated or incorrect.
Additionally, this engine version is
no longer supported.
Check this page in the stable branch for the latest additions and corrections.
SpriteFrames
Inherits: Resource < RefCounted < Object
Sprite frame library for AnimatedSprite2D and AnimatedSprite3D.
Description
Sprite frame library for an AnimatedSprite2D or AnimatedSprite3D node. Contains frames and animation data for playback.
Methods
void |
add_animation(anim: StringName) |
void |
add_frame(anim: StringName, texture: Texture2D, duration: float = 1.0, at_position: int = -1) |
void |
clear(anim: StringName) |
void |
|
get_animation_loop(anim: StringName) const |
|
get_animation_names() const |
|
get_animation_speed(anim: StringName) const |
|
get_frame_count(anim: StringName) const |
|
get_frame_duration(anim: StringName, idx: int) const |
|
get_frame_texture(anim: StringName, idx: int) const |
|
has_animation(anim: StringName) const |
|
void |
remove_animation(anim: StringName) |
void |
remove_frame(anim: StringName, idx: int) |
void |
rename_animation(anim: StringName, newname: StringName) |
void |
set_animation_loop(anim: StringName, loop: bool) |
void |
set_animation_speed(anim: StringName, fps: float) |
void |
set_frame(anim: StringName, idx: int, texture: Texture2D, duration: float = 1.0) |
Method Descriptions
void add_animation(anim: StringName) 🔗
Adds a new anim animation to the library.
void add_frame(anim: StringName, texture: Texture2D, duration: float = 1.0, at_position: int = -1) 🔗
Adds a frame to the anim animation. If at_position is -1, the frame will be added to the end of the animation. duration specifies the relative duration, see get_frame_duration for details.
void clear(anim: StringName) 🔗
Removes all frames from the anim animation.
void clear_all() 🔗
Removes all animations. An empty default animation will be created.
bool get_animation_loop(anim: StringName) const 🔗
Returns true if the given animation is configured to loop when it finishes playing. Otherwise, returns false.
PackedStringArray get_animation_names() const 🔗
Returns an array containing the names associated to each animation. Values are placed in alphabetical order.
float get_animation_speed(anim: StringName) const 🔗
Returns the speed in frames per second for the anim animation.
int get_frame_count(anim: StringName) const 🔗
Returns the number of frames for the anim animation.
float get_frame_duration(anim: StringName, idx: int) const 🔗
Returns a relative duration of the frame idx in the anim animation (defaults to 1.0). For example, a frame with a duration of 2.0 is displayed twice as long as a frame with a duration of 1.0. You can calculate the absolute duration (in seconds) of a frame using the following formula:
absolute_duration = relative_duration / (animation_fps * abs(playing_speed))
In this example, playing_speed refers to either AnimatedSprite2D.get_playing_speed or AnimatedSprite3D.get_playing_speed.
Texture2D get_frame_texture(anim: StringName, idx: int) const 🔗
Returns the texture of the frame idx in the anim animation.
bool has_animation(anim: StringName) const 🔗
Returns true if the anim animation exists.
void remove_animation(anim: StringName) 🔗
Removes the anim animation.
void remove_frame(anim: StringName, idx: int) 🔗
Removes the anim animation's frame idx.
void rename_animation(anim: StringName, newname: StringName) 🔗
Changes the anim animation's name to newname.
void set_animation_loop(anim: StringName, loop: bool) 🔗
If loop is true, the anim animation will loop when it reaches the end, or the start if it is played in reverse.
void set_animation_speed(anim: StringName, fps: float) 🔗
Sets the speed for the anim animation in frames per second.
void set_frame(anim: StringName, idx: int, texture: Texture2D, duration: float = 1.0) 🔗
Sets the texture and the duration of the frame idx in the anim animation. duration specifies the relative duration, see get_frame_duration for details.