50
OpenCV2.2 Install Guide

OpenCV2.2 Install Guide ver.0.5

Embed Size (px)

DESCRIPTION

2011/4/18 OpenCV2.2 Install Guide ver.0.5 http://kgxpx834.blog58.fc2.com/blog-entry-23.html

Citation preview

Page 1: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Page 2: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

1

目次

OpenCV2.2 Install Guide (Win32)

Install Guideの対象 ...................................................................................................... 2

ダウンロード .................................................................................................................. 3

ソリューションファイルの生成(CMake) ..................................................................... 11

ビルド ........................................................................................................................... 16

OpenCVの設定 ............................................................................................................ 18

確認............................................................................................................................... 19

OpenCV2.2 Install Guide (x64)

Install Guideの対象 .................................................................................................... 21

ダウンロード ................................................................................................................ 22

ソリューションファイルの生成(CMake) ..................................................................... 32

ビルド ........................................................................................................................... 37

OpenCVの設定 ............................................................................................................ 39

確認............................................................................................................................... 40

OpenCV SVN (trunk,tag,branchについて) ........................................................... 42

Visual Studio 2010のプロパティシートについて ...................................................... 45

参考サイト .................................................................................................................... 47

履歴............................................................................................................................... 47

連絡先 ........................................................................................................................... 47

著作権表記 .................................................................................................................... 48

その他 ........................................................................................................................... 49

Page 3: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

2

OpenCV2.2 Install Guide (Win32)

Install Guide の対象

本 Guide では,OpenCV2.2 を以下の環境を対象として開発環境を構築する.なお,OS

及び IDE はインストール及びセットアップが終わっているものとする.また,表の環境以

外に OpenCVの Visual Studio用ソリューションファイル生成に CMakeを用いる.

本 Guide では,OpenCV 以外にインストールするもの(TBB,CUDA など)に関しても,

開発環境を整えています.

Table 1. 環境

OS Microsoft Windows7 SP1 32bit

IDE Microsoft Visual Studio 2008 SP1 (VC++)

Microsoft Visual Studio 2010 SP1 (VC++) *1

OpenCV

OpenCV2.2

TBB

CUDA

Qt

Eigen

IPP *2

*1 Visual Studio 2010については下記の事項を参照して下さい.

*2 本 Guideでは用いなかった.

※開発環境の構築中に,Windowsの UAC(User Account Control:ユーザーアカウント制

御)が警告を出し,インストール作業などが上手くいかない場合がある.インストール作業

中は,UACを通知しない設定にしておくと回避できる.

※インストール作業を始める前に“OpenCV SVN (trunk,tag,branchについて)”を参照

して,インストールする OpenCVのリリース項目を選んで下さい.

※Visual Studio 2010のパス設定方法は,“Visual Studio 2010のプロパティシートについ

て”を参照して下さい.

Page 4: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

3

ダウンロード

必要なものをダウンロード及びセットアップする.

① OpenCV2.2

以下の URLから OpenCV2.2“OpenCV-2.2.0-win.zip”をダウンロードする.

http://sourceforge.net/projects/opencvlibrary/files/opencv-win/2.2/

圧縮ファイルを解凍して以下のディレクトリに置く.

C:¥Program Files¥OpenCV-2.2.0¥

Page 5: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

4

② TBB

以下の URLから TBB安定版の最新バージョン“tbb30_◯◯◯oss_win.zip”*3をダウン

ロードする. *3 ◯はバージョン番号

http://threadingbuildingblocks.org/file.php?fid=77

圧縮ファイルを解凍して以下のディレクトリに置く.

C:¥Program Files¥tbb30_◯◯◯oss¥

環境変数と Visual Studioにパスを設定する.*4

*4 以降のパスの設定では設定するパスのみ表記する.それぞれ読み替えて設定すること.

【環境変数】

[コントロールパネル]>[システム]>[システムの詳細設定]を押して,“システムのプ

ロパティ”ウィンドウを表示する.[詳細設定]タブの[環境変数]を押して,“環境変

数”ウィンドウを表示する.[システムの環境変数]欄の“Path”を選択し,[編集]

を押す.“システム変数の編集”ウィンドウが表示されるので,変数値に以下のパス

を追加する.*5

*5 設定してあるパスは消さないように注意すること.最悪の場合 OSが起動しなくなります.

・TBB30_INSTALL_DIR *6

*6 初期状態では変数が無いので,[新規]を押して作成する.以降の説明で変数名のないものは新規に作る

C:¥Program Files¥tbb30_◯◯◯oss

【解説】

TBB(Threading Building Blocks)は,Intelのマルチコア CPUを用いた並列

プログラミングのための C++テンプレートクラスライブラリです.TBBをイ

ンストールすることで,OpenCV内部の並列処理機能を有効にします.利用

には,Intelのマルチコア CPUを推奨します.

Page 6: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

5

・Path *7

*7 既に設定してある変数値の後ろに追加する.先頭のセミコロンを忘れないこと.

;%TBB30_INSTALL_DIR%¥bin¥ia32¥vc○ *8

*8 ○は利用する Visual Studioのバージョンに合わせる.2008なら 9,2010なら 10を指定.

【Visual Studio】

Visual Studioを開き,[ツール]>[オプション]を押して,“オプション”ウィンドウ

を表示する.左のツリーから[プロジェクトおよびソリューション]>[VC++ディレク

トリ]を選択する.右側に表示される[ディレクトリを表示するプロジェクト]欄を以

下の 3つに切り替えてそれぞれパスを設定する.

・実行可能ファイル

$(TBB30_INSTALL_DIR)¥bin¥ia32¥vc○

・インクルード ファイル

$(TBB30_INSTALL_DIR)¥include

・ライブラリ ファイル

$(TBB30_INSTALL_DIR)¥lib¥ia32¥vc○

Page 7: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

6

③ CUDA

以下の URLから NVIDIA GPUの最新バージョンのドライバをダウンロード及びインス

トールする.

http://www.nvidia.co.jp/Download/index.aspx?lang=jp

以下の URLから CUDA3.2の必要なファイルをダウンロードする.

http://developer.nvidia.com/object/cuda_3_2_downloads.html

・CUDA Toolkit“cudatoolkit_3.2.16_win_32.msi”

・GPU Computing SDK code samples“gpucomputingsdk_3.2.16_win_32.exe”

・NVIDIA Performance Primitives (NPP) library“npp_3.2.16_win_32.zip”

CUDA Toolkit及び GPU Computing SDK code samplesを実行ファイルからインストー

ルする. *9

*9 CUDA Toolkit及び GPU Computing SDK code samplesのインストール途中に利用者登録情報の入力画面が出てきますが,必要

な項目を入力,更新情報の必要/不要を選択すれば次に進めます.

NVIDIA Performance Primitives (NPP) library の圧縮ファイルを解凍して以下のディ

レクトリに置く. *10

*10 NPPの README.TXTのように CUDA Toolkitのパスにファイルをコピーすると OpenCVの CMakeが見つけられない.

