Game Icons

RubyGem access to the SVGs on game-icons.net, an awesome library of free icons.

Installation

Add this line to your application's Gemfile:

gem 'game_icons'

And then execute:

$ bundle

Or install it yourself as:

$ gem install game_icons

Usage

require 'game_icons'

GameIcons.get('glass-heart').file     # absolute path to glass-heart.svg, black-on-white
GameIcons.get('glass-heart.svg').file # .svg extension allowed too
GameIcons.get(:flame).file            # symbols work too
GameIcons.get('glass-heart').string   # the SVG string
GameIcons.get('glass-heart').string   # the SVG string
GameIcons.get('glass-heart').recolor(fg: '333', bg: 'ccc').string # recolor the foreground and background to different shades of gray
GameIcons.get('glass-heart').recolor(fg: '333', bg: 'ccc', fg_opacity: 0.25, bg_opacity: 0.75).string # recolor with opacity c

GameIcons.names                       # returns an array of all names

Working With Squib

Squib is my other pet project. Here's some example usage:

require 'game_icons' # Be sure to also put this in your Gemfile and run "bundle install"
require 'squib'

Squib::Deck.new do
  #You can access just the file
  svg file: GameIcons.get('glass-heart').file
  #Or you can get the data as a string
  svg data: GameIcons.get('glass-heart').string
  svg data: GameIcons.get('glass-heart').recolor(fg: '333', bg: 'ccc').string
end

We Are Not Game-Icons.net

This is not affiliated with game-icons.net. They are awesome, talented artists who give away their hard work. I'm not them.

That said, the Ruby code surroudning this Gem is MIT licensed. The icons themselves are under a CC BY 3.0. Be sure to attribute them in your work.

Contributing

1. Fork it ( https://github.com/[my-github-username]/game_icons/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