redgreenblue 0.8.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 766113ae54ad00c066d264e8bd8d63610f5347e75d95aee3c34bacac0b027a99
-  data.tar.gz: a91d7d49e36ebfc29328e32c2aa67df908e4fbc9d36c4ec957e1e6d8ed3220b7
+  metadata.gz: 65191c26a6dcae9a6bb52abe182d376e0975b79672686120185c9a2b3d49e4e9
+  data.tar.gz: 3fb9dc542660f5edaec8283a2e74ec0687e369e05475bf6840344ca5cca0304f
 SHA512:
-  metadata.gz: 587d547ca6139b84ef36f8064a768aee1cdb3f5618f4f03c9ab606df477ad6ebffe82b00837fe55b06fcf2ba6275a1d85484f758394755567b1aab81351bf1df
-  data.tar.gz: e5203156810f3f577bbe20de7d862f96518db292b1f848778dc2c9dc5223b16c9e15e6effc2e08ed4dba655891805873fdf95cda511c5a533f87462200401746
+  metadata.gz: 4c0d6a47aa611822dba62189c14ebf38c0ef6315f08ac9b5eb9efe04b28487d2c95105c0e86536cb52fdc9ce36df445d060623a14e99f2dbab34df5e0d10e515
+  data.tar.gz: 756bdaa8c6859c685e51342ee8a6d34e7340ea0580bd79b4487443d97b04629ed1b7c8f1631bf3ac26a5570e6c243aba7f7b931243ea967f07d8437fa223d495

data/lib/redgreenblue.rb

@@ -1,28 +1,30 @@
 class RGB
 end
 
-require 'redgreenblue/version'
+%w(
 
-require 'redgreenblue/base'
+  version
 
-require 'redgreenblue/24bit'
-require 'redgreenblue/48bit'
-require 'redgreenblue/hex'
+  base
 
-require 'redgreenblue/hsl_hsv'
-require 'redgreenblue/cie'
+  24bit 48bit hex int
 
-require 'redgreenblue/inspect'
-require 'redgreenblue/lazy'
+  hsl hsv hsb
 
-require 'redgreenblue/rgb565'
-require 'redgreenblue/bgr24bit'
-require 'redgreenblue/gif'
-require 'redgreenblue/terminal'
-require 'redgreenblue/web'
+  ostwald
 
-require 'redgreenblue/mix'
-require 'redgreenblue/misc'
-require 'redgreenblue/random'
+  gamma
 
-require 'redgreenblue/os'
+  cie_1931 cie_1976
+
+  name
+
+  inspect view lazy
+
+  rgb565 bgr24bit gif terminal web gpl mac
+
+  match mix misc random
+
+  os
+
+).each { |m| require "redgreenblue/#{m}" }

data/lib/redgreenblue/24bit.rb

@@ -51,6 +51,17 @@ class RGB
     c
   end
 
+  # Sets the red, green, and blue values to those of the nearest 24-bit color.
+  def snap!
+    self.rgb = rgb
+    self
+  end
+
+  # Creates a new RGB object containing the nearest 24-bit color.
+  def snap
+    RGB.rgb rgb
+  end
+
   # Calls the given block for each 24-bit RGB color (from black to white), passing the color as an RGB object.
   #
   # Returns the number of iterations.

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.
@@ -66,7 +66,7 @@ class RGB
     ( self.class == other.class ) && ( self.values == other.values )
   end
 