C:¥Program Files¥npp_3.2.16_win_32¥SDK

【解説】

CUDA(Compute Unified Device Architecture)は,NVIDIAの汎用計算向け

の GPUプログラミング開発環境です.OpenCVには,画像処理や特徴点検出

などを GPU上に実装して高速に処理できる機能が含まれています.GPU機

能の利用には,NVIDIAの CUDA対応 GPUを必要とします.また,Fermi

以降かつミドルレンジ以上の GPUを推奨します.

Page 8: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

7

環境変数と Visual Studioにパスを設定する.

【環境変数】

・NPP_ROOT_DIR

C:¥Program Files¥npp_3.2.16_win_32¥SDK

・Path

;%NPP_ROOT_DIR%¥common¥npp¥bin

【Visual Studio】

・実行可能ファイル

$(CUDA_BIN_PATH)

$(NPP_ROOT_DIR)¥common¥npp¥bin

・インクルード ファイル

$(CUDA_INC_PATH)

$(NVSDKCOMPUTE_ROOT)¥C¥common¥inc

$(NVSDKCOMPUTE_ROOT)¥shared¥inc

$(NPP_ROOT_DIR)¥common¥npp¥include

・ライブラリ ファイル

$(CUDA_LIB_PATH)

$(NVSDKCOMPUTE_ROOT)¥C¥common¥lib

$(NVSDKCOMPUTE_ROOT)¥shared¥lib

$(NPP_ROOT_DIR)¥common¥npp¥lib

※CUDA3.2は Visual Studio 2010に対応していません.Visual Studio 2010は CUDA4.0

からの対応となります.CUDA4.0のリリースに合わせて OpenCVも対応すると思われま

す.

Page 9: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

8

④ Qt

以下の URL から最新バージョンの Windows 版 Qt ライブラリ“qt-win-opensource-4.

◯.◯-vs2008.exe”をダウンロード,インストールする.

http://qt.nokia.com/downloads-jp

環境変数と Visual Studioのパスを設定する.

【環境変数】

・QTDIR

C:¥Qt¥4.◯.◯

・Path

;%QTDIR%¥bin

【Visual Studio】

・実行可能ファイル

$(QTDIR)¥bin

・インクルード ファイル

$(QTDIR)¥include

・ライブラリ ファイル

$(QTDIR)¥lib

【解説】

Qtは,Nokiaのクロスプラットフォームなアプリケーション・ユーザーイン

ターフェース開発フレームワークです.OpenCVでは,Qtをインストールす

ることで,以前からのシンプルな GUIに加え,リッチな GUIを使えるよう

になります.

Page 10: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

9

⑤ Eigen

以下の URL から Eigen 安定版の最新バージョン“eigen-2.0.◯◯.zip”をダウンロード

する.

http://eigen.tuxfamily.org/index.php?title=Main_Page#Download

圧縮ファイルを解凍して以下のディレクトリに置く.右のディレクトリ構造図を参照し

て下さい.

C:¥Program Files¥eigen¥

環境変数と Visual Studioにパスを設定する.

【環境変数】

・EIGEN_DIR

C:¥Program Files¥eigen

【Visual Studio】

・インクルード ファイル

$(EIGEN_DIR)

【解説】

Eigenは,フリーの行列・ベクトル演算ライブラリです.様々な行列・ベクト

ル演算を SIMD拡張命令を用いて高速に処理できます.OpenCVでは,Eigen

の行列と cv::Matを相互に変換でき,Eigenの高機能な行列・ベクトル演算を

利用しやすくなっています.

Program Files

eigen

Eigen

src

Array

Core

Eigen

Page 11: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

10

⑥ CMake

以下の URLから CMake“cmake-2.○.○-win32-x86.exe”をダウンロード,インストー

ルする.

http://www.cmake.org/cmake/resources/software.html

【解説】

CMakeは,ソフトウェアのビルドを自動化するためのクロスプラットフォー

ムなシステムです.OpenCV では,標準で用意されているバイナリを用いな

い場合は,CMakeを用いてソリューションファイルを作成,ビルドします.

Page 12: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

11

ソリューションファイルの生成(CMake)

CMakeを使って Visual Studio用のソリューションファイルを生成する.

① [スタートメニュー ]>[すべてのプログラム ]>[CMake ◯◯ ]の中にある CMake

(cmake-gui)を起動する.

② [Where is the source code:]の[Browse Source…]を押し,以下のパスを指定する.

C:¥Program Files¥OpenCV-2.2.0

③ [Where is build the binaries:]の[Browse Source…]を押し,以下のパスを指定する.

C:¥Program Files¥OpenCV-2.2.0¥build

④ [Configure]を押し,[Specify the generator for this project]で利用する IDE(Visual

Studio)を選び[Finish]を押す.Visual Studio 製品名と内部バージョンの対応は以下

のとおり.

Table 2. Visual Studio製品名と内部バージョンの対応

Visual Studio 製品名 内部バージョン

Visual Studio 6.0 6

Visual Studio .NET 7

Visual Studio .NET 2003 7.1

Visual Studio 2005 8

Visual Studio 2008 9

Visual Studio 2010 10

Page 13: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

12

⑤ 下の欄に現在の設定での出力及びエラー内容,中央の欄に選択できるオプションの一

覧が表示されます.以下に初期状態の出力の一部を示します.

Could NOT find PythonInterp (missing: PYTHON_EXECUTABLE)

Could NOT find PythonLibs (missing: PYTHON_LIBRARIES PYTHON_INCLUDE_DIRS)

Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE)

Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE)

“Could NOT find ◯◯◯◯(missing:◯◯◯◯)”などはオプションを指定しているが

必要な情報が見つからないということを示しています.オプションを指定する場合,

必要な情報の指定漏れか間違っている可能性があるので,中央の欄でオプションの設

定を確認します.また,オプションを必要としない場合,中央の欄でオプションの設

定を外します.

General configuration for opencv 2.2.0 =====================================

Built as dynamic libs?: ON

GUI:

Win32 UI: 1

Image I/O:

JPEG: build

PNG: build

TIFF: build

JPEG 2000: build

OpenEXR: NO

Video I/O:

VideoInput: 1

Interfaces:

Use IPP: NO

Use TBB: NO

Use Cuda: No

Use Eigen2: NO

-----------------------------------------------------------------

“General configuration for opencv 2.2.0=”以降は現在の出力設定の一覧を示してい

ます.

Page 14: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

13

⑥ 中央の欄でオプションを設定します.

CMakeでは,中央の欄でのオプションの設定と[Configure]を繰り返して出力設定

をしていきます.[Configure]を押すたびに,下の欄のエラーや出力設定の一覧が

更新されます.

1. TBB

[WITH_TBB]にチェックを入れ,[Configure]を押します.

新たに[TBB_INCLUDE_DIR]が表示されるので,TBB の include を指定し,

[Configure]を押します.

C:¥Program Files¥tbb30_◯◯◯oss¥include

新たに[TBB_LIB_DIR]が表示されるので,TBB の lib¥ia32¥vc9 を指定し,

