Module: Color::Maker::Support

Defined in:
lib/color/maker/support.rb

Overview

Utilities methods

Class Method Summary collapse

Class Method Details

.hex_to_color(hex) ⇒ Color::RGB

Convert color from HEX to Color::RGB

Parameters:

Returns:

  • (Color::RGB) —

    color



185
186
187
188
 
# File 'lib/color/maker/support.rb', line 185

def hex_to_color(hex)
  hex = hex.sub(/0x/, '')
  Color::RGB.by_hex(hex)
end

.hsl_to_color(hsl) ⇒ Color::RGB

Convert color from HSL to Color::RGB

Examples:

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

Parameters:

Returns:

  • (Color::RGB) —

    color



155
156
157
158
 
# File 'lib/color/maker/support.rb', line 155

def hsl_to_color(hsl)
  rgb = hsl_to_rgb(hsl)
  Color::RGB.new(rgb[:r], rgb[:g], rgb[:b])
end

.hsl_to_hsv(hsl) ⇒ Hash

Convert color from HSL to HSV

Examples:

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 })

Parameters:

Returns:

  • (Hash) —

    color in HSL format



143
144
145
146
 
# File 'lib/color/maker/support.rb', line 143

def hsl_to_hsv(hsl)
  rgb = hsl_to_rgb(hsl)
  rgb_to_hsv(rgb)
end

.hsl_to_rgb(hsl) ⇒ Hash

Convert color from HSL to RGB

Examples:

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 }

Parameters:

Returns:

  • (Hash) —

    color in RGB format



109
110
111
112
113
114
115
116
117
118
119
120
121
122
 
# File 'lib/color/maker/support.rb', line 109

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

.hsv_to_color(hsv) ⇒ Color::RGB

Convert color from HSV to Color::RGB

Parameters:

Returns:

  • (Color::RGB) —

    color



176
177
178
179
 
# File 'lib/color/maker/support.rb', line 176

def hsv_to_color(hsv)
  rgb = hsv_to_rgb(hsv)
  rgb_to_color(rgb)
end

.hsv_to_hsl(hsv) ⇒ Hash

Convert color from HSV to HSL

Examples:

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 })

Parameters:

Returns:

  • (Hash) —

    color in HSL format



131
132
133
134
 
# File 'lib/color/maker/support.rb', line 131

def hsv_to_hsl(hsv)
  rgb = hsv_to_rgb(hsv)
  rgb_to_hsl(rgb)
end

.hsv_to_rgb(hsv) ⇒ Hash

Convert color from HSV to RGB format

Examples:

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 }

Parameters:

Returns:

  • (Hash) —

    color in RGB format



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/color/maker/support.rb', line 13

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

.normalize_color_keys(hash, options = {}) ⇒ Hash

Normalize color keys

Examples:

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 }

Parameters:

  • hash (Hash) —

    values in HSV, RGB or HSL format

  • options (Hash) (defaults to: {}) —

    ({ format: :rgb, short: true })

Returns:

  • (Hash) —

    color keys normalized



198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
 
# File 'lib/color/maker/support.rb', line 198

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

.rgb_to_color(rgb) ⇒ Color::RGB

Convert color from RGB to Color::RGB

Examples:

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

Parameters:

Returns:

  • (Color::RGB) —

    color



167
168
169
170
 
# File 'lib/color/maker/support.rb', line 167

def rgb_to_color(rgb)
  rgb = normalize_color_keys(rgb, format: :rgb)
  Color::RGB.new(rgb[:r], rgb[:g], rgb[:b])
end

.rgb_to_hsl(rgb) ⇒ Hash

Convert color from RGB to HSL

Examples:

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 }

Parameters:

Returns:

  • (Hash) —

    color in HSL format



77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
 
# File 'lib/color/maker/support.rb', line 77

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

.rgb_to_hsv(rgb) ⇒ Hash

Convert color from RGB to HSV

Examples:

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 }

Parameters:

Returns:

  • (Hash) —

    color in HSV format



47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
 
# File 'lib/color/maker/support.rb', line 47

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