quick_magick 0.6.1 → 0.7.0

data/Manifest

@@ -1,13 +1,13 @@
+Manifest
 README
 Rakefile
+lib/quick_magick.rb
 lib/quick_magick/image.rb
 lib/quick_magick/image_list.rb
-lib/quick_magick.rb
-Manifest
-quick_magick.gemspec
-test/image_test.rb
+test/9.gif
 test/badfile.xxx
-test/multipage.tif
 test/image_list_test.rb
+test/image_test.rb
+test/multipage.tif
 test/test_magick.rb
-test/9.gif
+test/warnings.tiff

data/README

@@ -66,7 +66,7 @@ Actually, I didn't need this feature, but I may need it in the future.
 
 At this point I decided to make my own gem and QuickMagick was born.
 I addressed the problems of MiniMagick while using the same main idea.
-First, QuickMagick doesn't write any temporary images to disk.
+First, QuickMagick doesn't write any temporary image files to disk.
 It doesn't issue any command line commands till the very end when you are saving the image.
 Second, I made an API similar to RMagick which allows for accessing multipage images.
 Third, I added API commands to create images from scratch and drawing simple primitives on images.
@@ -107,9 +107,9 @@ I couldn't test MiniMagick for this because it doesn't support an API for drawin
 
 == Conclusion
 QuickMagick is very easy to install, very easy to use and allows you to access most features of ImageMagick.
-RMagick is a bit faster and has an advantage of allowing you to access single pixels but it's a bit hard to install.
+RMagick is a bit faster but it's a bit hard to install.
 Also RMagick sometimes fail when it tries to handle large images.
-MiniMagick is proved to be a bit slower than QuickMagick with no advantage.
+MiniMagick is proved to be slower than QuickMagick with no advantage.
 So, it's better to use QuickMagick when your application is not image-centric.
 This means, you're not going to build an image manipulation tool or something like this.
 For normal operations like resize, rotate, generating captchas ... etc, QuickMagick will be a good friend of you.
@@ -161,7 +161,7 @@ QuickMagick supports also ImageList s
 	il.resize "300x300>"
 	il.save!
 
-(new) You can also create images from scratch
+You can also create images from scratch
 	# Create a 300x300 gradient image from yellow to red
 	i1 = QuickMagick::Image::gradient(300, 300, QuickMagick::RadialGradient, :yellow, :red)
 	i1.save 'gradient.png'
@@ -178,6 +178,15 @@ QuickMagick supports also ImageList s
 
 ... you can then convert it to blob using
   i.to_blob
+  
+(new) You can now access single pixels using QuickMagick
+	# Create a 300x300 gradient image from yellow to red
+	i1 = QuickMagick::Image::gradient(300, 300, QuickMagick::RadialGradient, :yellow, :red)
+	i1.save 'gradient.png'
+	
+	# Now you can access single pixel values
+	i1.get_pixel(10,10) # [255, 0, 0]
+	i1.get_pixel(50,50) # [255, 15, 0]
 
 For more information on drawing API visit:
 http://www.imagemagick.org/Usage/draw/

data/Rakefile

@@ -2,7 +2,7 @@ require 'rubygems'
 require 'rake'
 require 'echoe'
  
-Echoe.new('quick_magick', '0.6.1') do |p|
+Echoe.new('quick_magick', '0.7.0') do |p|
   p.description    = "QuickMagick allows you to access ImageMagick command line functions using Ruby interface."
   p.url            = "http://quickmagick.rubyforge.org/"
   p.author         = "Ahmed ElDawy"

data/lib/quick_magick/image.rb

@@ -19,12 +19,8 @@ module QuickMagick
         info = identify(%Q<"#{filename}">)
         info_lines = info.split(/[\r\n]/)
         images = []
-        if info_lines.size == 1
-          images << Image.new(filename, info_lines.first)
-        else
-          info_lines.each_with_index do |info_line, i|
-            images << Image.new("#{filename}[#{i.to_s}]", info_line)
-          end
+        info_lines.each_with_index do |info_line, i|
+          images << Image.new("#{filename}", i, info_line)
         end
         images.each(&proc) if block_given?
         return images
@@ -38,7 +34,7 @@ module QuickMagick
         template_name = type + ":"
         template_name << color1.to_s if color1
         template_name << '-' << color2.to_s if color2
-        i = self.new(template_name, nil, true)
+        i = self.new(template_name, 0, nil, true)
         i.size = QuickMagick::geometry(width, height)
         i
       end