[Configure]を押します.

C:¥Program Files¥tbb30_◯◯◯oss¥lib¥ia32¥vc9

2. CUDA

[WITH_CUDA]にチェックを入れ,[Configure]を押します.

新たに以下のオプションが表示されるので,それぞれ設定し,[Configure]を押し

ます.

[CUDA_BUILD_CUBIN]

チェック無し

[CUDA_BUILD_EMULATION]

チェック無し

[CUDA_COMPUTE_CAPABILITES]

1.1 1.2 1.3 2.0 *11

*11 Compute Capabiliteyは,CUDA-Zなどを使って確認できる.利用する GPUに合わせて変更する?

[CUDA_NPP_LIBRARY_ROOT_DIR]

C:/Program Files/npp_3.2.16_win_32/SDK

[CUDA_SDK_ROOT_DIR]

C:¥ProgramData¥NVIDIA Corporation¥NVIDIA GPU Computing

SDK 3.2¥C

[CUDA_TOOLKIT_ROOT_DIR]

C:¥Program Files¥NVIDIA GPU Computing Toolkit¥CUDA¥v3.2

[CUDA_VERBOSE_BUILD]

チェック無し

Page 15: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

14

3. Qt

[WITH_QT]と[WITH_QT_OPENGL]にチェックを入れ,[Configure]を押します.

[QT_QMAKE_EXECUTABLE]に Qt の bin¥qmake.exe を指定し,[Configure]

を押します.

C:/Qt/4.◯.◯/bin/qmake.exe

4. Eigen

[WITH_EIGEN2]にチェックを入れ,[Configure]を押します.

[EIGEN2_INCLUDE_PATH]に Eigen の¥include を指定し,[Configure]を押し

ます.

C:¥Program Files¥eigen *12

*12 eigenフォルダと Eigenフォルダの違いに注意.ダウンロード>⑤Eigenのディレクトリ構造図を参照.

5. IPP

[USE_IPP]にチェックを入れ,[IPP_PATH]を設定し,[Configure]を押すことで有

効になります.今回は詳細の説明は省きます.

6. その他

その他の設定を確認していきます.

・サンプルプログラムが必要な場合

[INSTALL_C_EXAMPLES](,[INSTALL_PYTHON_EXAMPLES])と

[BUILD_EXAMPLES]にチェックを入れ,[Configure]を押します.*13

*13 [INSTALL_◯_EXAMPLES]のみの場合,プロジェクトファイルは生成されない.

・Pythonが不要な場合

[BUILD_NEW_PYTHON_SUPPORT]のチェックを外して,[Configure]

を押します.

⑦ 下の欄に現在の設定での出力を確認します.以下にオプション設定後の出力の一部を

示します.

CUDA detected: 3.2

NPP detected: 3.2.16

General configuration for opencv 2.2.0 =====================================

Built as dynamic libs?: ON

GUI:

Page 16: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

15

QT 4.x: 1

QT OpenGL support: 1

Image I/O:

JPEG: build

PNG: build

TIFF: build

JPEG 2000: build

OpenEXR: NO

Video I/O:

VideoInput: 1

Interfaces:

Python: OFF

Use IPP: NO

Use TBB: YES

Use Cuda: YES

Use Eigen2: YES

-----------------------------------------------------------------

“General configuration for opencv 2.2.0 =”以降に注目してください.“GUI”

“ImageI/O”“VideoI/O”“Interfaces”“Documentation”の出力設定を確認します.

⑧ 最後に[Generate]ボタンを押してソリューションファイルを生成します.

[Where is build the binaries:]に設定した出力ディレクトリに OpenCVのソリューシ

ョンファイルが生成されていることを確認し,CMakeを閉じます.

Page 17: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

16

ビルド

OpenCVのビルドを行う前にファイルの修正を行います.

OpenCV では,Web カメラから動画像をキャプチャして処理を行うことが多いです.し

かし,OpenCV2.2 tag版にはカメラキャプチャにバグがあります.このままではWebカメ

ラなどを利用することができません.

以下の URLから,修正済みのファイル(precomp.hpp)をダウンロードして差し替える(下

の“Zip Archive”からダウンロード),または訂正該当箇所を書き換えます.

C:¥Program Files¥OpenCV-2.2.0¥modules¥highgui¥src¥precomp.hpp

https://code.ros.org/trac/opencv/changeset/4383

修正が完了したら,出力ディレクトリ(OpenCV-2.2.0¥build¥)に作成された OpenCV の

ソリューションファイル“OpenCV.sln”を Visual Studioで開きます.

Page 18: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

17

Visual Studioのメニューから[ビルド]>[バッチビルド]を押します.

“バッチビルド”ウィンドウが表示されるので,[ALL_BUILD]の Debug,Releaseの両

方にチェックをつけ,[ビルド]を押します.

ビルドが終わり,出力ログを見て“0 失敗”ならば成功です.

Page 19: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

18

OpenCV の設定

環境設定と Visual Studioにパスを設定する.

【環境変数】

・OPENCV

C:¥Program Files¥OpenCV-2.2.0

・Path

;%OPENCV%¥build¥bin¥Debug

;%OPENCV%¥build¥bin¥Release

【Visual Studio】

・実行可能ファイル

$(OPENCV)¥build¥bin¥Debug

$(OPENCV)¥build¥bin¥Release

・インクルード ファイル

$(OPENCV)¥include

$(OPENCV)¥modules¥calib3d¥include

$(OPENCV)¥modules¥contrib¥include

$(OPENCV)¥modules¥core¥include

$(OPENCV)¥modules¥features2d¥include

$(OPENCV)¥modules¥ffmpeg

$(OPENCV)¥modules¥flann¥include

$(OPENCV)¥modules¥gpu¥include

$(OPENCV)¥modules¥haartraining

$(OPENCV)¥modules¥highgui¥include

$(OPENCV)¥modules¥imgproc¥include

$(OPENCV)¥modules¥legacy¥include

$(OPENCV)¥modules¥ml¥include

$(OPENCV)¥modules¥objdetect¥include

$(OPENCV)¥modules¥traincascade

$(OPENCV)¥modules¥video¥include

・ライブラリ ファイル

$(OPENCV)¥build¥lib¥Debug

$(OPENCV)¥build¥lib¥Release

Page 20: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

19

確認

以上の設定を終えたら,実際に開発できるのか確認する.

以下のような単純に画像を読み込み,表示するプログラムを書いてみる.

Visual Studio を開き,[ファイル]>[新規作成]>[プロジェクト]を押し,“新しいプロジェ

クト”のウィンドウを表示する.“プロジェクトの種類”から[Visual C++]>[Win32]を選び,

“テンプレート”から[Win32コンソールアプリケーション]を選ぶ.任意のプロジェクト名

○○○を入力して[OK]を押す.“Win32 アプリケーション ウィザード”が開くので,その

まま[完了]を押してソリューションを作成する.

“ソリューションエクスプローラー”から[○○○]>[ソース ファイル]>[○○○.cpp]を開

