Huespace

A ruby gem that extracts a palette of most representative colors from images.

Inspired by color-thief by Lokesh Dhakar (https://github.com/lokesh/color-thief) and Camalian by Nazar Hussain (https://github.com/nazarhussain/camalian/blob/master/camalian.gemspec)

Installation

Install the gem and add to the application's Gemfile by executing:

$ bundle add huespace

If bundler is not being used to manage dependencies, install the gem by executing:

$ gem install huespace

Usage

image_source

In the following text image_source means one of the following:

• path to the image stored locally
• url of the image
• image as a stream of bytes (so you can fetch it once on the backend)

Extracting a palette of colors

Returns an array of colors, exp. [[47, 48, 62], [91, 92, 117], [218, 154, 95]]

Huespace.get_palette(image_source, n_colors)

Extracting the dominant color

Returns the color that best represents the image

Huespace.get_dominant_color(image_source)

Extracting the most colorful color

Returns the most colorful (probably best described as most vibrant) color from a palette of 6 colors

Huespace.get_most_colorful_color(image_source)

License

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