redgreenblue 0.11.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc4e866d75637857fb5a4b27b77829e20f488e321fa287b73a5d6d9c21d194a9
-  data.tar.gz: e3f9e875b0a8893bd21a6cd503702881833f54873557f84c4cf4776338294668
+  metadata.gz: 0e6715019b7628fa8a5027295b3fb5e617f829d494eda1c4a0dad495adca6e44
+  data.tar.gz: 745987a3b640392f140bc6f7d3d18575f815a75a00d96162a0a9f3cdba64cc71
 SHA512:
-  metadata.gz: 94b96125e65443d7ceb66cfabf9ba6b0681bfc51046b8d308e86d0904a58a7f745f6ea159a040ee79dcb9713ace9adbc416a5705c4b2ebb85333bf09f0dd9a43
-  data.tar.gz: f3e0bd4c0cdcd432dd50fc518f1d2062c66ac907f55b3235405589b2d797791c48b3d62284ae665a8fc4d60c4209ce0b3d46d07a459e15d2fa261d9b1aa8df1d
+  metadata.gz: 16538077413e35eeeae4d4da51bfd6eca7d7d3c9beba338df99742278762aa243dce8262fd9f95276154881dbdafe5ab26e4282ac2e485d82337f69a3bb61679
+  data.tar.gz: 5dabac01d2f52b4cd187f4248a4d3a520e76ff5c419ead409468bb01b14935b67b528375fca2ad338d79f8257c74489511609da792a88f52f4eb8de670377cd6

data/lib/redgreenblue/base.rb

@@ -8,7 +8,7 @@ class RGB
   #
   # Currently always 'sRGB'.
   def color_space
-    @color_space ||= 'sRGB'
+    'sRGB'
   end
 
   # Returns the red component as a value between 0 and 1.

data/lib/redgreenblue/{cie.rb → cie_1931.rb}

@@ -5,15 +5,18 @@ class RGB
   # Based on:
   # - http://www.brucelindbloom.com/index.html?Eqn_RGB_to_XYZ.html
   # - https://en.wikipedia.org/wiki/CIE_1931_color_space
-  # sRGB to XYZ matrix for D65 reference white by Bruce Lindbloom:
-  # - http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html
-  def cie_xyz
+  # sRGB to XYZ matrix for D65 reference white calculated with Javascript by Bruce Lindbloom:
+  # - http://www.brucelindbloom.com/ColorCalculator.html
+  def cie_xyz(round: true)
     r, g, b = linear_values
+
     [
-      r * 0.4124564 + g * 0.3575761 + b * 0.1804375,
-      r * 0.2126729 + g * 0.7151522 + b * 0.0721750,
-      r * 0.0193339 + g * 0.1191920 + b * 0.9503041
-    ].map { |v| v.round(6) }
+
+      r * 0.4124_5643_9090 + g * 0.3575_7607_7644 + b * 0.1804_3748_3266,
+      r * 0.2126_7285_1406 + g * 0.7151_5215_5288 + b * 0.0721_7499_3307,
+      r * 0.0193_3389_5582 + g * 0.1191_9202_5881 + b * 0.9503_0407_8536
+
+    ].map { |v| round ? v.round(8) : v }
   end
 
   alias xyz cie_xyz
@@ -25,12 +28,15 @@ class RGB
   # - http://www.brucelindbloom.com/index.html?Eqn_XYZ_to_xyY.html
   # - https://ninedegreesbelow.com/photography/xyz-rgb.html
   def cie_xyy
-    x, y, z = xyz
+    x, y, z = cie_xyz(round: false)
+
     [
+
       x / ( x + y + z ),
       y / ( x + y + z ),
       y
-    ].map { |v| v.round(6) }
+
+    ].map { |v| v.round(8) }
   end
 
   alias xyy cie_xyy

data/lib/redgreenblue/cie_1976.rb

