ruby-vips8 0.1.0

data/example/example1.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/ruby
+
+require 'vips8'
+$vips_debug = true
+
+puts ""
+puts "starting up:"
+
+# this makes vips keep a list of all active objects which we can print out
+Vips::leak_set true
+
+# disable the operation cache
+Vips::cache_set_max 0
+
+puts ""
+puts "creating object:"
+x = Vips::Image.new
+Vips::Object::print_all
+
+puts ""
+puts "freeing object:"
+x = nil
+GC.start
+Vips::Object::print_all
+
+puts ""
+puts "creating operation:"
+op = Vips::Operation.new "black"
+Vips::Object::print_all
+op.set_property "width", 200
+op.set_property "height", 300
+
+puts ""
+puts "after operation init:"
+GC.start
+Vips::Object::print_all
+
+puts ""
+puts "operation lookup:"
+op2 = Vips::cache_operation_lookup op
+if op2
+    puts "cache hit"
+    op = op2
+    op2 = nil
+else
+    puts "cache miss ... building"
+    if not op.build
+        puts "*** build error"
+    end
+    Vips::cache_operation_add op
+end
+
+puts ""
+puts "after build:"
+GC.start
+Vips::Object::print_all
+
+puts ""
+puts "fetching output:"
+im = op.get_property "out"
+GC.start
+Vips::Object::print_all
+
+puts ""
+puts "fetching output again:"
+im2 = op.get_property "out"
+GC.start
+Vips::Object::print_all
+
+puts ""
+puts "freeing operation:"
+op.unref_outputs
+op = nil
+op2 = nil
+GC.start
+Vips::Object::print_all
+
+puts ""
+puts "shutting down:"
+im = nil
+im2 = nil
+GC.start
+Vips::shutdown
+GC.start

data/example/example2.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/ruby
+
+require 'vips8'
+
+puts ""
+puts "starting up:"
+
+# this makes vips keep a list of all active objects which we can print out
+Vips::leak_set true
+
+# disable the operation cache
+Vips::cache_set_max 0
+
+n = 100
+
+n.times do |i|
+    puts ""
+    puts "call #{i} ..."
+    out = Vips::call "black", 200, 300
+    if out.width != 200 or out.height != 300
+        puts "bad image result from black"
+    end
+end
+
+puts ""
+puts "after #{n} calls:"
+GC.start
+Vips::Object::print_all
+
+puts ""
+puts "shutting down:"

data/example/example3.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/ruby
+
+require 'vips8'
+
+# this makes vips keep a list of all active objects 
+# Vips::leak_set true
+
+# disable the operation cache
+# Vips::cache_set_max 0
+
+# turn on debug logging
+#Vips.set_debug true
+
+10000.times do |i|
+    puts "loop #{i} ..."
+    im = Vips::Image.new_from_file ARGV[0]
+    im = im.embed 100, 100, 3000, 3000, :extend => :mirror
+    im.write_to_file "x.v"
+end

data/example/example4.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby
+
+require 'vips8'
+
+# this makes vips keep a list of all active objects 
+Vips::leak_set true
+
+# disable the operation cache
+#Vips::cache_set_max 0
+
+# turn on debug logging
+#Vips.set_debug true
+
+ARGV.each do |filename|
+    im = Vips::Image.new_from_file filename
+    profile = im.get_value "icc-profile-data"
+    puts "profile has #{profile.length} bytes"
+end

data/example/example5.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/ruby
+
+require 'vips8'
+
+# this makes vips keep a list of all active objects 
+# Vips::leak_set true
+
+# disable the operation cache
+# Vips::cache_set_max 0
+
+# turn on debug logging
+#Vips.set_debug true
+
+if ARGV.length < 2
+    raise "usage: #{$PROGRAM_NAME}: input-file output-file"
+end
+
+im = Vips::Image.new_from_file ARGV[0], :access => :sequential
+
+im *= [1, 2, 1]
+
+# we want to be able to specify a scale for the convolution mask, so we have to
+# make it ourselves
+# if you are OK with scale=1, you can just pass the array directly to .conv()
+mask = Vips::Image.new_from_array [
+    [-1, -1, -1],
+    [-1, 16, -1],
+    [-1, -1, -1]], 8
+im = im.conv mask
+
+im.write_to_file ARGV[1]

