colorspace 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c139dfc8f81959c4676b6626d5e72bcca448b829213a624f9bced835e662ce3e
-  data.tar.gz: 7eadea0f02c8d3b44c6c11c7bca30b66cb1ce2e5f8630c81c9ab3bea7af58d56
+  metadata.gz: 9400e62857f08e86defabffe2f88ae73dc05ac5f05cc29f575a86917a2121c45
+  data.tar.gz: 8e38f06fc5d6d804a2cb81bcc3dbc0e2176987f9c7890088d62809998b1bcc73
 SHA512:
-  metadata.gz: 867d76ec2efb1ca07ec2d8da0308fdeea8f1e2437277e6cb6d9b3a3d839b003abb1b3020bc0b81160625b536e856c717f15f2dd8ce5361fe49959cc025b546c3
-  data.tar.gz: 78ea353372d5c30ae12c5e3c0c61744b9a587b0d4db1f3c733b10cb0f3e106079ba753eed6aae3d70b11f86ad595027f4fc76733c8a881f7d3bca13df5f3cda1
+  metadata.gz: 6abdcfa05487d616ad1972ac847bbc38744ceda59fd203b46327db3f3e7a7b162f8b2b201335c0d4f23dde49a05828f3fbbcf51d9358a82267b0ae20d2ad9969
+  data.tar.gz: e6e3d20acac710720d55f0e5d42fc9b7e32ee61c8eab857a24211ccd0e12224bbff7591d4a5a6d02c628d82dd56e73fce3cb0f5bb8a04ee9a9307dc5d41edfc7

data/.rubocop.yml

@@ -38,3 +38,6 @@ Style/DataInheritance:
 
 Style/ParallelAssignment:
   Enabled: false
+
+Gemspec/RequireMFA:
+  Enabled: false

data/Gemfile.lock

@@ -1,7 +1,8 @@
 PATH
   remote: .
   specs:
-    colorspace (0.1.0)
+    colorspace (0.1.1)
+      matrix (~> 0.4)
 
 GEM
   remote: https://rubygems.org/
@@ -9,6 +10,7 @@ GEM
     ast (2.4.2)
     json (2.7.1)
     language_server-protocol (3.17.0.3)
+    matrix (0.4.2)
     minitest (5.20.0)
     parallel (1.24.0)
     parser (3.2.2.4)

data/colorspace.gemspec

@@ -33,7 +33,6 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
+  spec.add_dependency 'matrix', '~> 0.4'
   # spec.metadata['rubygems_mfa_required'] = 'true'
 end

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.2'
 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.2
 platform: ruby
 authors:
 - Anna Kudriavtsev
@@ -9,7 +9,21 @@ autorequire:
 bindir: exe
 cert_chain: []
 date: 1980-01-01 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: matrix
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
 description:
 email:
 - anna328p@gmail.com
@@ -29,6 +43,7 @@ files:
 - flake.lock
 - flake.nix
 - lib/colorspace.rb
+- lib/colorspace/colorlib.rb
 - lib/colorspace/version.rb
 - shell.nix
 - sig/colorspace.rbs