き,以下のプログラムを記述する.また,適当な画像ファイルを用意し,ソースファイル

と同じディレクトリに置いておく.ソースコード中の画像ファイル名は適宜変更する.

#include "stdafx.h"

#include <opencv2/opencv.hpp>

#ifdef _DEBUG

#pragma comment(lib, "opencv_core220d.lib")

#pragma comment(lib, "opencv_highgui220d.lib")

#else

#pragma comment(lib, "opencv_core220.lib")

#pragma comment(lib, "opencv_highgui220.lib")

#endif

using namespace cv;

int _tmain(int argc, _TCHAR* argv[])

{

Mat sourceImage = imread("Lenna.bmp");

if(sourceImage.empty()){

cout << "画像ファイルが読み込めませんでした" << std::endl;

return -1;

}

namedWindow("Window", WINDOW_AUTOSIZE);

Page 21: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

20

imshow("Window", sourceImage);

waitKey(0);

return 0;

}

入力できたら,[ビルド]>[ソリューションのビルド]を押してビルドする.ビルドが成功し

たら[デバッグ]>[デバッグ無しで開始]を押し,プログラムを実行する.

エラー無く以下のような画面が出れば,正しく開発環境の構築ができています.

Page 22: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

21

OpenCV2.2 Install Guide (x64)

Install Guide の対象

本 Guide では,OpenCV2.2 を以下の環境を対象として開発環境を構築する.なお,OS

及び IDE はインストール及びセットアップが終わっているものとする.また,表の環境以

外に OpenCVの Visual Studio用ソリューションファイル生成に CMakeを用いる.

本 Guide では,OpenCV 以外にインストールするもの(TBB,CUDA など)に関しても,

開発環境を整えています.

Table 1. 環境

OS Microsoft Windows7 SP1 64bit

IDE Microsoft Visual Studio 2008 SP1 (VC++)

Microsoft Visual Studio 2010 SP1 (VC++) *1

OpenCV

OpenCV2.2

TBB

CUDA

Qt

Eigen

IPP *2

*1 Visual Studio 2010については下記の事項を参照して下さい.

*2 本 Guideでは用いなかった.

※開発環境の構築中に,Windowsの UAC(User Account Control:ユーザーアカウント制

御)が警告を出し,インストール作業などが上手くいかない場合がある.インストール作業

中は,UACを通知しない設定にしておくと回避できる.

※インストール作業を始める前に“OpenCV SVN (trunk,tag,branchについて)”を参照

して,インストールする OpenCVのリリース項目を選んで下さい.

※Visual Studio 2010のパス設定方法は,“Visual Studio 2010のプロパティシートについ

て”を参照して下さい.

Page 23: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

22

ダウンロード

必要なものをダウンロード及びセットアップする.

① OpenCV2.2

以下の URLから OpenCV2.2“OpenCV-2.2.0-win.zip”をダウンロードする.

http://sourceforge.net/projects/opencvlibrary/files/opencv-win/2.2/

圧縮ファイルを解凍して以下のディレクトリに置く.

C:¥Program Files¥OpenCV-2.2.0¥

Page 24: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

23

② TBB

以下の URLから TBB安定版の最新バージョン“tbb30_◯◯◯oss_win.zip”*3をダウン

ロードする. *3 ◯はバージョン番号

http://threadingbuildingblocks.org/file.php?fid=77

圧縮ファイルを解凍して以下のディレクトリに置く.

C:¥Program Files¥tbb30_◯◯◯oss¥

環境変数と Visual Studioにパスを設定する.*4

*4 以降のパスの設定では設定するパスのみ表記する.それぞれ読み替えて設定すること.

【環境変数】

[コントロールパネル]>[システム]>[システムの詳細設定]を押して,“システムのプ

ロパティ”ウィンドウを表示する.[詳細設定]タブの[環境変数]を押して,“環境変

数”ウィンドウを表示する.[システムの環境変数]欄の“Path”を選択し,[編集]

を押す.“システム変数の編集”ウィンドウが表示されるので,変数値に以下のパス

を追加する.*5

*5 設定してあるパスは消さないように注意すること.最悪の場合 OSが起動しなくなります.

・TBB30_INSTALL_DIR *6

*6 初期状態では変数が無いので,[新規]を押して作成する.以降の説明で変数名のないものは新規に作る

C:¥Program Files¥tbb30_◯◯◯oss

【解説】

TBB(Threading Building Blocks)は,Intelのマルチコア CPUを用いた並列

プログラミングのための C++テンプレートクラスライブラリです.TBBをイ

ンストールすることで,OpenCV内部の並列処理機能を有効にします.利用

には,Intelのマルチコア CPUを推奨します.

Page 25: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

24

・Path *7

*7 既に設定してある変数値の後ろに追加する.先頭のセミコロンを忘れないこと.

;%TBB30_INSTALL_DIR%¥bin¥intel64¥vc○ *8

*8 ○は利用する Visual Studioのバージョンに合わせる.2008なら 9,2010なら 10を指定.

【Visual Studio】

Visual Studioを開き,[ツール]>[オプション]を押して,“オプション”ウィンドウ

を表示する.左のツリーから[プロジェクトおよびソリューション]>[VC++ディレク

トリ]を選択する.右側に表示される[プラットフォーム]欄を“x64”に切り替え,[デ

ィレクトリを表示するプロジェクト]欄を以下の 3 つに切り替えてそれぞれパスを

設定する.

・実行可能ファイル

$(TBB30_INSTALL_DIR)¥bin¥intel64¥vc○

・インクルード ファイル

$(TBB30_INSTALL_DIR)¥include

・ライブラリ ファイル

$(TBB30_INSTALL_DIR)¥lib¥intel64¥vc○

Page 26: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

25

③ CUDA

以下の URLから NVIDIA GPUの最新バージョンのドライバをダウンロード及びインス

トールする.

http://www.nvidia.co.jp/Download/index.aspx?lang=jp

以下の URLから CUDA3.2の必要なファイルをダウンロードする.

http://developer.nvidia.com/object/cuda_3_2_downloads.html

・CUDA Toolkit“cudatoolkit_3.2.16_win_64.msi”

・GPU Computing SDK code samples“gpucomputingsdk_3.2.16_win_64.exe”

・NVIDIA Performance Primitives (NPP) library“npp_3.2.16_win_64.zip”

CUDA Toolkit及び GPU Computing SDK code samplesを実行ファイルからインストー

ルする. *9

*9 CUDA Toolkit及び GPU Computing SDK code samplesのインストール途中に利用者登録情報の入力画面が出てきますが,必要

な項目を入力,更新情報の必要/不要を選択すれば次に進めます.

NVIDIA Performance Primitives (NPP) libraryの圧縮ファイルを解凍して以下のディ

レクトリに置く. *10

*10 NPPの README.TXTのように CUDA Toolkitのパスにファイルをコピーすると OpenCVの CMakeが見つけられない.

C:¥Program Files¥npp_3.2.16_win_64¥SDK

