Windows で OpenCV バージョン 3.0.0 ベータをビルド

OpenCV (Open Computer Vision Library) とは，実時間コンピュータビジョン (real time computer vision) のアルゴリズムと文書とサンプルコードの集まり．

このページでは，Windows での OpenCV バージョン 3.0.0 ベータのインストール手順を図解等で説明する．

インストール手順
使ってみる

* 参考 Web ページ: https://opencv.org

前準備

Visual Studio Community 2013 のインストール
別の Web ページで、Visual Studio Community 2013 のインストールについて説明している．
cmake のインストール
別の Web ページで、cmake のインストールについて説明している．

インストール手順

Web ページを開く
http://sourceforge.net/projects/opencvlibrary/
「Files」をクリック
Windows 版が欲しいので「opencv-win」をクリック
最新版を選ぶ
クリックするとダウンロードが始まる
ダウンロードしたファイルを実行
解凍先ディレクトリを設定する．分かりやすいディレクトリを指定すること
解凍先ディレクトリ (下の図では C:\OpenCV300)を覚えておく
解凍が始まる
環境変数 OPENCV_DIR の設定
参考Webページ: https://docs.opencv.org/trunk/doc/tutorials/introduction/windows_install/windows_install.html#windowssetpathandenviromentvariable
「マイコンピュータ」 → 「プロパティ」 → 「詳細設定」 → 「環境変数」のように操作し、次のように設定する
＜設定例＞
64ビットWindows の場合
- 変数名: OPENCV_DIR
- 変数値: 「C:\OpenCV300\opencv\build\x64」
32ビットWindows の場合
- 変数名: OPENCV_DIR
- 変数値: 「C:\OpenCV300\opencv\build\x86」
環境変数 PATH の設定
「マイコンピュータ」 → 「プロパティ」 → 「詳細設定」 → 「環境変数」のように操作し、次のように設定する
- 変数名: PATH
- 変数値: 「%OPENCV_DIR%\vc12\bin」を追加。（他のパスとは「;」で区切る）

Microsoft Visual C++ を用いて OpenCV 3.0.0 ベータ本体をビルド

cmake-gui を起動
ソースコードのディレクトリと、ビルド結果を置くディレクトリの指定
- ソースコードのディレクトリ: C:/OpenCV300/opencv/sources
- ビルド結果を置くディレクトリ: C:/OpenCV300/opencv/build
「Configure」をクリック
「Use default native compilers」を選ぶ
Microsoft Visual C++ のバージョンを指定し、「Finish」をクリック
BUILD_opencv_world にチェックする．
(オプション) 元の画面で「BUILD_EXAMPLES」をチェック
「Generate」をクリック
OpenCV.sln を開く
Release バージョンを選ぶ
「ビルド (Build)」を選び、「ソリューションのビルド (Build Soulution)」を開始する
ビルドの結果、エラーメッセージが出ていないことを確認
環境変数 OPENCV_DIR の設定
参考Webページ: https://docs.opencv.org/trunk/doc/tutorials/introduction/windows_install/windows_install.html#windowssetpathandenviromentvariable
「マイコンピュータ」 → 「プロパティ」 → 「詳細設定」 → 「環境変数」のように操作し、次のように設定する
- 変数名: OPENCV_DIR
- 変数値: 「C:\OpenCV300\opencv\build」
環境変数 PATH の設定
「マイコンピュータ」 → 「プロパティ」 → 「詳細設定」 → 「環境変数」のように操作し、次のように設定する
- 変数名: PATH
- 変数値: 「%OPENCV_DIR%\bin\release」を追加。（他のパスとは「;」で区切る）

使ってみる

Microsoft Visual Studio 2013 の起動 (launch Microsoft Visual Studio 2003)
「ファイル (File)」 → 「新規 (New)」 → 「プロジェクト (Project)」
Visual C++ の Win32 コンソールアプリケーションを選び、プロジェクト名を付ける (Select "Visual C++" and then "Win32 Console Application")
プロジェクト名は何でも良い
「次へ (Next)」をクリック
空のプロジェクト (Empty Project) を選ぶ
(オプション) 64 ビット Windows を使う場合の設定
1. 「ビルド (Buold)」 →「構成マネージャ (Configuration Manager)」
2. 「プラットフォーム (Platform)」を選ぶ
3. 「新規作成 (New)」を選ぶ
4. 「新しいプラットフォーム (New Platform)」に「x64 (New Platform)」を指定する．
OpenCV に関する設定 (OpenCV Settings)
1. プロパティ・マネージャ (Property Manager)のウインドウを開く (Open a property manager window)
  あとで、プロパティを確認したいときに便利
2. プロジェクトを右クリックしてプロパティ (Properties) を選ぶ (Right click the project, then select the Properties)
3. インクルード・ディレクトリの設定 (Set include directories)
  C/C++ → General と操作し、次のように設定
  - Configuration : All Configurations
  - Additional Include Directories : $(OPENCV_DIR)\include
4. ライブラリ・ディレクトリの設定 (Set library directories)
  Linker → General と操作し、次のように設定
  - Configuration : All Configurations
  - Additional Library Directories : $(OPENCV_DIR)\lib\release
5. ライブラリの設定 (Set libraries)
  Linker → Input と操作し、 Additional Dependencies を選び、次のように設定し、「OK」をクリック
  - Configuration : Active (Debug)
  - Additional Dependencies : opencv_ts300d.lib opencv_world300d.lib
  さらに、次のように設定し、「OK」をクリック
  - Configuration : Active (Release)
  - Additional Dependencies : opencv_ts300.lib opencv_world300.lib
ソースコードの追加操作
1. ソース・ファイル (Source File) を右クリックし、追加 (New) → 新規アイテム (New Item) と操作する
2. 「C++ File (.cpp)」を選び、「追加 (Add)」をクリック

エディタのウインドウを使い，ソースプログラムを入力 (Edit a source program in the editor window)

https://docs.opencv.org/trunk/doc/tutorials/introduction/display_image/display_image.html#display-image に記載のサンプル・コード

「C:\\HappyFish.jpg」のところは、画像ファイル名を設定すること

#include<opencv2/core/core.hpp>
#include<opencv2/imgcodecs.hpp>
#include<opencv2/highgui/highgui.hpp>

#include<iostream>
#include<string>

using namespace cv;
using namespace std;

int main( int argc, char** argv )
{
    string imageName("C:\\HappyFish.jpg"); 
    if( argc > 1)
    {
        imageName = argv[1];
    }

    Mat image;
    image = imread(imageName.c_str(), IMREAD_COLOR); // Read the file

    if( image.empty() )                      // Check for invalid input
    {
        cout <<  "Could not open or find the image" << std::endl ;
        return -1;
    }

    namedWindow( "Display window", WINDOW_AUTOSIZE ); // Create a window for display.
    imshow( "Display window", image );                // Show our image inside it.

    waitKey(0); // Wait for a keystroke in the window
    return 0;
}

ビルド (Build)
プロジェクト名（下の画面では「ConsoleApplication」）を選び，「ビルド」と操作する

ビルドの正常終了を確認する．
開始 (Start)
「デバッグ (Debug)」→「Start Without Debugging」　（または CTRL + F5キー）. ウインドウが現れるので，結果を確認．