redgreenblue 0.15.0 → 0.16.0

data/lib/redgreenblue/inspect.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   private
 
@@ -32,7 +32,7 @@ class RGB
   #
   # You can choose among several inspect styles. See the styles, style, and style= class methods.
   def inspect
-    send "_inspect_#{self.class.style}"
+    send "_inspect_#{RGB.style}"
   end
 
   # Returns a string representation of the object.
@@ -40,34 +40,46 @@ class RGB
     _inspect_default
   end
 
-  # Returns the base inspect style, dependent on the COLORTERM environment variable.
-  def self.base_style
-    if styles.include? ENV['REDGREENBLUE_STYLE']
-      ENV['REDGREENBLUE_STYLE']
-    else
-      if ENV['COLORTERM'] == 'truecolor'
-        'simple'
+end
+
+#----------------------------------------------------------------------#
+#                            Module Methods                            #
+#----------------------------------------------------------------------#
+
+module RGB
+
+  class << self
+
+    # Returns the base inspect style, dependent on the COLORTERM environment variable.
+    def base_style
+      if styles.include? ENV['REDGREENBLUE_STYLE']
+        ENV['REDGREENBLUE_STYLE']
       else
-        'default'
+        if ENV['COLORTERM'] == 'truecolor'
+          'simple'
+        else
+          'default'
+        end
       end
     end
-  end
 
-  # Returns the current inspect style.
-  def self.style
-    @@style ||= base_style
-  end
+    # Returns the current inspect style.
+    def style
+      @@style ||= base_style
+    end
 
