image_science 1.0.0

data/History.txt

@@ -0,0 +1,5 @@
+== 1.0.0 / 2006-12-01
+
+* 1 major enhancement
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,6 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bench.rb
+lib/image_science.rb

data/README.txt

@@ -0,0 +1,63 @@
+ImageScience
+    http://rubyforge.org/projects/seattlerb
+    http://seattlerb.rubyforge.org/
+    by Ryan Davis
+
+== DESCRIPTION:
+
+ImageScience is a clean and happy Ruby library that generates
+thumbnails -- and kicks the living crap out of RMagick. Oh, and it
+doesn't leak memory like a sieve. :)
+
+For more information including build steps, see http://seattlerb.rubyforge.org/
+
+== FEATURES/PROBLEMS:
+
+* 93 glorious lines of graphics manipulation magi... errr, SCIENCE!
+* Supports both square and proportional thumbnails.
+* Pretty much any graphics format you could want. No really.
+
+== SYNOPSYS:
+
+  ImageScience.with_image(file) do |img|
+    img.cropped_thumbnail("#{file}_cropped.png", 100)
+  end
+  
+  ImageScience.with_image(file) do |img|
+    img.thumbnail("#{file}_thumb.png", 100)
+  end
+
+== REQUIREMENTS:
+
+* FreeImage
+* ImageScience
+
+== INSTALL:
+
+* Download and install FreeImage. See notes at url above.
+* sudo gem install -y ImageScience
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2006 Ryan Davis, Seattle.rb
+
+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/Rakefile

@@ -0,0 +1,15 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/image_science.rb'
+
+Hoe.new('image_science', ImageScience::VERSION) do |p|
+  p.rubyforge_name = 'seattlerb'
+  p.description = p.paragraphs_of('README.txt', 2..3).join(" ")
+  p.summary = p.description[/^[^.]+\./]
+  p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1].first.strip
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+end
+
+# vim: syntax=Ruby

data/bench.rb

@@ -0,0 +1,42 @@
+#!/usr/local/bin/ruby -w
+
+require 'benchmark'
+require 'rubygems'
+require 'image_science'
+
+file = "blah_big.png"
+
+if RUBY_PLATFORM =~ /darwin/ then
+  # how fucking cool is this???
+  puts "taking screenshot for thumbnailing benchmarks"
+  system "screencapture -SC #{file}"
+else
+  abort "You need to plonk down #{file} or buy a mac"
+end unless test ?f, "#{file}"
+
+max = (ARGV.shift || 100).to_i
+
+puts "# of iterations = #{max}"
+Benchmark::bm(20) do |x|
+  x.report("null_time") {
+    for i in 0..max do
+      # do nothing
+    end
+  }
+
+  x.report("cropped") {
+    for i in 0..max do
+      ImageScience.with_image(file) do |img|
+        img.cropped_thumbnail("blah_cropped.png", 100)
+      end
+    end
+  }
+
+  x.report("proportional") {
+    for i in 0..max do
+      ImageScience.with_image(file) do |img|
+        img.thumbnail("blah_thumb.png", 100)
+      end
+    end
+  }
+end

data/lib/image_science.rb

