The initial Open Computer Vision library was originally developed by Intel Corporation. Recent development has been headed by Willow Garage, Inc.

• OpenCV project home opencv.willowgarage.com/wiki/

  • Download sourceforge.net/projects/opencvlibrary/

• Ruby/OpenCV original author’s web page blueruby.mydns.jp/opencv

OpenCV wrapper for Ruby

• Some OpenCV functions are wrapped.

• Ruby 1.8.7, 1.9.3 and OpenCV 2.3.1 are supported.

• OpenCV (required)

Ruby/OpenCV relies on the OpenCV library.

See opencv.willowgarage.com/wiki/InstallGuide

$ git clone git://github.com/ser1zw/ruby-opencv.git
$ cd ruby-opencv
$ git checkout master  # for OpenCV 2.3 or later. To use OpenCV 2.2, type "git checkout OpenCV_2.2" instead
$ ruby extconf.rb --with-opencv-dir=/path/to/opencvdir
$ make
$ make install

Use “nmake” instead of “make”.

In mswin32, OpenCV include folder and library folder are not installed in the same folder by default. You may need to specify OpenCV include folder and library folder respectively when you run extconf.rb.

$ git clone git://github.com/ser1zw/ruby-opencv.git
$ cd ruby-opencv
$ git checkout master  # for OpenCV 2.3 or later. To use OpenCV 2.2, type "git checkout OpenCV_2.2" instead
$ ruby extconf.rb --with-opencv-include=C:\path\to\opencvdir\build\include --with-opencv-lib=C:\path\to\opencvdir\build\x86\vc10\lib
$ nmake
$ nmake install

/path/to/opencvdir is the path you installs OpenCV library (default: /usr/local).

For example, if you install OpenCV library to /opt/local/ like:

$ cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/opt/local/ ./OpenCV-2.3.1
$ make
$ make install

Install Ruby/OpenCV with the following command:

$ ruby extconf.rb --with-opencv-dir=/opt/local
$ make
$ make install

You can also install this library creating a gem like:

$ git clone git://github.com/ser1zw/ruby-opencv.git
$ cd ruby-opencv
$ git checkout master  # for OpenCV 2.3 or later. To use OpenCV 2.2, type "git checkout OpenCV_2.2" instead
$ bundle install
$ rake gem
$ gem install pkg/opencv-*.gem -- --with-opencv-dir=/path/to/opencvdir

To add ruby-opencv in your Gemfile:

$ echo -e "\n"'gem "opencv", :git => "https://github.com/ser1zw/ruby-opencv"' >> Gemfile
$ bundle config build.opencv --with-opencv-dir=/path/to/opencvdir
$ bundle install  # or bundle update

#!/usr/bin/env ruby
require "opencv"

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

Here is a sample face detection program that doesn’t rely on the GUI components. In order for this to work you must copy the OpenCV haarcascades data into a subfolder called data.

#!/usr/bin/env ruby
require "opencv"

if ARGV.length < 2
  puts "Usage: your_app_name source dest"
  exit
end

data = "./data/haarcascades/haarcascade_frontalface_alt.xml"
detector = OpenCV::CvHaarClassifierCascade::load(data)
image = OpenCV::IplImage.load(ARGV[0])
detector.detect_objects(image).each do |region|
  color = OpenCV::CvColor::Blue
  image.rectangle! region.top_left, region.bottom_right, :color => color
end
image.save_image(ARGV[1])

For more samples, see examples/*.rb

The BSD Liscense

see LICENSE.txt