@@ -0,0 +1,105 @@
+class RGB
+
+  # Returns CIE 1976 L*a*b* (CIELAB) values for the RGB object.
+  def cie_lab(round: true)
+    cie_lab_luv(round: round, type: :lab)
+  end
+
+  alias lab cie_lab
+
+  # Returns CIE 1976 LCHab values for the RGB object, derived from L*a*b* (CIELAB).
+  #
+  # When C is 0, H is nil.
+  def cie_lch_ab
+    cie_lch_ab_uv(type: :lab)
+  end
+
+  # Returns CIE 1976 L*u*v* (CIELUV) values for the RGB object.
+  def cie_luv(round: true)
+    cie_lab_luv(round: round, type: :luv)
+  end
+
+  alias luv cie_luv
+
+  # Returns CIE 1976 LCHuv values for the RGB object, derived from L*u*v* (CIELUV).
+  #
+  # When C is 0, H is nil.
+  def cie_lch_uv
+    cie_lch_ab_uv(type: :luv)
+  end
+
+  # Returns the difference between this color and another color, according to the CIE 1976 delta E formula.
+  #
+  # Based on:
+  # - http://www.brucelindbloom.com/Eqn_DeltaE_CIE76.html
+  # - https://en.wikipedia.org/wiki/Color_difference
+  def delta_e_cie_1976(another)
+    l , a , b  =         cie_lab(round: false)
+    l2, a2, b2 = another.cie_lab(round: false)
+
+    Math.sqrt( (l - l2) ** 2 + (a - a2) ** 2 + (b - b2) ** 2 ).round(8)
+  end
+
+  alias de76 delta_e_cie_1976
+
+  private
+
+  # Returns either CIE 1976 L*a*b* (CIELAB) or CIE 1976 L*u*v* (CIELUV) values for the RGB object.
+  #
+  # L*a*b* formula based on:
+  # - http://www.brucelindbloom.com/Eqn_XYZ_to_Lab.html
+  # - https://en.wikipedia.org/wiki/CIELAB_color_space
+  # With peeking at:
+  # - https://github.com/halostatue/color/blob/master/lib/color/rgb.rb
+  #
+  # L*u*v* formula based on:
+  # - http://www.brucelindbloom.com/Eqn_XYZ_to_Luv.html
+  # - https://en.wikipedia.org/wiki/CIELUV
+  def cie_lab_luv(round: true, type: :lab)
+    x , y , z  =           cie_xyz(round: false)
+    xr, yr, zr = RGB.white.cie_xyz(round: false)
+
+    f = [ x / xr, y / yr, z / zr ].map { |v|
+      if v > ( 216.0 / 24389 )
+        Math.cbrt v
+      else
+        ( 24389.0 / 27 * v + 16 ) / 116.0
+      end
+    }
+
+    if type == :luv
+      [
+        l = 116 * f[1] - 16,
+        13 * l * ( ( 4 * x ) / ( x + 15 * y + 3 * z ) - ( 4 * xr ) / ( xr + 15 * yr + 3 * zr ) ),
+        13 * l * ( ( 9 * y ) / ( x + 15 * y + 3 * z ) - ( 9 * yr ) / ( xr + 15 * yr + 3 * zr ) )
+      ]
+    else
+      [
+        116 *  f[1] - 16,
+        500 * (f[0] - f[1]),
+        200 * (f[1] - f[2])
+      ]
+    end.map { |v| v.nan? ? 0.0 : ( round ? v.round(8) : v ) }
+  end
+
+  # Returns either CIE 1976 LCHab or CIE 1976 LCHuv values for the RGB object.
+  #
+  # Based on:
+  # - http://www.brucelindbloom.com/Eqn_Lab_to_LCH.html
+  # - http://www.brucelindbloom.com/Eqn_Luv_to_LCH.html
+  # - https://en.wikipedia.org/wiki/CIELAB_color_space
+  def cie_lch_ab_uv(type: :lab)
+    if type == :luv
+      l, v1, v2 = cie_luv(round: false)
+    else
+      l, v1, v2 = cie_lab(round: false)
+    end
+
+    [
+      l.round(8),
+      c = Math.hypot(v1, v2).round(8),
+      c == 0 ? nil : ( Math.atan2(v2, v1) * 180.0 / Math::PI ).modulo(360).round(8)
+    ]
+  end
+
+end

data/lib/redgreenblue/cie_1994.rb

@@ -0,0 +1,55 @@
+class RGB
+
+  # Returns the difference between this (reference) color and another color, according to the CIE 1994 delta E formula.
+  #
+  # By default uses parameters for use in graphic arts, and reference conditions.
+  # Parameters (k1, k2, kl, kc, kh) can be individually overriden for different applications and for variations in conditions.
+  #
+  # Based on:
+  # - http://www.brucelindbloom.com/Eqn_DeltaE_CIE94.html
+  # - https://archive.org/details/gov.law.cie.15.2004
+  # - https://en.wikipedia.org/wiki/Color_difference
+  def delta_e_cie_1994(another, k1: 0.045, k2: 0.015, kl: 1, kc: 1, kh: 1)
+
+    l , a , b  =         cie_lab(round: false)
+    l2, a2, b2 = another.cie_lab(round: false)
+
+    c  = Math.hypot(a , b )
+    c2 = Math.hypot(a2, b2)
+
+    da = a - a2
+    db = b - b2
+    dc = c - c2
+
+    dh2 = (da ** 2) + (db ** 2) - (dc ** 2)
+    dl = l - l2
+
+    sl = 1
+    sc = 1 + k1 * c
+    sh = 1 + k2 * c
+
+    Math.sqrt(
+      ( (dl  / ( kl*sl)) ** 2  ) +
+      ( (dc  / ( kc*sc)) ** 2  ) +
+      (  dh2 / ((kh*sh)  ** 2) )
+    ).round(6)
+
+  end
+
+  alias de94 delta_e_cie_1994
+
+  # Returns the difference between this (reference) color and another color, according to the CIE 1994 delta E formula.
+  #
+  # For use in graphic arts, under reference conditions.
+  def de94g(another)
+    delta_e_cie_1994(another)
+  end
+
+  # Returns the difference between this (reference) color and another color, according to the CIE 1994 delta E formula.
+  #
+  # For use with textiles, under reference conditions.
+  def de94t(another)
+    delta_e_cie_1994(another, k1: 0.048, k2: 0.014, kl: 2)
+  end
+
+end

