colorspace 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c139dfc8f81959c4676b6626d5e72bcca448b829213a624f9bced835e662ce3e
-  data.tar.gz: 7eadea0f02c8d3b44c6c11c7bca30b66cb1ce2e5f8630c81c9ab3bea7af58d56
+  metadata.gz: 0a7a8a2e7f6e06cdcb33c76456d17b601daffb641a6aa62e82e98a82f7501376
+  data.tar.gz: f6650c8b82ee3a0bf25f6f672b8bdfebb05cb5c6133a6fa66b28803d755053a6
 SHA512:
-  metadata.gz: 867d76ec2efb1ca07ec2d8da0308fdeea8f1e2437277e6cb6d9b3a3d839b003abb1b3020bc0b81160625b536e856c717f15f2dd8ce5361fe49959cc025b546c3
-  data.tar.gz: 78ea353372d5c30ae12c5e3c0c61744b9a587b0d4db1f3c733b10cb0f3e106079ba753eed6aae3d70b11f86ad595027f4fc76733c8a881f7d3bca13df5f3cda1
+  metadata.gz: c732e7601f8aa9f5b9d203201b5bb26e86609d300408a7a976bd71cf6ce340e2da60532eefad502b729788b112a02641ee538a6af2f036b13417edc19bb7eef5
+  data.tar.gz: d0cb84accdd0717ab8bdedf504a189f62afca2f6c77f86767a35e1bb2f9c7ce74e6070fb4a3fba1f3bd90f72302b86b562a1298ae9fa9b3d128923fc92cca846

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    colorspace (0.1.0)
+    colorspace (0.1.1)
 
 GEM
   remote: https://rubygems.org/

