mini_magick 3.2 → 3.3

data/README.rdoc

@@ -87,6 +87,14 @@ For more on the format command see
 http://www.imagemagick.org/script/command-line-options.php#format
 
 
+== Using GraphicsMagick
+
+Simply set 
+
+  MiniMagick.processor = :gm
+  
+And you are sorted.
+
 == Requirements
 
 You must have ImageMagick or GraphicsMagick installed.

data/Rakefile

@@ -1,7 +1,7 @@
 require 'rake'
 require 'rake/testtask'
-require 'rake/rdoctask'
-require 'rake/gempackagetask'
+require 'rdoc/task'
+require 'rubygems/package_task'
 
 $:.unshift(File.dirname(__FILE__) + "/lib")
 require 'mini_magick'
@@ -27,6 +27,8 @@ Rake::RDocTask.new(:rdoc) do |rdoc|
 end
 
 spec = eval(File.read('mini_magick.gemspec'))
-Rake::GemPackageTask.new(spec) do |pkg|
+Gem::PackageTask.new(spec) do |pkg|
   pkg.gem_spec = spec
+  pkg.need_zip = true
+  pkg.need_tar = true
 end

data/VERSION

@@ -1 +1 @@
-3.2
+3.3

data/lib/mini_magick.rb

@@ -1,5 +1,6 @@
 require 'tempfile'
 require 'subexec'
+require 'stringio'
 require 'pathname'
 
 module MiniMagick
@@ -21,14 +22,14 @@ module MiniMagick
     end
   end
 
-  MOGRIFY_COMMANDS = %w{adaptive-blur adaptive-resize adaptive-sharpen adjoin affine alpha annotate antialias append authenticate auto-gamma auto-level auto-orient background bench iterations bias black-threshold blue-primary point blue-shift factor blur border bordercolor brightness-contrast caption string cdl filename channel type charcoal radius chop clip clamp clip-mask filename clip-path id clone index clut contrast-stretch coalesce colorize color-matrix colors colorspace type combine comment string compose operator composite compress type contrast convolve coefficients crop cycle amount decipher filename debug events define format:option deconstruct delay delete index density depth despeckle direction type display server dispose method distort type coefficients dither method draw string edge radius emboss radius encipher filename encoding type endian type enhance equalize evaluate operator evaluate-sequence operator extent extract family name fft fill filter type flatten flip floodfill flop font name format string frame function name fuzz distance fx expression gamma gaussian-blur geometry gravity type green-primary point help identify ifft implode amount insert index intent type interlace type interline-spacing interpolate method interword-spacing kerning label string lat layers method level limit type linear-stretch liquid-rescale log format loop iterations mask filename mattecolor median radius modulate monitor monochrome morph morphology method kernel motion-blur negate noise radius normalize opaque ordered-dither NxN orient type page paint radius ping pointsize polaroid angle posterize levels precision preview type print string process image-filter profile filename quality quantizespace quiet radial-blur angle raise random-threshold low,high red-primary point regard-warnings region remap filename render repage resample resize respect-parentheses roll rotate degrees sample sampling-factor scale scene seed segments selective-blur separate sepia-tone threshold set attribute shade degrees shadow sharpen shave shear sigmoidal-contrast size sketch solarize threshold splice spread radius strip stroke strokewidth stretch type style type swap indexes swirl degrees texture filename threshold thumbnail tile filename tile-offset tint transform transparent transparent-color transpose transverse treedepth trim type type undercolor unique-colors units type unsharp verbose version view vignette virtual-pixel method wave weight type white-point point white-threshold write filename}
+  MOGRIFY_COMMANDS = %w{adaptive-blur adaptive-resize adaptive-sharpen adjoin affine alpha annotate antialias append authenticate auto-gamma auto-level auto-orient background bench iterations bias black-threshold blue-primary point blue-shift factor blur border bordercolor brightness-contrast caption string cdl filename channel type charcoal radius chop clip clamp clip-mask filename clip-path id clone index clut contrast-stretch coalesce colorize color-matrix colors colorspace type combine comment string compose operator composite compress type contrast convolve coefficients crop cycle amount decipher filename debug events define format:option deconstruct delay delete index density depth despeckle direction type display server dispose method distort type coefficients dither method draw string edge radius emboss radius encipher filename encoding type endian type enhance equalize evaluate operator evaluate-sequence operator extent extract family name fft fill filter type flatten flip floodfill flop font name format string frame function name fuzz distance fx expression gamma gaussian-blur geometry gravity type green-primary point help identify ifft implode amount insert index intent type interlace type interline-spacing interpolate method interword-spacing kerning label string lat layers method level limit type linear-stretch liquid-rescale log format loop iterations mask filename mattecolor median radius modulate monitor monochrome morph morphology method kernel motion-blur negate noise radius normalize opaque ordered-dither NxN orient type page paint radius ping pointsize polaroid angle posterize levels precision preview type print string process image-filter profile filename quality quantize quiet radial-blur angle raise random-threshold low,high red-primary point regard-warnings region remap filename render repage resample resize respect-parentheses roll rotate degrees sample sampling-factor scale scene seed segments selective-blur separate sepia-tone threshold set attribute shade degrees shadow sharpen shave shear sigmoidal-contrast size sketch solarize threshold splice spread radius strip stroke strokewidth stretch type style type swap indexes swirl degrees texture filename threshold thumbnail tile filename tile-offset tint transform transparent transparent-color transpose transverse treedepth trim type type undercolor unique-colors units type unsharp verbose version view vignette virtual-pixel method wave weight type white-point point white-threshold write filename}
 
   class Error < RuntimeError; end
   class Invalid < StandardError; end
 
   class Image
     # @return [String] The location of the current working file
