redgreenblue 0.8.0 → 0.13.0

data/lib/redgreenblue/view.rb

@@ -0,0 +1,34 @@
+class RGB
+
+  # Prints details for the RGB object, using multiple lines.
+  def view
+    puts _inspect_view
+  end
+
+  alias v view
+
+  private
+
+  def _inspect_view
+    o = []
+    o << 3.times.map { terminal_background + "      \e[0m "}
+    o << [ "#{_inspect_hex} ", '%-7.7s ' % color_space, '        ' ]
+
+    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.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: redgreenblue
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.13.0
 platform: ruby
 authors:
 - lllist.eu
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-20 00:00:00.000000000 Z
+date: 2020-11-09 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: 
@@ -21,26 +21,43 @@ 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/gamma.rb
 - lib/redgreenblue/gif.rb
+- lib/redgreenblue/gpl.rb
 - lib/redgreenblue/hex.rb
-- lib/redgreenblue/hsl_hsv.rb
+- lib/redgreenblue/hsb.rb
+- lib/redgreenblue/hsl.rb
+- lib/redgreenblue/hsv.rb
+- lib/redgreenblue/hsx_shared.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:
 - MIT
-metadata: {}
+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: 
 rdoc_options: []
 require_paths:
@@ -56,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: A simple Ruby library for handling RGB colors.

data/lib/redgreenblue/cie.rb

@@ -1,62 +0,0 @@
-class RGB
-
-  # Returns CIE 1931 XYZ values for the RGB object.
-  #
-  # 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
-    r, g, b = expanded_srgb_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) }
-  end
-
-  alias xyz cie_xyz
-
-  # Returns CIE 1931 xyY values for the RGB object.
-  #
-  # Based on:
-  # - https://en.wikipedia.org/wiki/CIE_1931_color_space
-  # - 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 / ( x + y + z ),
-      y / ( x + y + z ),
-      y
-    ].map { |v| v.round(6) }
-  end
-
-  alias xyy cie_xyy
-
-  # Returns CIE 1931 xy values for the RGB object.
-  def cie_xy
-    cie_xyy[0..1]
-  end
-
-  alias xy cie_xy
-
-  private
-
-  # Returns gamma-expanded (inverse-companded) RGB values for sRGB.
-  #
-  # Based on:
-  # - https://en.wikipedia.org/wiki/SRGB
-  # - http://www.brucelindbloom.com/Eqn_RGB_to_XYZ.html
-  def expanded_srgb_values
-    values.map { |v|
-      if v <= 0.04045
-        v / 12.92
-      else
-        ( ( v + 0.055 ) / 1.055 ) ** 2.4
-      end
-    }
-  end
-
-end

data/lib/redgreenblue/hsl_hsv.rb

@@ -1,59 +0,0 @@
-class RGB
-
-  # Returns color as HSL:
-  # hue (0..360), saturation (0..1), lightness (0..1).
-  # When saturation is 0, hue is nil.
-  def hsl
-    hsl_hsv_c[0]
-  end
-
-  # Returns color as HSV:
-  # hue (0..360), saturation (0..1), value (0..1).
-  # When saturation is 0, hue is nil.
-  #
-  # #hsb is an alias for #hsv.
-  def hsv
-    hsl_hsv_c[1]
-  end
-
-  alias hsb hsv
-
-  private
-
-  # Compute HSL, HSV, and chroma.
-  # With help from:
-  # - https://en.wikipedia.org/wiki/HSL_and_HSV
-  def hsl_hsv_c
-    sorted_hash = to_h
-    min, max = sorted_hash.values.values_at(2,0)
-
-    chroma = max - min
-
-    hue =
-      if chroma == 0
-        nil
-      else
-        case sorted_hash.keys.first
-        when :red
-          60 * ( ( ( green - blue  ) / chroma ).modulo 6 )
-        when :green
-          60 * ( (   blue  - red   ) / chroma + 2 )
-        when :blue
-          60 * ( (   red   - green ) / chroma + 4 )
-        end
-      end
-
-    lightness = ( min + max ) / 2.0
-
-    saturation_hsl =
-      chroma == 0 ? 0.0 : ( chroma / ( 1 - (2 * lightness - 1).abs ) ).round(9)
-
-    value = max
-
-    saturation_hsv =
-      value == 0 ? 0.0 : chroma / value
-
-    [ [hue, saturation_hsl, lightness], [hue, saturation_hsv, value], chroma ]
-  end
-
-end