remvee-mini_magick 1.2.3.1

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2005 Corey Johnson probablycorey@gmail.com
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.rdoc

@@ -0,0 +1,90 @@
+= MiniMagick
+
+A ruby wrapper for ImageMagick command line.
+
+
+== Why?
+
+I was using RMagick and loving it, but it was eating up huge amounts
+of memory. A simple script like this...
+
+  Magick::read("image.jpg") do |f|
+    f.write("manipulated.jpg")
+  end
+
+...would use over 100 Megs of Ram. On my local machine this wasn't a
+problem, but on my hosting server the ruby apps would crash because of
+their 100 Meg memory limit.
+
+
+== Solution!
+
+Using MiniMagick the ruby processes memory remains small (it spawns
+ImageMagick's command line program mogrify which takes up some memory
+as well, but is much smaller compared to RMagick)
+
+MiniMagick gives you access to all the commandline options ImageMagick
+has (Found here http://www.imagemagick.org/script/mogrify.php)
+
+
+== Examples
+
+Want to make a thumbnail from a file...
+
+  image = MiniMagick::Image.from_file("input.jpg")
+  image.resize "100x100"
+  image.write("output.jpg")
+
+Want to make a thumbnail from a blob...
+
+  image = MiniMagick::Image.from_blob(blob)
+  image.resize "100x100"
+  image.write("output.jpg")
+
+Need to combine several options?
+
+  image = MiniMagick::Image.from_file("input.jpg")
+  image.combine_options do |c|
+    c.sample "50%"
+    c.rotate "-90>"
+  end
+  image.write("output.jpg")
+
+Want to manipulate an image at its source (You won't have to write it
+out because the transformations are done on that file)
+
+  image = MiniMagick::Image.new("input.jpg")
+  image.resize "100x100"
+
+Want to get some meta-information out?
+
+  image = MiniMagick::Image.from_file("input.jpg")
+  image[:width]               # will get the width (you can also use :height and :format)
+  image["EXIF:BitsPerSample"] # It also can get all the EXIF tags
+  image["%m:%f %wx%h"]        # Or you can use one of the many options of the format command
+
+For more on the format command see
+http://www.imagemagick.org/script/command-line-options.php#format
+
+
+== Requirements
+
+You must have ImageMagick installed.
+
+
+== How To Install
+
+If you downloaded the plugin version, just drop the plugin into
+RAILS_ROOT/plugins/
+
+If you installed this as a gem, then to get it to work add <require
+"mini_magick"> to RAILS_ROOT/config/environment.rb
+
+If you have just downloaded this files then copy the mini_magick.rb
+file into your RAILS_ROOT/lib directory and add <require
+"mini-magick"> to RAILS_ROOT/config/environment.rb
+
+MiniMagick does NOT require rails though. All the code you need to use
+MiniMagick is located in the mini_magick/lib/mini_magick.rb file.
+
+

data/Rakefile

@@ -0,0 +1,29 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/packagetask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc "Clean generated files"
+task :clean => :clobber_rdoc do
+  rm FileList['test/output/*.png']
+end
+
+desc 'Test the mini_magick plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the mini_magick plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'MiniMagick'
+  rdoc.options << '--line-numbers'
+  rdoc.options << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/image_temp_file.rb

@@ -0,0 +1,13 @@
+require "tempfile"
+
+module MiniMagick
+  class ImageTempFile < Tempfile
+    def make_tmpname(basename, n)
+      # force tempfile to use basename's extension if provided
+      ext = File.extname(basename)
+
+      # force hyphens instead of periods in name
+      sprintf('%s%d-%d%s', File.basename(basename, ext), $$, n, ext)
+    end
+  end
+end

data/lib/mini_magick.rb

@@ -0,0 +1,178 @@
+require "open-uri"
+require "stringio"
+require "fileutils"
+
+require File.join(File.dirname(__FILE__), '/image_temp_file')
+
+module MiniMagick
+  class MiniMagickError < RuntimeError; end
+
+  VERSION = '1.2.3.1'
+
+  class Image
+    attr :path
+    attr :tempfile
+    attr :output
+
+    # Class Methods
+    # -------------
+    class << self
+      def from_blob(blob, extension=nil)
+        begin
+          tempfile = ImageTempFile.new("minimagick.#{extension}")
+          tempfile.binmode
+          tempfile.write(blob)
+        ensure
+          tempfile.close
+        end
+
+        return self.new(tempfile.path, tempfile)
+      end
+
+      # Use this if you don't want to overwrite the image file
+      def open(image_path)
+        File.open(image_path, "rb") do |f|
+          self.from_blob(f.read, File.extname(image_path))
+        end
+      end
+      alias_method :from_file, :open
+    end
+
+    # Instance Methods
+    # ----------------
+    def initialize(input_path, tempfile=nil)
+      @path = input_path
+      @tempfile = tempfile # ensures that the tempfile will stick around until this image is garbage collected.
+
+      # Ensure that the file is an image
+      run_command("identify", @path)
+    end
+
+    # For reference see http://www.imagemagick.org/script/command-line-options.php#format
+    def [](value)
+      # Why do I go to the trouble of putting in newlines? Because otherwise animated gifs screw everything up
+      case value.to_s
+      when "format"
+        run_command("identify", "-format", format_option("%m"), @path).split("\n")[0]
+      when "height"
+        run_command("identify", "-format", format_option("%h"), @path).split("\n")[0].to_i
+      when "width"
+        run_command("identify", "-format", format_option("%w"), @path).split("\n")[0].to_i
+      when "size"
+        File.size(@path) # Do this because calling identify -format "%b" on an animated gif fails!
+      when "original_at"
+        # Get the EXIF original capture as a Time object
+        Time.local(*self["EXIF:DateTimeOriginal"].split(/:|\s+/)) rescue nil
+      when /^EXIF\:/i
+        run_command('identify', '-format', "\"%[#{value}]\"", @path).chop
+      else
+        run_command('identify', '-format', "\"#{value}\"", @path).split("\n")[0]
+      end
+    end
+
+    # Sends raw commands to imagemagick's mogrify command. The image path is automatically appended to the command
+    def <<(*args)
+      run_command("mogrify", *args << @path)
+    end
+
+    # This is a 'special' command because it needs to change @path to reflect the new extension
+    # Formatting an animation into a non-animated type will result in ImageMagick creating multiple
+    # pages (starting with 0).  You can choose which page you want to manipulate.  We default to the
+    # first page.
+    def format(format, page=0)
+      run_command("mogrify", "-format", format, @path)
+
+      old_path = @path.dup
+      @path.sub!(/(\.\w+)?$/, ".#{format}")
+      File.unlink(old_path) unless old_path == @path
+
+      unless File.exists?(@path)
+        begin
+          FileUtils.copy_file(@path.sub(".#{format}", "-#{page}.#{format}"), @path)
+        rescue Errno::ENOENT
+          raise MiniMagickError, "Page #{page} not found"
+        end
+      end
+
+      raise MiniMagickError, "Unable to format to #{format}" unless File.exist?(@path)
+    ensure
+      Dir[@path.sub(/(\.\w+)?$/, "-[0-9]*.#{format}")].each do |fname|
+        File.unlink(fname)
+      end
+    end
+
+
+    # Writes the temporary image that we are using for processing to the output path
+    def write(output_path)
+      FileUtils.copy_file @path, output_path
+      run_command "identify", output_path # Verify that we have a good image
+    end
+
+    # Give you raw data back
+    def to_blob
+      f = File.new @path
+      f.binmode
+      f.read
+    ensure
+      f.close
+    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)
+    def method_missing(symbol, *args)
+      args.push(@path) # push the path onto the end
+      run_command("mogrify", "-#{symbol}", *args)
+      self
+    end
+
+    # You can use multiple commands together using this method
+    def combine_options(&block)
+      c = CommandBuilder.new
+      block.call c
+      run_command("mogrify", *c.args << @path)
+    end
+
+    # Check to see if we are running on win32 -- we need to escape things differently
+    def windows?
+      !(RUBY_PLATFORM =~ /win32/).nil?
+    end
+
+    # Outputs a carriage-return delimited format string for Unix and Windows
+    def format_option(format)
+      windows? ? "#{format}\\n" : "#{format}\\\\n"
+    end
+
+    def run_command(command, *args)
+      args.collect! do |arg|
+        arg = arg.to_s
+        arg = %|"#{arg}"| unless arg[0] == ?- # values quoted because they can contain characters like '>', but don't quote switches
+        arg
+      end
+
+      @output = `#{command} #{args.join(' ')}`
+
+      if $? != 0
+        raise MiniMagickError, "ImageMagick command (#{command} #{args.join(' ')}) failed: Error Given #{$?}"
+      else
+        @output
+      end
+    end
+  end
+
+  class CommandBuilder
+    attr :args
+
+    def initialize
+      @args = []
+    end
+
+    def method_missing(symbol, *args)
+      @args << "-#{symbol}"
+      @args += args
+    end
+
+    def +(value)
+      @args << "+#{value}"
+    end
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification 
+name: remvee-mini_magick
+version: !ruby/object:Gem::Version 
+  version: 1.2.3.1
+platform: ruby
+authors: 
+- Corey Johnson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-13 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Uses command-line ImageMagick tools to resize, rotate, and mogrify images.
+email: probablycorey@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- README.rdoc
+- MIT-LICENSE
+- lib/image_temp_file.rb
+- lib/mini_magick.rb
+has_rdoc: true
+homepage: http://mini-magick.rubyforge.org/
+post_install_message: 
+rdoc_options: []
+
+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: "0"
+  version: 
+requirements: 
+- none
+rubyforge_project: mini_magick
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Manipulate images with minimal use of memory.
+test_files: []
+