@@ -0,0 +1,135 @@
+#!/usr/local/bin/ruby -w
+
+require 'rubygems'
+require 'inline'
+
+##
+# Provides a simple and clean API to generate thumbnails using
+# FreeImage as the underlying mechanism.
+#
+# For more information or if you have build issues with FreeImage, see
+# http://seattlerb.rubyforge.org/ImageScience.html
+
+class ImageScience
+  VERSION = '1.0.0'
+
+  ##
+  # The top-level image loader opens +path+ and then passes the image
+  # instance to the given block.
+
+  def self.with_image(path); end # :yields: image
+
+  ##
+  # Crops an image to +left+, +top+, +right+, and +bottom+ and then
+  # passes the new image to the given block.
+
+  def with_crop(left, top, right, bottom); end # :yields: image
+
+  ##
+  # Returns the width of the image, in pixels.
+
+  def width; end
+
+  ##
+  # Returns the height of the image, in pixels.
+
+  def height; end
+
+  ##
+  # Creates a proportional thumbnail of the image scaled so its widest
+  # edge is resized to +size+ and writes the new image to +path+.
+
+  def thumbnail(path, size); end
+
+  ##
+  # Creates a square thumbnail of the image cropping the longest edge
+  # to match the shortest edge, resizes to +size+, and writes the new
+  # image to +path+.
+
+  def cropped_thumbnail(path, size)
+    w, h = width, height
+    l, t, r, b, half = 0, 0, w, h, (w > h ? (w - h) : (h - w)) / 2
+
+    l, r = half, half + h if w > h
+    t, b = half, half + w if h > w
+
+    with_crop(l, t, r, b) do |img|
+      img.thumbnail(path, size)
+    end
+  end
+
+  inline do |builder|
+    builder.add_link_flags "-lfreeimage"
+    builder.include '"FreeImage.h"'
+
+    builder.c_singleton <<-"END"
+      VALUE with_image(char * input) {
+        FREE_IMAGE_FORMAT fif = FIF_UNKNOWN; 
+
+        fif = FreeImage_GetFileType(input, 0); 
+        if (fif == FIF_UNKNOWN) fif = FreeImage_GetFIFFromFilename(input); 
+        if ((fif != FIF_UNKNOWN) && FreeImage_FIFSupportsReading(fif)) { 
+          FIBITMAP *bitmap;
+          VALUE result = Qnil;
+          if (bitmap = FreeImage_Load(fif, input, 0)) {
+            VALUE obj = Data_Wrap_Struct(self, NULL, NULL, bitmap);
+            rb_iv_set(obj, "@file_type", INT2FIX(fif));
+            result = rb_yield(obj);
+            FreeImage_Unload(bitmap);
+          }
+          return result;
+        }
+        rb_raise(rb_eTypeError, "Unknown file format");
+      }
+    END
+
+    builder.c <<-"END"
+      VALUE with_crop(int l, int t, int r, int b) {
+        FIBITMAP *bitmap, *copy;
+        VALUE result = Qnil;
+        Data_Get_Struct(self, FIBITMAP, bitmap);
+
+        if (copy = FreeImage_Copy(bitmap, l, t, r, b)) {
+          VALUE obj = Data_Wrap_Struct(CLASS_OF(self), NULL, NULL, copy);
+          result = rb_yield(obj);
+          FreeImage_Unload(copy);
+        }
+        return result;
+      }
+    END
+
+    builder.c <<-"END"
+      int height() {
+        FIBITMAP *bitmap;
+        Data_Get_Struct(self, FIBITMAP, bitmap);
+        return FreeImage_GetHeight(bitmap);
+      }
+    END
+
+    builder.c <<-"END"
+      int width() {
+        FIBITMAP *bitmap;
+        Data_Get_Struct(self, FIBITMAP, bitmap);
+        return FreeImage_GetWidth(bitmap);
+      }
+    END
+
+    builder.c <<-"END"
+      VALUE thumbnail(char * output, int size) {
+        FIBITMAP *bitmap;
+        FREE_IMAGE_FORMAT fif = FreeImage_GetFIFFromFilename(output);
+        if (fif == FIF_UNKNOWN) fif = FIX2INT(rb_iv_get(self, "@file_type"));
+        if ((fif != FIF_UNKNOWN) && FreeImage_FIFSupportsWriting(fif)) { 
+          Data_Get_Struct(self, FIBITMAP, bitmap);
+          FIBITMAP *thumbnail = FreeImage_MakeThumbnail(bitmap, size, TRUE);
+          if (FreeImage_Save(fif, thumbnail, output, 0)) {
+            FreeImage_Unload(thumbnail);
+            return Qtrue;
+          }
+          return Qfalse;
+        }
+        rb_raise(rb_eTypeError, "Unknown file format");
+      }
+    END
+  end
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: image_science
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2006-12-13 00:00:00 -05:00
+summary: ImageScience is a clean and happy Ruby library that generates thumbnails -- and kicks the living crap out of RMagick.
+require_paths: 
+- lib
+email: ryand-ruby@zenspider.com
+homepage: http://rubyforge.org/projects/seattlerb
+rubyforge_project: seattlerb
+description: ImageScience is a clean and happy Ruby library that generates thumbnails -- and kicks the living crap out of RMagick. Oh, and it doesn't leak memory like a sieve. :) For more information including build steps, see http://seattlerb.rubyforge.org/
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Ryan Davis
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bench.rb
+- lib/image_science.rb
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.4
+    version: