rszr 0.3.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 47015c365c2eaa3d2fb3178bd8c68b67dcd33428
+  data.tar.gz: 11440490c24628076aa8f42592640c055126e302
+SHA512:
+  metadata.gz: e2353ad80438886866c5246d9483ba09000c3729142324e8e650b00d17415076017cfc0260986a647f3da0305d087fe193ff9fb60095cd0d2d82ab590a35fb53
+  data.tar.gz: ce0fefb4820593aa643a96f3c33d667c2a37c441f132541666cf60c3853866055ef5e1d4e44f7ee32f0d333ac70e095409c0a6835e2a2bb4f4a6b80187eff008

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Matthias Grosser
+
+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.md

@@ -0,0 +1,74 @@
+# Rszr
+
+Rszr is a fast image resizer.
+
+## Installation
+
+In your Gemfile:
+
+```ruby
+gem 'rszr'
+```
+
+### Imlib2
+
+Rszr requires the Imlib2 library to do the heavy lifting.
+
+#### OS X
+
+Using homebrew:
+
+```bash
+brew install imlib2
+```
+
+### Linux
+
+Using your favourite package manager:
+
+```bash
+yum install imlib2
+```
+
+```bash
+apt-get install libimlib2
+```
+
+## Usage
+
+```ruby
+# bounding box 400x300
+image = Rszr::Image.load('image.jpg')
+image.resize(400, 300)
+image.save('resized.jpg')
+
+# auto height
+image.resize(400, :auto)
+
+# auto width
+image.resize(:auto, 300)
+
+# scale factor
+image.resize(0.5)
+
+# crop
+image.crop(200, 200, 100, 100)
+
+# save memory, do not duplicate instance
+image.resize!(400, :auto)
+
+# image dimensions
+image.width => 400
+image.height => 300
+image.dimensions => [400, 300]
+```
+
+## Speed
+
+Resizing an 1500x997 JPEG image to 800x532, 100 times:
+
+Library         | Time
+----------------|-----------
+MiniMagick      | 11.4 s
+GD2             | 7.2 s
+Rszr            | 3.2 s

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/rszr.rb

@@ -0,0 +1,11 @@
+require 'fiddle'
+require 'fiddle/import'
+require 'rbconfig'
+require 'pathname'
+
+require 'rszr/version'
+require 'rszr/errors'
+require 'rszr/lib'
+require 'rszr/handle'
+require 'rszr/base'
+require 'rszr/image'

data/lib/rszr/base.rb

@@ -0,0 +1,27 @@
+module Rszr
+  module Base
+    
+    def self.included(base)
+      Rszr::Lib.delegate(base)
+      Rszr::Lib.delegate(base.singleton_class)
+    end
+    
+    protected
+    
+    def handle
+      @handle
+    end
+    
+    def ptr
+      @handle.ptr
+    end
+    
+    private
+    
+    def assert_valid_keys(hsh, *valid_keys)
+      if unknown_key = (hsh.keys - valid_keys).first
+        raise ArgumentError.new("Unknown key: #{unknown_key.inspect}. Valid keys are: #{valid_keys.map(&:inspect).join(', ')}")
+      end
+    end
+  end
+end

data/lib/rszr/errors.rb

@@ -0,0 +1,42 @@
+module Rszr
+  class Error < StandardError; end
+
+  class ErrorWithMessage < Error
+    MESSAGES = [nil,
+                'File does not exist',
+                'File is a directory',
+                'Read permission denied',
+                'Unsupported format',
+                'Path too long',
+                'Non-existant path component',
+                'Path component is not a directory',
+                'Path outside address space',
+                'Too many symbolic links',
+                'Out of memory',
+                'Out of file descriptors',
+                'Write permission denied',
+                'Out of disk space',
+                'Unknown error']
+    
+    attr_reader :ptr
+    
+    def initialize
+      @ptr = Fiddle::Pointer.malloc(Rszr::Lib.sizeof('Imlib_Load_Error'))
+    end
+    
+    def error?
+      return if ptr.null?
+      0 != ptr[0]
+    end
+    
+    def message
+      MESSAGES[ptr[0]] unless ptr.null?
+    end
+  end
+
+  
+  class FileNotFound < Error; end
+  class LoadError < ErrorWithMessage; end
+  class TransformationError < Error; end
+  class SaveError < ErrorWithMessage; end
+end

data/lib/rszr/handle.rb