data/example/trim8.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/ruby
+
+# An equivalent of ImageMagick's -trim in ruby-vips8 ... automatically remove
+# "boring" image edges.
+
+# We use .project to sum the rows and columns of a 0/255 mask image, the first
+# non-zero row or column is the object edge. We make the mask image with an
+# amount-different-from-background image plus a threshold.
+
+require 'vips8'
+
+im = Vips::Image.new_from_file ARGV[0]
+
+# find the value of the pixel at (0, 0) ... we will search for all pixels 
+# significantly different from this
+background = im.getpoint(0, 0)
+
+# we need to smooth the image, subtract the background from every pixel, take 
+# the absolute value of the difference, then threshold
+mask = (im.median - background).abs > 10
+
+# sum mask rows and columns, then search for the first non-zero sum in each
+# direction
+columns, rows = mask.project
+
+first_column, first_row = columns.profile
+left = first_row.min
+
+first_column, first_row = columns.fliphor.profile
+right = columns.width - first_row.min
+
+first_column, first_row = rows.profile
+top = first_column.min
+
+first_column, first_row = rows.flipver.profile
+bottom = rows.height - first_column.min
+
+# and now crop the original image
+im = im.crop left, top, right - left, bottom - top
+
+im.write_to_file ARGV[1]

data/example/watermark.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/ruby
+
+require 'vips8'
+ 
+im = Vips::Image.new_from_file ARGV[0], :access => :sequential
+ 
+text = Vips::Image.text ARGV[2], :width => 500, :dpi => 300
+text = (text * 0.3).cast(:uchar)
+text = text.embed 100, 100, text.width + 200, text.width + 200
+text = text.replicate 1 + im.width / text.width, 1 + im.height / text.height
+text = text.crop 0, 0, im.width, im.height
+
+# we want to blend into the visible part of the image and leave any alpha
+# channels untouched ... we need to split im into two parts
+
+# guess how many bands from the start of im contain visible colour information
+if im.bands >= 4 and im.interpretation == :cmyk
+    # cmyk image
+    n_visible_bands = 4
+    text_colour = [0, 255, 0, 0]
+elsif im.bands >= 3
+    # rgb image
+    n_visible_bands = 3
+    text_colour = [255, 0, 0]
+else
+    # mono image
+    n_visible_bands = 1
+    text_colour = 255
+end
+
+# split into image and alpha
+if im.bands - n_visible_bands > 0
+    alpha = im.extract_band n_visible_bands, :n => im.bands - n_visible_bands
+    im = im.extract_band 0, :n => n_visible_bands
+else
+    alpha = nil
+end
+
+marked = text.ifthenelse text_colour, im, :blend => true
+
+# reattach alpha
+marked = marked.bandjoin alpha  if alpha
+ 
+marked.write_to_file ARGV[1]

data/example/wobble.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby
+
+require 'vips8'
+
+image = Vips::Image.new_from_file ARGV[0]
+
+module Vips
+    class Image
+        def wobble
+            # this makes an image where pixel (0, 0) (at the top-left) has 
+            # value [0, 0], and pixel (image.width, image.height) at the 
+            # bottom-right has value [image.width, image.height]
+            index = Vips::Image.xyz width, height 
+
+            # make a version with (0, 0) at the centre, negative values up 
+            # and left, positive down and right
+            centre = index - [width / 2, height / 2]
+
+            # to polar space, so each pixel is now distance and angle in degrees
+            polar = centre.polar
+
+            # scale sin(distance) by 1/distance to make a wavey pattern
+            d = ((polar[0] * 3).sin * 10000) / (polar[0] + 1)
+
+            # and back to rectangular coordinates again to make a set of 
+            # vectors we can apply to the original index image
+            index += d.bandjoin(polar[1]).rect
+
+            # finally, use our modified index image to distort!
+            mapim index 
+        end
+    end
+end
+
+image = image.wobble
+image.write_to_file ARGV[1]

data/lib/vips8.rb

