bonanza-ruby-opencv 0.0.13.20140330211753

data/README.md

@@ -0,0 +1,98 @@
+# ruby-opencv
+
+An OpenCV wrapper for Ruby.
+
+* Web site: <https://github.com/ruby-opencv/ruby-opencv>
+* Ruby 1.9.3, 2.0.0, 2.1.x and OpenCV 2.4.8 are supported.
+
+## Requirement
+
+* OpenCV <http://opencv.org/>
+  * [Download](http://sourceforge.net/projects/opencvlibrary/)
+  * [Install guide](http://docs.opencv.org/doc/tutorials/introduction/table_of_content_introduction/table_of_content_introduction.html#table-of-content-introduction)
+
+## Install
+### Linux/Mac
+1. Install [OpenCV](http://sourceforge.net/projects/opencvlibrary/files/opencv-unix/)
+2. Install ruby-opencv
+
+```
+$ gem install ruby-opencv -- --with-opencv-dir=/path/to/opencvdir
+```
+
+Note: **/path/to/opencvdir** is the directory where you installed OpenCV.
+
+
+### Windows
+You can use pre-build binary for Windows (mswin32).
+
+1. Install [OpenCV](http://sourceforge.net/projects/opencvlibrary/files/opencv-win/)
+2. Set path to OpenCV libraries. When you installed OpenCV to **C:\opencv**, add **C:\opencv\build\x86\vc10\bin** to the systems path.
+3. Install ruby-opencv
+
+```
+$ gem install ruby-opencv
+```
+
+## Sample code
+### Load and Display an Image
+
+A sample to load and display an image. An equivalent code of [this tutorial](http://docs.opencv.org/doc/tutorials/introduction/display_image/display_image.html#display-image).
+
+```ruby
+require 'opencv'
+include OpenCV
+
+if ARGV.size == 0
+  puts "Usage: ruby #{__FILE__} ImageToLoadAndDisplay"
+  exit
+end
+
+image = nil
+begin
+  image = CvMat.load(ARGV[0], CV_LOAD_IMAGE_COLOR) # Read the file.
+rescue
+  puts 'Could not open or find the image.'
+  exit
+end
+
+window = GUI::Window.new('Display window') # Create a window for display.
+window.show(image) # Show our image inside it.
+GUI::wait_key # Wait for a keystroke in the window.
+```
+
+### Face Detection
+
+A sample to detect faces from an image.
+
+```ruby
+require 'opencv'
+include OpenCV
+
+if ARGV.length < 2
+  puts "Usage: ruby #{__FILE__} source dest"
+  exit
+end
+
+data = './data/haarcascades/haarcascade_frontalface_alt.xml'
+detector = CvHaarClassifierCascade::load(data)
+image = CvMat.load(ARGV[0])
+detector.detect_objects(image).each do |region|
+  color = CvColor::Blue
+  image.rectangle! region.top_left, region.bottom_right, :color => color
+end
+
+image.save_image(ARGV[1])
+window = GUI::Window.new('Face detection')
+window.show(image)
+GUI::wait_key
+```
+
+For more samples, see examples/*.rb
+
+## LICENSE:
+
+The BSD Liscense
+
+see LICENSE.txt
+

data/Rakefile

@@ -0,0 +1,99 @@
+# -*- mode: ruby; coding: utf-8 -*-
+require 'rubygems'
+require "rubygems/ext"
+require "rubygems/installer"
+require 'hoe'
+require 'rake/extensiontask'
+require 'fileutils'
+require './lib/opencv/psyched_yaml'
+require 'yard'
+require 'yard/rake/yardoc_task'
+require './yard_extension'
+
+SO_FILE = 'opencv.so'
+
+Hoe.plugin :gemspec
+
+hoespec = Hoe.spec 'ruby-opencv' do |s|
+  s.summary = 'OpenCV wrapper for Ruby'
+  s.description = 'ruby-opencv is a wrapper of OpenCV for Ruby. It helps you to write computer vision programs (e.g. detecting faces from pictures) with Ruby.'
+  s.licenses = ['The BSD License']
+  s.developer('lsxi', 'masakazu.yonekura@gmail.com')
+  s.developer('ser1zw', 'azariahsawtikes@gmail.com')
+  s.developer('pcting', 'pcting@gmail.com')
+
+  s.readme_file  = 'README.md'
+  s.history_file = 'History.txt'
+
+  s.spec_extras = { :extensions => ['ext/opencv/extconf.rb'] }
+
+  s.test_globs = ['test/test_*.rb']
+  s.urls = ['https://github.com/ruby-opencv/ruby-opencv/']
+
+  s.extra_dev_deps << ['rake-compiler', '~> 0'] << ['hoe-gemspec', '~> 0']
+
+  Rake::ExtensionTask.new('opencv', spec) do |ext|
+    ext.lib_dir = 'lib'
+  end
+end
+
+hoespec.spec.files.delete('.gemtest')
+
+Rake::Task[:test].prerequisites << :compile
+
+desc 'Create a pre-compiled gem'
+task 'gem:precompile' => ['gem'] do
+  tmp_dir = Dir.mktmpdir('tmp', '.')
+  gemfile = Dir.glob("pkg/*.gem")[0]
+  target_dir = File.join(tmp_dir, File.basename(gemfile, '.gem'))
+
+  installer = Gem::Installer.new(gemfile)
+  installer.unpack(target_dir)
+
+  gemspec = installer.spec
+  extension = gemspec.extensions[0]
+  gemspec.extensions.clear
+
+  config = ENV['CONFIG'] ?  YAML.load_file(ENV['CONFIG']) : {}
+  rubies = config['rubies'] || [Gem.ruby]
+  args = config['extopts'] || []
+  gemspec.platform = config['platform'] || Gem::Platform::CURRENT
+
+  multi = rubies.size > 1
+  rubies.each { |ruby|
+    lib_dir = 'lib'
+    if multi
+      major, minor, _ = `#{ruby} -e "print RUBY_VERSION"`.chomp.split('.')
+      lib_dir = File.join(lib_dir, [major, minor].join('.'))
+    end
+
+    make_cmd = (`#{ruby} -e "print RUBY_PLATFORM"` =~ /mswin/) ? 'nmake' : 'make'
+    Dir.chdir(target_dir) {
+      cmd = [ruby, extension, *args].join(' ')
+      results = []
+      Gem::Ext::ExtConfBuilder.run(cmd, results)
+      Gem::Ext::ExtConfBuilder.make('', results)
+
+      FileUtils.mkdir_p lib_dir
+      FileUtils.mv SO_FILE, lib_dir
+      sh "#{make_cmd} clean"
+    }
+
+    gemspec.files << File.join(lib_dir, SO_FILE)
+  }
+
+  Dir.chdir(target_dir) {
+    gemfile = Gem::Package.build(gemspec)
+    FileUtils.mv gemfile, File.dirname(__FILE__)
+  }
+
+  FileUtils.rm_rf tmp_dir
+end
+
+# yard
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb', 'ext/**/*.cpp']
+end
+
+# vim: syntax=ruby
+

data/config.yml

@@ -0,0 +1,7 @@
+platform: mingw32
+rubies:
+  - C:/ruby-1.9.3-p392-mingw32/bin/ruby.exe
+  - C:/ruby-2.0.0-p0-mingw32/bin/ruby.exe
+extopts:
+  - --with-opencv-include=C:/opencv/build/include
+  - --with-opencv-lib=C:/opencv/build/x86/mingw/lib

data/examples/alpha_blend.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+# -*- mode: ruby; coding: utf-8 -*-
+
+# Alpha blending sample with GUI
+
+require 'opencv'
+include OpenCV
+
+img1 = IplImage.load('images/lenna.jpg', CV_LOAD_IMAGE_ANYCOLOR | CV_LOAD_IMAGE_ANYDEPTH)
+img2 = IplImage.load('images/tiffany.jpg', CV_LOAD_IMAGE_ANYCOLOR | CV_LOAD_IMAGE_ANYDEPTH)
+
+window = GUI::Window.new('Alpha blend')
+max = 100.0
+val = max / 2.0
+window.set_trackbar("Alpha", max, val) { |v|
+  a = v.to_f / max
+  window.show CvMat.add_weighted(img1, a, img2, 1.0 - a, 0)
+}
+window.show CvMat.add_weighted(img1, val / max, img2, 1.0 - val / max, 0)
+GUI::wait_key
+

data/examples/contours/bounding-box-detect-canny.rb

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+#
+# Detects contours in an image and
+# their boundingboxes
+#
+require "opencv"
+
+# Load image
+cvmat = OpenCV::CvMat.load("rotated-boxes.jpg")
+
+# The "canny" edge-detector does only work with grayscale images
+# so to be sure, convert the image
+# otherwise you will get an OpenCV::CvStsAssert exception.
+cvmat = cvmat.BGR2GRAY
+
+# Use the "canny" edge detection algorithm (http://en.wikipedia.org/wiki/Canny_edge_detector)
+# Parameters are two colors that are then used to determine possible corners
+canny = cvmat.canny(50, 150)
+
+# Look for contours
+# We want them to be returned as a flat list (CV_RETR_LIST) and simplified (CV_CHAIN_APPROX_SIMPLE)
+# Both are the defaults but included here for clarity
+contour = canny.find_contours(mode: OpenCV::CV_RETR_LIST, method: OpenCV::CV_CHAIN_APPROX_SIMPLE)
+
+# The Canny Algorithm returns two matches for every contour (see O'Reilly: Learning OpenCV Page 235)
+# We need only the external edges so we ignore holes.
+# When there are no more contours, contours.h_next will return nil
+while contour
+  # No "holes" please (aka. internal contours)
+  unless contour.hole?
+
+    puts '-' * 80
+    puts "BOUNDING RECT FOUND"
+    puts '-' * 80
+
+    # You can detect the "bounding rectangle" which is always oriented horizontally and vertically
+    box = contour.bounding_rect
+    puts "found external contour with bounding rectangle from #{box.top_left.x},#{box.top_left.y} to #{box.bottom_right.x},#{box.bottom_right.y}"
+
+    # The contour area can be computed:
+    puts "that contour encloses an area of #{contour.contour_area} square pixels"
+
+    # .. as can be the length of the contour
+    puts "that contour is #{contour.arc_length} pixels long "
+
+    # Draw that bounding rectangle
+    cvmat.rectangle! box.top_left, box.bottom_right, color: OpenCV::CvColor::Black
+
+    # You can also detect the "minimal rectangle" which has an angle, width, height and center coordinates
+    # and is not neccessarily horizonally or vertically aligned.
+    # The corner of the rectangle with the lowest y and x position is the anchor (see image here: http://bit.ly/lT1XvB)
+    # The zero angle position is always straight up. 
+    # Positive angle values are clockwise and negative values counter clockwise (so -60 means 60 degree counter clockwise)
+    box = contour.min_area_rect2
+    puts "found minimal rectangle with its center at (#{box.center.x.round},#{box.center.y.round}), width of #{box.size.width.round}px, height of #{box.size.height.round} and an angle of #{box.angle.round} degree"
+  end
+  contour = contour.h_next
+end 
+
+# And save the image
+puts "\nSaving image with bounding rectangles"
+cvmat.save_image("rotated-boxes-with-detected-bounding-rectangles.jpg")

data/examples/contours/contour_retrieval_modes.rb

@@ -0,0 +1,139 @@
+#!/usr/bin/env ruby
+#
+# This file shows the different retrieval modes for contour detection
+#
+require "opencv"
+
+# Load image
+# The structure of the image is "explained" in bitmap-contours-with-labels.png
+cvmat = OpenCV::CvMat.load("bitmap-contours.png")
+
+# "find_contours" does only operate on bitmap images (black/white)
+mat = OpenCV::CvMat.new(cvmat.rows, cvmat.cols, :cv8u, 1)
+(cvmat.rows * cvmat.cols).times do |i|
+  mat[i] = (cvmat[i][0] <= 128) ? OpenCV::CvScalar.new(0) : OpenCV::CvScalar.new(255)
+end
+
+# find_contours takes two parameters:
+# 1. Retrieval mode (:mode, defines the structure of the contour sequence returned)
+#    - CV_RETR_LIST (default)
+#    - CV_RETR_EXTERNAL
+#    - CV_RETR_CCOMP
+#    - CV_RETR_TREE
+# 2. Retrieval Method (:method, how the contours are approximated)
+#    - CV_CHAIN_CODE
+#    - CV_CHAIN_APPROX_NONE
+#    - CV_CHAIN_APPROX_SIMPLE (default)
+#    - CV_CHAIN_APPROX_TC89_L1
+#    - CV_CHAIN_APPROX_T89_KCOS
+#    - CV_LINK_RUNS
+
+#
+# The default: CV_RETR_LIST and CV_CHAIN_APPROX_SIMPLE
+# This produces a flat list of contours that can be traversed with .h_next and .h_prev
+#
+puts "Detecting using CV_RETR_LIST and CV_CHAIN_APPROX_SIMPLE"
+contour = mat.find_contours(mode: OpenCV::CV_RETR_LIST, method: OpenCV::CV_CHAIN_APPROX_SIMPLE)
+cindex=1
+
+while contour
+  puts "Contour ##{cindex} is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+  contour = contour.h_next
+  cindex+=1
+end 
+
+#
+# CV_RETR_EXTERNAL retrieves only the outer most non "hole" contour
+#
+puts '-'*80
+puts "Detecting using CV_RETR_EXTERNAL and CV_CHAIN_APPROX_SIMPLE"
+contour = mat.find_contours(mode: OpenCV::CV_RETR_EXTERNAL, method: OpenCV::CV_CHAIN_APPROX_SIMPLE)
+cindex=1
+
+while contour
+  puts "Contour ##{cindex} is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+  contour = contour.h_next
+  cindex+=1
+end 
+
+#
+# CV_RETR_CCOMP organizes the contours in a two level deep stack
+# The first level holds the contours
+# The second level contains the holes of the contours in level 1
+#
+# C00001 <-> C00000 <-> C000 <-> C0
+#                         |     |
+#                         V     V
+#                       H0000   H00
+#
+puts '-'*80
+puts "Detecting using CV_RETR_CCOMP and CV_CHAIN_APPROX_SIMPLE"
+contour = mat.find_contours(mode: OpenCV::CV_RETR_CCOMP, method: OpenCV::CV_CHAIN_APPROX_SIMPLE)
+
+# C00001
+puts "Contour #1 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour = contour.h_next
+
+# C00000
+puts "Contour #2 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour = contour.h_next
+
+# C000
+puts "Contour #3 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour_down = contour.v_next
+
+# H0000
+puts "Contour #4 is #{contour_down.contour_area} px^2 (width: #{contour_down.bounding_rect.width}, height: #{contour_down.bounding_rect.height}, type: #{(contour_down.hole?)?"hole":"contour"})"
+contour = contour.h_next
+
+# C0
+puts "Contour #5 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour_down = contour.v_next
+
+# H00
+puts "Contour #6 is #{contour_down.contour_area} px^2 (width: #{contour_down.bounding_rect.width}, height: #{contour_down.bounding_rect.height}, type: #{(contour_down.hole?)?"hole":"contour"})"
+
+#
+# CV_RETR_TREE manages the contours in a tree structure
+# This reconstructs the complete hierarchy of contours and holes that the image displayed
+#
+# C0
+#  |
+#  V
+# H00
+#  |
+#  V
+# C000
+#  |
+#  V
+# H0000-------+
+#  |          |
+#  V          V
+# C00000   C00001
+#
+puts '-'*80
+puts "Detecting using CV_RETR_TREE and CV_CHAIN_APPROX_SIMPLE"
+contour = mat.find_contours(mode: OpenCV::CV_RETR_TREE, method: OpenCV::CV_CHAIN_APPROX_SIMPLE)
+
+# C0
+puts "Contour #1 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour = contour.v_next
+
+# H00
+puts "Contour #2 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour = contour.v_next
+
+# C000
+puts "Contour #3 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour = contour.v_next
+
+# H0000
+puts "Contour #4 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour = contour.v_next
+
+# C00000
+puts "Contour #5 is #{contour.contour_area} px^2 (width: #{contour.bounding_rect.width}, height: #{contour.bounding_rect.height}, type: #{(contour.hole?)?"hole":"contour"})"
+contour_right = contour.h_next
+
+# C00001
+puts "Contour #6 is #{contour_right.contour_area} px^2 (width: #{contour_right.bounding_rect.width}, height: #{contour_right.bounding_rect.height}, type: #{(contour_right.hole?)?"hole":"contour"})"

data/examples/convexhull.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+# convexhull.rb
+# Draw contours and convexity defect points to captured image
+require "rubygems"
+require "opencv"
+include OpenCV
+
+window = GUI::Window.new("convexhull")
+capture = CvCapture::open
+
+accuracy = 1
+t = window.set_trackbar("accuracy", 10, 1) { |v|
+  accuracy = v
+}
+
+circle_options = { color: CvColor::Blue, line_type: :aa, thickness: -1 }
+
+loop do
+  image = capture.query
+
+  # Calculate contours from a binary image
+  gray = image.BGR2GRAY
+  bin = gray.threshold(0x44, 0xFF, :binary)
+  contours = bin.find_contours
+
+  while contours
+    # Draw contours
+    poly = contours.approx(accuracy: accuracy)
+    begin
+      image.draw_contours!(poly, CvColor::Red, CvColor::Black, 2,
+                           thickness: 2, line_type: :aa)
+    end while (poly = poly.h_next)
+
+    # Draw convexity defects
+    hull = contours.convex_hull2(true, false)
+    contours.convexity_defects(hull).each { |cd|
+      image.circle!(cd.start, 3, circle_options)
+      image.circle!(cd.depth_point, 3, circle_options)
+      image.circle!(cd.end, 3, circle_options)
+    }
+    contours = contours.h_next
+  end
+
+  window.show image
+  exit if GUI::wait_key(1)
+end
+