2013-01-26 22:31:21 -05:00
# ruby-opencv
An OpenCV wrapper for Ruby.
* Web site: < https: // github . com / ruby-opencv / ruby-opencv >
2013-03-24 06:50:22 -04:00
* Ruby 1.9.3, 2.0.0 and OpenCV 2.4.4 are supported.
2013-01-26 22:31:21 -05:00
## 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, mingw32).
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 (for mswin32)** or **C:\opencv\build\x86\mingw\bin (for mingw32)** 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