-  # Returns a list of all available inspect styles.
-  def self.styles
-    ( self.instance_methods + self.private_instance_methods ).grep( /^_inspect_(.*)/ ) { $1 }.sort
-  end
+    # Returns a list of all available inspect styles.
+    def styles
+      ( Color.instance_methods + Color.private_instance_methods ).grep( /^_inspect_(.*)/ ) { $1 }.sort
+    end
+
+    # Selects an inspect style.
+    #
+    # Only the first few characters of your preferred style are required.
+    def style=(s)
+      @@style = styles.grep( /^#{s.to_s.downcase}/ ).first || style
+    end
 
-  # Selects an inspect style.
-  #
-  # Only the first few characters of your preferred style are required.
-  def self.style=(s)
-    @@style = styles.grep( /^#{s.to_s.downcase}/ ).first || style
   end
 
 end

data/lib/redgreenblue/int.rb

@@ -1,11 +1,11 @@
-class RGB
+class RGB::Color
 
   # Returns the color as a 24-bit integer in the range 0..16777215.
   def to_i
     ( r << 16 ) + ( g << 8 ) + b
   end
 
-  # Creates a new RGB object from a 24-bit integer in the range 0..16777215.
+  # Creates a new RGB::Color object from a 24-bit integer in the range 0..16777215.
   def self.at(number)
     n = number.to_i
     if (0..16777215) === n
@@ -20,3 +20,20 @@ class RGB
   end
 
 end
+
+#----------------------------------------------------------------------#
+#                            Module Methods                            #
+#----------------------------------------------------------------------#
+
+module RGB
+
+  class << self
+
+    # Creates a new RGB::Color object from a 24-bit integer in the range 0..16777215.
+    def at(number)
+      Color.at(number)
+    end
+
+  end
+
+end

data/lib/redgreenblue/lazy.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   #----------------------------------------------------------------------#
   #                            Class Methods                             #
@@ -6,17 +6,17 @@ class RGB
 
   class << self
 
-    # Creates a white RGB object.
+    # Creates a white RGB::Color object.
     def white
       new(1,1,1)
     end
 
-    # Creates a black RGB object.
+    # Creates a black RGB::Color object.
     def black
       new(0,0,0)
     end
 
-    # Creates a grey RGB object. Defaults to lightness 0.5, a middle grey. Black equals grey(0), white equals grey(1).
+    # Creates a grey RGB::Color 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)
@@ -26,32 +26,32 @@ class RGB
     # Alias gray for grey.
     alias gray grey
 
-    # Creates a pure red RGB object.
+    # Creates a pure red RGB::Color object.
     def red
       new(1,0,0)
     end
 
-    # Creates a pure green RGB object.
+    # Creates a pure green RGB::Color object.
     def green
       new(0,1,0)
     end
 
-    # Creates a pure blue RGB object.
+    # Creates a pure blue RGB::Color object.
     def blue
       new(0,0,1)
     end
 
-    # Creates a yellow RGB object.
+    # Creates a yellow RGB::Color object.
     def yellow
       new(1,1,0)
     end
 
-    # Creates a cyan RGB object.
+    # Creates a cyan RGB::Color object.
     def cyan
       new(0,1,1)
     end
 
-    # Creates a magenta RGB object.
+    # Creates a magenta RGB::Color object.
     def magenta
       new(1,0,1)
     end
@@ -71,3 +71,77 @@ class RGB
   end
 
 end
+
+#----------------------------------------------------------------------#
+#                            Module Methods                            #
+#----------------------------------------------------------------------#
+
+module RGB
+
+  class << self
+
+    # Creates a white RGB::Color object.
+    def white
+      Color.white
+    end
+
+    # Creates a black RGB::Color object.
+    def black
+      Color.black
+    end
+
+    # Creates a grey RGB::Color 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)
+      Color.grey(lightness)
+    end
+
+    # Alias gray for grey.
+    alias gray grey
+
+    # Creates a pure red RGB::Color object.
+    def red
+      Color.red
+    end
+
+    # Creates a pure green RGB::Color object.
+    def green
+      Color.green
+    end
+
+    # Creates a pure blue RGB::Color object.
+    def blue
+      Color.blue
+    end
+
+    # Creates a yellow RGB::Color object.
+    def yellow
+      Color.yellow
+    end
+
+    # Creates a cyan RGB::Color object.
+    def cyan
+      Color.cyan
+    end
+
+    # Creates a magenta RGB::Color object.
+    def magenta
+      Color.magenta
+    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
+
+  end
+
+end

data/lib/redgreenblue/mac.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   # Returns the color in the format used by AppleScript (a 48-bit RGB triplet).
   def applescript

data/lib/redgreenblue/match.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   # Matches this color to a set of colors by calculating their euclidean distance.
   #

data/lib/redgreenblue/math.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
 private
 

data/lib/redgreenblue/misc.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   # Inverts the object's color.
   def invert!
@@ -6,7 +6,7 @@ class RGB
     self
   end
 
-  # Creates a new RGB object with the inverted color of this RGB object.
+  # Creates a new RGB::Color with the inverted color of this RGB object.
   def invert
     dup.invert!
   end
@@ -17,23 +17,23 @@ class RGB
     values.min == values.max
   end
 
-  # Returns an array of RGB objects for all possible ways in which the red, green, and blue values of this object can be exchanged.
+  # Returns an array of RGB::Colors for all possible ways in which the red, green, and blue values of this object can be exchanged.
   #
   # Example: RGB.red.permutation returns [ RGB.red, RGB.green, RGB.blue ].
   # See also: shuffle.
   def permutation
-    values.permutation.to_a.uniq.map { |v| RGB.new v }
+    values.permutation.to_a.uniq.map { |v| RGB::Color.new v }
   end
 
-  # Returns an array of three RGB objects, for the red, green, and blue components of this object.
+  # Returns an array of three RGB::Colors, for the red, green, and blue components of this object.
   def components
-    [ RGB.new(red,0,0), RGB.new(0,green,0), RGB.new(0,0,blue) ]
+    [ RGB::Color.new(red,0,0), RGB::Color.new(0,green,0), RGB::Color.new(0,0,blue) ]
   end
 
-  # Creates a new RGB object from three RGB objects representing the red, green, and blue components.
+  # Creates a new RGB::Color from three RGB::Colors representing the red, green, and blue components.
   def self.assemble(*a)
     v = a.flatten
-    RGB.new(v[0].red, v[1].green, v[2].blue)
+    RGB::Color.new(v[0].red, v[1].green, v[2].blue)
   end
 
   # Returns the euclidean distance between this color and another color.
@@ -50,3 +50,20 @@ class RGB
   end
 
 end
+
+#----------------------------------------------------------------------#
+#                            Module Methods                            #
+#----------------------------------------------------------------------#
+
+module RGB
+
+  class << self
+
+  # Creates a new RGB::Color from three RGB::Colors representing the red, green, and blue components.
+  def assemble(*a)
+    Color.assemble(*a)
+  end
+
+  end
+
+end

data/lib/redgreenblue/mix.rb

@@ -1,14 +1,14 @@
-class RGB
+class RGB::Color
 
-  # Changes the object's color by mixing it with a portion of another RGB color.
+  # Changes the object's color by mixing it with a portion of another RGB::Color.
   def mix!(another,portion=0.5)
     self.values = mix_values(another.values, portion)
     self
   end
 
-  # Creates a new RGB object by mixing this object's color with a portion of another RGB color.
+  # Creates a new RGB::Color by mixing this object's color with a portion of another RGB::Color.
   def mix(another,portion=0.5)
-    RGB.new mix_values(another.values, portion)
+    RGB::Color.new mix_values(another.values, portion)
   end
 
   # Changes the object's color by mixing it with a portion of white.
@@ -16,7 +16,7 @@ class RGB
     mix!(RGB.white, portion)
   end
 
-  # Creates one or more new RGB objects by mixing this object's color with a portion of white.
+  # Creates one or more new RGB::Colors by mixing this object's color with a portion of white.
   def whiten(portion=0.5, *portions)
     if (portion.class != Array) and portions.none?
       mix(RGB.white, portion)
@@ -30,7 +30,7 @@ class RGB
     mix!(RGB.black, portion)
   end
 
-  # Creates one or more new RGB objects by mixing this object's color with a portion of black.
+  # Creates one or more new RGB::Colors by mixing this object's color with a portion of black.
   def blacken(portion=0.5, *portions)
     if (portion.class != Array) and portions.none?
       mix(RGB.black, portion)

data/lib/redgreenblue/name.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   # Returns the name.
   def name

data/lib/redgreenblue/opt/philipshue.rb

@@ -2,15 +2,15 @@
 #
 # Conforms to Bridge API 1.35 for Philips Hue, published 20-Nov-2019.
 
-# Automatically load core RGB class before loading options.
+# Automatically load core RGB module before loading options.
 require 'redgreenblue'
 
-class RGB
+class RGB::Color
 
   # Only available when optional support for Philips Hue lights is loaded.
   #
   # Returns a hash with the arguments required by the Philips Hue API,
-  # to set a light to this RGB object's hue, saturation and brightness.
+  # to set a light to this RGB::Color's hue, saturation and brightness.
   #
   # Formatted as JSON, this hash can be sent to a bridge to set a light's state.
   #

data/lib/redgreenblue/os/mac.rb

@@ -1,20 +1,20 @@
-class RGB
+class RGB::Color
 
-  # On Mac OS, shows the color picker to choose a color for the RGB object.
+  # On Mac OS, shows the color picker to choose a color for this object.
   # Not available on other platforms.
   def pick
-    result = RGB.mac_choose(self)
+    result = RGB::Color.mac_choose(self)
     if result
       self.rrggbb = result
     end
   end
 
-  # On Mac OS, shows the color picker and creates an RGB object with the chosen color.
+  # On Mac OS, shows the color picker and creates an RGB::Color with the chosen color.
   # Not available on other platforms.
   #
   # 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)
+  def self.pick(default_color=RGB::Color.new)
+    result = RGB::Color.mac_choose(default_color)
     if result
       RGB.rrggbb result
     else
@@ -62,3 +62,20 @@ class RGB
   end
 
 end
+
+
+module RGB
+
+  class << self
+
+    # On Mac OS, shows the color picker and creates an RGB::Color with the chosen color.
+    # Not available on other platforms.
+    #
+    # If no default color is specified, the picker defaults to a middle grey.
+    def pick(default_color=new)
+      Color.pick(default_color)
+    end
+
+  end
+
+end

data/lib/redgreenblue/ostwald.rb

@@ -1,6 +1,6 @@
-class RGB
+class RGB::Color
 
-  # Returns a new RGB object with this color's Ostwald full-color,
+  # Returns a new RGB::Color object with this color's Ostwald full-color,
   # or nil for achromatic colors (white, greys, and black).
   #
   # The resulting color contains no white or black,
@@ -19,7 +19,7 @@ class RGB
     if color_portion == 0
       nil
     else
-      RGB.new( values.map { |v| ( ( v - white_portion ) / color_portion ).round(6) } )
+      RGB::Color.new( values.map { |v| ( ( v - white_portion ) / color_portion ).round(6) } )
     end
   end
 

data/lib/redgreenblue/random.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   # Shuffles the object's red, green, and blue values.
   def shuffle!
@@ -6,9 +6,9 @@ class RGB
     self
   end
 
-  # Creates a new RGB object with this object's red, green, and blue values shuffled.
+  # Creates a new RGB::Color with this object's red, green, and blue values shuffled.
   def shuffle
-    RGB.new values.shuffle
+    RGB::Color.new values.shuffle
   end
 
   # Assigns random values to red, green, and blue.
@@ -17,9 +17,26 @@ class RGB
     self
   end
 
-  # Creates a new RGB object with random red, green, and blue values.
+  # Creates a new RGB::Color with random red, green, and blue values.
   def self.rand
     new(Kernel::rand, Kernel::rand, Kernel::rand)
   end
 
 end
+
+#----------------------------------------------------------------------#
+#                            Module Methods                            #
+#----------------------------------------------------------------------#
+
+module RGB
+
+  class << self
+
+    # Creates a new RGB::Color with random red, green, and blue values.
+    def rand
+      Color.rand
+    end
+
+  end
+
+end

data/lib/redgreenblue/rgb565.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   # Returns the color in 16-bit RGB565 format.
   def rgb565
@@ -15,7 +15,7 @@ class RGB
     self.b = ( ( v & 0x001f )       ) << 3
   end
 
-  # Creates a new RGB color from 16-bit RGB565 data.
+  # Creates a new RGB::Color from 16-bit RGB565 data.
   def self.rgb565(rgb565_string)
     c = self.new
     c.rgb565 = rgb565_string
@@ -23,3 +23,20 @@ class RGB
   end
 
 end
+
+#----------------------------------------------------------------------#
+#                            Module Methods                            #
+#----------------------------------------------------------------------#
+
+module RGB
+
+  class << self
+
+    # Creates a new RGB::Color from 16-bit RGB565 data.
+    def rgb565(rgb565_string)
+      Color.rgb565(rgb565_string)
+    end
+
+  end
+
+end

data/lib/redgreenblue/terminal.rb

@@ -1,4 +1,4 @@
-class RGB
+class RGB::Color
 
   # With help from:
   # - https://gist.github.com/XVilka/8346728

data/lib/redgreenblue/version.rb

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

data/lib/redgreenblue/view.rb

@@ -1,6 +1,6 @@
-class RGB
+class RGB::Color
 
-  # Prints a color swatch and details for the RGB object, using multiple lines.
+  # Prints a color swatch and details for the RGB::Color object, using multiple lines.
   #
   # You can optionally supply a second color to be shown inside the swatch, for comparison.
   def view(other=nil)