data/lib/redgreenblue/gpl.rb

@@ -1,30 +1,94 @@
 class RGB
 
-  ########################################################################
-  # Class methods                                                        #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
 
   class << self
 
-    private
+    # Creates a new RGB object from a line of gpl (Gimp color palette) input. Returns nil if not successful.
+    #
+    # @example
+    #  RGB.gpl "255 153 204\tpink"
+    def gpl(line)
+      if line.chomp.match( /^\s*(?<r>\d{1,3})\s+(?<g>\d{1,3})\s+(?<b>\d{1,3})(\s+(?<name>.*))?/ )
+        color = RGB.rgb $~[:r].to_i, $~[:g].to_i, $~[:b].to_i
+        color.name = $~[:name] if $~[:name]
+        color
+      else
+        nil
+      end
+    end
+
+    # Loads a gpl (Gimp color palette) source and returns an array of RGB objects.
+    #
+    # Options:
+    # - file: Path to a .gpl file to be loaded.
+    # - url: URL for a .gpl source to be loaded.
+    # - compact: Defaults to true. If set to false, returns nil for each line that can not be parsed to an RGB color.
+    # - freeze: Defaults to false. If set to true, returns a frozen array of frozen objects.
+    #
+    # @example String
+    #  RGB.load_gpl "255 0 0\tred\n255 153 204\tpink\n"
+    # @example File
+    #  RGB.load_gpl file: '/path/to/palette.gpl'
+    #  RGB.load_gpl file: '/path/to/palette.gpl', compact: false
+    # @example URL
+    #  RGB.load_gpl url: 'https://lospec.com/palette-list/yuko-tomita-time.gpl'
+    def load_gpl(source=nil, file: nil, url: nil, compact: true, freeze: false)
+
+      if ! source
+        if file
+          source = File.open file
+        elsif url
+          require 'open-uri'
+          source = URI.open url
+        end
+      end
+
+      if source.respond_to? :each_line
+        list = source.each_line.map { |line| RGB.gpl(line) }
+
+        if compact
+          list.compact!
+        end
+
+        if freeze
+          list.freeze
+          list.each &:freeze
+        end
+
+        list
+      else
+        raise ArgumentError, 'Not a valid source'
+      end
+    end
 
+    # Returns a header for a .gpl file (Gimp color palette). Includes an optional name and number of columns.
+    #
+    # @example
+    #  RGB.gpl_header('Spring')
+    #
     # Reverse-engineered from:
     # - https://github.com/GNOME/gimp/blob/5d79fba8238a27b8691556489898d33b3fa0dda0/app/core/gimppalette-load.c
-    def gpl_header(name, columns=nil)
+    def gpl_header(name=nil, columns: nil)
       "GIMP Palette\n" +
-      "Name: #{name}\n" +
+      ( name    ? "Name: #{name}\n"       : '' ) +
       ( columns ? "Columns: #{columns}\n" : '' )
     end
 
   end
 
-  ########################################################################
-  # Instance methods                                                     #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                           Instance Methods                           #
+  #----------------------------------------------------------------------#
 
-  # Returns the color in the format used in .gpl files (Gimp color palettes). A name for the color is optional.
-  def gpl(name=nil)
-    ( "%3d %3d %3d" % rgb ) + ( name ? "\t#{name}" : '' )
+  # Returns the color in the format used in .gpl files (Gimp color palettes), including its name (if present).
+  #
+  # You can optionally supply a name as argument.
+  def gpl(gpl_name=name)
+    ( "%3d %3d %3d" % rgb ) +
+    ( gpl_name.to_s.size != 0 ? "\t#{gpl_name}" : '' )
   end
 
 end

data/lib/redgreenblue/hsb.rb

@@ -2,9 +2,9 @@ require 'redgreenblue/hsv'
 
 class RGB
 
-  ########################################################################
-  # Class methods                                                        #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
 
   class << self
 
@@ -13,9 +13,9 @@ class RGB
 
   end
 
-  ########################################################################
-  # Instance methods                                                     #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                           Instance Methods                           #
+  #----------------------------------------------------------------------#
 
   # Returns color as HSB:
   # hue (0..360), saturation (0..1), brightness (0..1).

data/lib/redgreenblue/hsl.rb

@@ -3,9 +3,9 @@ require 'redgreenblue/math'
 
 class RGB
 
-  ########################################################################
-  # Class methods                                                        #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
 
   class << self
 
@@ -23,9 +23,9 @@ class RGB
 
   end
 
-  ########################################################################
-  # Instance methods                                                     #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                           Instance Methods                           #
+  #----------------------------------------------------------------------#
 
   # Returns color as HSL:
   # hue (0..360), saturation (0..1), lightness (0..1).

data/lib/redgreenblue/hsv.rb

@@ -3,9 +3,9 @@ require 'redgreenblue/math'
 
 class RGB
 
