async-ruby-vips

Non-blocking transformation and image writing in Ruby, powered by VIPS

Requirements

• OS X or Linux
• MRI >= 1.9.2
• libvips 7.28.x
• libexif

Prerequisites

• On Ubuntu, apt-get install libvips-dev, or follow the guidelines at: https://github.com/jcupitt/libvips

If you installed it from source, make sure:

• /usr/local/lib is on your LD_LIBRARY_PATH
• /usr/local/bin is on PATH
• /usr/local/lib/pkgconfig is on PKG_CONFIG_PATH

Building

• bundle install # to install dependencies
• rake gemspec # to generate gemspec file
• rake build # to build the gem
• rake install # to install the gem

Example

require 'rubygems'
require 'async_vips'
include AsyncVips


# Non-blocking scaling of an image:
# Allowed symbols are:  :load, :scale_x, :scale_y, :save
# Wneh called, a function is invoked on a separate native thread. 
# The callback-proc is invoked on a separate Ruby thread on completion.
AsyncVips.transform(:load => srcfile, :scale_x => 800, :save => dstfile) do |img|
  if(img.error != nil)
    puts img.error
  end
end

# Set the number of operations cached by VIPS: 
AsyncVips.set_cache(100)

# Get image information:
# Allowed symbols are:  :load
AsyncVips.info(:load => srcfile) do |img|
  puts img.src    # image filepath
  puts img.width  # image width
  puts img.height # image height
  puts img.size   # image size in bytes
end


## Using event machine

require 'rubygems'
require 'async_vips'
require 'eventmachine'
include AsyncVips

#puts AsyncVips::VERSION
#puts AsyncVips::LIB_VERSION
AsyncVips.set_cache(0) # sets the number of operations cached by VIPS

EM.run do

  EM.add_timer(3) do
     source = './images/*.JPG'
     files = Dir[source]
     files.each do |srcfile|
       dstfile = './output/'+File.basename(srcfile)

       AsyncVips.transform(:load => srcfile, :scale_x => 800, :save => dstfile) do |img|
         puts img.src
         if(img.error != nil)
           puts img.error
         end                 
       end

     end
  end

  EM.add_periodic_timer(1) do
    puts "#{Time.now}"
  end
end


```ruby


## Version history

### 1.2.1 - added support for natural_orientation flag
### 1.1.0 - shrink operation
### 1.0.0 - initial release