camalian 0.0.1 → 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6d00dedccb6e595bdc20ada99a24660c6ae5dd3d
+  data.tar.gz: 5c0dbce2351031926ae80fd502d96f14899c83c6
+SHA512:
+  metadata.gz: e7cf381751a54732d7a08474333accca30b0b5284c0916373f88c739e1951f4557469c5c5611d719200e29d5c1c5403aa87d7143395fbf3e96b311d55d66a9d2
+  data.tar.gz: bf78a507dcec731e88d8fe13c0f6e5e962529bf644d5fb49b9d760518ebf1352c25108a4f1e3ee4fab726c663b773bdcb0ff3aa6a975b359c4f9771a4dbad57c

data/README.md

@@ -1,12 +1,12 @@
 # Camalian
 
-TODO: Write a gem description
+Ruby gem to extract color palettes from images and play with their saturation
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'camalian'
+    gem 'camalian', '~> 0.0.2'
 
 And then execute:
 
@@ -18,7 +18,10 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+    image = Camalian::load('file_path')
+    colors = image.prominent_colors(15)
+    colors = colors.sort_similar_colors
+    colors.light_colors(0, 40)
 
 ## Contributing
 

data/Rakefile

@@ -1 +1,10 @@
 require "bundler/gem_tasks"
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+desc "Run tests"
+task :default => :test

data/camalian.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["nazarhussain@gmail.com"]
   spec.description   = %q{Library used to deal with colors and images}
   spec.summary       = %q{Library used to deal with colors and images. You can extract colors from images.}
