Gem Version Build Status Code Climate Coverage Status Inline docs Gitter chat

emojidex

emojidex core tools and scripts in Ruby. Provides a set of tools to utilize emojidex emoji right away in Ruby. Available as the "emojidex" gem.

Usage

The emojidex gem can be used either on-line or off-line. Offline components require you to bundle the assets you want to use by including either the emojidex-vectors gem for SVG assets or emojidex-rasters gem for PNG assets. Simply including "emojidex-vectors" or "emojidex-rasters" in your Gemfile or having the gem installed will enable this. Without one or both of these gems installed the off-line components will fall back to connecting to the emojidex service and, if they are unable to connect, will attempt to find the assets in the emojidex cache (usually found in $HOME/.emojidex).

emojidex isn't just a set of emoji and some tools, it's a full service that allows anyone to register their own emoji and for anyone else to use them. emojidex can also store a users favorites and history.

emoji Collections

The Collection is the primary container for sets of emoji. All containers inherit from Emojidex::Data::Collection.

emoji

the Emojidex::Data::Emoji object contains the details of a single emoji.

emoji.path(:png, :hdpi)

emoji Indexes

Off-line Usage

When using emojidex off-line you will only have access to the collections you have included or have available locally. Two collections are available as gems, the emojidex-rasters gem contains PNG in various sizes and the emojidex-vectors gem contains SVG assets. Both contain the UTF and Extended collections. To use either of them you simply need to make an instance of one or more of the named collections in 'emojidex/data' after requiring either 'emojidex-rasters' or 'emojidex-vectors. We'll use the more-commonly used PNG rasters for this example:

For UTF (Unicode Standard) emoji:

require 'emojidex-rasters'
require 'emojidex/data/utf'

emoji = Emojidex::Data::UTF.new

For Extended (emojidex Original) emoji:

require 'emojidex-rasters'
require 'emojidex/data/extended'

emoji = Emojidex::Data::Extended.new

For all emoji in the cache (will include UTF and Extended if they have been cached):

require 'emojidex/data/collection'

emoji = Emojidex::Data::Collection.new

For a combined set of UTF, Extended and Cached emoji:

require 'emojidex/data/collection'
require 'emojidex/data/utf'
require 'emojidex/data/extended'

emoji = Emojidex::Data::Collection.new
emoji << Emojidex::Data::UTF.new
emoji << Emojidex::Data::Extended.new

Warning
Off-line usage is limited to open-source projects. If you are using this gem without connecting to the emojidex service and your project is not open-source a commercial license is required. Please contact info at emojidex dot com for details.

Assets

You can find Vectors here: emojidex-vectors
You can find Rasters here: emojidex-rasters

License

emojidex and emojidex tools are licensed under the emojidex Open License.

©2013 the emojidex project / Genshin Souzou K.K. [Phantom Creation Inc.]