redgreenblue 0.7.0 → 0.12.0

data/lib/redgreenblue/random.rb

@@ -6,6 +6,11 @@ class RGB
     self
   end
 
+  # Creates a new RGB object with this object's red, green, and blue values shuffled.
+  def shuffle
+    RGB.new values.shuffle
+  end
+
   # Assigns random values to red, green, and blue.
   def randomize!
     self.values = Kernel::rand, Kernel::rand, Kernel::rand

data/lib/redgreenblue/rgb565.rb

@@ -15,11 +15,6 @@ class RGB
     self.b = ( ( v & 0x001f )       ) << 3
   end
 
-  # Returns the color in 16-bit RGB565 format as a string of 0's and 1's
-  def rgb565_binary
-    rgb565.bytes.reverse.map { |b| "%08b" % b }.join
-  end
-
   # Creates a new RGB color from 16-bit RGB565 data.
   def self.rgb565(rgb565_string)
     c = self.new

data/lib/redgreenblue/terminal.rb

@@ -0,0 +1,19 @@
+class RGB
+
+  # With help from:
+  # - https://gist.github.com/XVilka/8346728
+  # - https://unix.stackexchange.com/questions/404414
+
+  # Returns the ANSI escape sequence required to set the foreground color on a terminal to this color.
+  # Only works on terminals that support 24-bit colors, so-called "true color".
+  def terminal_foreground
+    "\e[38;2;%d;%d;%dm" % rgb
+  end
+
+  # Returns the ANSI escape sequence required to set the background color on a terminal to this color.
+  # Only works on terminals that support 24-bit colors, so-called "true color".
+  def terminal_background
+    "\e[48;2;%d;%d;%dm" % rgb
+  end
+
+end

data/lib/redgreenblue/version.rb

@@ -1,3 +1,11 @@
 class RGB
-  VERSION = '0.7.0'
+
+  # redgreenblue version.
+  VERSION = '0.12.0'
+
+  # Returns RGB::VERSION.
+  def self.version
+    VERSION
+  end
+
 end

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

@@ -0,0 +1,65 @@
+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.
+  def css_hex
+    "##{hex true}"
+  end
+
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: redgreenblue
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.12.0
 platform: ruby
 authors:
 - lllist.eu
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-11 00:00:00.000000000 Z
+date: 2020-09-08 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: 
@@ -21,22 +21,41 @@ files:
 - lib/redgreenblue/48bit.rb
 - lib/redgreenblue/base.rb
 - lib/redgreenblue/bgr24bit.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/math.rb
 - lib/redgreenblue/misc.rb
-- lib/redgreenblue/nice.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:
@@ -52,8 +71,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
-summary: A simple Ruby library for handling RGB colors
+summary: A simple Ruby library for handling RGB colors.
 test_files: []

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

data/lib/redgreenblue/nice.rb

@@ -1,9 +0,0 @@
-class RGB
-
-  def inspect
-    "RGB ##{hex} (red=%1.5f green=%1.5f blue=%1.5f)" % [red, green, blue]
-  end
-
-  alias to_s inspect
-
-end