add installation document for Windows (RubyInstaller)
This commit is contained in:
parent
37c730f631
commit
b7892c80e3
|
@ -0,0 +1,83 @@
|
|||
# Install ruby-opencv with RubyInstaller on Windows
|
||||
|
||||
This document shows how to install ruby-opencv with RubyInstaller on Windows.
|
||||
|
||||
Official OpenCV binary for MinGW32 is no longer distributed, so when you use ruby-opencv with RubyInstaller, you should build OpenCV yourself using Devkit.
|
||||
|
||||
|
||||
## Requirement
|
||||
- Windows 10 64bit
|
||||
- [Ruby 2.3.0p0 x64-mingw32 on RubyInstaller](http://rubyinstaller.org/)
|
||||
- [Devkit (DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe)](http://rubyinstaller.org/add-ons/devkit/)
|
||||
- [OpenCV 2.4.13](https://sourceforge.net/projects/opencvlibrary/)
|
||||
- [CMake 3.6.0 x64](https://cmake.org/)
|
||||
|
||||
|
||||
## How to install OpenCV and ruby-opencv
|
||||
### Download and extract OpenCV
|
||||
|
||||
Download OpenCV library from https://sourceforge.net/projects/opencvlibrary/ and extract it.
|
||||
|
||||
|
||||
### Create OpenCV Makefile with CMake
|
||||
|
||||
Open ```cmd.exe``` and run the following commands.
|
||||
|
||||
```
|
||||
D:\>set DEVKIT_PATH=D:/local/devkit
|
||||
D:\>set SOURCE_PATH=D:/work/opencv-2.4.13/sources
|
||||
D:\>set OPENCV_INSTALL_PATH=D:/opencv-2.4.13
|
||||
D:\>cmake %SOURCE_PATH% -G"MinGW Makefiles" -DCMAKE_INSTALL_PREFIX=%OPENCV_INSTALL_PATH% -DCMAKE_MAKE_PROGRAM=%DEVKIT_PATH%/mingw/bin/mingw32-make.exe -DCMAKE_C_COMPILER=%DEVKIT_PATH%/mingw/bin/gcc.exe -DCMAKE_CXX_COMPILER=%DEVKIT_PATH%/mingw/bin/g++.exe -DBUILD_PERF_TESTS=OFF
|
||||
```
|
||||
|
||||
In this document, I assume that the Devkit is installed to ```D:/local/devkit```, the OpenCV library is extracted to ```D:/work/opencv-2.4.13``` and its source directory is ```D:/work/opencv-2.4.13/sources```, and the output will be installed in ```D:/opencv-2.4.13```.
|
||||
|
||||
Note that ```D:\>``` is a prompt of ```cmd.exe```, so you should not input it.
|
||||
|
||||
|
||||
### Build OpenCV with DevKit
|
||||
|
||||
Run the following commands in ```cmd.exe```.
|
||||
|
||||
```
|
||||
D:\>%DEVKIT_PATH%/mingw/bin/mingw32-make.exe
|
||||
D:\>%DEVKIT_PATH%/mingw/bin/mingw32-make.exe install
|
||||
```
|
||||
|
||||
|
||||
### Install ruby-opencv
|
||||
|
||||
Run the following commands in ```cmd.exe```.
|
||||
|
||||
```
|
||||
D:\>path %OPENCV_INSTALL_PATH%\x64\mingw\bin;%DEVKIT_PATH%\mingw\bin;%PATH%
|
||||
D:\>gem install ruby-opencv -- --with-opencv-include=%OPENCV_INSTALL_PATH%/include --with-opencv-lib=%OPENCV_INSTALL_PATH%/x64/mingw/lib
|
||||
```
|
||||
|
||||
And try to use ruby-opencv.
|
||||
|
||||
```
|
||||
D:\>irb
|
||||
irb(main):001:0> require 'opencv'
|
||||
=> true
|
||||
irb(main):002:0> OpenCV::CV_VERSION
|
||||
=> "2.4.13"
|
||||
```
|
||||
|
||||
Note that the paths ```%OPENCV_INSTALL_PATH%\x64\mingw\bin``` and ```%DEVKIT_PATH%\mingw\bin``` must **ALWAYS** be set when using ```ruby-opencv```, or you may get the following error.
|
||||
|
||||
```
|
||||
D:\>irb
|
||||
irb(main):001:0> require 'opencv'
|
||||
LoadError: 126: The specified module could not be found. - D:/local/ruby/lib/ruby/gems/2.3.0/gems/ruby-opencv-0.0.17/lib/opencv.so
|
||||
from D:/local/ruby/lib/ruby/site_ruby/2.3.0/rubygems/core_ext/kernel_require.rb:133:in `require'
|
||||
from D:/local/ruby/lib/ruby/site_ruby/2.3.0/rubygems/core_ext/kernel_require.rb:133:in `rescue in require'
|
||||
from D:/local/ruby/lib/ruby/site_ruby/2.3.0/rubygems/core_ext/kernel_require.rb:40:in `require'
|
||||
from D:/local/ruby/lib/ruby/gems/2.3.0/gems/ruby-opencv-0.0.17/lib/opencv.rb:8:in `rescue in <top (required)>'
|
||||
from D:/local/ruby/lib/ruby/gems/2.3.0/gems/ruby-opencv-0.0.17/lib/opencv.rb:5:in `<top (required)>'
|
||||
from D:/local/ruby/lib/ruby/site_ruby/2.3.0/rubygems/core_ext/kernel_require.rb:133:in `require'
|
||||
from D:/local/ruby/lib/ruby/site_ruby/2.3.0/rubygems/core_ext/kernel_require.rb:133:in `rescue in require'
|
||||
from D:/local/ruby/lib/ruby/site_ruby/2.3.0/rubygems/core_ext/kernel_require.rb:40:in `require'
|
||||
from (irb):1
|
||||
from D:/local/ruby/bin/irb.cmd:19:in `<main>'
|
||||
```
|
Loading…
Reference in New Issue