colorscore 0.0.2 → 0.0.3

data/README.md

@@ -0,0 +1,22 @@
+# Colorscore
+
+Colorscore is a simple library that uses ImageMagick to quantize an image and find its representative colors. It can also score those colors against a palette using the CIE2000 Delta E formula. This could be used to index images for a "search by color" feature.
+
+## Requirements
+
+* ImageMagick 6.5+
+
+## Usage
+
+```ruby
+include Colorscore
+histogram = Histogram.new('test/fixtures/skydiver.jpg')
+
+# This image is 78.8% #7a9ab5:
+histogram.scores.first # => [0.7884625, RGB [#7a9ab5]]
+
+# This image is closest to pure blue:
+palette = Palette.from_hex(['ff0000', '00ff00', '0000ff'])
+scores = palette.scores(histogram.scores, 1)
+scores.first # => [0.16493763694876, RGB [#0000ff]]
+```

data/lib/colorscore/histogram.rb

@@ -1,7 +1,7 @@
 module Colorscore
   class Histogram
     def initialize(image_path, colors=16, depth=8)
-      output = `convert #{image_path} -resize 400x400 -format %c -dither None -quantize LAB -colors #{colors} -depth #{depth} histogram:info:-`
+      output = `convert #{image_path} -resize 400x400 -format %c -dither None -quantize YIQ -colors #{colors} -depth #{depth} histogram:info:-`
       @lines = output.lines.sort.reverse.map(&:strip).reject(&:empty?)
     end
     

data/lib/colorscore/palette.rb

@@ -7,10 +7,14 @@ module Colorscore
                "000000", "999999", "cccccc", "ffffff"]
     
     def self.default
-      new DEFAULT.map { |hex| Color::RGB.from_html(hex) }
+      from_hex DEFAULT
     end
     
-    def scores(histogram_scores)
+    def self.from_hex(hex_values)
+      new hex_values.map { |hex| Color::RGB.from_html(hex) }
+    end
+    
+    def scores(histogram_scores, distance_threshold=0.275)
       scores = map do |palette_color|
         score = 0
         
@@ -19,7 +23,7 @@ module Colorscore
           
           color = color.to_hsl.tap { |c| c.s = 0.05 + c.s * (4 - c.l * 2.5) }.to_rgb
           
-          if (distance = Metrics.distance(palette_color, color)) < 0.275
+          if (distance = Metrics.distance(palette_color, color)) < distance_threshold
             distance_penalty = (1 - distance) ** 4
             score += color_score * distance_penalty
           end 

data/lib/colorscore/version.rb

@@ -1,3 +1,3 @@
 module Colorscore
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: colorscore
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: 
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Milo Winningham
@@ -15,11 +15,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-01-12 00:00:00 -08:00
-default_executable: 
+date: 2012-02-12 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   prerelease: false
+  type: :runtime
   requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -29,11 +29,11 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  type: :runtime
   name: color
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
   prerelease: false
+  type: :development
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -43,7 +43,6 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  type: :development
   name: rake
   version_requirements: *id002
 description: Finds the dominant colors in an image and scores them against a user-defined palette, using the CIE2000 Delta E formula.
@@ -58,6 +57,7 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - Gemfile
+- README.md
 - Rakefile
 - colorscore.gemspec
 - lib/colorscore.rb
@@ -70,7 +70,6 @@ files:
 - test/metrics_test.rb
 - test/palette_test.rb
 - test/test_helper.rb
-has_rdoc: true
 homepage: 
 licenses: []
 
@@ -100,7 +99,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
 summary: Finds the dominant colors in an image.