SpriteFrames

Inherits: Resource < Reference < Object

Sprite frame library for AnimatedSprite.

Description

Sprite frame library for AnimatedSprite. Contains frames and animation data for playback.

Note: You can associate a set of normal maps by creating additional SpriteFrames resources with a _normal suffix. For example, having 2 SpriteFrames resources run and run_normal will make it so the run animation uses the normal map.

Properties

Array frames

Methods

void add_animation ( String anim )
void add_frame ( String anim, Texture frame, int at_position=-1 )
void clear ( String anim )
void clear_all ( )
bool get_animation_loop ( String anim ) const
PoolStringArray get_animation_names ( ) const
float get_animation_speed ( String anim ) const
Texture get_frame ( String anim, int idx ) const
int get_frame_count ( String anim ) const
bool has_animation ( String anim ) const
void remove_animation ( String anim )
void remove_frame ( String anim, int idx )
void rename_animation ( String anim, String newname )
void set_animation_loop ( String anim, bool loop )
void set_animation_speed ( String anim, float speed )
void set_frame ( String anim, int idx, Texture txt )

Property Descriptions

Array frames

Compatibility property, always equals to an empty array.

Method Descriptions

void add_animation ( String anim )

Adds a new animation to the library.

void add_frame ( String anim, Texture frame, int at_position=-1 )

Adds a frame to the given animation.

void clear ( String anim )

Removes all frames from the given animation.

void clear_all ( )

Removes all animations. A "default" animation will be created.

bool get_animation_loop ( String anim ) const

If true, the given animation will loop.

PoolStringArray get_animation_names ( ) const

Returns an array containing the names associated to each animation. Values are placed in alphabetical order.

float get_animation_speed ( String anim ) const

The animation's speed in frames per second.

Texture get_frame ( String anim, int idx ) const

Returns the animation's selected frame.

int get_frame_count ( String anim ) const

Returns the number of frames in the animation.

bool has_animation ( String anim ) const

If true, the named animation exists.

void remove_animation ( String anim )

Removes the given animation.

void remove_frame ( String anim, int idx )

Removes the animation's selected frame.

void rename_animation ( String anim, String newname )

Changes the animation's name to newname.

void set_animation_loop ( String anim, bool loop )

If true, the animation will loop.

void set_animation_speed ( String anim, float speed )

The animation's speed in frames per second.

void set_frame ( String anim, int idx, Texture txt )

Sets the texture of the given frame.

© 2014–2020 Juan Linietsky, Ariel Manzur, Godot Engine contributors
Licensed under the MIT License.
https://docs.godotengine.org/en/3.2/classes/class_spriteframes.html