@@ -0,0 +1,37 @@
+module Rszr
+  class Handle
+    attr_reader :ptr, :klass
+    
+    def initialize(obj, ptr)
+      @ptr = ptr
+      raise ArgumentError, "#{obj.class.inspect} does not define the finalize class method" unless obj.class.respond_to?(:finalize, true)
+      @klass = obj.class
+      ObjectSpace.define_finalizer(obj, self)
+    end
+    
+    def replace!(other_ptr)
+      raise ArgumentError, "Cannot replace pointer with itself" if ptr == other_ptr
+      finalize!
+      @ptr = other_ptr
+    end
+    
+    def finalize!(*args)
+      #puts "Finalizing #{args.inspect} #{ptr.inspect}"
+      if !ptr.null? && klass
+        #puts "  calling #{args.inspect}"
+        klass.send(:finalize, ptr)
+        ptr = Fiddle::Pointer.new(0)
+      #else
+        #puts "  skipping #{args.inspect}"
+      end
+    end
+    
+    def release!
+      replace! Fiddle::Pointer.new(0)
+    end
+    
+    def call(object_id)
+      finalize!(object_id)
+    end
+  end
+end

data/lib/rszr/image.rb

@@ -0,0 +1,183 @@
+module Rszr
+  class Image
+    include Base
+
+    class << self
+      
+      alias_method :instantiate, :new
+      protected :instantiate
+      
+      def new(width, height)
+        ptr = imlib_create_image(width, height)
+        raise Error, 'Could not instantiate image' if ptr.null?
+        instantiate(ptr)
+      end
+            
+      def load(path, options = {})
+        path = path.to_s
+        raise FileNotFound unless File.exist?(path)
+        load_error = LoadError.new
+        imlib_set_cache_size(0)
+        ptr = imlib_load_image_with_error_return(path, load_error.ptr)
+        raise load_error, load_error.message if ptr.null?
+        return instantiate(ptr)
+      end
+      alias :open :load
+      
+      protected
+      
+      def finalize(ptr)
+        imlib_context_set_image(ptr)
+        imlib_free_image
+      end
+      
+    end
+    
+    def initialize(ptr)
+      @handle = Handle.new(self, ptr)
+    end
+    
+    def width
+      context_set_image
+      imlib_image_get_width
+    end
+    
+    def height
+      context_set_image
+      imlib_image_get_height
+    end
+    
+    def dimensions
+      [width, height]
+    end
+    
+    def format
+      context_set_image
+      str_ptr = imlib_image_format
+      return if str_ptr.null?
+      str_ptr.to_s
+    end
+    
+    def resize(*args)
+      instantiate(create_resized_image(*args))
+    end
+    
+    def resize!(*args)
+      handle.replace!(create_resized_image(*args))
+      self
+    end
+    
+    def crop(*args)
+      instantiate(create_cropped_image(*args))
+    end
+    
+    def crop!(*args)
+      handle.replace!(create_cropped_image(*args))
+      self
+    end
+    
+    def save(path, format = nil)
+      context_set_image
+      format ||= format_from_filename(path) || 'jpg'
+      imlib_image_set_format(format)
+      save_error = SaveError.new
+      imlib_save_image_with_error_return(path, save_error.ptr)
+      raise save_error, save_error.message if save_error.error?
+      true
+    end
+    
+    def inspect
+      "#<#{self.class.name}:0x#{object_id.to_s(16)} width=#{width} height=#{height} format=#{format.inspect}>"
+    end
+    
+    private
+    
+    # 0.5               0 < scale < 1
+    # 400, 300          fit box
+    # 400, :auto        fit width, auto height
+    # :auto, 300        auto width, fit height
+    # 400, 300, crop: :center_middle
+    # 400, 300, background: rgba
+    # 400, 300, aspect: false
+    
+    def create_resized_image(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      assert_valid_keys options, :crop, :background, :skew  #:extend, :width, :height, :max_width, :max_height, :box
+      context_set_image
+      x, y, = 0, 0
+      if args.size == 1
+        scale = args.first
+        raise ArgumentError, "scale #{scale.inspect} out of range" unless scale > 0 && scale < 1
+        new_width = width.to_f * scale
+        new_height = height.to_f * scale
+      elsif args.size == 2
+        box_width, box_height = args
+        if :auto == box_width && box_height.is_a?(Numeric)
+          new_height = box_height
+          new_width = box_height.to_f / height.to_f * width.to_f
+        elsif box_width.is_a?(Numeric) && :auto == box_height
+          new_width = box_width
+          new_height = box_width.to_f / width.to_f * height.to_f
+        elsif box_width.is_a?(Numeric) && box_height.is_a?(Numeric)
+          if options[:skew]
+            new_width, new_height = box_width, box_height
+          elsif options[:crop]
+            # TODO: calculate x, y offset if crop
+          else
+            scale = width.to_f / height.to_f
+            box_scale = box_width.to_f / box_height.to_f
+            if scale >= box_scale # wider
+              new_width = box_width
+              new_height = height.to_f * box_width.to_f / width.to_f
+            else # narrower
+              new_height = box_height
+              new_width = width.to_f * box_height.to_f / height.to_f
+            end
+          end
+        else
+          raise ArgumentError, "unconclusive arguments #{args.inspect} #{options.inspect}"
+        end
+      else
+        raise ArgumentError, "wrong number of arguments (#{args.size} for 1..2)"
+      end
+      
+      #new_width = options[:width] || imlib_image_get_width
+      #new_height = options[:height] || imlib_image_get_height
+      #if max_width = options[:max_width] and new_width > max_width
+      #  scale  = max_width.to_f / new_width.to_f
+      #  width  = max_width
+      #  new_height = (scale * new_height).to_i
+      #end
+      #if max_height = options[:max_height] and new_height > max_height
+      #  scale  = max_height.to_f / new_height.to_f
+      #  new_height = max_height
+      #  new_width  = (scale * new_width).to_i
+      #end
+      
+      imlib_context_set_anti_alias(1)
+      resized_ptr = imlib_create_cropped_scaled_image(x, y, imlib_image_get_width, imlib_image_get_height, new_width.round, new_height.round)
+      raise TransformationError, "error resizing image" if resized_ptr.null?
+      resized_ptr
+    end
+    
+    def create_cropped_image(x, y, width, height)
+      context_set_image
+      cropped_ptr = imlib_create_cropped_image(x, y, width, height)
+      raise TransformationError, 'error cropping image' if cropped_ptr.null?
+      cropped_ptr
+    end
+    
+    def format_from_filename(path)
+      File.extname(path)[1..-1]
+    end
+    
+    def context_set_image
+      imlib_context_set_image(ptr)
+    end
+    
+    def instantiate(ptr)
+      self.class.send(:instantiate, ptr)
+    end
+    
+  end
+end

data/lib/rszr/lib.rb

@@ -0,0 +1,64 @@
+module Rszr
+  
+  module Lib
+    extend Fiddle::Importer
+    
+    dlload case RbConfig::CONFIG['arch']
+    when /darwin/ then 'libImlib2.dylib'
+    when /mswin/, /cygwin/ then 'imlib2.dll'
+    else
+      'libImlib2.so'
+    end
+    
+    typealias 'Imlib_Image',      'void *'
+    typealias 'Imlib_Context',    'void *'
+    typealias 'enum',             'int'
+    typealias 'Imlib_Load_Error', 'enum'
+
+    #typedef void       *Imlib_Color_Modifier;
+    #typedef void       *Imlib_Updates;
+    #typedef void       *Imlib_Font;
+    #typedef void       *Imlib_Color_Range;
+    #typedef void       *Imlib_Filter;
+    #typedef struct _imlib_border Imlib_Border;
+    #typedef struct _imlib_color Imlib_Color;
+    #typedef void       *ImlibPolygon;
+    
+    extern 'int         imlib_get_cache_size()'
+    extern 'void        imlib_set_cache_size(int)'
+    
+    extern 'Imlib_Image imlib_load_image(const char *)'
+    extern 'Imlib_Image imlib_load_image_without_cache(const char *)'
+    extern 'Imlib_Image imlib_load_image_with_error_return(const char *, Imlib_Load_Error *)'
+    extern 'Imlib_Image imlib_create_image(int, int)'
+    extern 'void        imlib_context_set_image(Imlib_Image)'
+    extern 'int         imlib_image_get_width()'
+    extern 'int         imlib_image_get_height()'
+    extern 'void        imlib_context_set_anti_alias(char)'
+
+    # source_x, source_y, source_width, source_height, destination_width, destination_height
+    extern 'Imlib_Image imlib_create_cropped_scaled_image(int, int, int, int, int, int)'
+    # x, y, width, height
+    extern 'Imlib_Image imlib_create_cropped_image(int, int, int, int)'
+    
+    extern 'char *      imlib_image_format()'
+    extern 'void        imlib_image_set_format(const char *)'
+    extern 'void        imlib_save_image(const char *)'
+    extern 'void        imlib_save_image_with_error_return(const char *, Imlib_Load_Error *)'
+    
+    extern 'void        imlib_free_image()'
+    extern 'void        imlib_free_image_and_decache()'
+    
+    def self.delegate(base)
+      Lib.methods.grep(/\Aimlib_/).each do |method|
+        line_no = __LINE__; str = %Q{
+          def #{method}(*args, &block)
+            Lib.#{method}(*args, &block)
+          end
+        }
+        base.class_eval(str, __FILE__, line_no)
+      end
+    end
+    
+  end
+end

data/lib/rszr/version.rb

@@ -0,0 +1,3 @@
+module Rszr
+  VERSION = "0.3.1"
+end

metadata

@@ -0,0 +1,152 @@
+--- !ruby/object:Gem::Specification
+name: rszr
+version: !ruby/object:Gem::Version
+  version: 0.3.1
+platform: ruby
+authors:
+- Matthias Grosser
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: gd2-ffij
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mini_magick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Fast image resizer - do one thing and do it fast.
+email:
+- mtgrosser@gmx.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- lib/rszr.rb
+- lib/rszr/base.rb
+- lib/rszr/errors.rb
+- lib/rszr/handle.rb
+- lib/rszr/image.rb
+- lib/rszr/lib.rb
+- lib/rszr/version.rb
+homepage: https://github.com/mtgrosser/rszr
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Fast image resizer
+test_files: []