-  ########################################################################
-  # Class methods                                                        #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
 
   class << self
 
@@ -23,9 +23,9 @@ class RGB
 
   end
 
-  ########################################################################
-  # Instance methods                                                     #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                           Instance Methods                           #
+  #----------------------------------------------------------------------#
 
   # Returns color as HSV:
   # hue (0..360), saturation (0..1), value (0..1).

data/lib/redgreenblue/hsx_shared.rb

@@ -1,8 +1,8 @@
 class RGB
 
-  ########################################################################
-  # Class methods                                                        #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
 
   class << self
 
@@ -48,9 +48,9 @@ class RGB
 
   end
 
-  ########################################################################
-  # Instance methods                                                     #
-  ########################################################################
+  #----------------------------------------------------------------------#
+  #                           Instance Methods                           #
+  #----------------------------------------------------------------------#
 
   private
 

data/lib/redgreenblue/hwb.rb

@@ -0,0 +1,14 @@
+class RGB
+
+  # Returns the color's hue (0..360), whiteness (0..1), and blackness (0..1), as defined by the HWB color model.
+  #
+  # For achromatic colors, hue is nil.
+  #
+  # Based on:
+  # - http://alvyray.com/Papers/CG/HWB_JGTv208.pdf (PDF)
+  # - https://en.wikipedia.org/wiki/HWB_color_model
+  def hwb
+    [ hsv_h, cwk[1,2] ].flatten
+  end
+
+end

data/lib/redgreenblue/inspect.rb

@@ -3,11 +3,11 @@ class RGB
   private
 
   def _inspect_default(prefix='RGB')
-    "#{prefix} ##{hex} (red=%1.5f green=%1.5f blue=%1.5f)" % [red, green, blue]
+    "#{prefix} #{_inspect_hex} (red=%1.5f green=%1.5f blue=%1.5f)" % [red, green, blue] + ( name ? ' ' + name : '' )
   end
 
   def _inspect_hex
-    "##{hex}"
+    (self == snap ? '#' : '~') + hex
   end
 
   def _inspect_swatch
@@ -15,13 +15,17 @@ class RGB
   end
 
   def _inspect_short
-    _inspect_swatch + " ##{hex}"
+    "#{_inspect_swatch} #{_inspect_hex}"
   end
 
   def _inspect_simple
     _inspect_default _inspect_swatch
   end
 
+  def _inspect_name
+    _inspect_swatch + ( name ? ' ' + name : '' )
+  end
+
   public
 
   # Returns a programmer-friendly representation of the object.

data/lib/redgreenblue/lazy.rb

@@ -1,53 +1,73 @@
 class RGB
 
-  # Creates a white RGB object.
-  def self.white
-    new(1,1,1)
-  end
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
 
-  # Creates a black RGB object.
-  def self.black
-    new(0,0,0)
-  end
+  class << self
 
-  # Creates a grey RGB object. Defaults to lightness 0.5, a middle grey. Black equals grey(0), white equals grey(1).
-  #
-  # ::gray is an alias for ::grey.
-  def self.grey(lightness=0.5)
-    new(lightness, lightness, lightness)
-  end
+    # Creates a white RGB object.
+    def white
+      new(1,1,1)
+    end
 
-  # Alias gray for grey.
-  self.singleton_class.send(:alias_method, :gray, :grey)
+    # Creates a black RGB object.
+    def black
+      new(0,0,0)
+    end
 
-  # Creates a pure red RGB object.
-  def self.red
-    new(1,0,0)
-  end
+    # Creates a grey RGB object. Defaults to lightness 0.5, a middle grey. Black equals grey(0), white equals grey(1).
+    #
+    # ::gray is an alias for ::grey.
+    def grey(lightness=0.5)
+      new(lightness, lightness, lightness)
+    end
 
-  # Creates a pure green RGB object.
-  def self.green
-    new(0,1,0)
-  end
+    # Alias gray for grey.
+    alias gray grey
 
-  # Creates a pure blue RGB object.
-  def self.blue
-    new(0,0,1)
-  end
+    # Creates a pure red RGB object.
+    def red
+      new(1,0,0)
+    end
 
-  # Creates a yellow RGB object.
-  def self.yellow
-    new(1,1,0)
-  end
+    # Creates a pure green RGB object.
+    def green
+      new(0,1,0)
+    end
 
-  # Creates a cyan RGB object.
-  def self.cyan
-    new(0,1,1)
-  end
+    # Creates a pure blue RGB object.
+    def blue
+      new(0,0,1)
+    end
+
+    # Creates a yellow RGB object.
+    def yellow
+      new(1,1,0)
+    end
+
+    # Creates a cyan RGB object.
+    def cyan
+      new(0,1,1)
+    end
+
+    # Creates a magenta RGB object.
+    def magenta
+      new(1,0,1)
+    end
+
+    # Returns the 8 corners of the RGB cube.
+    def corners
+      [ black, red, yellow, green, cyan, blue, magenta, white ]
+    end
+
+    # Returns the centre of the RGB cube.
+    def centre
+      grey
+    end
+
+    alias center centre
 
