This is a simple command line tool to quickly create a spritesheet(texture atlas) from all images in a given folder. It outputs one big PNG image containing the sprites, and a .lua file containing the metadata for indexing them.
SpriteTinner can replace a more complex tool like TexturePacker, especially if you only need a basic spritesheet.
Sprites will have extra transparency removed to pack in tighter, with the original sizes listed in the metadata file. The metadata file is compatible with CoronaSDK, and it very easy to use with the LOVE game framework.
Official releases are hosted on github, along with the latest code.
git clone --recursive https://github.com/jessevanherk/sprite-tinner.git
SpriteTinner depends on:
- lua 5.1 (or higher)
- lua-filesystem
- lua-imlib2
- imlib2
On an Ubuntu system, you can install these by running:
sudo apt-get install lua5.1 lua-filesystem luarocks libimlib2 libimlib2-dev
sudo luarocks install lua-imlib2
Start the build by running:
make
Install the binary by running:
sudo make install
This will install the spritetinner executable into /usr/local/bin. You can move it somewhere else if you want.
spritetinner [-nc] [-h] [-p spritefile.png] [-m metafile.lua] -i imagedir
This will create a power-of-2 sized PNG image called spritefile.png, as well as metadata in metafile.lua, suitable for use by coronaSDK.
###OPTIONS:
- i: source image directory to parse. required.
- p: filename for output PNG file. default is output.png
- m: filename for output lua metadata file. default is output.lua
- nc: no autocropping of sprites, images used at full size
- h: show this help
All PNG images contained in imagedir will be included, recursively.
spritetinner -pimages/myspritesheet.png -mdata/myspritesheet.lua -i./images/
This will create 2 files:
- images/myspritesheet.png - contains all of the sprites in one big image
- data/myspritesheet.lua - contains info about each sprite, suitable for use by coronaSDK
- The only allowed input image format is PNG.
- only creates images with power-of-2 sizes. This is on purpose, for older video cards.
- some graphics cards don't play nicely with large texture atlases.
This is free software released under the MIT license. You can use it for almost anything, including commercial projects.
See the LICENSE file for full details.
Author: Jesse van Herk [email protected]
Based heavily on Jakesgordon's code from: https://github.com/jakesgordon/bin-packing/blob/master/js/packer.growing.js