-    attr :path
+    attr_accessor :path
 
     # Class Methods
     # -------------
@@ -62,6 +63,34 @@ module MiniMagick
         create(ext) { |f| f.write(blob) }
       end
 
+      # Creates an image object from a binary string blob which contains raw pixel data (i.e. no header data).
+      #
+      # === Returns
+      #
+      # * [Image] The loaded image.
+      #
+      # === Parameters
+      #
+      # * [blob] <tt>String</tt> -- Binary string blob containing raw pixel data.
+      # * [columns] <tt>Integer</tt> -- Number of columns.
+      # * [rows] <tt>Integer</tt> -- Number of rows.
+      # * [depth] <tt>Integer</tt> -- Bit depth of the encoded pixel data.
+      # * [map] <tt>String</tt> -- A code for the mapping of the pixel data. Example: 'gray' or 'rgb'.
+      # * [format] <tt>String</tt> -- The file extension of the image format to be used when creating the image object. Defaults to 'png'.
+      #
+      def import_pixels(blob, columns, rows, depth, map, format="png")
+        # Create an image object with the raw pixel data string:
+        image = create(".dat", validate = false) { |f| f.write(blob) }
+        # Use ImageMagick to convert the raw data file to an image file of the desired format:
+        converted_image_path = image.path[0..-4] + format
+        argument = "-size #{columns}x#{rows} -depth #{depth} #{map}:#{image.path} #{converted_image_path}"
+        cmd = CommandBuilder.new("convert", argument) #Example: convert -size 256x256 -depth 16 gray:blob.dat blob.png
+        image.run(cmd)
+        # Update the image instance with the path of the properly formatted image, and return:
+        image.path = converted_image_path
+        image
+      end
+
       # Opens a specific image file either on the local file system or at a URI.
       #
       # Use this if you don't want to overwrite the image file.
@@ -73,12 +102,14 @@ module MiniMagick
       # @param file_or_url [String] Either a local file path or a URL that open-uri can read
       # @param ext [String] Specify the extension you want to read it as
       # @return [Image] The loaded image
-      def open(file_or_url, ext = File.extname(file_or_url))
+      def open(file_or_url, ext = nil)
         file_or_url = file_or_url.to_s # Force it to be a String... hell or highwater
         if file_or_url.include?("://")
           require 'open-uri'
+          ext ||= File.extname(URI.parse(file_or_url).path)
           self.read(Kernel::open(file_or_url), ext)
         else
+          ext ||= File.extname(file_or_url)
           File.open(file_or_url, "rb") do |f|
             self.read(f, ext)
           end
@@ -97,18 +128,19 @@ module MiniMagick
       # by both #open and #read to create a new object! Ensures we have a good tempfile!
       #
       # @param ext [String] Specify the extension you want to read it as
+      # @param validate [Boolean] If false, skips validation of the created image. Defaults to true.
       # @yield [IOStream] You can #write bits to this object to create the new Image
       # @return [Image] The created image
-      def create(ext = nil, &block)
+      def create(ext = nil, validate = true, &block)
         begin
-          tempfile = Tempfile.new(['mini_magick', ext.to_s])
+          tempfile = Tempfile.new(['mini_magick', ext.to_s.downcase])
           tempfile.binmode
           block.call(tempfile)
           tempfile.close
 
           image = self.new(tempfile.path, tempfile)
 