-  # Creates a magenta RGB object.
-  def self.magenta
-    new(1,0,1)
   end
 
 end

data/lib/redgreenblue/mac.rb

@@ -0,0 +1,8 @@
+class RGB
+
+  # Returns the color in the format used by AppleScript (a 48-bit RGB triplet).
+  def applescript
+    "{%i, %i, %i}" % rrggbb
+  end
+
+end

data/lib/redgreenblue/match.rb

@@ -0,0 +1,49 @@
+class RGB
+
+  # Matches this color to a set of colors by calculating their euclidean distance.
+  #
+  # Returns the given set of colors with their distance from this color, sorted by distance (nearest color first).
+  # @example What is nearer: red, grey or white?
+  #  RGB.hex('f9c').match_distance [RGB.red, RGB.grey, RGB.white]
+  def match_distance(others)
+    others.map { |c| [ c, distance(c) ] }.sort_by { |a| a[1] }
+  end
+
+  # Matches this color to a set of colors using the CIE 1976 delta E formula.
+  #
+  # Returns the given set of colors with their difference from this color, sorted by difference (nearest color first).
+  # @example Find the 3 nearest CSS named colors
+  #  RGB.hex('f9c').match_de76(RGB.css).first(3)
+  def match_de76(others)
+    others.map { |c| [ c, de76(c) ] }.sort_by { |a| a[1] }
+  end
+
+  # Matches this (reference) color to a set of colors using the CIE 1994 delta E formula.
+  #
+  # Returns the given set of colors with their difference from this color, sorted by difference (nearest color first).
+  #
+  # By default uses parameters for use in graphic arts, and reference conditions.
+  # Parameters (k1, k2, kl, kc, kh) can be individually overriden for different applications and for variations in conditions.
+  def match_de94(others, k1: 0.045, k2: 0.015, kl: 1, kc: 1, kh: 1)
+    others.map { |c| [ c, de94(c, k1: k1, k2: k2, kl: kl, kc: kc, kh: kh) ] }.sort_by { |a| a[1] }
+  end
+
+  # Matches this (reference) color to a set of colors using the CIE 1994 delta E formula.
+  #
+  # For use in graphic arts, under reference conditions.
+  #
+  # Returns the given set of colors with their difference from this color, sorted by difference (nearest color first).
+  def match_de94g(others)
+    others.map { |c| [ c, de94g(c) ] }.sort_by { |a| a[1] }
+  end
+
+  # Matches this (reference) color to a set of colors using the CIE 1994 delta E formula.
+  #
+  # For use with textiles, under reference conditions.
+  #
+  # Returns the given set of colors with their difference from this color, sorted by difference (nearest color first).
+  def match_de94t(others)
+    others.map { |c| [ c, de94t(c) ] }.sort_by { |a| a[1] }
+  end
+
+end

data/lib/redgreenblue/misc.rb

@@ -36,4 +36,17 @@ class RGB
     RGB.new(v[0].red, v[1].green, v[2].blue)
   end
 
+  # Returns the euclidean distance between this color and another color.
+  #
+  # When you imagine a color as a point in a 3-dimensional space,
+  # the dimensions being red, green, and blue,
+  # this is the distance between two colors.
+  def distance(another)
+    (
+      ( (another.red   - red  ) ** 2) +
+      ( (another.green - green) ** 2) +
+      ( (another.blue  - blue ) ** 2)
+    ) ** (1/2.0)
+  end
+
 end

data/lib/redgreenblue/name.rb

@@ -0,0 +1,13 @@
+class RGB
+
+  # Returns the name.
+  def name
+    defined?(@name) ? @name : nil
+  end
+
+  # Sets the name (a string or nil).
+  def name=(text)
+    @name = ( text.to_s.size != 0 ) ? text.to_s : nil
+  end
+
+end

data/lib/redgreenblue/opt/philipshue.rb

@@ -22,6 +22,8 @@ class RGB
   # @example Use
   #  RGB.magenta.to_philips_hue_api_hsb_arguments
   #  => {"on"=>true, "bri"=>254, "hue"=>54613, "sat"=>254}
+  #  RGB.black.to_philips_hue_api_hsb_arguments
+  #  => {"on"=>false}
   # @return [Hash] API arguments
   def to_philips_hue_api_hsb_arguments(black_off=true)
     my_hsb = hsb

data/lib/redgreenblue/os/mac.rb

@@ -3,7 +3,7 @@ class RGB
   # On Mac OS, shows the color picker to choose a color for the RGB object.
   # Not available on other platforms.
   def pick
-    result = RGB.mac_choose(rrggbb)
+    result = RGB.mac_choose(self)
     if result
       self.rrggbb = result
     end
@@ -14,7 +14,7 @@ class RGB
   #
   # If no default color is specified, the picker defaults to a middle grey.
   def self.pick(default_color=RGB.new)
-    result = RGB.mac_choose(default_color.rrggbb)
+    result = RGB.mac_choose(default_color)
     if result
       RGB.rrggbb result
     else
