emote2ss

Animated webp to spritesheets converting tool
git clone git://bsandro.tech/emote2ss
Log | Files | Refs | README | LICENSE

README (1698B)


      1 emote2ss = 'Emote to SpriteSheet' utility.
      2 
      3 License: BSD 2-Clause.
      4 
      5 Simple tool to expand a given animated .webp into a spritesheet of given columns count-wide of lossless webp.
      6 
      7 There is a GUI version with a preview of the output sprite and a command-line utility that you can pass the column count as a command-line argument.
      8 
      9 CLI Usage:
     10 `emote2ss [-c COLUMNS] [-w MAX_WIDTH_PIXELS] [-o OUTPUT_FILE] file.webp`, e.g. `emote2ss -c 10 MyAnimationFile.webp` - expands animated file into a spritesheet of 10 frames wide.
     11 Other arguments:
     12 -w MAX_WIDTH - as alternative to columns it is possible to pass maximum spritesheet width in pixels. The utility will fit as many columns there as possible.
     13 -o OUTPUT_FILE - optional path+name for output file. If it is not set then the output file is named the same as the source with the prefix "atlas_", e.g. FlanClap.webp produces atlas_FlanClap.webp at the same directory as source.
     14 
     15 Note that at least one of the options -c or -w has to be set.
     16 
     17 GUI Usage: should be self-explanatory, it doesn't support command-line arguments as of yet.
     18 
     19 Dependencies:
     20 Libraries: libwebp and libwebpdemux.
     21 Bundled GUI toolkit: luigi - https://github.com/nakst/luigi
     22 
     23 Building prerequisities:
     24 Only libwebp/libwebpdemux, C99 compiler, standard pkg-config and GNU Makefile are needed.
     25 I've tested builds for GNU/Linux, OpenBSD, NetBSD and macOS.
     26 
     27 Windows builds are still WIP, it was sufficient to change '-DUI_LINUX' to '-DUI_WINDOWS' in gui/Makefile before but not after many changes in gui version.
     28 
     29 To build GUI tool run `make gui` or run make inside 'gui' folder.
     30 To build CLI tool run `make cli` or run make inside 'cli' folder.
     31 
     32 Or just run `make` to build everything.