atome 0.5.7.0.3 → 0.3191

data/lib/atome/utilities/color_helper/color/palette/gimp.rb

@@ -1,104 +0,0 @@
-require 'color/palette'
-
-# A class that can read a GIMP (GNU Image Manipulation Program) palette file
-# and provide a Hash-like interface to the contents. GIMP colour palettes
-# are RGB values only.
-#
-# Because two or more entries in a GIMP palette may have the same name, all
-# named entries are returned as an array.
-#
-#   pal = Color::Palette::Gimp.from_file(my_gimp_palette)
-#   pal[0]          => Color::RGB<...>
-#   pal["white"]    => [ Color::RGB<...> ]
-#   pal["unknown"]  => [ Color::RGB<...>, Color::RGB<...>, ... ]
-#
-# GIMP Palettes are always indexable by insertion order (an integer key).
-class Color::Palette::Gimp
-  include Enumerable
-
-  class << self
-    # Create a GIMP palette object from the named file.
-    def from_file(filename)
-      File.open(filename, "rb") { |io| Color::Palette::Gimp.from_io(io) }
-    end
-
-    # Create a GIMP palette object from the provided IO.
-    def from_io(io)
-      Color::Palette::Gimp.new(io.read)
-    end
-  end
-
-  # Create a new GIMP palette from the palette file as a string.
-  def initialize(palette)
-    @colors   = []
-    @names    = {}
-    @valid    = false
-    @name     = "(unnamed)"
-
-    palette.split($/).each do |line|
-      line.chomp!
-      line.gsub!(/\s*#.*\Z/, '')
-
-      next if line.empty?
-
-      if line =~ /\AGIMP Palette\Z/
-        @valid = true
-        next
-      end
-
-      info = /(\w+):\s(.*$)/.match(line)
-      if info
-        @name = info.captures[1] if info.captures[0] =~ /name/i
-        next
-      end
-
-      line.gsub!(/^\s+/, '')
-      data = line.split(/\s+/, 4)
-      name = data.pop.strip
-      data.map! { |el| el.to_i }
-
-      color = Color::RGB.new(*data)
-
-      @colors << color
-      @names[name] ||= []
-      @names[name]  << color
-    end
-  end
-
-  # Provides the colour or colours at the provided selectors.
-  def values_at(*selectors)
-    @colors.values_at(*selectors)
-  end
-
-  # If a Numeric +key+ is provided, the single colour value at that position
-  # will be returned. If a String +key+ is provided, the colour set (an
-  # array) for that colour name will be returned.
-  def [](key)
-    if key.kind_of?(Numeric)
-      @colors[key]
-    else
-      @names[key]
-    end
-  end
-
-  # Loops through each colour.
-  def each
-    @colors.each { |el| yield el }
-  end
-
-  # Loops through each named colour set.
-  def each_name #:yields color_name, color_set:#
-    @names.each { |color_name, color_set| yield color_name, color_set }
-  end
-
-  # Returns true if this is believed to be a valid GIMP palette.
-  def valid?
-    @valid
-  end
-
-  def size
-    @colors.size
-  end
-
-  attr_reader :name
-end

data/lib/atome/utilities/color_helper/color/palette/monocontrast.rb

@@ -1,164 +0,0 @@
-require 'color/palette'
-
-# Generates a monochromatic constrasting colour palette for background and
-# foreground. What does this mean?
-#
-# Monochromatic: A single colour is used to generate the base palette, and
-# this colour is lightened five times and darkened five times to provide
-# eleven distinct colours.
-#
-# Contrasting: The foreground is also generated as a monochromatic colour
-# palette; however, all generated colours are tested to see that they are
-# appropriately contrasting to ensure maximum readability of the foreground
-# against the background.
-class Color::Palette::MonoContrast
-  # Hash of CSS background colour values.
-  #
-  # This is always 11 values:
-  #
-  # 0::       The starting colour.
-  # +1..+5::  Lighter colours.
-  # -1..-5::  Darker colours.
-  attr_reader :background
-  # Hash of CSS foreground colour values.
-  #
-  # This is always 11 values:
-  #
-  # 0::       The starting colour.
-  # +1..+5::  Lighter colours.
-  # -1..-5::  Darker colours.
-  attr_reader :foreground
-
-  DEFAULT_MINIMUM_BRIGHTNESS_DIFF = (125.0 / 255.0)
-
-  # The minimum brightness difference between the background and the
-  # foreground, and must be between 0..1. Setting this value will regenerate
-  # the palette based on the base colours. The default value for this is 125
-  # / 255.0. If this value is set to +nil+, it will be restored to the
-  # default.
-  attr_reader :minimum_brightness_diff
-  def minimum_brightness_diff=(bd) #:nodoc:
-    @minimum_brightness_diff = if bd.nil?
-                                 DEFAULT_MINIMUM_BRIGHTNESS_DIFF
-                               elsif bd > 1.0
-                                 1.0
-                               elsif bd < 0.0
-                                 0.0
-                               else
-                                 bd
-                               end
-    regenerate(@background[0], @foreground[0])
-  end
-
-  DEFAULT_MINIMUM_COLOR_DIFF = (500.0 / 255.0)
-
-  # The minimum colour difference between the background and the foreground,
-  # and must be between 0..3. Setting this value will regenerate the palette
-  # based on the base colours. The default value for this is 500 / 255.0.
-  attr_reader :minimum_color_diff
-  def minimum_color_diff=(cd) #:nodoc:
-    @minimum_color_diff = if cd.nil?
-                            DEFAULT_MINIMUM_COLOR_DIFF
-                          elsif cd > 3.0
-                            3.0
-                          elsif cd < 0.0
-                            0.0
-                          else
-                            cd
-                          end
-    regenerate(@background[0], @foreground[0])
-  end
-
-  # Generate the initial palette.
-  def initialize(background, foreground = nil)
-    @minimum_brightness_diff = DEFAULT_MINIMUM_BRIGHTNESS_DIFF
-    @minimum_color_diff = DEFAULT_MINIMUM_COLOR_DIFF
-    regenerate(background, foreground)
-  end
-
-  # Generate the colour palettes.
-  def regenerate(background, foreground = nil)
-    foreground ||= background
-    background = background.to_rgb
-    foreground = foreground.to_rgb
-
-    @background = {}
-    @foreground = {}
-
-    @background[-5] = background.darken_by(10)
-    @background[-4] = background.darken_by(25)
-    @background[-3] = background.darken_by(50)
-    @background[-2] = background.darken_by(75)
-    @background[-1] = background.darken_by(85)
-    @background[ 0] = background
-    @background[+1] = background.lighten_by(85)
-    @background[+2] = background.lighten_by(75)
-    @background[+3] = background.lighten_by(50)
-    @background[+4] = background.lighten_by(25)
-    @background[+5] = background.lighten_by(10)
-
-    @foreground[-5] = calculate_foreground(@background[-5], foreground)
-    @foreground[-4] = calculate_foreground(@background[-4], foreground)
-    @foreground[-3] = calculate_foreground(@background[-3], foreground)
-    @foreground[-2] = calculate_foreground(@background[-2], foreground)
-    @foreground[-1] = calculate_foreground(@background[-1], foreground)
-    @foreground[ 0] = calculate_foreground(@background[ 0], foreground)
-    @foreground[+1] = calculate_foreground(@background[+1], foreground)
-    @foreground[+2] = calculate_foreground(@background[+2], foreground)
-    @foreground[+3] = calculate_foreground(@background[+3], foreground)
-    @foreground[+4] = calculate_foreground(@background[+4], foreground)
-    @foreground[+5] = calculate_foreground(@background[+5], foreground)
-  end
-
-  # Given a background colour and a foreground colour, modifies the
-  # foreground colour so that it will have enough contrast to be seen
-  # against the background colour.
-  #
-  # Uses #mininum_brightness_diff and #minimum_color_diff.
-  def calculate_foreground(background, foreground)
-    nfg = nil
-    # Loop through brighter and darker versions of the foreground color. The
-    # numbers here represent the amount of foreground color to mix with
-    # black and white.
-    [100, 75, 50, 25, 0].each do |percent|
-      dfg = foreground.darken_by(percent)
-      lfg = foreground.lighten_by(percent)
-
-      dbd = brightness_diff(background, dfg)
-      lbd = brightness_diff(background, lfg)
-
-      if lbd > dbd
-        nfg = lfg
-        nbd = lbd
-      else
-        nfg = dfg
-        nbd = dbd
-      end
-
-      ncd = color_diff(background, nfg)
-
-      break if nbd >= @minimum_brightness_diff and ncd >= @minimum_color_diff
-    end
-    nfg
-  end
-
-  # Returns the absolute difference between the brightness levels of two
-  # colours. This will be a decimal value between 0 and 1. W3C accessibility
-  # guidelines for {colour contrast}[http://www.w3.org/TR/AERT#color-contrast]
-  # suggest that this value be at least approximately 0.49 (125 / 255.0) for
-  # proper contrast.
-  def brightness_diff(c1, c2)
-    (c1.brightness - c2.brightness).abs
-  end
-
-  # Returns the contrast between to colours, a decimal value between 0 and
-  # 3. W3C accessibility guidelines for {colour
-  # contrast}[http://www.w3.org/TR/AERT#color-contrast] suggest that this
-  # value be at least approximately 1.96 (500 / 255.0) for proper contrast.
-  def color_diff(c1, c2)
-    r = (c1.r - c2.r).abs
-    g = (c1.g - c2.g).abs
-    b = (c1.b - c2.b).abs
-    r + g + b
-  end
-end

data/lib/atome/utilities/color_helper/color/palette.rb

@@ -1,4 +0,0 @@
-require 'color'
-
-module Color::Palette
-end

data/lib/atome/utilities/color_helper/color/rgb/colors.rb

@@ -1,167 +0,0 @@
-class Color::RGB
-  class << self
-    private
-    def named(rgb, *names)
-      __named_color(self, new(*rgb), *names)
-    end
-  end
-
-  named [0xf0, 0xf8, 0xff], :AliceBlue
-  named [0xfa, 0xeb, 0xd7], :AntiqueWhite
-  named [0x00, 0xff, 0xff], :Aqua
-  named [0x7f, 0xff, 0xd4], :Aquamarine
-  named [0xf0, 0xff, 0xff], :Azure
-  named [0xf5, 0xf5, 0xdc], :Beige
-  named [0xff, 0xe4, 0xc4], :Bisque
-  named [0x66, 0x33, 0x99], :RebeccaPurple, :BeccaPurple
-  named [0x00, 0x00, 0x00], :Black
-  named [0xff, 0xeb, 0xcd], :BlanchedAlmond
-  named [0x00, 0x00, 0xff], :Blue
-  named [0x8a, 0x2b, 0xe2], :BlueViolet
-  named [0xa5, 0x2a, 0x2a], :Brown
-  named [0xde, 0xb8, 0x87], :BurlyWood, :Burlywood
-  named [0x5f, 0x9e, 0xa0], :CadetBlue
-  named [0xff, 0x5e, 0xd0], :Carnation
-  named [0x8d, 0x00, 0x00], :Cayenne
-  named [0x7f, 0xff, 0x00], :Chartreuse
-  named [0xd2, 0x69, 0x1e], :Chocolate
-  named [0xff, 0x7f, 0x50], :Coral
-  named [0x64, 0x95, 0xed], :CornflowerBlue
-  named [0xff, 0xf8, 0xdc], :Cornsilk
-  named [0xdc, 0x14, 0x3c], :Crimson
-  named [0x00, 0xff, 0xff], :Cyan
-  named [0x00, 0x00, 0x8b], :DarkBlue
-  named [0x00, 0x8b, 0x8b], :DarkCyan
-  named [0xb8, 0x86, 0x0b], :DarkGoldenRod, :DarkGoldenrod
-  named [0xa9, 0xa9, 0xa9], :DarkGray, :DarkGrey
-  named [0x00, 0x64, 0x00], :DarkGreen
-  named [0xbd, 0xb7, 0x6b], :DarkKhaki
-  named [0x8b, 0x00, 0x8b], :DarkMagenta
-  named [0x55, 0x6b, 0x2f], :DarkOliveGreen, :DarkoliveGreen
-  named [0xff, 0x8c, 0x00], :DarkOrange
-  named [0x99, 0x32, 0xcc], :DarkOrchid
-  named [0x8b, 0x00, 0x00], :DarkRed
-  named [0xe9, 0x96, 0x7a], :DarkSalmon, :Darksalmon
-  named [0x8f, 0xbc, 0x8f], :DarkSeaGreen
-  named [0x48, 0x3d, 0x8b], :DarkSlateBlue
-  named [0x2f, 0x4f, 0x4f], :DarkSlateGray, :DarkSlateGrey
-  named [0x00, 0xce, 0xd1], :DarkTurquoise
-  named [0x94, 0x00, 0xd3], :DarkViolet
-  named [0xff, 0x8c, 0x00], :Darkorange
-  named [0xff, 0x14, 0x93], :DeepPink
-  named [0x00, 0xbf, 0xbf], :DeepSkyBlue
-  named [0x69, 0x69, 0x69], :DimGray, :DimGrey
-  named [0x1e, 0x90, 0xff], :DodgerBlue
-  named [0xd1, 0x92, 0x75], :Feldspar
-  named [0xb2, 0x22, 0x22], :FireBrick, :Firebrick
-  named [0xff, 0xfa, 0xf0], :FloralWhite
-  named [0x22, 0x8b, 0x22], :ForestGreen
-  named [0xff, 0x00, 0xff], :Fuchsia
-  named [0xdc, 0xdc, 0xdc], :Gainsboro
-  named [0xf8, 0xf8, 0xff], :GhostWhite
-  named [0xff, 0xd7, 0x00], :Gold
-  named [0xda, 0xa5, 0x20], :GoldenRod, :Goldenrod
-  named [0x80, 0x80, 0x80], :Gray, :Grey
-  named [10, 10, 10, 100.0], :Gray10, :Grey10
-  named [20, 20, 20, 100.0], :Gray20, :Grey20
-  named [30, 30, 30, 100.0], :Gray30, :Grey30
-  named [40, 40, 40, 100.0], :Gray40, :Grey40
-  named [50, 50, 50, 100.0], :Gray50, :Grey50
-  named [60, 60, 60, 100.0], :Gray60, :Grey60
-  named [70, 70, 70, 100.0], :Gray70, :Grey70
-  named [80, 80, 80, 100.0], :Gray80, :Grey80
-  named [90, 90, 90, 100.0], :Gray90, :Grey90
-  named [0x00, 0x80, 0x00], :Green
-  named [0xad, 0xff, 0x2f], :GreenYellow
-  named [0xf0, 0xff, 0xf0], :HoneyDew, :Honeydew
-  named [0xff, 0x69, 0xb4], :HotPink
-  named [0xcd, 0x5c, 0x5c], :IndianRed
-  named [0x4b, 0x00, 0x82], :Indigo
-  named [0xff, 0xff, 0xf0], :Ivory
-  named [0xf0, 0xe6, 0x8c], :Khaki
-  named [0xe6, 0xe6, 0xfa], :Lavender
-  named [0xff, 0xf0, 0xf5], :LavenderBlush
-  named [0x7c, 0xfc, 0x00], :LawnGreen
-  named [0xff, 0xfa, 0xcd], :LemonChiffon
-  named [0xad, 0xd8, 0xe6], :LightBlue
-  named [0xf0, 0x80, 0x80], :LightCoral
-  named [0xe0, 0xff, 0xff], :LightCyan
-  named [0xfa, 0xfa, 0xd2], :LightGoldenRodYellow, :LightGoldenrodYellow
-  named [0xd3, 0xd3, 0xd3], :LightGray, :LightGrey
-  named [0x90, 0xee, 0x90], :LightGreen
-  named [0xff, 0xb6, 0xc1], :LightPink
-  named [0xff, 0xa0, 0x7a], :LightSalmon, :Lightsalmon
-  named [0x20, 0xb2, 0xaa], :LightSeaGreen
-  named [0x87, 0xce, 0xfa], :LightSkyBlue
-  named [0x84, 0x70, 0xff], :LightSlateBlue
-  named [0x77, 0x88, 0x99], :LightSlateGray, :LightSlateGrey
-  named [0xb0, 0xc4, 0xde], :LightSteelBlue, :LightsteelBlue
-  named [0xff, 0xff, 0xe0], :LightYellow
-  named [0x00, 0xff, 0x00], :Lime
-  named [0x32, 0xcd, 0x32], :LimeGreen
-  named [0xfa, 0xf0, 0xe6], :Linen
-  named [0xff, 0x00, 0xff], :Magenta
-  named [0x80, 0x00, 0x00], :Maroon
-  named [0x66, 0xcd, 0xaa], :MediumAquaMarine, :MediumAquamarine
-  named [0x00, 0x00, 0xcd], :MediumBlue
-  named [0xba, 0x55, 0xd3], :MediumOrchid
-  named [0x93, 0x70, 0xdb], :MediumPurple
-  named [0x3c, 0xb3, 0x71], :MediumSeaGreen
-  named [0x7b, 0x68, 0xee], :MediumSlateBlue
-  named [0x00, 0xfa, 0x9a], :MediumSpringGreen
-  named [0x48, 0xd1, 0xcc], :MediumTurquoise
-  named [0xc7, 0x15, 0x85], :MediumVioletRed
-  named [0x19, 0x19, 0x70], :MidnightBlue
-  named [0xf5, 0xff, 0xfa], :MintCream
-  named [0xff, 0xe4, 0xe1], :MistyRose
-  named [0xff, 0xe4, 0xb5], :Moccasin
-  named [0xff, 0xde, 0xad], :NavajoWhite
-  named [0x00, 0x00, 0x80], :Navy
-  named [0xfd, 0xf5, 0xe6], :OldLace
-  named [0x80, 0x80, 0x00], :Olive
-  named [0x6b, 0x8e, 0x23], :OliveDrab, :Olivedrab
-  named [0xff, 0xa5, 0x00], :Orange
-  named [0xff, 0x45, 0x00], :OrangeRed
-  named [0xda, 0x70, 0xd6], :Orchid
-  named [0xee, 0xe8, 0xaa], :PaleGoldenRod, :PaleGoldenrod
-  named [0x98, 0xfb, 0x98], :PaleGreen
-  named [0xaf, 0xee, 0xee], :PaleTurquoise
-  named [0xdb, 0x70, 0x93], :PaleVioletRed
-  named [0xff, 0xef, 0xd5], :PapayaWhip
-  named [0xff, 0xda, 0xb9], :PeachPuff, :Peachpuff
-  named [0xcd, 0x85, 0x3f], :Peru
-  named [0xff, 0xc0, 0xcb], :Pink
-  named [0xdd, 0xa0, 0xdd], :Plum
-  named [0xb0, 0xe0, 0xe6], :PowderBlue
-  named [0x80, 0x00, 0x80], :Purple
-  named [0xff, 0x00, 0x00], :Red
-  named [0xbc, 0x8f, 0x8f], :RosyBrown
-  named [0x41, 0x69, 0xe1], :RoyalBlue
-  named [0x8b, 0x45, 0x13], :SaddleBrown
-  named [0xfa, 0x80, 0x72], :Salmon
-  named [0xf4, 0xa4, 0x60], :SandyBrown
-  named [0x2e, 0x8b, 0x57], :SeaGreen
-  named [0xff, 0xf5, 0xee], :SeaShell, :Seashell
-  named [0xa0, 0x52, 0x2d], :Sienna
-  named [0xc0, 0xc0, 0xc0], :Silver
-  named [0x87, 0xce, 0xeb], :SkyBlue
-  named [0x6a, 0x5a, 0xcd], :SlateBlue
-  named [0x70, 0x80, 0x90], :SlateGray, :SlateGrey
-  named [0xff, 0xfa, 0xfa], :Snow
-  named [0x00, 0xff, 0x7f], :SpringGreen
-  named [0x46, 0x82, 0xb4], :SteelBlue
-  named [0xd2, 0xb4, 0x8c], :Tan
-  named [0x00, 0x80, 0x80], :Teal
-  named [0xd8, 0xbf, 0xd8], :Thistle
-  named [0xff, 0x63, 0x47], :Tomato
-  named [0x40, 0xe0, 0xd0], :Turquoise
-  named [0xee, 0x82, 0xee], :Violet
-  named [0xd0, 0x20, 0x90], :VioletRed
-  named [0xf5, 0xde, 0xb3], :Wheat
-  named [0xff, 0xff, 0xff], :White
-  named [0xf5, 0xf5, 0xf5], :WhiteSmoke
-  named [0xff, 0xff, 0x00], :Yellow
-  named [0x9a, 0xcd, 0x32], :YellowGreen
-end
-
-require_relative 'metallic'

data/lib/atome/utilities/color_helper/color/rgb/contrast.rb

@@ -1,57 +0,0 @@
-# -*- ruby encoding: utf-8 -*-
-
-class Color::RGB
-  # Outputs how much contrast this color has with another RGB color.
-  # Computes the same regardless of which one is considered foreground. If
-  # the other color does not have a #to_rgb method, this will throw an
-  # exception. Anything over about 0.22 should have a high likelihood of
-  # being legible, but the larger the difference, the more contrast.
-  # Otherwise, to be safe go with something > 0.3
-  def contrast(other)
-    other = coerce(other)
-
-    # The following numbers have been set with some care.
-    ((diff_brightness(other) * 0.65) +
-     (diff_hue(other)        * 0.20) +
-     (diff_luminosity(other) * 0.15))
-  end
-
-  private
-  # Provides the luminosity difference between two rbg vals
-  def diff_luminosity(other)
-    other = coerce(other)
-    l1 = (0.2126 * (other.r) ** 2.2) +
-         (0.7152 * (other.b) ** 2.2) +
-         (0.0722 * (other.g) ** 2.2);
-
-    l2 = (0.2126 * (self.r) ** 2.2) +
-         (0.7152 * (self.b) ** 2.2) +
-         (0.0722 * (self.g) ** 2.2);
-
-    ((([l1, l2].max) + 0.05) / ( ([l1, l2].min) + 0.05 ) - 1) / 20.0
-  end
-
-  # Provides the brightness difference.
-  def diff_brightness(other)
-    other = other.to_rgb
-    br1 = (299 * other.r + 587 * other.g + 114 * other.b)
-    br2 = (299 * self.r + 587 * self.g + 114 * self.b)
-    (br1 - br2).abs / 1000.0;
-  end
-
-  # Provides the euclidean distance between the two color values
-  def diff_euclidean(other)
-    other = other.to_rgb
-    ((((other.r - self.r) ** 2) +
-      ((other.g - self.g) ** 2) +
-      ((other.b - self.b) ** 2)) ** 0.5) / 1.7320508075688772
-  end
-
-  # Difference in the two colors' hue
-  def diff_hue(other)
-    other = other.to_rgb
-    ((self.r - other.r).abs +
-     (self.g - other.g).abs +
-     (self.b - other.b).abs) / 3
-  end
-end

data/lib/atome/utilities/color_helper/color/rgb/metallic.rb

@@ -1,28 +0,0 @@
-# -*- ruby encoding: utf-8 -*-
-
-class Color::RGB
-  # This namespace contains some RGB metallic colours suggested by Jim
-  # Freeze.
-  module Metallic; end
-
-  class << self
-    private
-    def metallic(rgb, *names)
-      __named_color(Metallic, new(*rgb), *names)
-    end
-  end
-
-  metallic [0x99, 0x99, 0x99], :Aluminum
-  metallic [0xd9, 0x87, 0x19], :CoolCopper
-  metallic [0xb8, 0x73, 0x33], :Copper
-  metallic [0x4c, 0x4c, 0x4c], :Iron
-  metallic [0x19, 0x19, 0x19], :Lead
-  metallic [0xb3, 0xb3, 0xb3], :Magnesium
-  metallic [0xe6, 0xe6, 0xe6], :Mercury
-  metallic [0x80, 0x80, 0x80], :Nickel
-  metallic [0x60, 0x00, 0x00], :PolySilicon, :Poly
-  metallic [0xcc, 0xcc, 0xcc], :Silver
-  metallic [0x66, 0x66, 0x66], :Steel
-  metallic [0x7f, 0x7f, 0x7f], :Tin
-  metallic [0x33, 0x33, 0x33], :Tungsten
-end