-          if !image.valid?
+          if validate and !image.valid?
             raise MiniMagick::Invalid
           end
           return image
@@ -130,9 +162,9 @@ module MiniMagick
       @path = input_path
       @tempfile = tempfile # ensures that the tempfile will stick around until this image is garbage collected.
     end
-    
+
     def escaped_path
-      Pathname.new(@path).to_s.gsub(" ", "\\ ")
+      Pathname.new(@path).to_s.inspect
     end
 
     # Checks to make sure that MiniMagick can read the file and understand it.
@@ -256,9 +288,7 @@ module MiniMagick
     def write(output_to)
       if output_to.kind_of?(String) || !output_to.respond_to?(:write)
         FileUtils.copy_file @path, output_to
-        # We need to escape the output path if it contains a space
-        escaped_output_to = output_to.to_s.gsub(' ', '\\ ')
-        run_command "identify", escaped_output_to # Verify that we have a good image
+        run_command "identify", output_to.to_s.inspect # Verify that we have a good image
       else # stream
         File.open(@path, "rb") do |f|
           f.binmode
@@ -279,6 +309,11 @@ module MiniMagick
     ensure
       f.close if f
     end
+    
+    def mime_type
+      format = self[:format]
+      "image/"+format.downcase
+    end
 
     # If an unknown method is called then it is sent through the morgrify program
     # Look here to find all the commands (http://www.imagemagick.org/script/mogrify.php)
@@ -409,7 +444,7 @@ module MiniMagick
     end
 
     def +(*options)
-      push(@args.pop.gsub /^-/, '+')
+      push(@args.pop.gsub(/^-/, '+'))
       if options.any?
         options.each do |o|
           push "\"#{ o }\""

data/test/image_test.rb

@@ -1,7 +1,6 @@
 require 'rubygems'
 require 'test/unit'
 require 'pathname'
-require 'stringio'
 require File.expand_path('../../lib/mini_magick', __FILE__)
 
 #MiniMagick.processor = :gm
@@ -13,11 +12,13 @@ class ImageTest < Test::Unit::TestCase
 
   SIMPLE_IMAGE_PATH = CURRENT_DIR + "simple.gif"
   MINUS_IMAGE_PATH  = CURRENT_DIR + "simple-minus.gif"
-  TIFF_IMAGE_PATH   = CURRENT_DIR + "leaves spaced.tiff"
+  TIFF_IMAGE_PATH   = CURRENT_DIR + "leaves (spaced).tiff"
   NOT_AN_IMAGE_PATH = CURRENT_DIR + "not_an_image.php"
   GIF_WITH_JPG_EXT  = CURRENT_DIR + "actually_a_gif.jpg"
   EXIF_IMAGE_PATH   = CURRENT_DIR + "trogdor.jpg"
+  CAP_EXT_PATH      = CURRENT_DIR + "trogdor_capitalized.JPG"
   ANIMATION_PATH    = CURRENT_DIR + "animation.gif"
+  PNG_PATH          = CURRENT_DIR + "png.png"
 
   def test_image_from_blob
     File.open(SIMPLE_IMAGE_PATH, "rb") do |f|
@@ -36,6 +37,7 @@ class ImageTest < Test::Unit::TestCase
   def test_image_io_reading
     buffer = StringIO.new(File.read(SIMPLE_IMAGE_PATH))
     image = Image.read(buffer)
+    assert image.valid?
     image.destroy!
   end
 
@@ -53,10 +55,21 @@ class ImageTest < Test::Unit::TestCase
 
   def test_remote_image
     image = Image.open("http://www.google.com/images/logos/logo.png")
-    image.valid?
+    assert image.valid?
     image.destroy!
   end
 
+  def test_remote_image_with_complex_url
+    image = Image.open("http://a0.twimg.com/a/1296609216/images/fronts/logo_withbird_home.png?extra=foo&plus=bar")
+    assert image.valid?
+    image.destroy!
+  end
+  
+  def test_reformat_with_capitalized_extension
+    image = Image.open(CAP_EXT_PATH)
+    image.format "jpg"
+  end
+
   def test_image_write
     output_path = "output.gif"
     begin
@@ -253,6 +266,25 @@ class ImageTest < Test::Unit::TestCase
     FileUtils.rm("test.gif")
   end
 
