What?

A simple sprite sheet generator for the command line on Windows and Linux.

SSSprites takes a directory of PNGs / JPGs / BMPs / TGAs and puts them into a sprite sheet. Files with other extensions are ignored. The same image formats are supported for output.

Example:

C:\>sssprites C:\images\hero_animation -out:C:\project\game\assets\sprites\hero_animation.png
REM use the working directory as the source for images if no directory is given
C:\images\hero_animation>sssprites -out:C:\project\game\assets\sprites\hero_animation.png

Why?

Surprisingly there seem to be very few usable sprite sheet generators for the command line, so I wrote this one. I guess nowadays big engines have their own tools for this and you could also make them manually or with relatively bad plugins for image editors, but I wanted something that could be easily integrated with the build script of my game projects, so here we are.

Limitations

Only square images are supported as output

... and the output size and number of channels are guessed by the number of image files in the input directory and the size of the first image file

Examples:

• 4 files, first image: 128x128px, 3ch -> output image: 256x256pixels, 3ch
• 9 files, first image: 128x128px, 3ch -> output image: 384x384pixels, 3ch
• 5 files, first image: 128x128px, 3ch -> output image: 384x384pixels, 3ch

No way to manually specify the order of the images

The OS must provide the images in the right order, which usually means that the files must be named for alphabetical sorting.

All input images must be the same size, same number of channels, etc.

... otherwise an error will occur. This means either all images have an alpha channel or none of them do!