AtlasContainer

An animation player using a TextureRect to display an AtlasTexture. An addon for the Godot engine.

• Description
• Installation
• Usage
• Signals
• Functions
• Properties
• Issues

Description

Similar to the AnimatedSprite node, AtlasPlayer is a way to animate an atlas or a sprite sheet. The difference in benefit comes from the adjustable size of AtlasPlayer. In other words, it can be used for UI purposes such as loading screen or even gifs! In truth, it all comes down to what your project is. If this addon fits your need, might as well try it out.

Installation

1. Download the latest version in releases or clone the repository.
2. Copy the contents of addons/AtlasPlayer into your res://addons/AtlasPlayer directory.
3. Enable Dialogue Manager in your project plugins.

Usage

1. Create an AtlasPlayer in the current scene and modify the properties in the inspector.
2. Set an image for the Atlas Texture. Recommended to drag and drop the image directly in the inspector.
3. Based on the number of tiles, set the Hframe for width and Vframe for height.
   Example: a character sprite with six tiles of movement, with a width of three (3) tiles and height of two (2).
   The Hframe in the scenario would be three (3) and the Vframe would be two (2).
4. Set the Start Frame and the End Frame. The starting and ending point of the animation.
5. Adjust the Speed of the player to best fit the animation.
6. Before moving to the next step, it is recommended to turn on the Auto Start. Otherwise, use the start() function of the node to play the animation.
7. Play the scene and see if the sprite plays properly.

Note: the instructions can also be applied in code. See the script for more details such as the start() and stop() function.

Signals

Functions

Properties

Issues

• None as of current...

Said issues may be fixed in the future updates. However, if you know a way to fix it, do open up an issue or a pull request. Your contribution would be greatly apprciated