Project

color_diff

0.03
Low commit activity in last 3 years
A long-lived project that still receives updates
color_diffhansondr/color_diffHomepageDocumentationSource CodeBug TrackerWiki
Calculate RGB color distances using CIEDE2000 formula
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
1,683,723
Stars
10
Forks
2
Watchers
1
 Releases
Current version
0.2
Total releases
2
First release
2017-06-15
Latest release
2025-12-19
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
2
Merged Pull Requests
2
Pull Request Acceptance Rate
50%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2022-04-26
Reverse Dependencies
0

 Dependencies

Development

rspec
~> 3.0
 Project Readme

Color Diff

Calculating differences between colors using the CIEDE2000 algorithm

Install

gem install color_diff

Usage

Difference between two colors:

yellow = ColorDiff::Color::RGB.new 255, 255, 0
gold   = ColorDiff::Color::RGB.new 255, 215, 0

ColorDiff.between yellow, gold
# => 11.584521223499245

Picking the most similar color from a list:

red    = ColorDiff::Color::RGB.new 255,   0,   0
blue   = ColorDiff::Color::RGB.new   0,   0, 255
yellow = ColorDiff::Color::RGB.new 255, 255,   0
gold   = ColorDiff::Color::RGB.new 255, 215,   0

list   = ColorDiff::List.new [red, blue, yellow]
list.closest_to(gold) == yellow
# => true

Building a map of nearest match colors from a finite palette:

red       = ColorDiff::Color::RGB.new 255,  0,  0
black     = ColorDiff::Color::RGB.new   0,  0,  0
dark_gray = ColorDiff::Color::RGB.new  80, 80, 80
maroon    = ColorDiff::Color::RGB.new 128,  0,  0

list = ColorDiff::List.new [red, black]
palette = [dark_gray, maroon]

list.closest_to_map(palette)
# => { 'R255G0B0' => maroon, 'R0B0G0' => dark_gray }