husler 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in husler.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,13 @@
+Copyright 2012 Bradley Schaefer
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,11 @@
+# Husler
+
+A ruby implementation of [HUSL, a human-friendly color space](http://boronine.com/husl/).
+
+## Usage
+
+TODO
+
+## Credit
+
+Algorithms translated from Alexei Boronine's canonical implementation at https://github.com/boronine/husl

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/husler.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'husler/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "husler"
+  gem.version       = Husler::VERSION
+  gem.authors       = ["Bradley Schaefer"]
+  gem.email         = ["bradley.schaefer@gmail.com"]
+  gem.description   = %q{A ruby implementation of HUSL, a human-friendly color space}
+  gem.summary       = %q{A ruby implementation of HUSL, a human-friendly color space}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

data/lib/husler.rb

@@ -0,0 +1,183 @@
+require 'mathn'
+
+require "husler/version"
+require 'husler/constants'
+
+# :nodoc:
+module Husler
+  extend self
+
+  #	Pass in HUSL values and get back RGB values, H ranges from 0 to 360, S and L from 0 to 100.
+  #	RGB values will range from 0 to 1.
+  def husl_to_rgb(h, s, l)
+    xyz_rgb(luv_xyz(lch_luv(husl_lch([h, s, l]))))
+  end
+
+  #	Pass in RGB values ranging from 0 to 1 and get back HUSL values.
+  #	H ranges from 0 to 360, S and L from 0 to 100.
+  def rgb_to_husl(r, g, b)
+    lch_husl(luv_lch(xyz_luv(rgb_xyz([r, g, b]))))
+  end
+
+  private
+
+  def max_chroma(l, h)
+    hrad = (h / 360.0) * 2.0 * PI
+    sin_h = Math.sin(hrad)
+    cos_h = Math.cos(hrad)
+    sub1 = ((l + 16) ** 3) / 1560896.0
+    sub2 = sub1 > 0.008856 ? sub1 : (l / 903.3);
+
+    result = Float::INFINITY
+
+    M.each do |m1, m2, m3|
+			top = ((0.99915 * m1 + 1.05122 * m2 + 1.14460 * m3) * sub2);
+			rbottom = (0.86330 * m3 - 0.17266 * m2);
+			lbottom = (0.12949 * m3 - 0.38848 * m1);
+			bottom = (rbottom * sin_h + lbottom * cos_h) * sub2;
+
+      LIMITS.each do |t|
+        c = (l * (top - 1.05122 * t) / (bottom + 0.17266 * sin_h * t));
+        result = c if c > 0 && c < result
+      end
+    end
+
+    result
+  end
+
+  def dot_product l1, l2
+      sum = 0
+      for i in 0...l1.size
+          sum += l1[i] * l2[i]
+      end
+      sum
+  end
+
+  def f(t)
+    t > LAB_E ? (t ** ONE_THIRD) : (7.787 * t + 16 / 116.0)
+  end
+
+  def f_inv(t)
+    val = t ** 3
+    val > LAB_E ? val : ((116 * t - 16) / LAB_K)
+  end
+
+  def from_linear(c)
+		c <= 0.0031308 ? (12.92 * c) : (1.055 * (c ** (1 / 2.4)) - 0.055)
+  end
+
+  def to_linear(c)
+    a = 0.055
+
+    c > 0.04045 ? ( ((c + a) / (1 + a)) ** 2.4) : (c / 12.92)
+  end
+
+  def rgb_prepare(tuple)
+    tuple.map! do |v|
+      v = v.round(3)
+      v = [0, v].max
+      v = [1, v].min
+
+      (v * 255).round
+    end
+  end
+
+  def xyz_rgb(tuple)
+    tuple.map! do |v|
+      from_linear(dot_product(v, tuple))
+    end
+  end
+
+  def rgb_xyz(tuple)
+    rgbl = tuple.map { |v| to_linear(v) }
+
+    (0...3).each do |i|
+      tuple[i] = dot_product(M_INV[i], rgbl)
+    end
+    tuple
+  end
+
+  def xyz_luv(tuple)
+    x, y, z = *tuple
+
+		var_u = (4 * x) / (x + (15.0 * y) + (3 * z));
+		var_v = (9 * y) / (x + (15.0 * y) + (3 * z));
+
+		l = 116 * f(y / REF_Y) - 16;
+		u = 13 * l * (var_u - REF_U);
+		v = 13 * l * (var_v - REF_V);
+
+    tuple[0] = l
+    tuple[1] = u
+    tuple[2] = v
+
+    tuple
+  end
+
+  def luv_xyz(tuple)
+    l, u, v = *tuple
+
+    return tuple.map! { 0.0 } if l == 0
+
+		var_y = f_inv((l + 16) / 116.0)
+		var_u = u / (13.0 * l) + REF_U
+		var_v = v / (13.0 * l) + REF_V
+
+		y = var_y * REF_Y
+		x = 0 - (9 * y * var_u) / ((var_u - 4.0) * var_v - var_u * var_v)
+		z = (9 * y - (15 * var_v * y) - (var_v * x)) / (3.0 * var_v)
+
+		tuple[0] = x
+		tuple[1] = y
+		tuple[2] = z
+
+    tuple
+  end
+
+  def luv_lch(tuple)
+    _, u, v = *tuple
+
+    c = ((u ** 2) + (v ** 2)) ** (1 / 2.0)
+    h_rad = Math.atan2(v, u)
+    h = h_rad * 360.0 / 2.0 / PI
+    h = h + 360 if h < 0
+
+    tuple[1] = c
+    tuple[2] = h
+
+    tuple
+  end
+
+  def lch_luv(tuple)
+    _, c, h = *tuple
+
+    h_rad = h / 360.0 * 2.0 * PI
+    u = Math.cos(h_rad) * c
+    v = Math.sin(h_rad) * c
+
+    tuple[1] = u
+    tuple[2] = v
+
+    tuple
+  end
+
+  def husl_lch(tuple)
+    h, s, l = *tuple
+
+    max = max_chroma(l, h)
+    c = max / 100.0 * s
+
+    tuple[0], tuple[1], tuple[2] = l, c, h
+    tuple
+  end
+
+  def lch_husl(tuple)
+    l, c, h = *tuple
+
+    max = max_chroma(l, h)
+    s = c / max * 100
+
+    tuple[0], tuple[1], tuple[2] = h, s, l
+    tuple
+  end
+end

data/lib/husler/constants.rb

@@ -0,0 +1,30 @@
+module Husler
+  PI = Math::PI
+  #PI = 3.1415926535897932384626433832795
+
+  ONE_THIRD = (1.0 / 3.0)
+
+  M = [
+    [3.2406, -1.5372, -0.4986],
+    [-0.9689, 1.8758, 0.0415],
+    [0.0557, -0.2040, 1.0570]
+  ]
+
+  M_INV = [
+    [0.4124, 0.3576, 0.1805],
+    [0.2126, 0.7152, 0.0722],
+    [0.0193, 0.1192, 0.9505]
+  ]
+
+  LIMITS = [0.0, 1.0]
+
+  REF_X = 0.95047
+  REF_Y = 1.00000
+  REF_Z = 1.08883
+
+  REF_U = 0.19784
+  REF_V = 0.46834
+  
+  LAB_E = 0.008856
+  LAB_K = 903.3
+end

data/lib/husler/version.rb

@@ -0,0 +1,3 @@
+module Husler
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: husler
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Bradley Schaefer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-07 00:00:00.000000000 Z
+dependencies: []
+description: A ruby implementation of HUSL, a human-friendly color space
+email:
+- bradley.schaefer@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- husler.gemspec
+- lib/husler.rb
+- lib/husler/constants.rb
+- lib/husler/version.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: A ruby implementation of HUSL, a human-friendly color space
+test_files: []