godot-docs/classes/class_spriteframes.rst

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the SpriteFrames.xml source instead.
.. The source is found in doc/classes or modules/<name>/doc_classes.

.. _class_SpriteFrames:

SpriteFrames
============

**Inherits:** :ref:`Resource<class_resource>` **<** :ref:`Reference<class_reference>` **<** :ref:`Object<class_object>`

**Category:** Core

Brief Description
-----------------

Sprite frame library for AnimatedSprite.

Member Functions
----------------

+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`add_animation<class_SpriteFrames_add_animation>` **(** :ref:`String<class_string>` anim **)**                                                                    |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`add_frame<class_SpriteFrames_add_frame>` **(** :ref:`String<class_string>` anim, :ref:`Texture<class_texture>` frame, :ref:`int<class_int>` at_position=-1 **)** |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`clear<class_SpriteFrames_clear>` **(** :ref:`String<class_string>` anim **)**                                                                                    |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`clear_all<class_SpriteFrames_clear_all>` **(** **)**                                                                                                             |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`        | :ref:`get_animation_loop<class_SpriteFrames_get_animation_loop>` **(** :ref:`String<class_string>` anim **)** const                                                    |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`      | :ref:`get_animation_speed<class_SpriteFrames_get_animation_speed>` **(** :ref:`String<class_string>` anim **)** const                                                  |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Texture<class_texture>`  | :ref:`get_frame<class_SpriteFrames_get_frame>` **(** :ref:`String<class_string>` anim, :ref:`int<class_int>` idx **)** const                                           |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>`          | :ref:`get_frame_count<class_SpriteFrames_get_frame_count>` **(** :ref:`String<class_string>` anim **)** const                                                          |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`        | :ref:`has_animation<class_SpriteFrames_has_animation>` **(** :ref:`String<class_string>` anim **)** const                                                              |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`remove_animation<class_SpriteFrames_remove_animation>` **(** :ref:`String<class_string>` anim **)**                                                              |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`remove_frame<class_SpriteFrames_remove_frame>` **(** :ref:`String<class_string>` anim, :ref:`int<class_int>` idx **)**                                           |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`rename_animation<class_SpriteFrames_rename_animation>` **(** :ref:`String<class_string>` anim, :ref:`String<class_string>` newname **)**                         |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`set_animation_loop<class_SpriteFrames_set_animation_loop>` **(** :ref:`String<class_string>` anim, :ref:`bool<class_bool>` loop **)**                            |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`set_animation_speed<class_SpriteFrames_set_animation_speed>` **(** :ref:`String<class_string>` anim, :ref:`float<class_float>` speed **)**                       |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| void                           | :ref:`set_frame<class_SpriteFrames_set_frame>` **(** :ref:`String<class_string>` anim, :ref:`int<class_int>` idx, :ref:`Texture<class_texture>` txt **)**              |
+--------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Member Variables
----------------

  .. _class_SpriteFrames_frames:

- :ref:`Array<class_array>` **frames**


Description
-----------

Sprite frame library for :ref:`AnimatedSprite<class_animatedsprite>`. Contains frames and animation data for playback.

Member Function Description
---------------------------

.. _class_SpriteFrames_add_animation:

- void **add_animation** **(** :ref:`String<class_string>` anim **)**

Adds a new animation to the the library.

.. _class_SpriteFrames_add_frame:

- void **add_frame** **(** :ref:`String<class_string>` anim, :ref:`Texture<class_texture>` frame, :ref:`int<class_int>` at_position=-1 **)**

Adds a frame to the given animation.

.. _class_SpriteFrames_clear:

- void **clear** **(** :ref:`String<class_string>` anim **)**

Removes all frames from the given animation.

.. _class_SpriteFrames_clear_all:

- void **clear_all** **(** **)**

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

.. _class_SpriteFrames_get_animation_loop:

- :ref:`bool<class_bool>` **get_animation_loop** **(** :ref:`String<class_string>` anim **)** const

If ``true`` the given animation will loop.

.. _class_SpriteFrames_get_animation_speed:

- :ref:`float<class_float>` **get_animation_speed** **(** :ref:`String<class_string>` anim **)** const

The animation's speed in frames per second.

.. _class_SpriteFrames_get_frame:

- :ref:`Texture<class_texture>` **get_frame** **(** :ref:`String<class_string>` anim, :ref:`int<class_int>` idx **)** const

Returns the animation's selected frame.

.. _class_SpriteFrames_get_frame_count:

- :ref:`int<class_int>` **get_frame_count** **(** :ref:`String<class_string>` anim **)** const

Returns the number of frames in the animation.

.. _class_SpriteFrames_has_animation:

- :ref:`bool<class_bool>` **has_animation** **(** :ref:`String<class_string>` anim **)** const

If ``true`` the named animation exists.

.. _class_SpriteFrames_remove_animation:

- void **remove_animation** **(** :ref:`String<class_string>` anim **)**

Removes the given animation.

.. _class_SpriteFrames_remove_frame:

- void **remove_frame** **(** :ref:`String<class_string>` anim, :ref:`int<class_int>` idx **)**

Removes the animation's selected frame.

.. _class_SpriteFrames_rename_animation:

- void **rename_animation** **(** :ref:`String<class_string>` anim, :ref:`String<class_string>` newname **)**

Changes the animation's name to ``newname``.

.. _class_SpriteFrames_set_animation_loop:

- void **set_animation_loop** **(** :ref:`String<class_string>` anim, :ref:`bool<class_bool>` loop **)**

If ``true`` the animation will loop.

.. _class_SpriteFrames_set_animation_speed:

- void **set_animation_speed** **(** :ref:`String<class_string>` anim, :ref:`float<class_float>` speed **)**

The animation's speed in frames per second.

.. _class_SpriteFrames_set_frame:

- void **set_frame** **(** :ref:`String<class_string>` anim, :ref:`int<class_int>` idx, :ref:`Texture<class_texture>` txt **)**

Sets the texture of the given frame.