Automating bleed addition to tilesets

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:

  1. the easiest way is by adding the tool directly in your path by installing through RubyGems: gem install tileset_tooling
  2. 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:

  1. a tileset that already has a margin, where one pixel of said margin will be replaced with the bleed
  2. 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 🙂