color_conversion 0.1.0

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.rvmrc
+.bundle
+.config
+.yardoc
+.rspec
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+bin

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in color_parser.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,9 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard 'rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/color_conversion/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')               { "spec" }
+end
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Derek DeVries
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,67 @@
+## Color Conversion
+
+This gem provides conversions for colors to and from Hex, RGB, and HSL. 
+
+## Examples
+
+Create a new color:
+```ruby
+# from hex
+color = Color.new("#FFFFFF")
+color = Color.new("#FFF")
+
+# from rgb and rgba
+color = Color.new(r: 255, g: 255, b: 255)
+color = Color.new(r: 255, g: 255, b: 255, a: 0.5)
+
+# from hsl and hsla
+color = Color.new(h: 0, s: 100, l: 100)
+color = Color.new(h: 0, s: 100, l: 100, a: 0.5)
+
+# from textual color
+color = Color.new("white")
+
+# from a css declaration
+color = Color.new("rgb(255,255,255)")
+color = Color.new("hsl(0,100%,100%)")
+```
+
+
+Convert to RGB
+```ruby
+Color.new("white").rgb
+=> {:r=>255, :g=>255, :b=>255}
+```
+
+Convert to Hex
+```ruby
+Color.new("white").hex
+=> "#FFFFFF"
+```
+
+Convert to HSL
+```ruby
+Color.new("white").hsl
+=> {:h=>0, :s=>100, :l=>100}
+```
+
+Convert to Name
+```ruby
+Color.new("#FFFFFF").name
+=> "white"
+```
+
+
+## Installation
+
+To install ColorConversion, add the gem to your Gemfile: 
+
+```ruby
+gem "color_conversion", "~> 0.1.0"
+```
+
+## LICENSE
+
+Copyright (c) 2013 Derek DeVries
+
+Released under the [MIT License](http://www.opensource.org/licenses/MIT)

data/Rakefile

@@ -0,0 +1,22 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+namespace :spec do
+  desc 'Run unit specs only'
+  RSpec::Core::RakeTask.new(:unit) do |task|
+    task.pattern    = 'spec'
+    task.rspec_opts = '--tag "~live"'
+  end
+
+  desc 'Run acceptance specs only'
+  RSpec::Core::RakeTask.new(:acceptance) do |task|
+    task.pattern    = 'spec'
+    task.rspec_opts = '--tag "live"'
+  end
+end
+
+task :default => :spec

data/color_conversion.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'color_conversion/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "color_conversion"
+  gem.version       = ColorConversion::VERSION
+  gem.summary       = %q{Convert colors to hex/rgb/hsv}
+  gem.description   = gem.summary
+
+  gem.required_ruby_version = '>= 1.9.3'
+  gem.license       = "MIT"
+
+  gem.authors       = ["Derek DeVries"]
+  gem.email         = ["derek@sportspyder.com"]
+  gem.homepage      = "https://github.com/devrieda/color_conversion"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency("rake")
+  gem.add_development_dependency("rspec", "~> 2.9")
+
+  # guard
+  gem.add_development_dependency("guard", "~> 1.7")
+  gem.add_development_dependency("guard-rspec", "~> 2.5")
+  gem.add_development_dependency("rb-fsevent", "~> 0.9")
+end

data/lib/color_conversion.rb

@@ -0,0 +1,20 @@
+require 'forwardable'
+
+require 'color_conversion/version'
+require 'color_conversion/errors'
+require 'color_conversion/color'
+require 'color_conversion/color_converter'
+
+require 'color_conversion/converters/hex_converter'
+require 'color_conversion/converters/rgb_string_converter'
+require 'color_conversion/converters/hsl_string_converter'
+require 'color_conversion/converters/name_converter'
+
+require 'color_conversion/converters/cmyk_converter'
+require 'color_conversion/converters/hsl_converter'
+require 'color_conversion/converters/hsv_converter'
+require 'color_conversion/converters/rgb_converter'
+require 'color_conversion/converters/null_converter'
+
+module ColorConversion
+end

data/lib/color_conversion/color.rb

@@ -0,0 +1,10 @@
+module ColorConversion
+  class Color
+    extend Forwardable
+    def_delegators :@converter, :rgb, :hex, :hsl, :hsv, :hsb, :cymk, :alpha
+
+    def initialize(color)
+      @converter = ColorConverter.factory(color)
+    end
+  end
+end

data/lib/color_conversion/color_converter.rb

@@ -0,0 +1,124 @@
+module ColorConversion
+  class ColorConverter
+    attr_reader :rgba
+
+    # keep track of subclasses for factory
+    class << self
+      attr_reader :converters
+    end
+
+    @converters = []
+
+    def self.inherited(subclass)
+      ColorConverter.converters << subclass
+    end
+
+    def self.factory(color)
+      converter = ColorConverter.converters.find do |klass| 
+        klass.matches?(color)
+      end
+      converter.new(color) if converter
+    end
+    
+    def initialize(color)
+      @rgba = to_rgba(color)
+    end
+    
+    def rgb
+      {r: @rgba[:r], g: @rgba[:g], b: @rgba[:b]}
+    end
+    
+    def hex      
+      "#" + ("%02x" % @rgba[:r] + "%02x" % @rgba[:g] + "%02x" % @rgba[:b])
+    end
+    
+    def hsl
+      r = @rgba[:r] / 255.0
+      g = @rgba[:g] / 255.0
+      b = @rgba[:b] / 255.0
+      min = [r, g, b].min
+      max = [r, g, b].max
+      delta = max - min
+
+      h = if max == min
+        0
+      elsif r == max
+        (g - b) / delta 
+      elsif g == max
+        2 + (b - r) / delta 
+      elsif b == max
+        4 + (r - g) / delta
+      end
+      
+      h = [h * 60, 360].min
+      h += 360 if h < 0
+      l = (min + max) / 2.0
+
+      s = if (max == min)
+        0
+      elsif (l <= 0.5)
+        delta / (max + min)
+      else
+        delta / (2.0 - max - min)
+      end
+
+      {h: h.round, s: (s * 100).round, l: (l * 100).round}
+    end
+    
+    def hsv
+      r = @rgba[:r].to_f
+      g = @rgba[:g].to_f
+      b = @rgba[:b].to_f
+      min = [r, g, b].min
+      
+      max = [r, g, b].max
+      delta = (max - min).to_f
+      
+      s = max == 0 ? 0 : (delta / max * 1000) / 10.0
+      
+      h = if max == min
+        0
+      elsif r == max
+        (g - b) / delta
+      elsif g == max
+        2 + (b - r) / delta 
+      elsif b == max
+        4 + (r - g) / delta
+      end
+      
+      h = [h * 60, 360].min      
+      h += 360 if h < 0
+
+      v = ((max / 255.0) * 1000) / 10.0
+
+      {h: h.round, s: s.round, v: v.round}
+    end
+    
+    def hsb
+      hsb = hsv
+      hsb[:b] = hsb.delete(:v)
+      hsb
+    end
+    
+    def cmyk
+      r = @rgba[:r] / 255.0
+      g = @rgba[:g] / 255.0
+      b = @rgba[:b] / 255.0
+
+      k = [1.0 - r, 1.0 - g, 1.0 - b].min
+      c = (1.0 - r - k) / (1.0 - k)
+      m = (1.0 - g - k) / (1.0 - k)
+      y = (1.0 - b - k) / (1.0 - k)
+
+      {c: (c * 100).round, 
+       m: (m * 100).round, 
+       y: (y * 100).round, 
+       k: (k * 100).round}
+    end
+
+    def alpha
+      @rgba[:a]
+    end
+
+  end
+end

data/lib/color_conversion/converters/cmyk_converter.rb

@@ -0,0 +1,26 @@
+module ColorConversion
+  class CmykConverter < ColorConverter
+
+    def self.matches?(color)
+      return false unless color.kind_of?(Hash)
+
+      color.include?(:c) && color.include?(:m) && 
+      color.include?(:y) && color.include?(:k)
+    end
+
+    private
+
+    def to_rgba(cmyk)
+      c = cmyk[:c].to_f / 100.0
+      m = cmyk[:m].to_f / 100.0
+      y = cmyk[:y].to_f / 100.0
+      k = cmyk[:k].to_f / 100.0
+
+      r = (255 * (1.0 - [1.0, c * (1.0 - k) + k].min)).round
+      g = (255 * (1.0 - [1.0, m * (1.0 - k) + k].min)).round
+      b = (255 * (1.0 - [1.0, y * (1.0 - k) + k].min)).round
+
+      {r: r, g: g, b: b, a: 1.0}
+    end
+  end
+end

data/lib/color_conversion/converters/hex_converter.rb

@@ -0,0 +1,26 @@
+module ColorConversion
+  class HexConverter < ColorConverter
+
+    def self.matches?(color)
+      return false unless color.kind_of?(String)
+
+      color.include?("#") && [4, 7].include?(color.length)
+    end
+
+    private
+
+    def to_rgba(hex)
+      hex = normalize_hex(hex)
+
+      {:r => hex[0,2].hex,
+       :g => hex[2,2].hex,
+       :b => hex[4,2].hex, 
+       :a => 1.0}
+    end
+
+    def normalize_hex(hex)
+      hex = hex.gsub("#", "")
+      (hex.length == 3 ? hex[0,1]*2 + hex[1,1]*2 + hex[2,1]*2: hex).downcase
+    end
+  end
+end

data/lib/color_conversion/converters/hsl_converter.rb

@@ -0,0 +1,51 @@
+module ColorConversion
+  class HslConverter < ColorConverter
+
+    def self.matches?(color)
+      return false unless color.kind_of?(Hash)
+
+      color.include?(:h) && color.include?(:s) && color.include?(:l)
+    end
+
+    private
+    
+    def to_rgba(hsl)
+      h = hsl[:h].to_s.gsub(/[^0-9\.]/, "").to_f / 360.0
+      s = hsl[:s].to_s.gsub(/[^0-9\.]/, "").to_f / 100.0
+      l = hsl[:l].to_s.gsub(/[^0-9\.]/, "").to_f / 100.0
+      a = hsl[:a] ? hsl[:a].to_s.gsub(/[^0-9\.]/, "").to_f : 1.0
+
+      return [l * 255, l * 255, l * 255] if s == 0
+
+      t2 = if l < 0.5
+        l * (1 + s)
+      else
+        l + s - l * s
+      end
+
+      t1 = 2 * l - t2
+
+      rgb = [0, 0, 0]
+
+      (0..2).each do |i|
+        t3 = h + 1 / 3.0 * - (i - 1)
+        t3 < 0 && t3 += 1
+        t3 > 1 && t3 -= 1
+
+        val = if 6 * t3 < 1
+          t1 + (t2 - t1) * 6 * t3
+        elsif 2 * t3 < 1
+          t2
+        elsif 3 * t3 < 2
+          t1 + (t2 - t1) * (2 / 3.0 - t3) * 6
+        else
+          t1
+        end
+
+        rgb[i] = (val * 255).round
+      end
+      
+      {r: rgb[0], g: rgb[1], b: rgb[2], a: a}
+    end
+  end
+end