opencv¶ ↑

OpenCV Sourceforge Project sourceforge.net/projects/opencvlibrary/

Ruby/OpenCV Author’s Web Page blueruby.mydns.jp/opencv

DESCRIPTION:¶ ↑

OpenCV Ruby Wrapper

FEATURES/PROBLEMS:¶ ↑

• First release rubygems, Some OpenCV function wrapped.

• Use of Carbon windows on Mac OS X is a little buggy, especially when called from the command line.

• Mouse interaction often causes segfaults on my Mac OS X (ruby 1.8.7).

• Sadly, use of X Windows as an alternative on Mac OS X is similarly buggy.

REQUIREMENTS:¶ ↑

• OpenCV 1.0 or later. sourceforge.net/projects/opencvlibrary/

• OpenCV has several dependencies, see INSTALLATION INSTRUCTIONS below

• ffcall (optional) www.haible.de/bruno/packages-ffcall.html

INSTALLATION INSTRUCTIONS¶ ↑

• OpenCV is a requirement. Unfortunately there’s a bug in the code that affects our ability to use Carbon windows, so we can’t install from a port. We’ll have to install from source.

• First, these are the dependencies we’ll need:

• atk

• pango

• jpeg

• tiff

• libpng

• pkgconfig

• gtk2

• glib2

• ffcall

• Use ports to install them:

$ sudo port install atk 
$ sudo port install glib2 
$ sudo port install pango
$ sudo port install jpeg
$ sudo port install tiff
$ sudo port install libpng
$ sudo port install pkgconfig
$ sudo port install gtk2
$ sudo port install ffcall

• Ports is going to install them in /opt/local, which is where this gem will go looking for ffcall, so that will work well for us.

• Next, download version 1.1pre1 of the opencv-linux package here: sourceforge.net/project/showfiles.php?group_id=22870

• Navigate to where you downloaded it and:

tar xzvf opencv-1.1pre1.tar.gz
cd opencv-1.1.0/

• Important: Before we configure and build, we need to fix a small bug in the code. Open up the file otherlibs/highgui/window_carbon.cpp in a text editor and make this change to line 645:

return NULL;

should be changed to

return result;

(This bug is tracked in sourceforge here: sourceforge.net/tracker/index.php?func=detail&aid=2668857&group_id=22870&atid=376677)

• Now save the file, and we can run configure:

./configure --with-carbon=yes CPPFLAGS="-I/opt/local/include -I/usr/include/malloc" LDFLAGS=-L/opt/local/lib

After configure runs, it will print out a display showing which libraries are in use. Double-check that the windowing system is using “Carbon/Mac OS X” and not gtk.

• Finish installing:

make
sudo make install

The last of the output from the install command will probably complain about not being able to find ldconfig. That’s fine. You’re on a Mac; you don’t need ldconfig (macosx.com/forums/mac-os-x-system-mac-software/5200-ldconfig.html).

• Now install the gem

sudo gem install bantic-ruby-opencv

• Check your work:

$ irb
irb> require 'rubygems'
=> true
irb> require 'opencv'
=> true

SYNOPSIS:¶ ↑

# Show image via GUI Window.

require "rubygems"
require "opencv"

image = OpenCV::IplImage.load("sample.jpg")
window = OpenCV::GUI::Window.new("preview")
window.show(image)
OpenCV::GUI::wait_key

# other sample code, see examples/*.rb

Documentation is available here: doc.blueruby.mydns.jp/opencv/

LICENSE:¶ ↑

The BSD Liscense

see LICENSE.txt