husl 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 802b38dbbe059a518dd54868775ecb5947c307e9
+  data.tar.gz: bb97a320ddc75100acc0f8d3f0a67fb6101e37f9
+SHA512:
+  metadata.gz: b1cb618f1f8ad0e631078919245b3e842e32234fd33f5c3daf8a2c64e716db28a5e3cdc1accf3254f54de2a949230bcbe0b5f60601fa849d7be0e67fa620ba76
+  data.tar.gz: 47054b907542db4ee93704f76375746b53c4c20edbfa3fd39b5e3c90da258f657dd74ed4bcdd17038234bb4ee8bbbeed2f738df2307ef264df43b1c1d1bfc9c5

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.ruby-version

@@ -0,0 +1 @@
+2.2.1

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+cache: bundler
+rvm:
+  - 2.2.1
+
+script: 'bundle exec rspec'
+
+notifications:
+  email:
+    recipients:
+      - croitoruradubogdan@gmail.com
+    on_failure: change
+    on_success: never

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Radu-Bogdan Croitoru
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# Husl
+
+A Ruby implementation of [HUSL](http://www.husl-colors.org).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'husl'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install husl
+
+## Usage
+
+**husl_to_hex(hue, saturation, lightness)**
+
+`hue` is a float between 0 and 360, `saturation` and `lightness` are floats between 0 and 100. This function returns the resulting color as a hex string.
+
+**husl_to_rgb(hue, saturation, lightness)**
+
+Like above, but returns a list of 3 floats between 0 and 1, for each RGB channel.
+
+**hex_to_husl(hex)**
+
+Takes a hex string and returns the HUSL color as a list of floats as defined above.
+
+**rgb_to_husl(red, green, blue)**
+
+Like above, but `red`, `green` and `blue` are passed as floats between 0 and 1.
+
+For HUSLp (the pastel variant), use `huslp_to_hex`, `huslp_to_rgb`, `hex_to_huslp` and `rgb_to_huslp`.
+
+## Testing
+
+Run `rspec spec/`.

data/Rakefile

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

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "husl"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+require "pry"
+Pry.start
+
+# require "irb"
+# IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/husl.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'husl/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "husl"
+  spec.version       = Husl::VERSION
+  spec.authors       = ["Radu-Bogdan Croitoru"]
+  spec.email         = ["croitoruradubogdan@gmail.com"]
+
+  spec.summary       = %q{Human friendly alternative to HSL.}
+  spec.description   = %q{HUSL is implemented as a set of functions to convert colors between RGB, HUSL and HUSLp. }
+  spec.homepage      = "https://github.com/radubogdan/husl"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rspec"
+end

data/lib/husl.rb

@@ -0,0 +1,276 @@
+require "husl/version"
+
+module Husl
+  extend self
+
+  M = [
+    [3.240969941904521, -1.537383177570093, -0.498610760293],
+    [-0.96924363628087, 1.87596750150772, 0.041555057407175],
+    [0.055630079696993, -0.20397695888897, 1.056971514242878],
+  ]
+
+  M_INV = [
+    [0.41239079926595, 0.35758433938387, 0.18048078840183],
+    [0.21263900587151, 0.71516867876775, 0.072192315360733],
+    [0.019330818715591, 0.11919477979462, 0.95053215224966],
+  ]
+
+  REF_X = 0.95045592705167
+  REF_Y = 1.0
+  REF_Z = 1.089057750759878
+  REF_U = 0.19783000664283
+  REF_V = 0.46831999493879
+  KAPPA = 903.2962962
+  EPSILON = 0.0088564516
+
+  ###
+
+  def husl_to_hex h, s, l
+    rgb_to_hex(*husl_to_rgb(h, s, l))
+  end
+
+  def huslp_to_hex h, s, l
+    rgb_to_hex(*huslp_to_rgb(h, s, l))
+  end
+
+  def hex_to_husl hex
+    rgb_to_husl(*hex_to_rgb(hex))
+  end
+
+  def hex_to_huslp hex
+    rgb_to_huslp(*hex_to_rgb(hex))
+  end
+
+  def husl_to_rgb h, s, l
+    xyz_to_rgb(luv_to_xyz(lch_to_luv(husl_to_lch([h, s, l]))))
+  end
+
+  def rgb_to_husl r, g, b
+    lch_to_husl(rgb_to_lch(r, g, b))
+  end
+
+  def huslp_to_rgb h, s, l
+    lch_to_rgb(*huslp_to_lch([h, s, l]))
+  end
+
+  def rgb_to_huslp r, g, b
+    lch_to_huslp(rgb_to_lch(r, g, b))
+  end
+
+  def lch_to_rgb l, c, h
+    xyz_to_rgb(luv_to_xyz(lch_to_luv([l, c, h])))
+  end
+
+  def rgb_to_lch r, g, b
+    luv_to_lch(xyz_to_luv(rgb_to_xyz([r, g, b])))
+  end
+
+  def rgb_to_hex r, g, b
+    "#%02x%02x%02x" % rgb_prepare([r, g, b])
+  end
+
+  def hex_to_rgb hex
+    hex = hex.tr("#", "")
+    [].tap { |arr| hex.split('').each_slice(2) { |block| arr << block.join.to_i(16) / 255.0 } }
+  end
+
+  ###
+
+  def rgb_to_xyz arr
+    rgbl = arr.map { |val| to_linear(val) }
+    M_INV.map { |i| dot_product(i, rgbl) }
+  end
+
+  def xyz_to_luv arr
+    x, y, z = arr
+    l = f(y)
+
+    return [0.0, 0.0, 0.0] if [x, y, z, 0.0].uniq.length == 1 || l == 0.0
+
+    var_u = (4.0 * x) / (x + (15.0 * y) + (3.0 * z))
+    var_v = (9.0 * y) / (x + (15.0 * y) + (3.0 * z))
+    u = 13.0 * l * (var_u - REF_U)
+    v = 13.0 * l * (var_v - REF_V)
+
+    [l, u, v]
+  end
+
+  def luv_to_lch arr
+    l, u, v = arr
+    c = ((u ** 2) + (v ** 2)) ** (1 / 2.0)
+    hrad = Math.atan2(v, u)
+    h = radians_to_degrees(hrad)
+    h += 360.0 if h < 0.0
+    [l, c, h]
+  end
+
+  def lch_to_husl arr
+    l, c, h = arr
+    return [h, 0.0, 100.0] if l > 99.9999999
+    return [h, 0.0, 0.0] if l < 0.00000001
+
+    mx = max_chroma_for(l, h)
+    s = c / mx * 100.0
+
+    [h, s, l]
+  end
+
+  def lch_to_huslp arr
+    l, c, h = arr
+
+    return [h, 0.0, 100.0] if l > 99.9999999
+    return [h, 0.0, 0.0] if l < 0.00000001
+
+    mx = max_safe_chroma_for(l)
+    s = c / mx * 100.0
+
+    [h, s, l]
+  end
+
+  ###
+
+  def xyz_to_rgb arr
+    xyz = M.map { |i| dot_product(i, arr) }
+    xyz.map { |i| from_linear(i) }
+  end
+
+  def luv_to_xyz arr
+    l, u, v = arr
+
+    return [0.0, 0.0, 0.0] if l == 0
+
+    var_y = f_inv(l)
+    var_u = u / (13.0 * l) + REF_U
+    var_v = v / (13.0 * l) + REF_V
+
+
+    y = var_y * REF_Y
+    x = 0.0 - (9.0 * y * var_u) / ((var_u - 4.0) * var_v - var_u * var_v)
+    z = (9.0 * y - (15.0 * var_v * y) - (var_v * x)) / (3.0 * var_v)
+
+    [x, y, z]
+  end
+
+  def lch_to_luv arr
+    l, c, h = arr
+
+    hrad = degrees_to_radians(h)
+    u = Math.cos(hrad) * c
+    v = Math.sin(hrad) * c
+
+    [l, u, v]
+  end
+
+  def husl_to_lch arr
+    h, s, l = arr
+
+    return [100, 0.0, h] if l > 99.9999999
+    return [0.0, 0.0, h] if l < 0.00000001
+
+    mx = max_chroma_for(l, h)
+    c = mx / 100.0 * s
+
+    [l, c, h]
+  end
+
+  def huslp_to_lch arr
+    h, s, l = arr
+
+    return [100, 0.0, h] if l > 99.9999999
+    return [0.0, 0.0, h] if l < 0.00000001
+
+    mx = max_safe_chroma_for(l)
+    c = mx / 100.0 * s
+
+    [l, c, h]
+  end
+
+  ###
+
+  def radians_to_degrees rad
+    rad * 180.0 / Math::PI
+  end
+
+  def degrees_to_radians degrees
+    degrees * Math::PI / 180.0
+  end
+
+  def max_chroma_for l, h
+    hrad = h / 360.0 * Math::PI * 2.0
+    lengths = []
+
+    get_bounds(l).each do |line|
+      l = length_of_ray_until_intersect(hrad, line)
+      lengths << l if l
+    end
+
+    lengths.min
+  end
+
+  def max_safe_chroma_for l
+    lengths = []
+
+    get_bounds(l).each do |m1, b1|
+      x = intersect_line_line([m1, b1], [-1.0 / m1, 0.0])
+      lengths << distance_from_pole([x, b1 + x * m1])
+    end
+
+    lengths.min
+  end
+
+  def get_bounds l
+    sub1 = ((l + 16.0) ** 3.0) / 1560896.0
+    sub2 = sub1 > EPSILON ? sub1 : l / KAPPA
+    ret = []
+
+    M.each do |m1, m2, m3|
+      [0, 1].each do |t|
+        top1 = (284517.0 * m1 - 94839.0 * m3) * sub2
+        top2 = (838422.0 * m3 + 769860.0 * m2 + 731718.0 * m1) * l * sub2 - 769860.0 * t * l
+        bottom = (632260.0 * m3 - 126452.0 * m2) * sub2 + 126452.0 * t
+        ret << [top1 / bottom, top2 / bottom]
+      end
+    end
+
+    ret
+  end
+
+  def length_of_ray_until_intersect theta, line
+    m1, b1 = line
+    length = b1 / (Math.sin(theta) - m1 * Math.cos(theta))
+    return nil if length < 0
+    length
+  end
+
+  def intersect_line_line line1, line2
+    (line1[1] - line2[1]) / (line2[0] - line1[0])
+  end
+
+  def distance_from_pole point
+    Math.sqrt(point[0] ** 2 + point[1] ** 2)
+  end
+
+  def f t
+    t > EPSILON ? 116 * ((t / REF_Y) ** (1.0 / 3.0)) - 16.0 : t / REF_Y * KAPPA
+  end
+
+  def f_inv t
+    t > 8 ? REF_Y * ((t + 16.0) / 116.0) ** 3.0 : REF_Y * t / KAPPA
+  end
+
+  def to_linear c
+    c > 0.04045 ? ((c + 0.055) / 1.055) ** 2.4 : c / 12.92
+  end
+
+  def from_linear c
+    c <= 0.0031308 ? 12.92 * c : (1.055 * (c ** (1.0 / 2.4)) - 0.055)
+  end
+
+  def dot_product a, b
+    a.zip(b).map { |i, j| i * j }.inject(:+)
+  end
+
+  def rgb_prepare arr
+    arr.map! { |ch| ch = ch.round(3); ch = [0, ch].max; ch = [1, ch].min; (ch * 255).round }
+  end
+end

data/lib/husl/version.rb

@@ -0,0 +1,3 @@
+module Husl
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: husl
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Radu-Bogdan Croitoru
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-07-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 'HUSL is implemented as a set of functions to convert colors between
+  RGB, HUSL and HUSLp. '
+email:
+- croitoruradubogdan@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- husl.gemspec
+- lib/husl.rb
+- lib/husl/version.rb
+homepage: https://github.com/radubogdan/husl
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Human friendly alternative to HSL.
+test_files: []