color-maker 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 448854ab6021a69144db3a5959dc5c889c685282
+  data.tar.gz: 69051f1096a95ae6da1706f405ac1ff16910dcfc
+SHA512:
+  metadata.gz: 842806eaa65b94d907e731240c78865096c08a92791ee325bff9cf869a9f08c9f6470260666c52a531e4345c21b3c2381659d0a8c68a8f09fc6e49ac9d9472fc
+  data.tar.gz: 5bfc948e3739ba22ca027ee88724cdf0db8edc86210996de60d1c31eff6c12a2ce1a388867aaf92d1cb3a5df5473eabcbbfbd34bb6bea38d5452fbe5acf85b3b

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Viorel Craescu
+
+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,4 @@
+color-maker
+===========
+
+Color generator for Ruby

data/Rakefile

@@ -0,0 +1,13 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/*_test.rb']
+end
+
+desc 'Run tests'
+task :default => :test
+
+

data/color-maker.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'color/maker/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "color-maker"
+  spec.version       = Color::Maker::VERSION
+  spec.authors       = ["Viorel Craescu"]
+  spec.email         = ["viorel@craescu.com"]
+  spec.summary       = %q{Color generator}
+  spec.description   = %q{Color generator}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "color", "~> 1.7"
+  spec.add_dependency "activesupport"
+  spec.add_development_dependency "yard"
+  spec.add_development_dependency "minitest"
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/color-maker.rb

@@ -0,0 +1,10 @@
+require "color/maker/version"
+require 'color/hash'
+require 'color/string'
+require 'color/array'
+require 'color/maker'
+require 'color/maker/support'
+require 'active_support/core_ext/hash/keys'
+require 'active_support/core_ext/object/try'
+require 'color'
+require 'yaml'

data/lib/color/array.rb

@@ -0,0 +1,30 @@
+# Monkey patch Array class with color conversion utility methods
+class Array
+  # Converts an array to color
+  #
+  # @param [Symbol] format color format (:rgb, :hsv, :hsl)
+  # @return [Color::RGB]
+  # @example
+  #   [150, 200, 100].to_color(:rgb) #=> Color::RGB
+  #   [200, 0.9, 0.3].to_color(:hsv) #=> Color::RGB
+  #   [150, 0.3, 0.1].to_color(:hsl) #=> Color::RGB
+  def to_color(format = :rgb)
+    format = format.to_sym
+    if format == :rgb
+      r, g, b = self
+      return Color::Maker::Support::rgb_to_color(r: r.to_i, g: g.to_i, b: b.to_i)
+    end
+
+    if format == :hsv
+      h, s, v = self
+      return Color::Maker::Support::hsv_to_color(h: h.to_f, s: s.to_f, v: v.to_f)
+    end
+
+    if format == :hsl
+      h, s, l = self
+      return Color::Maker::Support::hsl_to_color(h: h.to_f, s: s.to_f, l: l.to_f)
+    end
+
+    raise "Unknown color format: #{format}"
+  end
+end

data/lib/color/hash.rb

@@ -0,0 +1,51 @@
+# Monkey patch Hash class with color conversion utility methods
+class Hash
+  # Convert an Hash to color
+  # 
+  # @param [Symbol] format color format (:rgb, :hsv, :hsl)
+  # @return [Color::RGB]
+  # @example
+  #   { r: 150, g: 100, b: 200 }.to_colour(:rgb) #=> Color::RGB
+  #   { red: 150, green: 100, blue: 200 }.to_colour(:rgb) #=> Color::RGB
+  #   { h: 150, s: 100, v: 200 }.to_colour(:hsv) #=> Color::RGB
+  #   { hue: 150, saturation: 100, value: 200 }.to_colour(:hsv) #=> Color::RGB
+  #   { hue: 150, saturation: 100, lightness: 200 }.to_colour(:hsl) #=> Color::RGB
+  #   { h: 150, s: 100, l: 200 }.to_colour(:hsl) #=> Color::RGB
+  def to_color(format = :rgb)
+    format = format.to_sym
+    if format == :rgb
+      normalized = Color::Maker::Support.normalize_color_keys(self, format: :rgb)
+      r, g, b = normalized[:r].to_i, normalized[:g].to_i, normalized[:b].to_i
+      return Color::Maker::Support::rgb_to_color(r: r, g: g, b: b)
+    end
+
+    if format == :hsv
+      normalized = Color::Maker::Support.normalize_color_keys(self, format: :hsv)
+      h, s, v = normalized[:h].to_f, normalized[:s].to_f, normalized[:v].to_f
+      return Color::Maker::Support::hsv_to_color(h: h, s: s, v: v)
+    end
+
+    if format == :hsl
+      normalized = Color::Maker::Support.normalize_color_keys(self, format: :hsl)
+      h, s, l = normalized[:h].to_f, normalized[:s].to_f, normalized[:l].to_f
+      return Color::Maker::Support::hsl_to_color(h: h, s: s, l: l)
+    end
+    
+    raise "Unknow color format: #{format}"
+  end
+
+  # Replace keys
+  #
+  # @param [Symbol, Array, String] needle The value being searched for, otherwise known 
+  #   as the needle. An array may be used to designate multiple needles.
+  # @param [Symbol, String] replace The replacement value that replaces found search values.
+  # @example
+  #   { one: 1, two: 2 }.replace_key!([:one, :two], :three) #=> { three: 2 }
+  #   { one: 1, two: 2 }.replace_key!(:one, :three) #=> { three: 1, two: 2 }
+  def replace_key!(needle, replace)
+    needle = [needle] unless needle.is_a?(Enumerable)
+    needle.each { |key| self[replace] = self.delete(key) if self.key?(key) }
+    self
+  end
+end
+

data/lib/color/maker.rb

@@ -0,0 +1,241 @@
+module Color
+  # Create random pleasing colors as well as color schemes based on a given color.
+  class Maker
+    PHI = 0.618033988749895
+
+    # Value generator, Random class instance
+    attr_accessor :generator
+
+    @colors_path = File.join(File.dirname(__FILE__), '..', 'colors.yml')
+
+    # @!attribute [r]
+    # Default color make options
+    @defaults = {
+      hue: nil,
+      saturation: nil,
+      value: nil,
+      base_color: nil,
+      greyscale: false,
+      grayscale: false,
+      golden: true,
+      random: false,
+      count: 1,
+      seed: false
+    }
+
+    class << self
+      # @!macro color_maker_defaults
+      #   @option options [Symbol] :hue (nil) By setting the hue, you determine the 
+      #    color. (0..360)
+      #   @option options [Symbol] :saturation (nil) By setting the saturation, you 
+      #     determine the distance from gray. (0..1.0)
+      #   @option options [Symbol] :value (nil) By setting the value, you determine 
+      #     the balance between black and white. (0..1.0)
+      #   @option options [Symbol] :base_color (nil) Setting a base_color (e.g. "pink") 
+      #     will create a random color within the HSV range of the chosen color. 
+      #     Will recognize any of the 146 standard HTML colors, it has a very
+      #     good memory.
+      #   @option options [Symbol] :greyscale (false) for the brits - Setting either 
+      #     greyscale or grayscale (but we all know which one is correct) to true 
+      #     will cause all of the colors you generate to be within the grey or gray 
+      #     range. This is effectively the same as setting your saturation to 0.
+      #   @option options [Symbol] :grayscale (false) for the yanks - Setting either 
+      #     greyscale or grayscale (but we all know which one is correct) to true 
+      #     will cause all of the colors you generate to be within the grey or gray 
+      #     range. This is effectively the same as setting your saturation to 0.
+      #   @option options [Symbol] :golden (true) Setting golden to true randomizes 
+      #     your hue (overrides hue setting) and makes you a spectacular color 
+      #     based on the golden ratio. It's so good, it's the default. Make sure to 
+      #     turn it off if you want to have more control over your generated colors.
+      #   @option options [Symbol] :random (false) It will completely randomize the 
+      #     hue, saturation, and value of the colors it makes.
+      #   @option options [Symbol] :count (1) Setting count to higher than 1 will 
+      #     return an array full of the colors. If you set it to 1, you'll just get 
+      #     the one color! It makes a sort of sense if you think about it.
+      
+      # @!macro color_maker_defaults_rgb
+      #   @option options [Symbol] :red (nil) red value for the color to start with (0..255)
+      #   @option options [Symbol] :green (nil) green value for the color to start with (0..255)
+      #   @option options [Symbol] :blue (nil) blue value for the color to start with (0..255)
+
+      # @!macro color_maker_defaults_hsl
+      #   @option options [Symbol] :lightness (nil) the luminosity of the colour (0..1.0)
+
+      # @!macro color_maker_defaults
+      attr_reader :defaults
+
+      # Memorized colors
+      #
+      # @return [Hash]
+      # @example
+      #   Color::Maker.colors(:aquamarine) #=> 7FFFD4
+      def colors
+        return @colors if @colors
+        @hex_colors = ::YAML.load_file(@colors_path)
+        @hex_colors.symbolize_keys!
+        @colors = Hash.new do |h, k|
+          if @hex_colors[k]
+            h[k] = Color::RGB.by_hex(@hex_colors[k])
+          else
+            h[k] = Color::RGB.by_name(k)
+          end
+        end
+      end
+
+      # Return a Color::RGB object
+      #
+      # @param name [Symbol] css color name or from above list
+      # @return Color::RGB
+      # @example
+      #   Color::Maker.by_name(:aquamarine) #=> Color::RGB
+      #   Color::Maker.by_name(:blue) #=> Color::RGB
+      #   Color::Maker.by_name(:aliceblue) #=> Color::RGB
+      # {include:file:lib/colors.yml}
+      def by_name(name)
+        self.colors[name.downcase.to_sym]
+      end
+    end
+
+    # @!macro color_maker_defaults
+    # @!macro color_maker_defaults_rgb
+    # @!macro color_maker_defaults_hsl
+    def initialize(options = {})
+      options = normalize_options(options)
+      @options = self.class.defaults.merge(options)
+      @generator = Random.new(options[:seed]) rescue Random.new
+    end
+
+    # Generates a new color
+    # @param [Hash] options the options to generate the color
+    # @!macro color_maker_defaults
+    # @!macro color_maker_defaults_rgb
+    # @!macro color_maker_defaults_hsl
+    # @return Color::RGB
+    def make(options = {})
+      generator = self.generator
+      generator = Random.new(options[:seed]) if options[:seed]
+
+      options = normalize_options(options)
+      options = self.class.defaults.merge(@options.merge(options))
+
+      base_color = self.class.by_name(options[:base_color]) if options[:base_color]
+      colors = []
+      options[:count].times do |i|
+        if base_color
+          base_color = base_color.to_hsl
+          base_color = Support::hsl_to_hsv(h: base_color.hue, s: base_color.s, l: base_color.l)
+
+          hue = generator.rand((base_color[:h] - 5)..(base_color[:h] + 5))
+          saturation = generator.rand(0.4..0.85)
+          value = generator.rand(0.4..0.85)
+          colors << [hue, saturation, value].to_color(:hsv)
+        else
+          hue = make_hue(options, generator)
+          saturation = make_saturation(options, generator)
+          value = make_value(options, generator)
+
+          colors << [hue, saturation, value].to_color(:hsv)
+        end
+      end
+
+      colors = colors[0] if colors.size == 1
+      colors
+    end
+
+
+    private
+    def normalize_options(options)
+      normalized = {}
+
+      variants = { hue: [:h], saturation: [:s], value: [:v], 
+                   red: [:r], green: [:g], blue: [:b],
+                   lightness: [:l, :luminosity, :light],
+                   greyscale: [:grayscale, :gray] }
+
+      variants.each do |key, keys|
+        found_key = keys.find { |k| options[k] } || key
+        normalized[key] ||= options[found_key] if options[found_key]
+        options.delete(found_key) if normalized[key]
+      end
+
+      options.each { |key, value| normalized[key] = value unless normalized.key?(key) }
+      normalized.merge(extract_color(normalized))
+      normalized
+    end
+
+    def extract_color(options)
+      formats = { :hsv => [:hue, :saturation, :value],
+                  :rgb => [:red, :green, :blue ],
+                  :hsl => [:hue, :saturation, :lightness] }
+
+      format = formats.map do |key, keys| 
+        [key, keys.count { |k| options[k] } ] 
+      end
+      format = format.max_by { |v| v.last }.first
+
+      color = {}
+      formats[format].each { |value| color[value] = options[value].to_f }
+
+      case format
+      when :rgb
+        color = Support.rgb_to_hsv(color)
+      when :hsl
+        color = Support.hsl_to_hsv(color)
+      end
+
+      color
+    end
+
+    def make_hue(options = {}, generator = nil)
+      generator ||= self.generator
+
+      if options[:greyscale]
+        hue = 0
+      elsif options[:golden]
+        random_hue = generator.rand(0..360)
+        hue = (random_hue + (random_hue / PHI)) % 360
+      elsif options[:hue].nil? || options[:random]
+        hue = random_hue
+      else
+        hue = clamp(options[:hue], 0, 360)
+      end
+      hue
+    end
+
+    def make_saturation(options = {}, generator = nil)
+      generator ||= self.generator
+
+      if options[:greyscale]
+        saturation = 0
+      elsif options[:random]
+        saturation = generator.rand(0..1.0)
+      elsif options[:saturation].nil?
+        saturation = 0.4
+      else
+        saturation = clamp(options[:saturation], 0, 1)
+      end
+
+      saturation
+    end
+
+    def make_value(options = {}, generator = nil)
+      generator ||= self.generator
+
+      if options[:random]
+        value = self.generator.rand(0..1.0)
+      elsif options[:greyscale]
+        value = self.generator.rand(0.15..0.75)
+      elsif options[:value].nil?
+        value = 0.75
+      else
+        value = clamp(options[:value], 0, 1)
+      end
+
+      value
+    end
+
+    def clamp(num, min, max)
+      [min, [num, max].min].max
+    end
+  end
+end

data/lib/color/maker/support.rb

@@ -0,0 +1,235 @@
+module Color
+  class Maker
+    # Utilities methods
+    module Support
+      class << self
+        # Convert color from HSV to RGB format
+        #
+        # @param [Hash] hsv 
+        # @return [Hash] color in RGB format
+        # @example
+        #   Color::Maker::Support.hsv_to_rgb({ h: 12, s: 0.9, v: 0.2 }) #=> { r: 51, g: 14, b: 5 }
+        #   Color::Maker::Support.hsv_to_rgb({ hue: 12, saturation: 0.9, value: 0.2 }) #=> { r: 51, g: 14, b: 5 }
+        def hsv_to_rgb(hsv)
+          hsv = normalize_color_keys(hsv, format: :hsv)
+          h, s, v = hsv[:h].to_f / 360.0, hsv[:s].to_f, hsv[:v].to_f
+          i = (h * 6).floor
+          f = h * 6 - i
+          p = v * (1 - s)
+          q = v * (1 - f * s)
+          t = v * (1 - (1 - f) * s)
+          case i % 6
+          when 0
+            r, g, b = v, t, p
+          when 1
+            r, g, b = q, v, p
+          when 2
+            r, g, b = p, v, t
+          when 3
+            r, g, b = p, q, v
+          when 4
+            r, g, b = t, p, v
+          else
+            r, g, b = v, p, q
+          end
+          
+          r, g, b = (r * 255).round(0), (g * 255).round(0), (b * 255).round(0)
+          { r: r, g: g, b: b }
+        end
+
+        # Convert color from RGB to HSV
+        #
+        # @param [Hash] rgb
+        # @return [Hash] color in HSV format
+        # @example
+        #   Color::Maker::Support.rgb_to_hsv({ r: 15, g: 193, b: 17 }) #=> { h: 120.7, s: 0.922, v: 0.757 }
+        #   Color::Maker::Support.rgb_to_hsv({ red: 15, green: 193, blue: 17 }) #=> { h: 120.7, s: 0.922, v: 0.757 }
+        def rgb_to_hsv(rgb)
+          rgb = normalize_color_keys(rgb, format: :rgb)
+          r, g, b = rgb[:r].to_f / 255.0, rgb[:g].to_f / 255.0, rgb[:b].to_f / 255.0  
+          min, max = [r, g, b].min, [r, g, b].max
+          delta = max - min
+          v = max
+
+          return { h: 0, s: 0, v: v.round(3) } if max == 0 || delta == 0
+
+          s = delta / max
+          h = 4 + (r - g) / delta
+
+          if r == max
+            h = (g - b) / delta
+          elsif g == max
+            h = 2 + (b - r) / delta
+          end
+
+          h *= 60
+          h += 360 if h < 0
+          { h: h.round(1), s: s.round(3), v: v.round(3) }
+        end
+
+        # Convert color from RGB to HSL
+        #
+        # @param [Hash] rgb
+        # @return [Hash] color in HSL format
+        # @example
+        #   Color::Maker::Support.rgb_to_hsl({ r: 15, g: 193, b: 17 }) #=> { h: 120.7, s: 0.922, v: 0.757 }
+        #   Color::Maker::Support.rgb_to_hsl({ red: 15, green: 193, blue: 17 }) #=> { h: 120.7, s: 0.922, v: 0.757 }
+        def rgb_to_hsl(rgb)
+          rgb = normalize_color_keys(rgb, format: :rgb)
+          r, g, b = rgb[:r].to_f / 255.0, rgb[:g].to_f / 255.0, rgb[:b].to_f / 255.0  
+          min, max = [r, g, b].min, [r, g, b].max
+          delta = max - min
+
+          l = (min + max) / 2.0
+          return { h: 0, s: 0, l: l } if delta == 0
+
+          s = l < 0.5 ? delta / (max + min) : delta / (2 - max - min)
+
+          case(max)
+          when r
+            h = (g - b) / delta + (g < b ? 6 : 0)
+          when g
+            h = (b - r) / delta + 2
+          when b
+            h = (r - g) / delta + 4
+          end
+
+          h *= 60
+
+          { h: h.round(1), s: s.round(3), l: l.round(3) }
+        end
+
+        # Convert color from HSL to RGB
+        #
+        # @param [Hash] hsl
+        # @return [Hash] color in RGB format
+        # @example 
+        #   Color::Maker::Support.hsl_to_rgb({ h: 120.7, s: 0.856, l: 0.408 }) #=> { r: 15, g: 193, b: 17 }
+        #   Color::Maker::Support.hsl_to_rgb({ hue: 120.7, saturation: 0.856, lightness: 0.408 }) #=> { r: 15, g: 193, b: 17 }
+        def hsl_to_rgb(hsl)
+          hsl = normalize_color_keys(hsl, format: :hsl)
+          h, s, l = hsl[:h].to_f / 360.0, hsl[:s].to_f, hsl[:l].to_f
+          return { r: l, g: l, b: l } if s == 0
+
+          q = l < 0.5 ? l * (1 + s) : l + s - l * s
+          p = 2 * l - q
+
+          r = hue_to_rgb(p: p, q: q, t: h + 1 / 3.0) * 255
+          g = hue_to_rgb(p: p, q: q, t: h) * 255
+          b = hue_to_rgb(p: p, q: q, t: h - 1 / 3.0) * 255
+
+          { r: r.round(0), g: g.round(0), b: b.round(0) }
+        end
+
+        # Convert color from HSV to HSL
+        # 
+        # @param [Hash] hsv
+        # @return [Hash] color in HSL format
+        # @example
+        #   Color::Maker::Support.hsv_to_hsl({ h: 120.7, s: 0.922, v: 0.757 }) #=> { h: 120.7, s: 0.856, v: 0.408 })
+        #   Color::Maker::Support.hsv_to_hsl({ hue: 120.7, saturation: 0.922, value: 0.757 }) #=> { h: 120.7, s: 0.856, v: 0.408 })
+        def hsv_to_hsl(hsv)
+          rgb = hsv_to_rgb(hsv)
+          rgb_to_hsl(rgb)
+        end
+
+        # Convert color from HSL to HSV
+        # 
+        # @param [Hash] hsl
+        # @return [Hash] color in HSL format
+        # @example
+        #   Color::Maker::Support.hsl_to_hsv({ h: 120.7, s: 0.856, l: 0.408 }) #=> { h: 120.7, s: 0.922, v: 0.757 })
+        #   Color::Maker::Support.hsl_to_hsv({ hue: 120.7, saturation: 0.856, lightness: 0.408 }) #=> { h: 120.7, s: 0.922, v: 0.757 })
+        def hsl_to_hsv(hsl)
+          rgb = hsl_to_rgb(hsl)
+          rgb_to_hsv(rgb)
+        end
+
+        # Convert color from HSL to Color::RGB
+        #
+        # @param [Hash] hsl
+        # @return [Color::RGB] color
+        # @example
+        #   Color::Maker::Support.hsl_to_color({ h: 120.7, s: 0.856, l: 0.408 }) #=> Color::RGB
+        #   Color::Maker::Support.hsl_to_color({ hue: 120.7, saturation: 0.856, lightness: 0.408 }) #=> Color::RGB
+        def hsl_to_color(hsl)
+          rgb = hsl_to_rgb(hsl)
+          Color::RGB.new(rgb[:r], rgb[:g], rgb[:b])
+        end
+
+        # Convert color from RGB to Color::RGB
+        # 
+        # @param [Hash] rgb
+        # @return [Color::RGB] color
+        # @example
+        #   Color::Maker::Support.rgb_to_color({ r: 100, g: 150, b: 250 }) #=> Color::RGB
+        #   Color::Maker::Support.rgb_to_color({ red: 100, green: 150, blue: 250 }) #=> Color::RGB
+        def rgb_to_color(rgb)
+          rgb = normalize_color_keys(rgb, format: :rgb)
+          Color::RGB.new(rgb[:r], rgb[:g], rgb[:b])
+        end
+
+        # Convert color from HSV to Color::RGB
+        # 
+        # @param [Hash] hsv
+        # @return [Color::RGB] color
+        def hsv_to_color(hsv)
+          rgb = hsv_to_rgb(hsv)
+          rgb_to_color(rgb)
+        end
+
+        # Convert color from HEX to Color::RGB
+        # 
+        # @param [Hash] hex
+        # @return [Color::RGB] color
+        def hex_to_color(hex)
+          hex = hex.sub(/0x/, '')
+          Color::RGB.by_hex(hex)
+        end
+
+        # Normalize color keys
+        #
+        # @param [Hash] hash values in HSV, RGB or HSL format
+        # @param [Hash] options ({ format: :rgb, short: true })
+        # @return [Hash] color keys normalized
+        # @example
+        #   Color::Maker::Support.normalize_color_keys({ r: 100, blue: 100, g: 100 }) #=> { r: 100, b: 100, g: 10 }
+        #   Color::Maker::Support.normalize_color_keys({ r: 100, blue: 100, g: 100 }, short: false) #=> { red: 100, blue: 100, green: 10 }
+        def normalize_color_keys(hash, options = {})
+          default_options =  { format: :rgb, short: true }
+          options = default_options.merge(options)
+
+          format = options[:format].to_sym
+            
+          keys = {
+            rgb: { [:r, :red] => [:r, :red], [:b, :blue] => [:b, :blue], [:g, :green] => [:g, :green] },
+            hsv: { [:h, :hue] => [:h, :hue], [:s, :saturation] => [:s, :saturation], [:v, :value] => [:v, :value] },
+            hsl: { [:h, :hue] => [:h, :hue], [:s, :saturation] => [:s, :saturation], [:l, :light] => [:l, :lightness, :luminosity, :light] }
+          }
+
+          return unless keys[format]
+
+          normalized = hash.dup
+          keys[format].each do |key, variants|
+            default = options[:short] ? key.first : key.last
+            normalized.replace_key!(variants, default)
+          end
+
+          normalized
+        end
+
+        private
+        def hue_to_rgb(hue)
+          p, q, t = hue[:p].to_f, hue[:q].to_f, hue[:t].to_f
+          t += 1 if t < 0
+          t -= 1 if t > 1
+          return p + (q - p) * 6 * t if t < (1 / 6.0)
+          return q if t < (1 / 2.0)
+          return p + (q - p) * (2 / 3.0 - t) * 6 if t < (2 / 3.0)
+          p
+        end
+
+      end
+    end
+  end
+end