After my findings from my other post, where I manually modified a tileset to add a bleed around my tiles, I got lazy and decided never to do that again. From that decision rose a small project to handle various changes to tilesets, aptly named: tileset tooling. My first use case: automating bleed addition to tilesets. In this post, I’ll go over a few of the details on how I built the tool and a few usage examples.
Getting the tool
The tool relies on imagemagick. The first thing to do is to install that library: sudo apt-get install imagemagick.
Then there are two ways of getting the tool:
- the easiest way is by adding the tool directly in your path by installing through RubyGems: gem install tileset_tooling
- follow the documentation in the project readme and setup as a developer to run directly the checked-out code
Usage scenarios
As previously said, the tool only has one real feature: adding a bleed to a tileset. The tool handles two use cases:
- a tileset that already has a margin, where one pixel of said margin will be replaced with the bleed
- a tileset that does not have any margin, where the tool will add a 1-pixel margin and put the bleed there
Running the tool for both of these scenarios is done the same way: tileset_tooling bleed insert test/data/simple_no_margin.png.
Right now, there is not much more to say. More information can be found in the tool’s wiki and a rdoc file contains all arguments and commands.
Future of the tool
Right now, nothing specific is planned for the tool. I do plan on playing with Unity, and tilesets, so a few more features might come from there. Users are also free to request features directly through GitHub.
Helping around
As a developer, I do not have any real Ruby experience. Also, I’m quite new to the whole Unity/tileset world. Any help is welcome, from anyone with any background 🙂