2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2020-03-30 18:22:57 +02:00
<class name= "AnimatedSprite2D" inherits= "Node2D" version= "4.0" >
2017-09-12 22:42:36 +02:00
<brief_description >
Sprite node that can use multiple textures for animation.
</brief_description>
<description >
2017-10-06 18:33:16 +02:00
Animations are created using a [SpriteFrames] resource, which can be configured in the editor via the SpriteFrames panel.
2020-07-10 21:52:16 +02:00
[b]Note:[/b] You can associate a set of normal or specular maps by creating additional [SpriteFrames] resources with a [code]_normal[/code] or [code]_specular[/code] suffix. For example, having 3 [SpriteFrames] resources [code]run[/code], [code]run_normal[/code], and [code]run_specular[/code] will make it so the [code]run[/code] animation uses normal and specular maps.
2017-09-12 22:42:36 +02:00
</description>
<tutorials >
2020-08-21 14:25:12 +02:00
<link title= "2D Sprite animation" > https://docs.godotengine.org/en/latest/tutorials/2d/2d_sprite_animation.html</link>
2020-10-01 10:34:47 +02:00
<link title= "2D Dodge The Creeps Demo" > https://godotengine.org/asset-library/asset/515</link>
2017-09-12 22:42:36 +02:00
</tutorials>
<methods >
<method name= "is_playing" qualifiers= "const" >
<return type= "bool" >
</return>
<description >
2019-06-22 01:04:47 +02:00
Returns [code]true[/code] if an animation is currently being played.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "play" >
<return type= "void" >
</return>
2020-02-22 14:59:09 +01:00
<argument index= "0" name= "anim" type= "StringName" default= "@""" >
2017-09-12 22:42:36 +02:00
</argument>
2019-04-15 14:49:41 +02:00
<argument index= "1" name= "backwards" type= "bool" default= "false" >
</argument>
2017-09-12 22:42:36 +02:00
<description >
2019-06-22 01:04:47 +02:00
Plays the animation named [code]anim[/code]. If no [code]anim[/code] is provided, the current animation is played. If [code]backwards[/code] is [code]true[/code], the animation will be played in reverse.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "stop" >
<return type= "void" >
</return>
<description >
2019-06-22 01:04:47 +02:00
Stops the current animation (does not reset the frame counter).
2017-09-12 22:42:36 +02:00
</description>
</method>
</methods>
<members >
2020-02-22 14:59:09 +01:00
<member name= "animation" type= "StringName" setter= "set_animation" getter= "get_animation" default= "@"default"" >
2017-10-06 18:33:16 +02:00
The current animation from the [code]frames[/code] resource. If this value changes, the [code]frame[/code] counter is reset.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "centered" type= "bool" setter= "set_centered" getter= "is_centered" default= "true" >
2019-06-29 15:24:23 +02:00
If [code]true[/code], texture will be centered.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "flip_h" type= "bool" setter= "set_flip_h" getter= "is_flipped_h" default= "false" >
2019-06-29 15:24:23 +02:00
If [code]true[/code], texture is flipped horizontally.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "flip_v" type= "bool" setter= "set_flip_v" getter= "is_flipped_v" default= "false" >
2019-06-29 15:24:23 +02:00
If [code]true[/code], texture is flipped vertically.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "frame" type= "int" setter= "set_frame" getter= "get_frame" default= "0" >
2017-10-06 18:33:16 +02:00
The displayed animation frame's index.
2017-09-12 22:42:36 +02:00
</member>
2019-07-15 20:42:47 +02:00
<member name= "frames" type= "SpriteFrames" setter= "set_sprite_frames" getter= "get_sprite_frames" >
2017-09-27 07:56:16 +02:00
The [SpriteFrames] resource containing the animation(s).
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "offset" type= "Vector2" setter= "set_offset" getter= "get_offset" default= "Vector2( 0, 0 )" >
2017-09-27 07:56:16 +02:00
The texture's drawing offset.
2017-09-12 22:42:36 +02:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "playing" type= "bool" setter= "_set_playing" getter= "_is_playing" default= "false" >
2018-12-20 13:46:54 +01:00
If [code]true[/code], the [member animation] is currently playing.
2017-09-12 22:42:36 +02:00
</member>
2020-02-12 09:59:06 +01:00
<member name= "shininess" type= "float" setter= "set_shininess" getter= "get_shininess" default= "1.0" >
2020-03-30 18:22:57 +02:00
Strength of the specular light effect of this [AnimatedSprite2D].
2020-02-12 09:59:06 +01:00
</member>
<member name= "specular_color" type= "Color" setter= "set_specular_color" getter= "get_specular_color" default= "Color( 1, 1, 1, 1 )" >
2020-03-03 19:21:21 +01:00
The color of the specular light effect.
2020-02-12 09:59:06 +01:00
</member>
2019-06-29 12:38:01 +02:00
<member name= "speed_scale" type= "float" setter= "set_speed_scale" getter= "get_speed_scale" default= "1.0" >
2019-05-08 04:45:49 +02:00
The animation speed is multiplied by this value.
2018-05-12 09:38:00 +02:00
</member>
2017-09-12 22:42:36 +02:00
</members>
<signals >
<signal name= "animation_finished" >
<description >
2017-09-27 07:56:16 +02:00
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.
2017-09-12 22:42:36 +02:00
</description>
</signal>
<signal name= "frame_changed" >
<description >
2017-10-06 18:33:16 +02:00
Emitted when [member frame] changed.
2017-09-12 22:42:36 +02:00
</description>
</signal>
</signals>
<constants >
</constants>
</class>