【解説】

CUDA(Compute Unified Device Architecture)は,NVIDIAの汎用計算向け

の GPUプログラミング開発環境です.OpenCVには,画像処理や特徴点検出

などを GPU上に実装して高速に処理できる機能が含まれています.GPU機

能の利用には,NVIDIAの CUDA対応 GPUを必要とします.また,Fermi

以降かつミドルレンジ以上の GPUを推奨します.

Page 27: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

26

環境変数と Visual Studioにパスを設定する.

【環境変数】

・NPP_ROOT_DIR

C:¥Program Files¥npp_3.2.16_win_64¥SDK

・Path

;%NPP_ROOT_DIR%¥common¥npp¥bin

【Visual Studio】

・実行可能ファイル

$(CUDA_BIN_PATH)

$(NPP_ROOT_DIR)¥common¥npp¥bin

・インクルード ファイル

$(CUDA_INC_PATH)

$(NVSDKCOMPUTE_ROOT)¥C¥common¥inc

$(NVSDKCOMPUTE_ROOT)¥shared¥inc

$(NPP_ROOT_DIR)¥common¥npp¥include

・ライブラリ ファイル

$(CUDA_LIB_PATH)

$(NVSDKCOMPUTE_ROOT)¥C¥common¥lib

$(NVSDKCOMPUTE_ROOT)¥shared¥lib

$(NPP_ROOT_DIR)¥common¥npp¥lib

※CUDA3.2は Visual Studio 2010に対応していません.Visual Studio 2010は CUDA4.0

からの対応となります.CUDA4.0のリリースに合わせて OpenCVも対応すると思われま

す.

Page 28: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

27

④ Qt

以下の URLから最新バージョンの Qtライブラリのソースコード

“qt-everywhere-opensource-src-4.◯.◯.zip”をダウンロードする.

http://qt.nokia.com/downloads-jp

圧縮ファイルを解凍して以下のパスに置く.

C:¥Qt¥4.◯.◯x64¥

スタートメニューの[すべてのプログラム]>[Microsoft Visual Studio ◯]>[Visual Studio

Tools]から“Visual Studio ◯ x64 Win64コマンドプロンプト”を開く.

【解説】

Qtは,Nokiaのクロスプラットフォームなアプリケーション・ユーザーイン

ターフェース開発フレームワークです.OpenCVでは,Qtをインストールす

ることで,以前からのシンプルな GUIに加え,リッチな GUIを使えるよう

になります.

Page 29: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

28

以下のコマンドで Qtのmakeファイルを生成する.

[コマンド] [操作内容]

cd C:¥Qt¥4.◯.◯x64 Qtのインストールフォルダへ移動

configure メニューの起動

o 商用/オープンソースの選択

y ライセンスの承諾

以下のコマンドで Qtをコンパイルする. *11

*11 Qtのコンパイルには数時間かかるので,OSがスリープモードなどに入らないように電源設定しておく.また,セキュリティソ

フトの自動スキャンなどを OFFにしておくことを推奨する.

[コマンド] [操作内容]

nmake Qtのコンパイル

PCの性能によるが,目安として 3時間程でコンパイルが終わる.

Page 30: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

29

環境変数と Visual Studioのパスを設定する.

【環境変数】

・QTDIR

C:¥Qt¥4.◯.◯x64

・Path

;%QTDIR%¥bin

【Visual Studio】

・実行可能ファイル

$(QTDIR)¥bin

・インクルード ファイル

$(QTDIR)¥include

・ライブラリ ファイル

$(QTDIR)¥lib

Page 31: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

30

⑤ Eigen

以下の URL から Eigen 安定版の最新バージョン“eigen-2.0.◯◯.zip”をダウンロード

する.

http://eigen.tuxfamily.org/index.php?title=Main_Page#Download

圧縮ファイルを解凍して以下のディレクトリに置く.右のディレクトリ構造図を参照し

て下さい.

C:¥Program Files¥eigen¥

環境変数と Visual Studioにパスを設定する.

【環境変数】

・EIGEN_DIR

C:¥Program Files¥eigen

【Visual Studio】

・インクルード ファイル

$(EIGEN_DIR)

【解説】

Eigenは,フリーの行列・ベクトル演算ライブラリです.様々な行列・ベクト

ル演算を SIMD拡張命令を用いて高速に処理できます.OpenCVでは,Eigen

の行列と cv::Matを相互に変換でき,Eigenの高機能な行列・ベクトル演算を

利用しやすくなっています.

Program Files

eigen

Eigen

src

Array

Core

Eigen

Page 32: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

31

⑥ CMake

以下の URLから CMake“cmake-2.○.○-win32-x86.exe”をダウンロード,インストー

ルする. *12

*12 x86版だが,WOW64によって 64bitOS上でエミュレーション動作する.

http://www.cmake.org/cmake/resources/software.html

【解説】

CMakeは,ソフトウェアのビルドを自動化するためのクロスプラットフォー

ムなシステムです.OpenCV では,標準で用意されているバイナリを用いな

い場合は,CMakeを用いてソリューションファイルを作成,ビルドします.

Page 33: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

32

ソリューションファイルの生成(CMake)

CMakeを使って Visual Studio用のソリューションファイルを生成する.

⑨ [スタートメニュー ]>[すべてのプログラム ]>[CMake ◯◯ ]の中にある CMake

(cmake-gui)を起動する.

⑩ [Where is the source code:]の[Browse Source…]を押し,以下のパスを指定する.

C:¥Program Files¥OpenCV-2.2.0

⑪ [Where is build the binaries:]の[Browse Source…]を押し,以下のパスを指定する.

C:¥Program Files¥OpenCV-2.2.0¥build

⑫ [Configure]を押し,[Specify the generator for this project]で利用する IDE(Visual

Studio Win64)を選び[Finish]を押す.Visual Studio製品名と内部バージョンの対応

は以下のとおり.

Table 2. Visual Studio製品名と内部バージョンの対応

Visual Studio 製品名 内部バージョン

Visual Studio 6.0 6

Visual Studio .NET 7

Visual Studio .NET 2003 7.1

Visual Studio 2005 8

Visual Studio 2008 9

Visual Studio 2010 10

Page 34: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

33

⑬ 下の欄に現在の設定での出力及びエラー内容,中央の欄に選択できるオプションの一

覧が表示されます.以下に初期状態の出力の一部を示します.

Could NOT find PythonInterp (missing: PYTHON_EXECUTABLE)

Could NOT find PythonLibs (missing: PYTHON_LIBRARIES PYTHON_INCLUDE_DIRS)

Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE)

Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE)

“Could NOT find ◯◯◯◯(missing:◯◯◯◯)”などはオプションを指定しているが

必要な情報が見つからないということを示しています.オプションを指定する場合,

必要な情報の指定漏れか間違っている可能性があるので,中央の欄でオプションの設

定を確認します.また,オプションを必要としない場合,中央の欄でオプションの設

定を外します.

General configuration for opencv 2.2.0 =====================================

Built as dynamic libs?: ON

