Tutorial

Watch this tutorial to get started using sheetah.

User Interface

# Help
1. Hyperlink to online documentation
2. Hyperlink to online documentation
# Spritesheet Tools
3. Renders selected comp as Spritesheet
4. Export formats (png, tga, tif)
# Animation Tools
5. Setup for active layer (comp or footage)
6. Frame sequence export of active layer
7. Frame sequence output field
8. Option to save frame sequence as .txt file

Spritesheet Tools

The Spritesheet Tools are the main feature of this extension.
The goal was to simplify creating spritesheets as much as possible.

Step 1: Choose your export format

Select the preferred export format for your spritesheet. At the moment the available formats are png,tga and tif. The script will automatically export the alpha channel to make your life easier. Sheetah will remember the selected format so you do not need to setup this option again.

Step 2: Render Composition as Spritesheet

After creating your animation select your composition and click the scripts "Save Spritesheet" button. The script will attempt to create a single image containing all frames of the composition. A dialog will prompt you to type in a filename. Sheetah will try to auto generate a suitable name using this schema:

[comp_name]_[frame_width]x[frame_height]px.[extension]

Sheetah automatically calculates the best possible pattern for the amount of rows and columns of the spritesheet. This means you do not need to set these values manually, yay!

Animation Tools

The Animation Tools have been developed to generate custom animation sequences based on your spritesheet. These are used especially in 2D or 3D games. Instead of simple forward or backwards playback you decide in which order frames ar played back. This is often done using comma separated frame sequences eg.: 1,2,2,2,3,3,4,5...

In a nutshell these sequences give artists the flexibility to recycle their spritesheet to generate more complex animations.

Step 1: Setup a composition for animation

Start by selecting the composition containing your animation. Now wrap this composition in a new empty composition to start creating your custom sequence. Select the composition layer and click "Setup Animation".

The script will add a Slider Control Effect among some other things. After its finished you can start creating your custom animation sequence by animating the Slider value. The Slider value represents the actual frame number of your composition.

Step 2: Export custom animation sequence

After you are satisfied with your custom animation sequence use the "Export Keyframes" button to export your frame sequence as comma seperated frame numbers.

The result will be shown in the text field under the button. It will be repopulated everytime you click "Export Keyframes". To select all keyframes click into the textfield and hit strg+a on Windows or ⌘+a on Mac.

The animation sequence can be exported as a .txt file as well. Simply click the corresponding checkbox. Everytime you click "Export Keyframes" the script will prompt you for a filename and export a .txt file containing your custom sequence.