spajus/gosu-texture-packer

TexturePacker support for Gosu game engine

gosu_texture_packer

Ruby gem that provides Texture Packer support for Gosu game engine.

Installation

Add this line to your application's Gemfile:

gem 'gosu_texture_packer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install gosu_texture_packer

Usage

tileset = Gosu::TexturePacker.load_json(gosu_window, '/path/to/tileset.json')
frame_names = tileset.frame_list
tile = tileset.frame(frame_names.first)
tile.draw(0, 0, 0) # tile is Gosu::Image

You may find that your tiles have "bleeding edges" when you stack them together. To avoid that, either use --extrude 1 or --reduce-border-artifacts when exporting Texture Packer tileset, or provide :precise mode parameter to load_json:

tileset = Gosu::TexturePacker.load_json(gosu_window, '/path/to/tileset.json', :precise)

However, loading with :precise mode will significantly increase memory consumption and reduce load time, so use it carefully.

Example Code

Run examples/tile_brush.rb or examples/random_map.rb to see gosu_texture_packer in action.

Example tilesets are loaded from spec/files directory.

Contributing

0. Read CONTRIBUTING.md
1. Fork it ( https://github.com/spajus/gosu-texture-packer/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request