streamio-magick 0.2.1

data/README.rdoc

@@ -0,0 +1,51 @@
+= Streamio Magick
+
+Simple yet powerful wrapper around imagemagick cli tools for reading metadata and transcoding images.
+
+== Installation
+
+  (sudo) gem install streamio-magick
+
+You also need to make sure to have imagemagick installed and that the commands identify and convert are available to the ruby process.
+
+This version is written against an imagemagick build from august 2010. So no guaranteed compatability with much earlier (or much later) versions.
+
+== Usage
+
+=== Require the gem
+
+  require 'rubygems'
+  require 'streamio-magick'
+
+=== Reading Metadata
+
+  image = Magick::Image.new("path/to/image.png")
+  
+  image.width # 640 (width of the image in pixels)
+  image.height # 480 (height of the image in pixels)
+  image.size # 455546 (filesize in bytes)
+  image.codec # "PNG"
+  
+  image.valid? # true (would be false if identify fails to read the image)
+  
+=== Transcoding
+
+First argument is the output file path.
+  
+  image.transcode("image.jpg") # Transcode to jpg format
+
+Give custom command line options for the convert command with a string.
+
+  image.transcode("image.jpg", "-resize 320x240")
+
+The transcode function returns an Image object for the encoded file.
+
+  transcoded_image = image.transcode("image.jpg", "-resize 320x240")
+
+  transcoded_image.width # 320
+  transcoded_image.height # 240
+  transcoded_image.codec # "JPEG"
+  
+== Copyright
+
+Copyright (c) 2010 Streamio Networks AB. See LICENSE for details.

data/lib/magick/image.rb

@@ -0,0 +1,50 @@
+# Output example:
+# file.ext JPEG 1920x1200 1920x1200+0+0 8-bit DirectClass 1.955MB 0.000u 0:00.000
+# Error example:
+# identify: no decode delegate for this image format `file.ext' @ error/constitute.c/ReadImage/532.
+
+class Magick::Image
+  attr_reader :width, :height, :codec, :path, :size
+  
+  def initialize(path)
+    raise Errno::ENOENT, "the file '#{path}' does not exist" unless File.exists?(path)
+    
+    @path = escape(path)
+    @size = File.size(path)
+    
+    stdin, stdout, stderr = Open3.popen3("identify '#{path}'") # Output will land in stderr
+
+    out = stdout.read
+    err = stderr.read
+    
+    @valid = out.length > 0
+    
+    if valid?
+      filename, @codec, resolution, etc = out.split
+      
+      @width = resolution.split("x").first.to_i
+      @height = resolution.split("x").last.to_i
+    end
+  end
+  
+  def valid?
+    @valid
+  end
+  
+  def transcode(output_file, parameters = "")
+    stdin, stdout, stderr = Open3.popen3("convert #{path} #{escape(parameters)} #{output_file}")
+    
+    out = stdout.read
+    err = stderr.read
+    
+    raise err if err.length > 0
+    
+    self.class.new(output_file)
+  end
+  
+  protected
+  def escape(path)
+    map  =  { '\\' => '\\\\', '</' => '<\/', "\r\n" => '\n', "\n" => '\n', "\r" => '\n', '"' => '\\"' }
+    path.gsub(/(\\|<\/|\r\n|[\n\r"])/) { map[$1] }
+  end
+end

data/lib/magick/version.rb

@@ -0,0 +1,3 @@
+module Magick
+  VERSION = "0.2.1"
+end

data/lib/streamio-magick.rb

@@ -0,0 +1,4 @@
+require 'open3'
+
+require 'magick/version'
+require 'magick/image'

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification 
+name: streamio-magick
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 1
+  version: 0.2.1
+platform: ruby
+authors: 
+- David Backeus
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-08-26 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        hash: 27
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id001
+description: Simple yet powerful wrapper around imagemagick cli tools for reading metadata and transcoding images.
+email: 
+- david@streamio.se
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/magick/image.rb
+- lib/magick/version.rb
+- lib/streamio-magick.rb
+- README.rdoc
+has_rdoc: true
+homepage: http://github.com/streamio/streamio-magick
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  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: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Reads metadata and transcodes images.
+test_files: []
+