No commit activity in last 3 years
No release in over 3 years
This gem makes it easy adding an animated image given a sprite sheet
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.12
~> 1.3
~> 10.0
>= 0

Runtime

 Project Readme

SpriteAnimation

This gem makes it easy creating animated images in your views given a sprite sheet. Just add it to your project and start animating sprite sheets. SpriteAnimation gem encapsulates all the javascript, jquery and rails logic you need. It was made to be as simple as possible. Try it!

Usage

SpriteAnimation gem extends your view helpers with one more method: animate_sprite.

animate_sprite(image_src, frame_count, params = {})

image_src

The source of the image, just like in image_tag helper. Can be a local image or a URL of an image.

frame_count

String with the number of frames that your sprite sheet has.

params

An optional hash containing the following parameters:

  • scale: Decimal value to resize your frame size. Defaults to 1.
  • orientation: A symbol containing the orientation of your sprite sheet.
    Can be: :vertical or :horizontal. If it's not given, SpriteAnimation will try to guess it based on the height and width of your sprite sheet.

Installation

Add this line to your application's Gemfile:

gem 'sprite_animation'

Then run

bundle install

After that, just add the require statement to your application.js

//= require sprite_animation

Examples

Using slim-template

= animate_sprite("sample-sheet.png", "10")      # Looks for a sprite sheet located at app/assets/images/ with 10 frames.
= animate_sprite("sample-sheet.png", "10", scale: 0.5)      # Same as above, but reducing the frame size to 50% of the original.
= animate_sprite("horizontal-sheet.png", "10", orientation: :horizontal)    # Forces the orientation to be horizontal
= animate_sprite("http://www.remotesheet.com/sheet.jpg", "12") # Fetches the sprite sheet at the URL and animates it with 12 frames

Dependencies

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/DanielsLuz/sprite_animation. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Changelog

0.3.0 Added infrastructure for rspec tests.