@@ -47,7 +43,7 @@ module QuickMagick
       def solid(width, height, color=nil)
         template_name = QuickMagick::SolidColor+":"
         template_name << color.to_s if color
-        i = self.new(template_name, nil, true)
+        i = self.new(template_name, 0, nil, true)
         i.size = QuickMagick::geometry(width, height)
         i
       end
@@ -56,7 +52,7 @@ module QuickMagick
       def pattern(width, height, pattern)
         raise QuickMagick::QuickMagickError, "Invalid pattern '#{pattern.to_s}'" unless QuickMagick::Patterns.include?(pattern.to_s)
         template_name = "pattern:#{pattern.to_s}"
-        i = self.new(template_name, nil, true)
+        i = self.new(template_name, 0, nil, true)
         i.size = QuickMagick::geometry(width, height)
         i
       end
@@ -86,10 +82,15 @@ module QuickMagick
       @last_is_draw = false
       self
     end
+    
+    # append the given string as is. Used to append special arguments like +antialias or +debug
+    def append_basic(arg)
+      @arguments << arg << ' '
+    end
 
     # Image settings supported by ImageMagick
     IMAGE_SETTINGS_METHODS = %w{
-      adjoin affine alpha antialias authenticate attenuate background bias black-point-compensation
+      adjoin affine alpha authenticate attenuate background bias black-point-compensation
       blue-primary bordercolor caption channel colors colorspace comment compose compress define
       delay depth display dispose dither encoding endian family fill filter font format fuzz gravity
       green-primary intent interlace interpolate interword-spacing kerning label limit loop mask
@@ -140,7 +141,7 @@ module QuickMagick
 
     # methods that are called with (=)
     WITH_EQUAL_METHODS =
-      %w{alpha antialias background bias black-point-compensation blue-primary border bordercolor caption
+      %w{alpha background bias black-point-compensation blue-primary border bordercolor caption
         cahnnel colors colorspace comment compose compress depth density encoding endian family fill filter
         font format frame fuzz geometry gravity label mattecolor page pointsize quality stroke strokewidth
         undercolor units weight
@@ -149,10 +150,14 @@ module QuickMagick
     # methods that takes geometry options
     WITH_GEOMETRY_METHODS =
       %w{density page sampling-factor size tile-offset adaptive-blur adaptive-resize adaptive-sharpen
-        annotate blur border chop contrast-stretch extent extract floodfill frame gaussian-blur
+        annotate blur border chop contrast-stretch extent extract frame gaussian-blur
         geometry lat linear-stretch liquid-rescale motion-blur region repage resample resize roll
         sample scale selective-blur shadow sharpen shave shear sigmoidal-contrast sketch
         splice thumbnail unsharp vignette wave crop}
+   
+    # Methods that need special treatment. This array is used just to keep track of them.
+    SPECIAL_COMMANDS =
+      %w{floodfill antialias draw}
 
     IMAGE_SETTINGS_METHODS.each do |method|
       if WITH_EQUAL_METHODS.include?(method)
@@ -191,13 +196,19 @@ module QuickMagick
       append_to_operators "floodfill", QuickMagick::geometry(width, height, x, y, flag), color
     end
     
+    # Enables/Disables flood fill. Pass a boolean argument.
+    def antialias=(flag)
+    	append_basic flag ? '-antialias' : '+antialias'
+    end
+    
     # define attribute readers (getters)
     attr_reader :image_filename
     alias original_filename image_filename
     
     # constructor
-    def initialize(filename, info_line=nil, pseudo_image=false)
+    def initialize(filename, index=0, info_line=nil, pseudo_image=false)
       @image_filename = filename
+      @index = index
       @pseudo_image = pseudo_image
       if info_line
         @image_infoline = info_line.split
@@ -208,7 +219,7 @@ module QuickMagick
     
     # The command line so far that will be used to convert or save the image
     def command_line
-      %Q< "(" #{@arguments} #{QuickMagick::c image_filename} ")" >
+      %Q< "(" #{@arguments} #{QuickMagick::c(image_filename + (@pseudo_image ? "" : "[#{@index}]"))} ")" >
     end
     
     # An information line about the image obtained using 'identify' command line
@@ -463,6 +474,26 @@ module QuickMagick
       File.size?(image_filename)
     end
     
+    # Reads a pixel from the image.
+    # WARNING: This is done through command line which is very slow.
+    # It is not recommended at all to use this method for image processing for example.
+    def get_pixel(x, y)
+    	error_file = Tempfile.new('identify_error')
+      result = `identify -verbose -crop #{QuickMagick::geometry(1,1,x,y)} #{QuickMagick::c(image_filename)}[#{@index}]  2>'#{error_file.path}'`
+      unless $?.success?
+	      error_message = <<-ERROR
+	        Error executing command: identify #{image_filename}
+	        Result is: #{result}
+	        Error is: #{error_file.read}
+	      ERROR
+        raise QuickMagick::QuickMagickError, error_message
+      end
+      result =~ /Histogram:\s*\d+:\s*\(\s*(\d+),\s*(\d+),\s*(\d+)\)/
+      return [$1.to_i, $2.to_i, $3.to_i]
+    ensure
+    	error_file.close
+    end
+    
     # displays the current image as animated image
     def animate
       `animate #{command_line}`

data/quick_magick.gemspec

@@ -2,15 +2,15 @@
 
 Gem::Specification.new do |s|
   s.name = %q{quick_magick}
-  s.version = "0.6.1"
+  s.version = "0.7.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Ahmed ElDawy"]
-  s.date = %q{2009-09-24}
+  s.date = %q{2009-11-16}
   s.description = %q{QuickMagick allows you to access ImageMagick command line functions using Ruby interface.}
   s.email = %q{ahmed.eldawy@badrit.com}
-  s.extra_rdoc_files = ["README", "lib/quick_magick/image.rb", "lib/quick_magick/image_list.rb", "lib/quick_magick.rb"]
-  s.files = ["README", "Rakefile", "lib/quick_magick/image.rb", "lib/quick_magick/image_list.rb", "lib/quick_magick.rb", "Manifest", "quick_magick.gemspec", "test/image_test.rb", "test/badfile.xxx", "test/multipage.tif", "test/image_list_test.rb", "test/test_magick.rb", "test/9.gif"]
+  s.extra_rdoc_files = ["README", "lib/quick_magick.rb", "lib/quick_magick/image.rb", "lib/quick_magick/image_list.rb"]
+  s.files = ["Manifest", "README", "Rakefile", "lib/quick_magick.rb", "lib/quick_magick/image.rb", "lib/quick_magick/image_list.rb", "test/9.gif", "test/badfile.xxx", "test/image_list_test.rb", "test/image_test.rb", "test/multipage.tif", "test/test_magick.rb", "test/warnings.tiff", "quick_magick.gemspec"]
   s.homepage = %q{http://quickmagick.rubyforge.org/}
   s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Quick_magick", "--main", "README"]
   s.require_paths = ["lib"]

data/test/image_test.rb

@@ -302,4 +302,25 @@ class ImageTest < Test::Unit::TestCase
     # Now it's non pseudo
     i.save!
   end
+  
+  def test_antialias
+    i = QuickMagick::Image.solid(100, 100, :white)
+    i.antialias = false
+    assert i.command_line =~ /\+antialias/
+
+    i = QuickMagick::Image.solid(100, 100, :white)
+    i.antialias = true
+    assert i.command_line =~ /\-antialias/
+  end
+
+  def test_get_pixel
+  	image = QuickMagick::Image.read(@logo_filename)[0]
+  	assert_equal [2,90,164], image.get_pixel(356, 286)
+  end
+  
+  def test_get_pixel_with_multipage
+    image_filename = File.join($base_dir, "multipage.tif")
+  	image = QuickMagick::Image.read(image_filename)[1]
+  	assert_equal [234,43,44], image.get_pixel(256,73)
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: quick_magick
 version: !ruby/object:Gem::Version 
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors: 
 - Ahmed ElDawy
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-09-24 00:00:00 +02:00
+date: 2009-11-16 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -21,23 +21,24 @@ extensions: []
 
 extra_rdoc_files: 
 - README
+- lib/quick_magick.rb
 - lib/quick_magick/image.rb
 - lib/quick_magick/image_list.rb
-- lib/quick_magick.rb
 files: 
+- Manifest
 - README
 - Rakefile
+- lib/quick_magick.rb
 - lib/quick_magick/image.rb
 - lib/quick_magick/image_list.rb
-- lib/quick_magick.rb
-- Manifest
-- quick_magick.gemspec
-- test/image_test.rb
+- test/9.gif
 - test/badfile.xxx
-- test/multipage.tif
 - test/image_list_test.rb
+- test/image_test.rb
+- test/multipage.tif
 - test/test_magick.rb
-- test/9.gif
+- test/warnings.tiff
+- quick_magick.gemspec
 has_rdoc: true
 homepage: http://quickmagick.rubyforge.org/
 licenses: []