@@ -32,7 +32,7 @@ class RGB
   #
   # Applescript command documented here:
   # Standard Additions -> User Interaction -> choose color
-  def self.mac_choose(color)
+  def self.mac_choose(default_color)
 
     app = case ENV['TERM_PROGRAM']
       when /iTerm\.app/
@@ -44,7 +44,7 @@ class RGB
     script = <<~ENDSCRIPT
       tell application "#{app}"
         try
-          return choose color default color { #{color[0]}, #{color[1]}, #{color[2]} }
+          return choose color default color #{default_color.applescript}
         on error
           return ""
         end try

data/lib/redgreenblue/ostwald.rb

@@ -32,12 +32,12 @@ class RGB
   # Based on:
   # - Color for the Sciences, pp. 575–591
   # - https://lirias.kuleuven.be/retrieve/306124 (PDF)
-  def ostwald_cwk
+  def ostwald_cwk(round: true)
     [
       color_portion = values.max - values.min,
       white_portion = values.min,
       1 - color_portion - white_portion
-    ]
+    ].map { |v| round ? v.round(8) : v }
   end
 
   alias cwk ostwald_cwk

data/lib/redgreenblue/palettes/css.gpl

@@ -0,0 +1,164 @@
+GIMP Palette
+Name: CSS Named Colors
+#
+# As per CSS Color Module Level 4, Editor's Draft, 19 August 2020.
+#   - source: https://drafts.csswg.org/css-color/#named-colors
+#
+# Notes: 
+#  "Don't cite this document other than as work in progress."
+#
+#  "CSS defines a large set of named colors, so that 
+#   common colors can be written and read more easily."
+#
+#  "[...] all of these keywords are ASCII case-insensitive."
+#
+#  "The names resolve to colors in sRGB."
+#
+240 248 255	aliceblue
+250 235 215	antiquewhite
+  0 255 255	aqua
+127 255 212	aquamarine
+240 255 255	azure
+245 245 220	beige
+255 228 196	bisque
+  0   0   0	black
+255 235 205	blanchedalmond
+  0   0 255	blue
+138  43 226	blueviolet
+165  42  42	brown
+222 184 135	burlywood
+ 95 158 160	cadetblue
+127 255   0	chartreuse
+210 105  30	chocolate
+255 127  80	coral
+100 149 237	cornflowerblue
+255 248 220	cornsilk
+220  20  60	crimson
+  0 255 255	cyan
+  0   0 139	darkblue
+  0 139 139	darkcyan
+184 134  11	darkgoldenrod
+169 169 169	darkgray
+  0 100   0	darkgreen
+169 169 169	darkgrey
+189 183 107	darkkhaki
+139   0 139	darkmagenta
+ 85 107  47	darkolivegreen
+255 140   0	darkorange
+153  50 204	darkorchid
+139   0   0	darkred
+233 150 122	darksalmon
+143 188 143	darkseagreen
+ 72  61 139	darkslateblue
+ 47  79  79	darkslategray
+ 47  79  79	darkslategrey
+  0 206 209	darkturquoise
+148   0 211	darkviolet
+255  20 147	deeppink
+  0 191 255	deepskyblue
+105 105 105	dimgray
+105 105 105	dimgrey
+ 30 144 255	dodgerblue
+178  34  34	firebrick
+255 250 240	floralwhite
+ 34 139  34	forestgreen
+255   0 255	fuchsia
+220 220 220	gainsboro
+248 248 255	ghostwhite
+255 215   0	gold
+218 165  32	goldenrod
+128 128 128	gray
+  0 128   0	green
+173 255  47	greenyellow
+128 128 128	grey
+240 255 240	honeydew
+255 105 180	hotpink
+205  92  92	indianred
+ 75   0 130	indigo
+255 255 240	ivory
+240 230 140	khaki
+230 230 250	lavender
+255 240 245	lavenderblush
+124 252   0	lawngreen
+255 250 205	lemonchiffon
+173 216 230	lightblue
+240 128 128	lightcoral
+224 255 255	lightcyan
+250 250 210	lightgoldenrodyellow
+211 211 211	lightgray
+144 238 144	lightgreen
+211 211 211	lightgrey
+255 182 193	lightpink
+255 160 122	lightsalmon
+ 32 178 170	lightseagreen
+135 206 250	lightskyblue
+119 136 153	lightslategray
+119 136 153	lightslategrey
+176 196 222	lightsteelblue
+255 255 224	lightyellow
+  0 255   0	lime
+ 50 205  50	limegreen
+250 240 230	linen
+255   0 255	magenta
+128   0   0	maroon
+102 205 170	mediumaquamarine
+  0   0 205	mediumblue
+186  85 211	mediumorchid
+147 112 219	mediumpurple
+ 60 179 113	mediumseagreen
+123 104 238	mediumslateblue
+  0 250 154	mediumspringgreen
+ 72 209 204	mediumturquoise
+199  21 133	mediumvioletred
+ 25  25 112	midnightblue
+245 255 250	mintcream
+255 228 225	mistyrose
+255 228 181	moccasin
+255 222 173	navajowhite
+  0   0 128	navy
+253 245 230	oldlace
+128 128   0	olive
+107 142  35	olivedrab
+255 165   0	orange
+255  69   0	orangered
+218 112 214	orchid
+238 232 170	palegoldenrod
+152 251 152	palegreen
+175 238 238	paleturquoise
+219 112 147	palevioletred
+255 239 213	papayawhip
+255 218 185	peachpuff
+205 133  63	peru
+255 192 203	pink
+221 160 221	plum
+176 224 230	powderblue
+128   0 128	purple
+102  51 153	rebeccapurple
+255   0   0	red
+188 143 143	rosybrown
+ 65 105 225	royalblue
+139  69  19	saddlebrown
+250 128 114	salmon
+244 164  96	sandybrown
+ 46 139  87	seagreen
+255 245 238	seashell
+160  82  45	sienna
+192 192 192	silver
+135 206 235	skyblue
+106  90 205	slateblue
+112 128 144	slategray
+112 128 144	slategrey
+255 250 250	snow
+  0 255 127	springgreen
+ 70 130 180	steelblue
+210 180 140	tan
+  0 128 128	teal
+216 191 216	thistle
+255  99  71	tomato
+ 64 224 208	turquoise
+238 130 238	violet
+245 222 179	wheat
+255 255 255	white
+245 245 245	whitesmoke
+255 255   0	yellow
+154 205  50	yellowgreen

