|
1 | | -Spritify |
| 1 | +### About |
2 | 2 |
|
3 | | -When an animation render is complete, all of the frames in the animation are |
4 | | -compiled into a single spritesheet usable for sprite-based games. |
| 3 | +This [Blender](https://blender.org) add-on will compile all rendered frames from your animation into a very nice and configurable sprite sheet, that's usable for sprite-based video games and even in modern cool websites. |
| 4 | +It can also generate animated gifs, allowing you to easily showcase and preview animations without needing to use any code at all, which usually comes in very handy. |
5 | 5 |
|
6 | | -There is a Spritify panel in Render Properties where you configure some of the |
7 | | -attributes of the sprite sheet as well as enable/disable the ability to |
8 | | -automatically generate a sprite sheet each time an animation render completes. |
| 6 | +It was originally developed for use in the amazing [Ancient Beast](https://AncientBeast.com) eSport game project but sharing is caring! 🌟 |
| 7 | + |
| 8 | +### Requirements |
| 9 | + |
| 10 | +This add-on requires that you have [ImageMagick](https://imagemagick.org) installed on your computer and the montage command is in your system path. |
| 11 | +It also assumes that you're rendering a sequence of still frames. Video renders will not work, so keep that in mind. |
9 | 12 |
|
10 | | -As of version 0.4.0, Spritify will also optionally generate an animated GIF. |
| 13 | +### Installation |
11 | 14 |
|
12 | | -Originally developed for use in the Ancient Beast (http://www.ancientbeast.com/) |
13 | | -project. |
| 15 | +1. Go to `Edit` / `Preferences` / `Add-ons` and click `Install...` |
| 16 | +2. Use the `File Browser` to find `spritify.py` on your hard drive |
| 17 | +3. Double-click or select the file and click `Install Add on...` |
| 18 | +4. Use the `Add-ons browser` to find and enable `Spritify` (from `Render` category) |
14 | 19 |
|
15 | | -More complete documentation can be found in Blender's add-ons Catalog |
16 | | -(http://wiki.blender.org/index.php/Extensions:2.6/Py/Scripts/Render/Spritify) |
| 20 | +### Usage |
| 21 | + |
| 22 | +There is a Spritify panel in Render Properties where you configure some of the |
| 23 | +attributes of the sprite sheet as well as enable or disable the ability to |
| 24 | +automatically generate a sprite sheet each time an animation render completes. |
0 commit comments