Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
ffi ruby wrapper for opencv
Ruby CMake
branch: master

README.md

Ruby Bindings for OpenCV

ROpenCV is a ffi ruby binding for the Open Source Computer Vision Library OpenCV.

Unlike other OpenCV ruby binding projects like ruby-opencv or opencv-ffi this binding is automatically generated by parsing the OpenCV C++ headers having the following advantages:

  • automatically up-to-date
  • full API coverage
  • closely match the original C++ interface

State:

  • All marked methods in the OpenCV C++ header are wrapped
  • Memory management needs review
  • Currently, no support for multi threading or GPU

License

ROpenCV is released under a BSD license, it is free for both academic and commercial use.

Compatibility Notes

ROpenCV should run on any platform which supports Ruby and OpenCV 2.4.4 or higher. It has been successfully tested on the following platforms.

  • Linux with Ruby 1.9.3 and OpenCV 2.4.4 - 2.4.6
  • Mac OSX with Ruby 1.9.3 and OpenCV 2.4.4 - 2.4.6

Installation

After running the following commands, ROpenCV and all the mandatory dependencies should be installed:

Ubuntu / Debian

Usage

require 'ropencv'
include OpenCV
m = cv::Mat.new(3,3,cv::CV_64FC1)

Example

require 'ropencv'
include OpenCV

mat = cv::imread("logo.png")
detector = cv::FeatureDetector::create("SURF")
keypoints = Std::Vector.new(cv::KeyPoint)
detector.detect(mat,keypoints)

puts "found #{keypoints.size} keypoints"
puts "first keypoint is at #{keypoints[0].pt.x}/#{keypoints[0].pt.y}"

cv::draw_keypoints(mat,keypoints,mat)
cv::imshow("key_points",mat)
cv::wait_key(-1)
Something went wrong with that request. Please try again.