data/lib/redgreenblue/version.rb

@@ -1,7 +1,7 @@
 class RGB
 
   # redgreenblue version.
-  VERSION = '0.11.0'
+  VERSION = '0.15.0'
 
   # Returns RGB::VERSION.
   def self.version

data/lib/redgreenblue/view.rb

@@ -0,0 +1,40 @@
+class RGB
+
+  # Prints a color swatch and details for the RGB object, using multiple lines.
+  #
+  # You can optionally supply a second color to be shown inside the swatch, for comparison.
+  def view(other=nil)
+    puts _inspect_view other
+  end
+
+  alias v view
+
+  private
+
+  def _inspect_view(other=nil)
+    o = []
+    o << 3.times.map { terminal_background + "      \e[0m "}
+    o << [ "#{_inspect_hex} ", '%-7.7s ' % color_space, '        ' ]
+
+    if other
+      o[0][1] = terminal_background + '  ' + other.terminal_background + '  ' + terminal_background + "  \e[0m "
+    end
+
+    o << components.map { |c| c.terminal_background + "  \e[0m " }
+    o << %w(R: G: B:)
+    o << values.map { |v| '%1.5f ' % v }
+    o << rgb.map { |v| '%3d ' % v }
+
+    o << %w(H: S: L:)
+    o << hsl.map { |v| v ? ('%7.3f ' % v) : '  -     ' }
+    o << %w(H: S: B:)
+    o << hsb.map { |v| v ? ('%7.3f ' % v) : '  -     ' }
+
+    o << 3.times.map { (ostwald_color ? ostwald_color.terminal_background + "  \e[0m " : '   ') }
+    o << %w(C: W: K:)
+    o << ostwald_cwk.map { |v| '%1.3f ' % v }
+
+    o.transpose.map(&:join).join("\n")
+  end
+
+end

data/lib/redgreenblue/web.rb

@@ -1,5 +1,60 @@
 class RGB
 
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
+
+  class << self
+
+    # Returns CSS named colors, as per CSS Color Module Level 4.
+    #
+    # Optional selector argument can be:
+    # - String or Regexp (to select by name)
+    # - RGB color (to select by color)
+    # - Integer (to select by index).
+    # Selection by name (string or regular expression) is case-insensitive by default.
+    #
+    # @example No Selector
+    #  # All colors
+    #  RGB.css
+    #
+    #  # Pastels
+    #  RGB.css.select { |c| c.ostwald_cwk[1] > 0.6 }
+    # @example Select by Name
+    #  # Exact name
+    #  RGB.css 'pink'
+    #
+    #  # Regular expression
+    #  RGB.css /pink|rose/
+    #
+    # @example Select by RGB color
+    #  RGB.css RGB.hex('0ff')
+    def css(selector=nil)
+      @@css ||= load_gpl file: ( File.join File.dirname(__FILE__), 'palettes', 'css.gpl' ), freeze: true
+      case selector
+        when NilClass
+          @@css
+        when String
+          n = selector.downcase
+          @@css.select { |c| c.name == n }.first
+        when Regexp
+          r = Regexp.new selector.source, Regexp::IGNORECASE
+          @@css.select { |c| c.name =~ r }
+        when Integer
+          @@css[selector]
+        when self
+          @@css.select { |c| c == selector }
+        else
+          raise ArgumentError, 'Unsupported selector'
+      end
+    end
+
+  end
+
+  #----------------------------------------------------------------------#
+  #                           Instance Methods                           #
+  #----------------------------------------------------------------------#
+
   # Returns the object's RGB value in hexadecimal notation as used in CSS.
   #
   # Shortens to 3 digits when possible.