GUI:

Win64 UI: 1

Image I/O:

JPEG: build

PNG: build

TIFF: build

JPEG 2000: build

OpenEXR: NO

Video I/O:

VideoInput: 1

Interfaces:

Use IPP: NO

Use TBB: NO

Use Cuda: No

Use Eigen2: NO

-----------------------------------------------------------------

“General configuration for opencv 2.2.0=”以降は現在の出力設定の一覧を示してい

ます.

Page 35: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

34

⑭ 中央の欄でオプションを設定します.

CMakeでは,中央の欄でのオプションの設定と[Configure]を繰り返して出力設定

をしていきます.[Configure]を押すたびに,下の欄のエラーや出力設定の一覧が

更新されます.

1. TBB

[WITH_TBB]にチェックを入れ,[Configure]を押します.

新たに[TBB_INCLUDE_DIR]が表示されるので,TBB の include を指定し,

[Configure]を押します.

C:¥Program Files¥tbb30_◯◯◯oss¥include

新たに[TBB_LIB_DIR]が表示されるので,TBB の lib¥intel64¥vc9 を指定し,

[Configure]を押します.

C:¥Program Files¥tbb30_◯◯◯oss¥lib¥intel64¥vc9

2. CUDA

[WITH_CUDA]にチェックを入れ,[Configure]を押します.

新たに以下のオプションが表示されるので,それぞれ設定し,[Configure]を押し

ます.

[CUDA_BUILD_CUBIN]

チェック無し

[CUDA_BUILD_EMULATION]

チェック無し

[CUDA_COMPUTE_CAPABILITES]

1.1 1.2 1.3 2.0 *13

*13 Compute Capabiliteyは,CUDA-Zなどを使って確認できる.利用する GPUに合わせて変更する?

[CUDA_NPP_LIBRARY_ROOT_DIR]

C:/Program Files/npp_3.2.16_win_64/SDK

[CUDA_SDK_ROOT_DIR]

C:¥ProgramData¥NVIDIA Corporation¥NVIDIA GPU Computing

SDK 3.2¥C

[CUDA_TOOLKIT_ROOT_DIR]

C:¥Program Files¥NVIDIA GPU Computing Toolkit¥CUDA¥v3.2

[CUDA_VERBOSE_BUILD]

チェック無し

Page 36: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

35

3. Qt

[WITH_QT]と[WITH_QT_OPENGL]にチェックを入れ,[Configure]を押します.

[QT_QMAKE_EXECUTABLE]に Qt の bin¥qmake.exe を指定し,[Configure]

を押します.

C:/Qt/4.◯.◯x64/bin/qmake.exe

4. Eigen

[WITH_EIGEN2]にチェックを入れ,[Configure]を押します.

[EIGEN2_INCLUDE_PATH]に Eigen の¥include を指定し,[Configure]を押し

ます.

C:¥Program Files¥eigen *14

*14 eigenフォルダと Eigenフォルダの違いに注意.ダウンロード>⑤Eigenのディレクトリ構造図を参照.

5. IPP

[USE_IPP]にチェックを入れ,[IPP_PATH]を設定し,[Configure]を押すことで有

効になります.今回は詳細の説明は省きます.

6. その他

その他の設定を確認していきます.

・サンプルプログラムが必要な場合

[INSTALL_C_EXAMPLES](,[INSTALL_PYTHON_EXAMPLES])と

[BUILD_EXAMPLES]にチェックを入れ,[Configure]を押します.*15

*15 [INSTALL_◯_EXAMPLES]のみの場合,プロジェクトファイルは生成されない.

・Pythonが不要な場合

[BUILD_NEW_PYTHON_SUPPORT]のチェックを外して,[Configure]

を押します.

⑮ 下の欄に現在の設定での出力を確認します.以下にオプション設定後の出力の一部を

示します.

CUDA detected: 3.2

NPP detected: 3.2.16

General configuration for opencv 2.2.0 =====================================

Built as dynamic libs?: ON

GUI:

Page 37: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

36

QT 4.x: 1

QT OpenGL support: 1

Image I/O:

JPEG: build

PNG: build

TIFF: build

JPEG 2000: build

OpenEXR: NO

Video I/O:

VideoInput: 1

Interfaces:

Python: OFF

Use IPP: NO

Use TBB: YES

Use Cuda: YES

Use Eigen2: YES

-----------------------------------------------------------------

“General configuration for opencv 2.2.0 =”以降に注目してください.“GUI”

“ImageI/O”“VideoI/O”“Interfaces”“Documentation”の出力設定を確認します.

⑯ 最後に[Generate]ボタンを押してソリューションファイルを生成します.

[Where is build the binaries:]に設定した出力ディレクトリに OpenCVのソリューシ

ョンファイルが生成されていることを確認し,CMakeを閉じます.

Page 38: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

37

ビルド

OpenCVのビルドを行う前にファイルの修正を行います.

OpenCV では,Web カメラから動画像をキャプチャして処理を行うことが多いです.し

かし,OpenCV2.2 tag版にはカメラキャプチャにバグがあります.このままではWebカメ

ラなどを利用することができません.

以下の URLから,修正済みのファイル(precomp.hpp)をダウンロードして差し替える(下

の“Zip Archive”からダウンロード),または訂正該当箇所を書き換えます.

C:¥Program Files¥OpenCV-2.2.0¥modules¥highgui¥src¥precomp.hpp

https://code.ros.org/trac/opencv/changeset/4383

修正が完了したら,出力ディレクトリ(OpenCV-2.2.0¥build¥)に作成された OpenCV の

ソリューションファイル“OpenCV.sln”を Visual Studioで開きます.

Page 39: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

38

Visual Studioのメニューから[ビルド]>[バッチビルド]を押します.

“バッチビルド”ウィンドウが表示されるので,[ALL_BUILD]の Debug,Releaseの両

方にチェックをつけ,[ビルド]を押します.

ビルドが終わり,出力ログを見て“0 失敗”ならば成功です.

Page 40: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

39

OpenCV の設定

環境設定と Visual Studioにパスを設定する.

【環境変数】

・OPENCV

C:¥Program Files¥OpenCV-2.2.0

・Path

;%OPENCV%¥build¥bin¥Debug

;%OPENCV%¥build¥bin¥Release

【Visual Studio】

・実行可能ファイル

$(OPENCV)¥build¥bin¥Debug

$(OPENCV)¥build¥bin¥Release

・インクルード ファイル

$(OPENCV)¥include

$(OPENCV)¥modules¥calib3d¥include

$(OPENCV)¥modules¥contrib¥include

$(OPENCV)¥modules¥core¥include

$(OPENCV)¥modules¥features2d¥include

$(OPENCV)¥modules¥ffmpeg

$(OPENCV)¥modules¥flann¥include

$(OPENCV)¥modules¥gpu¥include

$(OPENCV)¥modules¥haartraining

$(OPENCV)¥modules¥highgui¥include

$(OPENCV)¥modules¥imgproc¥include