@@ -0,0 +1,153 @@
+# This module provides a set of overrides for the vips image processing library
+# used via the gobject-introspection gem. 
+#
+# Author::    John Cupitt  (mailto:jcupitt@gmail.com)
+# License::   MIT
+
+# @private
+def log str 
+    if $vips_debug
+        puts str
+    end
+end
+
+# copied from ruby-gnome2/gstreamer/lib/gst.rb without much understanding
+
+require 'pathname'
+require 'gobject-introspection'
+
+# pick up a local girepository/lib in preference to the system one 
+base_dir = Pathname.new(__FILE__).dirname.dirname.expand_path
+vendor_dir = base_dir + "vendor" + "local"
+vendor_bin_dir = vendor_dir + "bin"
+GLib.prepend_dll_path(vendor_bin_dir)
+vendor_girepository_dir = vendor_dir + "lib" + "girepository-1.0"
+GObjectIntrospection.prepend_typelib_path(vendor_girepository_dir)
+
+module Vips
+    # @private
+    LOG_DOMAIN = "VIPS"
+    GLib::Log.set_log_domain(LOG_DOMAIN)
+
+    # about as crude as you could get
+    $vips_debug = false
+
+    # Turn debug logging on and off.
+    #
+    # @param dbg [Boolean] Set true to print debug log messages
+    def self.set_debug dbg 
+        $vips_debug = dbg
+    end
+
+    class << self
+        # @private
+        def const_missing(name)
+            log "Vips::const_missing: #{name}"
+        
+            init()
+            if const_defined?(name)
+                const_get(name)
+            else
+              super
+            end
+        end
+
+        # @private
+        def method_missing(name, *args, &block)
+            log "Vips::method_missing: #{name}, #{args}, #{block}"
+
+            init()
+            if respond_to?(name)
+                __send__(name, *args, &block)
+            else
+                super
+            end
+        end
+
+        # @private
+        def init(*argv)
+            log "Vips::init: #{argv}"
+
+            class << self
+                remove_method(:init)
+                remove_method(:const_missing)
+                remove_method(:method_missing)
+            end
+
+            loader = Loader.new(self, argv)
+            begin
+                loader.load("Vips")
+            rescue 
+                puts "Unable to load Vips"
+                puts "  Check that the vips library has been installed and is"
+                puts "  on your library path."
+                puts "  Check that the typelib `Vips-8.0.typelib` has been "
+                puts "  installed, and that it is on your GI_TYPELIB_PATH."
+                raise
+            end
+
+            require 'vips8/error'
+            require 'vips8/argument'
+            require 'vips8/operation'
+            require 'vips8/call'
+            require 'vips8/image'
+        end
+    end
+
+    # @private
+    class Loader < GObjectIntrospection::Loader
+        def initialize(base_module, init_arguments)
+            log "Vips::Loader.initialize: #{base_module}, #{init_arguments}"
+
+            super(base_module)
+            @init_arguments = init_arguments
+        end
+
+        private
+        def pre_load(repository, namespace)
+            log "Vips::Loader.pre_load: #{repository}, #{namespace}"
+
+            call_init_function(repository, namespace)
+            define_value_modules
+        end
+
+        def call_init_function(repository, namespace)
+            log "Vips::Loader.call_init_function: #{repository}, #{namespace}"
+
+            # call Vips::init
+            init = repository.find(namespace, "init")
+            succeeded, argv, error = init.invoke(:arguments => [$PROGRAM_NAME])
+
+            # TODO get the vips error buffer
+            raise error unless succeeded
+        end
+
+        def define_value_modules
+            @value_functions_module = Module.new
+            @value_methods_module = Module.new
+            @base_module.const_set("ValueFunctions", @value_functions_module)
+            @base_module.const_set("ValueMethods",   @value_methods_module)
+        end
+
+        def post_load(repository, namespace)
+            log "Vips::Loader.post_load:"
+        end
+
+    end
+end
+
+at_exit {
+        Vips::shutdown if Vips.respond_to? :shutdown
+}
+
+# this makes vips keep a list of all active objects which we can print out
+Vips::leak_set true if $vips_debug
+
+# @private
+def showall 
+    if $vips_debug
+        GC.start 
+        Vips::Object::print_all 
+    end
+end
+