lsrs-color_palette 0.0.2

data/README.rdoc

@@ -0,0 +1,28 @@
+#!/opt/local/bin/ruby
+
+# == Synopsis 
+#   color_palette prints the colors used in an image in order of usage.
+#
+# == Examples
+#   This command prints the 32 most used colors in the image barbie.jpg 
+#     color_palette barbie.jpg
+#
+#   Other examples:
+#     color_palette -n 16 barbie.jpg
+#
+# == Usage 
+#   color_palette [options] image_file
+#
+#   For help use: color_palette -h
+#
+# == Options
+#   -h, --help          Displays help message
+#   -v, --version       Display the version, then exit
+#   -n [NUM]            Set the number of colors to print in the palette (default is 32)
+#
+# == Author
+#   Matthew Shanley
+#
+# == Copyright
+#   Copyright (c) 2008 Matthew Shanley. Licensed under the MIT License:
+#   http://www.opensource.org/licenses/mit-license.php

data/Rakefile

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('color_palette', '0.0.2') do |p|
+  p.description = 'Describes the color palette of a given image.'
+  p.url = 'http://github.com/lsrs/color_palette/'
+  p.author = 'Matthew Shanley'
+  p.email = 'matthewshanley@littlesecretsrecords.com'
+  p.ignore_pattern = ["tmp/*", "script/*"]
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each {|ext| load ext }

data/bin/color_palette

@@ -0,0 +1,145 @@
+#!/opt/local/bin/ruby
+
+# == Synopsis 
+#   color_palette prints the colors used in an image in order of usage.
+#
+# == Examples
+#   This command prints the 32 most used colors in the image barbie.jpg 
+#     color_palette barbie.jpg
+#
+#   Other examples:
+#     color_palette -n 16 barbie.jpg
+#
+# == Usage 
+#   color_palette [options] image_file
+#
+#   For help use: color_palette -h
+#
+# == Options
+#   -h, --help          Displays help message
+#   -v, --version       Display the version, then exit
+#   -n [NUM]            Set the number of colors to print in the palette (default is 32)
+#
+# == Author
+#   Matthew Shanley
+#
+# == Copyright
+#   Copyright (c) 2008 Matthew Shanley. Licensed under the MIT License:
+#   http://www.opensource.org/licenses/mit-license.php
+
+
+require 'optparse'
+require 'rubygems'
+require 'RMagick'
+require 'rdoc/usage'
+require 'ostruct'
+
+include Magick
+
+
+class App
+  VERSION = '0.0.2'
+  
+  attr_reader :options
+  
+  def initialize(arguments, stdin)
+    @arguments = arguments
+    @stdin = stdin
+    
+    # Set defaults
+    @options = OpenStruct.new
+    @options.num_colors = 32
+  end
+  
+  
+  # Parse options, check arguments, then process the command
+  def run
+    if parsed_options? && arguments_valid?
+      
+      process_arguments
+      process_command
+      
+    else
+      output_usage
+    end
+  end
+  
+  
+  private
+  
+  def parsed_options?
+    # Specify options
+    opts = OptionParser.new
+    opts.on('-v', '--version')  { output_version ; exit 0}
+    opts.on('-h', '--help')     { output_help }
+    opts.on('-n [NUM]')         {|num| @options.num_colors = num.to_i }
+    
+    opts.parse!(@arguments) rescue return false
+    
+    true
+  end
+  
+  def output_options
+    puts "Options:\n"
+    
+    @options.marshal_dump.each do |name, val|
+      puts " #{name} = #{val}"
+    end
+  end
+  
+  # True if required arguments were provided
+  def arguments_valid?
+    true if @arguments.length >= 1
+  end
+  
+  # Setup the arguments
+  def process_arguments
+    # Get the file to work on
+    @img_file = ARGV[0]
+  end
+  
+  def output_help
+    output_version
+    RDoc::usage()    # exits app
+  end
+  
+  def output_usage
+    RDoc::usage('usage')   # gets usage from comments above
+  end
+  
+  def output_version
+    puts "#{File.basename(__FILE__)} version #{VERSION}"
+  end
+  
+  def process_command
+    
+    # Read in image
+    img_array = Image.read(@img_file)
+
+    # Check that there's at least one image
+    if img_array.size < 1
+      abort("Not a valid image.")
+    end
+
+    # Get the first image (we'll only deal with one)
+    img = img_array[0]
+    
+    # Reduce the number of colors in the image to match the number we'll output.
+    # Don't dither the image.
+    img = img.quantize(@options.num_colors, Magick::RGBColorspace, false)
+
+    # Get the histogram of all the colors, sorting by descending value
+    hist = img.color_histogram.sort {|a,b| b[1]<=>a[1]}
+
+    hist.each do |key, value|
+      # TODO Provide options for other forms of output, like RRR, GGG, BBB
+      puts "#{key.to_color(AllCompliance, false, 8)}"
+    end
+    
+  end
+end
+
+
+# Create and run the application
+app = App.new(ARGV, STDIN)
+app.run

data/color_palette.gemspec

@@ -0,0 +1,36 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{color_palette}
+  s.version = "0.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Matthew Shanley"]
+  s.date = %q{2009-01-24}
+  s.default_executable = %q{color_palette}
+  s.description = %q{Describes the color palette of a given image.}
+  s.email = %q{matthewshanley@littlesecretsrecords.com}
+  s.executables = ["color_palette"]
+  s.extra_rdoc_files = ["bin/color_palette", "README.rdoc"]
+  s.files = ["bin/color_palette", "Manifest", "Rakefile", "README.rdoc", "color_palette.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/lsrs/color_palette/}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Color_palette", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{color_palette}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{Describes the color palette of a given image.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<echoe>, [">= 0"])
+    else
+      s.add_dependency(%q<echoe>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<echoe>, [">= 0"])
+  end
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: lsrs-color_palette
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Matthew Shanley
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-24 00:00:00 -08:00
+default_executable: color_palette
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: echoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Describes the color palette of a given image.
+email: matthewshanley@littlesecretsrecords.com
+executables: 
+- color_palette
+extensions: []
+
+extra_rdoc_files: 
+- bin/color_palette
+- README.rdoc
+files: 
+- bin/color_palette
+- Manifest
+- Rakefile
+- README.rdoc
+- color_palette.gemspec
+has_rdoc: true
+homepage: http://github.com/lsrs/color_palette/
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Color_palette
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: color_palette
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Describes the color palette of a given image.
+test_files: []
+