$(OPENCV)¥modules¥legacy¥include

$(OPENCV)¥modules¥ml¥include

$(OPENCV)¥modules¥objdetect¥include

$(OPENCV)¥modules¥traincascade

$(OPENCV)¥modules¥video¥include

・ライブラリ ファイル

$(OPENCV)¥build¥lib¥Debug

$(OPENCV)¥build¥lib¥Release

Page 41: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

40

確認

以上の設定を終えたら,実際に開発できるのか確認する.

以下のような単純に画像を読み込み,表示するプログラムを書いてみる.

Visual Studio を開き,[ファイル]>[新規作成]>[プロジェクト]を押し,“新しいプロジェ

クト”のウィンドウを表示する.“プロジェクトの種類”から[Visual C++]>[Win32]を選び,

“テンプレート”から[Win32コンソールアプリケーション]を選ぶ.任意のプロジェクト名

○○○を入力して[OK]を押す.“Win32 アプリケーション ウィザード”が開くので,その

まま[完了]を押してソリューションを作成する.

“ソリューションエクスプローラー”から[○○○]>[ソース ファイル]>[○○○.cpp]を開

き,以下のプログラムを記述する.また,適当な画像ファイルを用意し,ソースファイル

と同じディレクトリに置いておく.ソースコード中の画像ファイル名は適宜変更する.

#include "stdafx.h"

#include <opencv2/opencv.hpp>

#ifdef _DEBUG

#pragma comment(lib, "opencv_core220d.lib")

#pragma comment(lib, "opencv_highgui220d.lib")

#else

#pragma comment(lib, "opencv_core220.lib")

#pragma comment(lib, "opencv_highgui220.lib")

#endif

using namespace cv;

int _tmain(int argc, _TCHAR* argv[])

{

Mat sourceImage = imread("Lenna.bmp");

if(sourceImage.empty()){

cout << "画像ファイルが読み込めませんでした" << std::endl;

return -1;

}

namedWindow("Window", WINDOW_AUTOSIZE);

Page 42: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

41

imshow("Window", sourceImage);

waitKey(0);

return 0;

}

入力できたら,[ビルド]>[構成マネージャ]を押し,“構成マネージャ”のウィンドウを開

きます.[アクティブソリューションプラットフォーム]欄で[新規作成]を押し,“新しいソリ

ューションプラットフォーム”のウィンドウを開きます.[新しいプラットフォームを入力

または選択してください]欄から“x64”を選択し,[OK]を押します.

“構成マネージャ”のウィンドウを閉じ,[ビルド]>[ソリューションのビルド]を押してビ

ルドする.ビルドが成功したら[デバッグ]>[デバッグ無しで開始]を押し,プログラムを実行

する.エラー無く以下のような画面が出れば,正しく開発環境の構築ができています.

Page 43: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

42

OpenCV SVN (trunk,tag,branch について)

OpenCVでは,trunk,tag,branchの 3種類がリリースされています.trunkには,常

に最新の機能が追加されていきます.この trunkがある程度纏まったところで,tagがつけ

られます.この tag が,1.0,1.1prea,2.0,2.1,2.2 など sourceforge で配布されている

ものにあたります.branchは,tagがつけられた段階から機能の追加は行わず,bug fixの

み行っていく安定版にあたります.

Table 1. OpenCVの各リリース項目

リリース項目 内容 配布場所

trunk 最新版 SVN

tag リリース版 sourceforge

branch 安定版 SVN

trunk と branch は SVN(Subversion)で管理されています.SVN では,commit(何らか

の変更や更新)があるごとに revisionと呼ばれる管理番号がつけられます.trunkや branch

は,SVNから任意の revisionを checkout(ローカルにコピーすること)することで入手でき

ます.ここでは OpenCV SVNから最新の revisionを取得する方法を説明します.

① SVNクライアントをインストールする.

本 InstallGuideでは,Windowsで動作する SVNクライアントとして“TortoiseSVN”

を使う方法を紹介する.以下のURLからTortoiseSVNの最新バージョン“TortoiseSVN-1.

○.○○.○○○○○-win●●-svn-1.○.○○.msi”と日本語言語パック“LanguagePack_1.

○.○○.○○○○○-win●●-ja.msi”をダウンロード,インストールする. *1

*1 ●●は 32bitOSなら 32,64bitOSなら 64.OSのバージョンに合わせてダウンロードする.

http://tortoisesvn.net/downloads.html

Page 44: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

43

スタートメニューの[すべてのプログラム]>[TortoiseSVN]から Settingsを開く.設定ウ

ィンドウが表示されるので,[General]>[TortoiseSVN]>[Lungage]欄で“日本語”を選択

し,[OK]を押すと日本語化される.

② 最新の revisionを checkoutする.

まず checkout するフォルダを作ります.フォルダは,任意の名前,任意の場所で構い

ません. *2

*2 今回は Cドライブの直下に“OpenCV2.2”という名前のフォルダを作りました.

作成したフォルダを右クリックしてコンテキストメニューを開き,[SVN チェックアウ

ト]を押し,“チェックアウト”ウィンドウを表示します.

Page 45: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

44

“チェックアウト”ウィンドウの[リポジトリの URL]欄にチェックアウトしたいリリース

項目の URLを入力します.trunkと branchの URLはそれぞれ以下の通りです.

Table 2. リポジトリの URL

trunk https://code.ros.org/svn/opencv/trunk/

branch https://code.ros.org/svn/opencv/branches/2.2/

[チェックアウトする深さ]欄は“再帰的”,[リビジョン]欄は“最新のリビジョン”を選択

します.もし,特定の revision を checkout したい場合は,[リビジョン]欄に revision 番

号を入力します.

[OK]を押すと,指定フォルダに checkoutされます.

③ OpenCV SVNのインストール

checkoutした OpenCV SVNを C:¥Program Files¥OpenCV-2.2.0に移します.あとは

tag版と同様に CMake,ビルドすればインストール完了です.

Page 46: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

45

Visual Studio 2010 のプロパティシートについて

Visual Studio 2010(Express以外)は,以前のような GUIによる作成した全てのプロジェ

クトに設定が継承されるグローバルなパス設定ができなくなりました.Visual Studio 2010

では,作成したプロジェクト毎にプロパティシートで設定を行います.*1 プロジェクト毎

に設定を継承するプロパティシートを変更する,複数のプロパティシートから設定を継承

するなど柔軟に設定することができます.

*1 以前の Visual Studioにもプロパティシートはあります.

しかし,プロジェクトを作成する毎にプロパティシートを指定して設定を継承するのは

少々手間がかかります.そこで本 Guide では,デフォルトで全てのプロジェクトに継承さ

れる以下のプロパティシートを利用して,グローバルなパス設定を行う方法を紹介します.

C:¥Users¥(ユーザー名)¥AppData¥Local¥Microsoft¥MSBuild¥v4.0

・Win32用プロパティシート

Microsoft.Cpp.Win32.user.props

・x64用プロパティシート

Microsoft.Cpp.x64.user.props