-  spec.homepage      = "http://www.nazarhussain.com"
+  spec.homepage      = "https://github.com/nazarhussain/camalian"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files`.split($/)
@@ -18,4 +18,10 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
+  spec.requirements  = 'ImageMagick'
+
+  spec.add_dependency "cocaine"
+  spec.add_dependency "rmagick", "~> 2.15.4"
+  spec.add_dependency "oily_png", "~> 1.2.0"
+
 end

data/lib/camalian.rb

@@ -1,5 +1,26 @@
+require "oily_png"
+require "tempfile"
+require "open-uri"
+require "cocaine"
+require "chunky_png_patch/color"
+
 require "camalian/version"
+require "camalian/color"
+require "camalian/palette"
+require "camalian/image"
 
 module Camalian
-  # Your code goes here...
+  class << self
+    def options
+      convert = `which convert`.strip
+      @options ||= {
+          :image_magick_path  => convert.length > 0 ? convert : '/usr/bin/convert',
+          :color_count        => 8,
+      }
+    end
+
+    def load(image_path)      
+      Image.new(image_path)
+    end
+  end
 end

data/lib/camalian/color.rb

@@ -0,0 +1,98 @@
+module Camalian
+  class Color
+
+    attr_reader :r, :g, :b, :h, :s, :l, :hsv
+
+    def initialize(*value)
+      if value.size == 1
+        rgb = extract_rgb(value.first)
+        build_components(rgb[0], rgb[1], rgb[2])
+      elsif value.size == 3
+        build_components(value[0], value[1], value[2])
+      end
+    end
+
+    def to_s
+      "red=#{r} green=#{g} blue=#{b} hue=#{h} saturation=#{s} lightness=#{l}"
+    end
+
+    def to_hex
+      "##{r.to_s(16).rjust(2, '0')}#{g.to_s(16).rjust(2, '0')}#{b.to_s(16).rjust(2, '0')}"
+    end
+
+    def distance(color)
+      [(self.h - color.h) % 360, (color.h - self.h) % 360].min
+    end
+
+    def extract_rgb(color_hash)
+      color_hash = color_hash[0..6]
+      color_hash = color_hash[1..6] if color_hash[0] == '#'
+      r = color_hash[0..1].to_i(16)
+      g = color_hash[2..3].to_i(16)
+      b = color_hash[4..5].to_i(16)
+      [r, g, b]
+    end
+
+    private
+
+    def build_components(r,g,b)
+      @r = r
+      @g = g
+      @b = b
+
+      ri = @r / 255.0
+      gi = @g / 255.0
+      bi = @b / 255.0
+
+      cmax = [ri, gi, bi].max
+      cmin = [ri, gi, bi].min
+      delta = cmax - cmin
+
+      @l = (cmax + cmin) / 2.0
+
+      if delta == 0
+        @h = 0
+      elsif cmax == ri
+        @h = 60 * (((gi - bi) / delta) % 6)
+      elsif cmax == gi
+        @h = 60 * (((bi - ri)/ delta) + 2)
+      elsif cmax == bi
+        @h = 60 * (((ri - gi)/ delta) + 4)
+      end
+
+      if (delta == 0)
+        @s = 0
+      else
+        @s = delta / ( 1 - (2*@l -1).abs )
+      end
+
+      @h = @h.round(2)
+      @s = (@s * 100).round(2)
+      @l = (@l * 100).round(2)
+
+      # HSV Calculation
+      # Hue calculation
+      if delta == 0
+        @hsv = [0]
+      elsif cmax == ri
+        @hsv = [60 * (((gi - bi) / delta) % 6)]
+      elsif cmax == gi
+        @hsv = [60 * (((bi - ri)/ delta) + 2)]
+      elsif cmax == bi
+        @hsv = [60 * (((ri - gi)/ delta) + 4)]
+      end
+
+      # Saturation calculation
+      if (cmax == 0)
+        @hsv  << 0
+      else
+        @hsv << delta / cmax
+      end
+
+      # Value calculation
+      @hsv << cmax
+
+      @hsv = [@hsv[0].round(2), (@hsv[1] * 100).round(2), (@hsv[2] * 100).round(2)]
+    end
+  end
+end

data/lib/camalian/image.rb

@@ -0,0 +1,36 @@
+require 'rmagick'
+
+module Camalian
+  class Image
+    attr_accessor :src_file_path
+
+    def initialize(file_path)
+      @src_file_path = file_path
+    end
+
+    def prominent_colors(count=Camalian.options[:color_count])
+      image = ::Magick::Image.read(@src_file_path)[0]
+      image.resize!(100,100)
+      colors = Palette.new
+      initial_count = count
+      q = nil
+      loop do
+        q = image.quantize(initial_count, Magick::RGBColorspace)
+        break if q.color_histogram.size > count
+        initial_count = initial_count + 10
+      end
+      palette = q.color_histogram.sort {|a, b| b[1] <=> a[1]}
+      (0..[count, palette.count].min - 1).each do |i|
+          c = palette[i].first.to_s.split(',').map {|x| x[/\d+/]}
+          c.pop
+          c[0], c[1], c[2] = [c[0], c[1], c[2]].map { |s|
+              s = s.to_i
+              s = s / 255 if s / 255 > 0 # not all ImageMagicks are created equal....
+              s
+          }
+          colors << Color.new(c[0],c[1],c[2])
+      end
+      return colors.uniq(&:to_hex)
+    end
+  end
+end

data/lib/camalian/palette.rb

@@ -0,0 +1,27 @@
+module Camalian
+  class Palette < Array
+
+    def sort_by_lightness
+      Palette.new(self.sort_by { |a| a.l }.reverse)
+    end
+
+    def sort_by_hue
+      Palette.new(self.sort_by { |a| a.h }.reverse)
+    end
+
+    def sort_similar_colors
+      Palette.new(self.sort_by { |a| a.hsv })
+    end
+
+    def sort_by_saturation
+      Palette.new(self.sort_by { |a| a.s }.reverse)
+    end
+
+    def light_colors(limit1, limit2)
+      min = [limit1, limit2].min
+      max = [limit1, limit2].max
+      table = self.dup
+      Palette.new(table.delete_if { |color| color.l > max or color.l < min })
+    end
+  end
+end

data/lib/camalian/version.rb

@@ -1,3 +1,3 @@
 module Camalian
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/lib/chunky_png_patch/color.rb

@@ -0,0 +1,14 @@
+module ChunkyPNG::Color
+  # See http://en.wikipedia.org/wiki/Hue#Computing_hue_from_RGB
+  def self.hue(pixel)
+    r, g, b = r(pixel), g(pixel), b(pixel)
+    return 0 if r == b and b == g
+    ((180 / Math::PI * Math.atan2((2 * r) - g - b, Math.sqrt(3) * (g - b))) - 90) % 360
+  end
+
+  # The modular distance, as the hue is circular
+  def self.distance(pixel, poxel)
+    hue_pixel, hue_poxel = hue(pixel), hue(poxel)
+    [(hue_pixel - hue_poxel) % 360, (hue_poxel - hue_pixel) % 360].min
+  end
+end

data/test/test_color.rb

@@ -0,0 +1,29 @@
+require 'minitest/autorun'
+require 'minitest/spec'
+require 'camalian'
+
+describe Camalian::Color do
+  before do
+    @color = Camalian::Color.new(120,255,30)
+  end
+
+  describe "Color initialized with 120, 255, 30 rgb values" do
+    it "hex value must be #78ff1e" do
+      @color.to_hex.must_equal "#78ff1e"
+    end
+
+    it "hsl color components must " do
+      [@color.h.to_i, @color.s.to_i, @color.l.to_i].must_equal [96, 100, 55]
+    end
+
+    it "hsv color components must " do
+      @color.hsv.map(&:to_i).must_equal [96, 88, 100]
+    end
+  end
+
+  describe "initialized with 1 integer rgb value" do
+    it "must have leading zero" do
+      Camalian::Color.new(7, 7, 7).to_hex.must_equal "#070707"
+    end
+  end
+end

data/test/test_palette.rb

@@ -0,0 +1,28 @@
+require 'minitest/autorun'
+require 'minitest/spec'
+require 'camalian'
+
+describe Camalian::Image do
+
+end
+
+describe Camalian::Palette do
+  before do
+    @image = Camalian::load( File.join( File.dirname(__FILE__), 'assets/palette.png'))
+    @palette = @image.prominent_colors(15)
+  end
+
+  describe "palette with 15 colors extracted" do
+    it "must have 15 colors" do
+      @palette.size.must_equal 15
+    end
+
+    it "sort similar colors in order" do
+      @palette.sort_similar_colors.map(&:to_hex).must_equal %W(#4dda15 #45c131 #41b53f #3da94d #3da84e #359169 #318578 #2d7986 #296d94 #2560a3 #2154b1 #1d48bf #193dcd #193cce #1530dc)
+    end
+
+    it "color with intensity 0-40 works well" do
+      @palette.light_colors(0, 40).map(&:to_hex).must_equal %W(#318578 #2560a3 #359169 #296d94 #2d7986)
+    end
+  end
+end

metadata

@@ -1,16 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: camalian
 version: !ruby/object:Gem::Version
-  version: 0.0.1
-  prerelease: 
+  version: 0.0.2
 platform: ruby
 authors:
 - Nazar Hussain
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-12 00:00:00.000000000 Z
-dependencies: []
+date: 2015-10-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cocaine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.15.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.15.4
+- !ruby/object:Gem::Dependency
+  name: oily_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.0
 description: Library used to deal with colors and images
 email:
 - nazarhussain@gmail.com
@@ -18,38 +59,48 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - camalian.gemspec
 - lib/camalian.rb
+- lib/camalian/color.rb
+- lib/camalian/image.rb
+- lib/camalian/palette.rb
 - lib/camalian/version.rb
-homepage: http://www.nazarhussain.com
+- lib/chunky_png_patch/color.rb
+- test/assets/palette.png
+- test/test_color.rb
+- test/test_palette.rb
+homepage: https://github.com/nazarhussain/camalian
 licenses:
 - MIT
+metadata: {}
 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: []
+requirements:
+- ImageMagick
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.4.5
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Library used to deal with colors and images. You can extract colors from
   images.
-test_files: []
+test_files:
+- test/assets/palette.png
+- test/test_color.rb
+- test/test_palette.rb