A simple texture packer for combining sprites and animations into a single texture.
A simple white space separated text format with single character tags (similar to Wavefront .obj). A json format is also available.
- A
#introduces a comment. There are no inline comments. - An
itag followed by a file path relative to the text file gives the image texture the file describes. - An
stag is followed by the name of the sprite, the x and y coordinates of the sprite in the atlas, and a width and height. Depending on export options the x, y coordinates may also be normalized to be between [0.0, 1.0) or have the Y axis flipped. Sprites in the file are in the same order as they appear in the ‘Sprites’ panel. - An
atag defines an animation with a name and number of frames - A
ftag followed by the parent animation name, followed by the frame index and sprite index defines an animation frame. The sprite index corresponds to the order in which sprites are defined in the file.
.atlas (normalized)
# texture number of sprites
i texture.tga 2
# tag x y width height
s tile000 0.250000 0.374512 128.000000 128.000000
s tile001 0.125000 0.374512 128.000000 128.000000
# animation frames frame time
a idle 2 0.066000
# parent frame sprite index
f idle 0 0
f idle 1 1
.atlas (pixel coordinates)
i texture.tga 2
# tag x y w h
s tile000 256 1280 128 128
s tile001 128 1280 128 128
mkdir build
cd build
cmake ..
make
On Windows cmake will generate a visual C++ solution.
You can export multiple atlases at once by providing a .spritepack project file with the -export argument. This can be used to generate atlases automatically when building your game.
spritepacker -export untitled.spritepack