通常のプロパティシートの作成,記述,継承の方法は以下の URL を参考にして下さい.

MSDNライブラリ:“プロパティシート(C++) Visual Studio 2010”

http://msdn.microsoft.com/ja-jp/library/a4xbdz1e.aspx

ここからは,既に本 Guide で必要な設定を書き込んだプロパティシートのサンプルを参

考に説明していきます.プロパティシートのサンプルは以下の URLからダウンロードして

下さい.

まとめ?ブログ:SkyDrive“Visual Studio 2010用プロパティシート”

http://goo.gl/SLOnL

プロパティシートは,XMLで記述されています.上記のプロパティシートのファイルを

メモ帳などの任意のテキストエディタで開き,編集します.プロパティシートのタブの間

に値を書きこんでいくことで設定します.パスとパスの間はセミコロン(;)で区切ります.

XMLの仕様上,タグの途中で改行は出来ないので注意して下さい.以下に各タブの説明を

記します.

Page 47: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

46

・ <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'"> ~

</PropertyGroup>

<PropertyGroup>タグに含まれるプロパティがどのビルド設定を対象としたもの

かを指定する.上の例では DebugビルドでWin32アプリケーションを対象とした

設定.Relase ビルドや x64 アプリケーションを対象とする場合は該当箇所を置き

換えて下さい.

・<ExecutablePath> ~ ;$(ExecutablePath)</ExecutablePath>

<ExecutiblePath>タグ内には実行可能ファイルのパスを記述する.

$(ExecutablePath)は Visual Studioデフォルトの実行可能ファイルのパス.

・<IncludePath> ~ ;$(IncludePath)</IncludePath>

<IncludePath>タグ内にはインクルードファイルのパスを記述する.

$(IncludePath)は Visual Studioデフォルトのインクルードファイルのパス.

・<LibraryPath> ~ ;$(LibraryPath)</LibraryPath>

<LibraryPath>タグ内にはインクルードファイルのパスを記述する.

$(LibraryPath)は Visual Studioデフォルトのライブラリファイルのパス.

サンプルのプロパティシートには記述しませんでしたが,以下のタグも利用できます.

・<ReferencePath> ~ ;$(ReferencePath)</ReferencePath>

<ReferencePath>タグ内には参照ファイルのパスを記述する.

$(ReferencePath)は Visual Studioデフォルトの参照ファイルのパス.

・<SourcePath> ~ ;$(SourcePath)</SourcePath>

<SourcePath>タグ内にはソースファイルのパスを記述する.

$(SourcePath)は Visual Studioデフォルトのソースファイルのパス.

・<ExcludePath> ~ ;$(ExcludePath)</ExcludePath>

<ExcludePath>タグ内にはディレクトリを除外のパスを記述する.

$(ExcludePath)は Visual Studioデフォルトのディレクトリを除外のパス.

本 Guideで説明した方法が必ずしも推奨されるわけではありません.OpenCV 2.2用

の設定を記した○○○.propsを作成しておき,プロジェクト作成毎に設定を継承する方法

が本来の方法だと思います.方法は任意で選んで下さい.

Page 48: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.5

47

参考サイト

・OpenCV Wiki

http://opencv.willowgarage.com/wiki/

・OpenCV Issue Tracker

https://code.ros.org/trac/opencv/

・Yahoo! GROUPS

http://tech.groups.yahoo.com/group/OpenCV/

・sourceforge

http://sourceforge.net/projects/opencvlibrary/

・OpenCVMeetingNotes

http://pr.willowgarage.com/wiki/OpenCVMeetingNotes

・OpenCV.jp

http://opencv.jp/

・第 10回 コンピュータビジョン勉強会@関東 番外編 OpenCV祭り

@ms_wikiさん発表資料“リリース動向 & Yahoo! Groups”

http://sites.google.com/site/cvsaisentan/

履歴

・Ver.0.1 2011/2/27

・Ver.0.2 2011/2/27

・Ver.0.3 2011/3/5

・Ver.0.4 2011/3/15

・Ver.0.5 2011/4/18

主な変更点

-タイトルをWin32,x64に修正

-VS2010の TBBのパス指定について

-VS2010のプロパティシートについて

-Eigenのディレクトリ図を追加

連絡先

説明の間違いや誤字,脱字,エラーなどありましたら以下の連絡先まで御一報頂ければ

幸いです.また,利用した感想など頂けると励みになります.Twitterでリプライ頂けるの

が一番反応良いと思います.長文や添付ファイルで Mail を使う場合も,Twitter で一言リ

プライ頂けると助かります.

Twitter :@UnaNancyOwen

http://twitter.com/UnaNancyOwen

Mail :[email protected]

Page 49: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.3

48

著作権表記

(要約)

OpenCV2.2 Install Guideは,UnaNancyOwenが私的に作成したものであり,再頒布,

使用,および改変は基本的に自由です.但し,著作者はいかなる損害の保証を致しません

のでご注意下さい.

(著作権表記)

Copyright (c) 2011 UnaNancyOwen All rights reserved.

本文章(OpenCV2.2 Install Guide)は、変更するかしないかを問わず、以下の条件を満た

す場合に限り、再頒布および使用が許可されます。

・本文章を再頒布する場合、上記の著作権表示、本条件一覧、および下記免責条項を含めること。

本文章は、著作権者およびコントリビューターによって「現状のまま」提供されており、

明示黙示を問わず、商業的な使用可能性、および特定の目的に対する適合性に関する暗黙

の保証も含め、またそれに限定されない、いかなる保証もありません。

著作権者もコントリビューターも、事由のいかんを問わず、損害発生の原因いかんを問わ

ず、かつ責任の根拠が契約であるか厳格責任であるか(過失その他の)不法行為であるか

を問わず、仮にそのような損害が発生する可能性を知らされていたとしても、本文章の使

用によって発生した(代替品または代用サービスの調達、使用の喪失、データの喪失、利

益の喪失、業務の中断も含め、またそれに限定されない)直接損害、間接損害、偶発的な

損害、特別損害、懲罰的損害、または結果損害について、一切責任を負わないものとしま

す。

Page 50: OpenCV2.2 Install Guide ver.0.5

OpenCV2.2 Install Guide

Ver.0.3

49

その他

TBBや NPPを C:¥Program Files以下に置いているが,Windowsのユーザー権

限の方針を考慮して C:¥ProgramData以下に置いたほうがいいのではないか?

CMakeオプションの動作解明.(特に検証が面倒臭い CUDA関係)

Doxygenへの対応

Pythonへの対応

サンプルプログラムを追加 or変更する?

・Webカメラからのキャプチャ

・簡単な画像処理

・画素値へのアクセス方法

日本語って難しいねー(´・ω・`)

OpenNIへの対応

OpenEXRへの対応

IPPへの対応(Intel Compiler欲しいお)

x64で Eigenの CMake & Compileは必要なのか?

x64のテストをする.(曖昧なところ多数なため)

著作権表記をクリエイティブコモンズに変更する?

Windows以外の OSへの対応