+  # https://github.com/probablycorey/mini_magick/issues/37
+  def test_nonstandard_locale
+    original_lang = ENV["LANG"]
+    ENV["LANG"] = "fr_FR.UTF-8"
+
+    # This test should break
+    test_throw_on_openining_not_an_image
+  ensure
+    ENV["LANG"] = original_lang
+  end
+
+  def test_poop
+    img = MiniMagick::Image.open(SIMPLE_IMAGE_PATH)
+    img.gravity "Center"
+    img.crop "480x480"
+    img.resize "250x250"
+    img.write "/tmp/output.png"
+  end
+
   def test_throw_format_error
     image = Image.open(SIMPLE_IMAGE_PATH)
     assert_raise MiniMagick::Error do
@@ -262,4 +294,49 @@ class ImageTest < Test::Unit::TestCase
     end
     image.destroy!
   end
+
+  def test_import_pixels_default_format
+    columns = 325
+    rows = 200
+    depth = 16 # 16 bits (2 bytes) per pixel
+    map = 'gray'
+    pixels = Array.new(columns*rows) {|i| i}
+    blob = pixels.pack("S*") # unsigned short, native byte order
+    image = Image.import_pixels(blob, columns, rows, depth, map)
+    assert image.valid?
+    assert_equal "png", image[:format].downcase
+    assert_equal columns, image[:width]
+    assert_equal rows, image[:height]
+    image.write("/tmp/imported_pixels_image.png")
+  end
+
+  def test_import_pixels_custom_format
+    columns = 325
+    rows = 200
+    depth = 16 # 16 bits (2 bytes) per pixel
+    map = 'gray'
+    format = 'jpeg'
+    pixels = Array.new(columns*rows) {|i| i}
+    blob = pixels.pack("S*") # unsigned short, native byte order
+    image = Image.import_pixels(blob, columns, rows, depth, map, format)
+    assert image.valid?
+    assert_equal format, image[:format].downcase
+    assert_equal columns, image[:width]
+    assert_equal rows, image[:height]
+    image.write("/tmp/imported_pixels_image." + format)
+  end
+
+  def test_mime_type
+    gif =         Image.open(SIMPLE_IMAGE_PATH)
+    jpeg =        Image.open(EXIF_IMAGE_PATH)
+    png =         Image.open(PNG_PATH)
+    tiff =        Image.open(TIFF_IMAGE_PATH)
+    hidden_gif =  Image.open(GIF_WITH_JPG_EXT)
+    
+    assert_equal "image/gif",   gif.mime_type
+    assert_equal "image/jpeg",  jpeg.mime_type
+    assert_equal "image/png",   png.mime_type
+    assert_equal "image/tiff",  tiff.mime_type
+    assert_equal "image/gif",   hidden_gif.mime_type
+  end
 end

metadata

@@ -1,12 +1,8 @@
 --- !ruby/object:Gem::Specification 
 name: mini_magick
 version: !ruby/object:Gem::Version 
-  hash: 3
-  prerelease: false
-  segments: 
-  - 3
-  - 2
-  version: "3.2"
+  prerelease: 
+  version: "3.3"
 platform: ruby
 authors: 
 - Corey Johnson
@@ -16,7 +12,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-11 00:00:00 +00:00
+date: 2011-06-02 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -27,12 +23,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 23
-        segments: 
-        - 0
-        - 0
-        - 4
-        version: 0.0.4
+        version: 0.1.0
   type: :runtime
   version_requirements: *id001
 description: ""
@@ -58,11 +49,13 @@ files:
 - test/command_builder_test.rb
 - test/composited.jpg
 - test/image_test.rb
-- test/leaves spaced.tiff
+- test/leaves (spaced).tiff
 - test/not_an_image.php
+- test/png.png
 - test/simple-minus.gif
 - test/simple.gif
 - test/trogdor.jpg
+- test/trogdor_capitalized.JPG
 has_rdoc: true
 homepage: http://github.com/probablycorey/mini_magick
 licenses: []
@@ -77,23 +70,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
       version: "0"
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Manipulate images with minimal use of memory via ImageMagick / GraphicsMagick
@@ -103,8 +90,10 @@ test_files:
 - test/command_builder_test.rb
 - test/composited.jpg
 - test/image_test.rb
-- test/leaves spaced.tiff
+- test/leaves (spaced).tiff
 - test/not_an_image.php
+- test/png.png
 - test/simple-minus.gif
 - test/simple.gif
 - test/trogdor.jpg
+- test/trogdor_capitalized.JPG