ruby-opencv 0.0.8.pre-mswin32 → 0.0.9.pre2-mswin32

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1c537ec10efac9d5e231685ac6adeaff0253d370
+  data.tar.gz: aaceb07211c27b308b2da2c8f1d509e71924556f
+SHA512:
+  metadata.gz: 924321f87474eb144e53bc4da9d71d5aa0693d9c2a84c3809dae4226be929d387a511a52ed88de226436e4c8c489f6af00b509c9524895125519155a7eb5daaf
+  data.tar.gz: 54f844f2394bf49a4c050e8cae1326db68d46e5c71fc2e26c7b03640bb53ed80e81ddcc8381404ec9509c38e2cfd1dacaa1240a85035ee983e9b0dd0721d03af

data/DEVELOPERS_NOTE.md

@@ -0,0 +1,137 @@
+# DEVELOPER'S NOTE
+
+## Requirement to develop ruby-opencv
+
+* OpenCV
+* Git
+* Microsoft Visual C++ (for mswin32)
+  * <http://www.microsoft.com/visualstudio/eng/downloads#d-2010-express>
+* MinGW and MSYS (for mingw32)
+  * gcc, g++ and MSYS are needed.
+  * <http://www.mingw.org>
+* Some gems (see Gemfile)
+  * [bundler](https://github.com/carlhuda/bundler/)
+  * [hoe](https://github.com/seattlerb/hoe)
+  * [hoe-gemspec](https://github.com/flavorjones/hoe-gemspec)
+  * [rake-compiler](https://github.com/luislavena/rake-compiler)
+
+
+## Create ruby-opencv gem
+Run the following commands.
+When you use mingw32, use **MSYS console**, or when you use mswin32,
+use [**Visual Studio Command Prompt**](http://msdn.microsoft.com/en-us/library/ms229859.aspx)
+instead of cmd.exe.
+
+```
+$ git clone git://github.com/ruby-opencv/ruby-opencv.git
+$ cd ruby-opencv
+$ git checkout master
+$ bundle install
+$ git ls-files > Manifest.txt
+$ rake gem:spec
+$ rake gem
+```
+**ruby-opencv-x.y.z.gem** will be created in **pkg** directory.
+
+To create pre-build binaries, create a config file firstly:
+
+```yml
+# config.yml
+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
+```
+
+Entries are below:
+
+- **platform**: Target platform (e.g. mingw32, mswin32)
+- **rubies**: Array of target versions of ruby's paths (You can create fat gems if you specify multiple versions of ruby)
+- **extopts**: Array of options to be passed to **extconf.rb**
+
+Then, run the following command:
+
+```
+$ rake gem:precompile CONFIG=config.yml
+```
+
+**ruby-opencv-x.y.z-mingw32.gem** will be created when you use mingw32, or
+**ruby-opencv-x.y.z-x86-mswin32.gem** when you use mswin32.
+
+
+## Install ruby-opencv manually
+### Linux/Mac
+
+```
+$ git clone git://github.com/ruby-opencv/ruby-opencv.git
+$ cd ruby-opencv
+$ git checkout master
+$ ruby ext/opencv/extconf.rb --with-opencv-dir=/path/to/opencvdir
+$ make
+$ make install
+```
+
+Note: **/path/to/opencvdir** is the directory where you installed OpenCV.
+
+
+### Windows (mswin32)
+
+Run the following commands on [**Visual Studio Command Prompt**](http://msdn.microsoft.com/en-us/library/ms229859.aspx).
+
+```
+$ git clone git://github.com/ruby-opencv/ruby-opencv.git
+$ cd ruby-opencv
+$ git checkout master
+$ ruby ext/opencv/extconf.rb --with-opencv-dir=C:\path\to\opencvdir\install  # for your own built OpenCV library
+$ nmake
+$ nmake install
+```
+
+To use pre-built OpenCV libraries, set the following option to extconf.rb.
+
+```
+$ ruby ext/opencv/extconf.rb --with-opencv-include=C:\path\to\opencvdir\build\include --with-opencv-lib=C:\path\to\opencvdir\build\x86\vc10\lib
+```
+
+
+### Windows (mingw32)
+
+Run the following commands on **MSYS console**.
+
+```
+$ git clone git://github.com/ruby-opencv/ruby-opencv.git
+$ cd ruby-opencv
+$ git checkout master
+$ ruby ext/opencv/extconf.rb --with-opencv-dir=/C/path/to/opencvdir/install  # for your own built OpenCV library
+$ make
+$ make install
+```
+
+To use pre-built OpenCV libraries, set the following option to extconf.rb.
+
+```
+$ ruby ext/opencv/extconf.rb --with-opencv-include=/c/path/to/opencvdir/build/include --with-opencv-lib=/c/path/to/opencvdir/build/x86/mingw/lib
+```
+
+
+## Run tests
+
+To run all tests, run **test/runner.rb**
+
+```
+$ cd ruby-opencv/test
+$ ruby runner.rb
+```
+
+To run tests of the specified function, run a specific test with --name option.
+
+The following sample runs tests for CvMat#initialize
+
+```
+$ cd ruby-opencv/test
+$ ruby test_cvmat.rb --name=test_initialize
+```
+

data/Gemfile

@@ -1,4 +1,4 @@
-source :gemcutter
+source 'https://rubygems.org'
 
 group :development do
   gem "hoe"

data/License.txt

@@ -1,30 +1,30 @@
-The BSD Liscense
-
-Copyright (c) 2008, Masakazu Yonekura
-All rights reserved.
-
-Redistribution and use of this software in source and binary forms, with or without modification, are
-permitted provided that the following conditions are met:
-
-* Redistributions of source code must retain the above
-  copyright notice, this list of conditions and the
-  following disclaimer.
-
-* Redistributions in binary form must reproduce the above
-  copyright notice, this list of conditions and the
-  following disclaimer in the documentation and/or other
-  materials provided with the distribution.
-
-* Neither the name of Masakazu Yonekura. nor the names of its
-  contributors may be used to endorse or promote products
-  derived from this software without specific prior
-  written permission of Masakazu Yonekura.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
-WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
-TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
-ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+The BSD License
+
+Copyright (c) 2008, Masakazu Yonekura
+All rights reserved.
+
+Redistribution and use of this software in source and binary forms, with or without modification, are
+permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above
+  copyright notice, this list of conditions and the
+  following disclaimer.
+
+* Redistributions in binary form must reproduce the above
+  copyright notice, this list of conditions and the
+  following disclaimer in the documentation and/or other
+  materials provided with the distribution.
+
+* Neither the name of Masakazu Yonekura. nor the names of its
+  contributors may be used to endorse or promote products
+  derived from this software without specific prior
+  written permission of Masakazu Yonekura.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/Manifest.txt

@@ -1,10 +1,12 @@
 .gitignore
+DEVELOPERS_NOTE.md
 Gemfile
 History.txt
 License.txt
 Manifest.txt
-README.rdoc
+README.md
 Rakefile
+config.yml
 examples/alpha_blend.rb
 examples/box.png
 examples/box_in_scene.png
@@ -108,15 +110,13 @@ ext/opencv/cvutils.cpp
 ext/opencv/cvutils.h
 ext/opencv/cvvideowriter.cpp
 ext/opencv/cvvideowriter.h
+ext/opencv/extconf.rb
 ext/opencv/gui.cpp
 ext/opencv/gui.h
 ext/opencv/iplconvkernel.cpp
 ext/opencv/iplconvkernel.h
 ext/opencv/iplimage.cpp
 ext/opencv/iplimage.h
-ext/opencv/lib/opencv.rb
-ext/opencv/lib/opencv/psyched_yaml.rb
-ext/opencv/lib/opencv/version.rb
 ext/opencv/mouseevent.cpp
 ext/opencv/mouseevent.h
 ext/opencv/opencv.cpp
@@ -127,11 +127,13 @@ ext/opencv/trackbar.cpp
 ext/opencv/trackbar.h
 ext/opencv/window.cpp
 ext/opencv/window.h
-extconf.rb
 images/CvMat_sobel.png
 images/CvMat_sub_rect.png
 images/CvSeq_relationmap.png
 images/face_detect_from_lena.jpg
+lib/opencv.rb
+lib/opencv/psyched_yaml.rb
+lib/opencv/version.rb
 ruby-opencv.gemspec
 test/helper.rb
 test/runner.rb

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 and OpenCV 2.4.5 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, 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
+

data/Rakefile

@@ -1,27 +1,36 @@
-# -*- mode: ruby; coding: utf-8-unix -*-
+# -*- mode: ruby; coding: utf-8 -*-
 require 'rubygems'
-require './ext/opencv/lib/opencv/psyched_yaml'
+require "rubygems/ext"
+require "rubygems/installer"
 require 'hoe'
 require 'rake/extensiontask'
+require 'fileutils'
+require './lib/opencv/psyched_yaml'
+
+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.rdoc'
+  s.readme_file  = 'README.md'
   s.history_file = 'History.txt'
-  s.spec_extras = { :extensions => ['extconf.rb'] }
+
+  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']
 
   Rake::ExtensionTask.new('opencv', spec) do |ext|
-    ext.lib_dir = File.join('lib', 'opencv')
+    ext.lib_dir = 'lib'
   end
 end
 
@@ -29,4 +38,53 @@ 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
+
 # vim: syntax=ruby