data/lib/colorspace/colorlib.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require 'matrix'
+
+# Library for working with RGB, XYZ, and LAB colorspaces
+module Colorspace
+  # rubocop: disable Layout/SpaceInsideArrayLiteralBrackets
+  # rubocop: disable Layout/ExtraSpacing
+  RGB_XYZ_MATRIX = Matrix[
+    [  0.4124564,  0.3575761,  0.1804375  ],
+    [  0.2126729,  0.7151522,  0.0721750  ],
+    [  0.0193339,  0.1191920,  0.9503041  ]
+  ].freeze
+
+  XYZ_RGB_MATRIX = Matrix[
+    [  3.2404542, -1.5371385, -0.4985314  ],
+    [ -0.9692660,  1.8760108,  0.0415560  ],
+    [  0.0556434, -0.2040259,  1.0572252  ]
+  ].freeze
+  # rubocop: enable Layout/ExtraSpacing
+  # rubocop: enable Layout/SpaceInsideArrayLiteralBrackets
+
+  ##
+  # A tristimulus value in the CIE 1931 space.
+  class XYZTristimulus < Data.define(:x, :y, :z)
+    # @dynamic x, y, z, initialize
+
+    def to_srgb_linear
+      r, g, b = (XYZ_RGB_MATRIX * Matrix[[x], [y], [z]]).to_a.flatten
+
+      SRGBLinearColor.new(r:, g:, b:)
+    end
+
+    def to_srgb
+      to_srgb_linear.gamma_compress
+    end
+
+    private def scale_f(val)
+      delta = 6.0 / 29
+      t = val
+
+      if t > delta**3
+        t**(1.0 / 3)
+      else
+        (t / (3 * (delta**2))) + (4.0 / 29)
+      end
+    end
+
+    # rubocop: disable Metrics/AbcSize
+    def to_cielab(illuminant: D65)
+      x_, y_, z_ = x * 100, y * 100, z * 100
+      xn, yn, zn = illuminant.x, illuminant.y, illuminant.z
+
+      l = (116 * scale_f(y_ / yn)) - 16
+      a = 500 * (scale_f(x_ / xn) - scale_f(y_ / yn))
+      b = 200 * (scale_f(y_ / yn) - scale_f(z_ / zn))
+
+      CIELABColor.new(l:, a:, b:)
+    end
+    # rubocop: enable Metrics/AbcSize
+
+    def to_ary = [x, y, z]
+    def to_a = to_ary
+  end
+
+  D65 = XYZTristimulus.new(x: 95.047, y: 100.0, z: 108.883)
+  D50 = XYZTristimulus.new(x: 96.42, y: 100.0, z: 82.51)
+
+  ##
+  # An RGB value in the sRGB colorspace.
+  class SRGBColor < Data.define(:r, :g, :b)
+    # @dynamic r, g, b, initialize
+    def self.from_hex(hex)
+      r, g, b = hex.chars.last(6).each_slice(2)
+        .map { |c| c.join.to_i(16) / 255.0 }
+
+      new(r: r || 0.0, g: g || 0.0, b: b || 0.0)
+    end
+
+    def to_hex
+      [r, g, b].map { |val|
+        (val * 255).round.clamp(0, 255).to_s(16).rjust(2, '0')
+      }.join
+    end
+
+    private def gamma_expand_one(val)
+      if val <= 0.04045
+        val / 12.92
+      else
+        ((val + 0.055) / 1.055)**2.4
+      end
+    end
+
+    def to_xyz
+      gamma_expand.to_xyz
+    end
+
+    def gamma_expand
+      SRGBLinearColor.new(
+        r: gamma_expand_one(r),
+        g: gamma_expand_one(g),
+        b: gamma_expand_one(b)
+      )
+    end
+
+    def to_ary = [r, g, b]
+    def to_a = to_ary
+  end
+
+  ##
+  # A gamma-expanded ("linear light") RGB value in the sRGB colorspace.
+  class SRGBLinearColor < Data.define(:r, :g, :b)
+    def to_xyz
+      x, y, z = (RGB_XYZ_MATRIX * Matrix[[r], [g], [b]]).to_a.flatten
+      XYZTristimulus.new(x:, y:, z:)
+    end
+
+    private def gamma_compress_one(val)
+      if val <= 0.0031308
+        12.92 * val
+      else
+        (1.055 * (val**(1.0 / 2.4))) - 0.055
+      end
+    end
+
+    def gamma_compress
+      SRGBColor.new(
+        r: gamma_compress_one(r),
+        g: gamma_compress_one(g),
+        b: gamma_compress_one(b)
+      )
+    end
+
+    def to_ary = [r, g, b]
+    def to_a = to_ary
+  end
+
+  ##
+  # A color in the CIE LAB color space.
+  class CIELABColor < Data.define(:l, :a, :b)
+    def self.from_hex(...)
+      SRGBColor.from_hex(...).to_xyz.to_cielab
+    end
+
+    def to_hex
+      to_xyz.to_srgb.to_hex
+    end
+
+    # rubocop: disable Metrics/AbcSize
+    def to_xyz(illuminant: D65)
+      xn, yn, zn = illuminant.x, illuminant.y, illuminant.z
+
+      p = (l + 16) / 116.0
+
+      x = xn * ((p + (a / 500.0))**3) / 100.0
+      y = yn * (p**3) / 100.0
+      z = zn * ((p - (b / 200.0))**3) / 100.0
+
+      XYZTristimulus.new(x:, y:, z:)
+    end
+    # rubocop: enable Metrics/AbcSize
+
+    def cie76(other)
+      (((other.l - l)**2) + ((other.a - a)**2) + ((other.b - b)**2))**0.5
+    end
+
+    def ciede2000(other)
+      # TODO: write this
+      cie76(other)
+    end
+
+    def to_ary = [l, a, b]
+    def to_a = to_ary
+  end
+end

data/lib/colorspace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Colorspace
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

data/lib/colorspace.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'colorspace/version'
+require_relative 'colorspace/colorlib'
 
 module Colorspace
   class Error < StandardError; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: colorspace
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Anna Kudriavtsev
@@ -29,6 +29,7 @@ files:
 - flake.lock
 - flake.nix
 - lib/colorspace.rb
+- lib/colorspace/colorlib.rb
 - lib/colorspace/version.rb
 - shell.nix
 - sig/colorspace.rbs