-  # Returns a sorted hash of 3 key/value pairs for red, green and blue,
+  # Returns a sorted hash of 3 key/value pairs for red, green, and blue,
   # sorted in order of decreasing value.
   def to_h
     ([:red, :green, :blue].zip values).sort_by {

data/lib/redgreenblue/cie_1931.rb

@@ -0,0 +1,51 @@
+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 calculated with Javascript by Bruce Lindbloom:
+  # - http://www.brucelindbloom.com/ColorCalculator.html
+  def cie_xyz(round: true)
+    r, g, b = linear_values
+
+    [
+
+      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
+
+  # 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 = cie_xyz(round: false)
+
+    [
+
+      x / ( x + y + z ),
+      y / ( x + y + z ),
+      y
+
+    ].map { |v| v.round(8) }
+  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
+
+end

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/gamma.rb

@@ -0,0 +1,44 @@
+class RGB
+
+  # Returns gamma-expanded (inverse-companded) RGB values for the object (three values between 0 and 1).
+  #
+  # Based on:
+  # - https://en.wikipedia.org/wiki/SRGB
+  # - http://www.brucelindbloom.com/Eqn_RGB_to_XYZ.html
+  # - https://entropymine.com/imageworsener/srgbformula/
+  def linear_values
+    if color_space == 'sRGB'
+      values.map { |v|
+        if v <= 0.04045
+          v / 12.92
+        else
+          ( ( v + 0.055 ) / 1.055 ) ** 2.4
+        end
+      }
+    else
+      raise "can not compute gamma for color space '#{color_space}'"
+    end
+  end
+
+  # Sets the object's RGB values using three linear RGB values, each between 0 and 1.
+  # Linear values will be converted to the object's gamma (gamma-companded).
+  #
+  # Based on:
+  # - https://en.wikipedia.org/wiki/SRGB
+  # - http://www.brucelindbloom.com/Eqn_XYZ_to_RGB.html
+  # - https://entropymine.com/imageworsener/srgbformula/
+  def linear_values=(*a)
+    if color_space == 'sRGB'
+      self.values = a.flatten.map { |v|
+        if v <= 0.0031308
+          v * 12.92
+        else
+          1.055 * ( v ** ( 1/2.4 ) ) - 0.055
+        end
+      }.map { |v| v.round(9) }
+    else
+      raise "can not compute gamma for color space '#{color_space}'"
+    end
+  end
+
+end

data/lib/redgreenblue/gpl.rb

@@ -0,0 +1,91 @@
+class RGB
+
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
+
+  class << self
+
+    # 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
+
+    private
+
+    # Reverse-engineered from:
+    # - https://github.com/GNOME/gimp/blob/5d79fba8238a27b8691556489898d33b3fa0dda0/app/core/gimppalette-load.c
+    def gpl_header(name, columns=nil)
+      "GIMP Palette\n" +
+      "Name: #{name}\n" +
+      ( columns ? "Columns: #{columns}\n" : '' )
+    end
+
+  end
+
+  #----------------------------------------------------------------------#
+  #                           Instance Methods                           #
+  #----------------------------------------------------------------------#
+
+  # 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

@@ -0,0 +1,61 @@
+require 'redgreenblue/hsv'
+
+class RGB
+
+  #----------------------------------------------------------------------#
+  #                            Class Methods                             #
+  #----------------------------------------------------------------------#
+
+  class << self
+
+    # Creates a new RGB object from HSB values: hue (0..360), saturation (0..1), and brightness (0..1).
+    alias hsb hsv
+
+  end
+
+  #----------------------------------------------------------------------#
+  #                           Instance Methods                           #
+  #----------------------------------------------------------------------#
+
+  # Returns color as HSB:
+  # hue (0..360), saturation (0..1), brightness (0..1).
+  # When saturation is 0, hue is nil.
+  alias hsb         hsv
+
+  # Returns the object's HSB-hue (0..360).
+  alias hsb_h       hsv_h
+
+  # Returns the object's HSB-saturation (0..1).
+  alias hsb_s       hsv_s
+
+  # Returns the object's HSB-brightness (0..1).
+  alias hsb_b       hsv_v
+
+  # Sets red, green, and blue using HSB values: hue (0..360), saturation (0..1), and brightness (0..1).
+  alias hsb=        hsv=
+
+  # Sets HSB-hue to a number of degrees (0..360) or nil.
+  #
+  # Adjusts red, green, and blue, leaving HSB-saturation and -brightness unchanged.
+  # When hue is nil, saturation will be 0.
+  alias hsb_h=      hsv_h=
+
+  # Sets HSB-saturation to a number between 0 and 1.
+  #
+  # Adjusts red, green, and blue, leaving HSB-hue and -brightness unchanged.
+  # When saturation is 0, hue will be nil.
+  alias hsb_s=      hsv_s=
+
+  # Sets HSB-brightness to a number between 0 and 1.
+  #
+  # Adjusts red, green, and blue, leaving HSB-hue and -saturation unchanged.
+  # When brightness is 0, hue will be nil, and saturation will be 0.
+  alias hsb_b=      hsv_v=
+
+  # Sets red, green, and blue by rotating the object's HSB-hue a number of degrees.
+  alias hsb_rotate! hsv_rotate!
+
+  # Creates one or more new RGB objects by rotating this object's HSB-hue a number of degrees.
+  alias hsb_rotate  hsv_rotate
+
+end