@@ -7,4 +62,53 @@ class RGB
     "##{hex true}"
   end
 
+  # Returns the names of CSS named colors identical to this color.
+  # @example
+  #  RGB.hex('f0f').css_names
+  def css_names
+    RGB.css(self).map &:name
+  end
+
+  # Returns the color's relative luminance, as defined by the Web Content Accessibility Guidelines (WCAG) 2.0.
+  #
+  # This is different from the Y component of CIE 1931 XYZ.
+  #
+  # Based on:
+  # - https://www.w3.org/TR/WCAG20/#relativeluminancedef
+  def wcag20_luminance(round: true)
+    if color_space == 'sRGB'
+      values.map { |v|
+        if v <= 0.03928
+          v / 12.92
+        else
+          ( ( v + 0.055 ) / 1.055 ) ** 2.4
+        end
+      }.zip( [0.2126, 0.7152, 0.0722] ).map { |c,f|
+        c * f
+      }.inject(:+).instance_eval { |v| round ? v.round(8) : v }
+    else
+      raise "can not calculate luminance for color space '#{color_space}'"
+    end
+  end
+
+  # Returns the contrast ratio for this color and another color, as defined by the Web Content Accessibility Guidelines (WCAG) 2.0.
+  #
+  # Based on:
+  # - https://www.w3.org/TR/WCAG20/#contrast-ratiodef
+  def wcag20_contrast_ratio(another, round: true)
+    luminances = [
+      wcag20_luminance(round: false),
+      another.wcag20_luminance(round: false)
+    ].sort.reverse
+
+    contrast_ratio = ( luminances[0] + 0.05 ) / ( luminances[1] + 0.05 )
+
+    round ? contrast_ratio.round(8) : contrast_ratio
+  end
+
+  # Returns true if this is one of the 216 so-called "web safe" colors, otherwise false.
+  def web_safe?
+    ( values - [0.0, 0.2, 0.4, 0.6, 0.8, 1.0] ).empty?
+  end
+
 end

data/lib/redgreenblue.rb

@@ -11,15 +11,19 @@ end
 
   hsl hsv hsb
 
-  ostwald
+  ostwald hwb
 
-  gamma cie
+  gamma
 
-  inspect lazy
+  cie_1931 cie_1976 cie_1994
 
-  rgb565 bgr24bit gif terminal web gpl
+  name
 
-  mix misc random
+  inspect view lazy
+
+  rgb565 bgr24bit gif terminal web gpl mac
+
+  match mix misc random
 
   os
 

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: redgreenblue
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.15.0
 platform: ruby
 authors:
 - lllist.eu
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-06-23 00:00:00.000000000 Z
+date: 2021-11-10 00:00:00.000000000 Z
 dependencies: []
-description: 
-email: 
+description:
+email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -21,7 +21,9 @@ files:
 - lib/redgreenblue/48bit.rb
 - lib/redgreenblue/base.rb
 - lib/redgreenblue/bgr24bit.rb
-- lib/redgreenblue/cie.rb
+- lib/redgreenblue/cie_1931.rb
+- lib/redgreenblue/cie_1976.rb
+- lib/redgreenblue/cie_1994.rb
 - lib/redgreenblue/gamma.rb
 - lib/redgreenblue/gif.rb
 - lib/redgreenblue/gpl.rb
@@ -30,20 +32,26 @@ files:
 - lib/redgreenblue/hsl.rb
 - lib/redgreenblue/hsv.rb
 - lib/redgreenblue/hsx_shared.rb
+- lib/redgreenblue/hwb.rb
 - lib/redgreenblue/inspect.rb
 - lib/redgreenblue/int.rb
 - lib/redgreenblue/lazy.rb
+- lib/redgreenblue/mac.rb
+- lib/redgreenblue/match.rb
 - lib/redgreenblue/math.rb
 - lib/redgreenblue/misc.rb
 - lib/redgreenblue/mix.rb
+- lib/redgreenblue/name.rb
 - lib/redgreenblue/opt/philipshue.rb
 - lib/redgreenblue/os.rb
 - lib/redgreenblue/os/mac.rb
 - lib/redgreenblue/ostwald.rb
+- lib/redgreenblue/palettes/css.gpl
 - lib/redgreenblue/random.rb
 - lib/redgreenblue/rgb565.rb
 - lib/redgreenblue/terminal.rb
 - lib/redgreenblue/version.rb
+- lib/redgreenblue/view.rb
 - lib/redgreenblue/web.rb
 homepage: https://github.com/lllisteu/redgreenblue
 licenses:
@@ -52,7 +60,7 @@ metadata:
   homepage_uri: https://github.com/lllisteu/redgreenblue
   changelog_uri: https://github.com/lllisteu/redgreenblue/blob/master/History.md
   documentation_uri: https://www.rubydoc.info/gems/redgreenblue/RGB
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -67,8 +75,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.22
+signing_key:
 specification_version: 4
 summary: A simple Ruby library for handling RGB colors.
 test_files: []