OpenCV 4.9.0 のインストール，動作確認（Windows 上）

【要約】 OpenCV のインストールと動作確認（Windows 上）について．OpenCVは実時間コンピュータビジョンのためのアルゴリズムとサンプルコードの集まりであり，顔認識や物体認識，画像処理など多様な機能を持つ．Windows上でのインストール手順は，OpenCVの公式ページから最新バージョンをダウンロードし，展開して指定のディレクトリに配置する．また，システム環境変数を設定することでOpenCVを使用することができる．C++やPythonを使った画像表示の例も提供され，それらを実行することでOpenCVの動作確認ができる．

OpenCV

• 2500 以上のアルゴリズム．
• 顔認識、物体認識、人間の動きの分類、カメラの動きの追跡、オブジェクトの動きの追跡、３次元モデルの抽出、ステレオカメラからの３次元点群の生成、イメージスティッチング、類似画像の検索、赤目の除去、眼球運動の追跡、ARの機能など
• ライセンス: BSD ライセンス
• インタフェース: C++, Python, Java, MATLAB
• マシン: Windows, Linux, Mac OS, iOS, Android

【サイト内の関連ページ】

• OpenCV について [PDF] , [パワーポイント]
• OpenCV のインストール，画像表示を行う C++ プログラムの実行手順: 別ページ »で説明している．
• OpenCV 4 の Python プログラム: 別ページ »にまとめ
• OpenCV 4 の C/C++ プログラム: 別ページ »にまとめている．

【OpenCV の公式情報】

• OpenCV の公式ページ: https://opencv.org
• GitHub の OpenCV のページ: https://github.com/opencv/opencv/releases

OpenCV 4.9.0 Windows版のダウンロードとインストール

1. GitHub の OpenCV の Webページを開く

   https://github.com/opencv/opencv/releases

2. バージョンを選ぶ

   下図では，OpenCV 4.9.0 を選んで， 「Assets」を展開している．

   

   他のバージョンを選んだ場合でも，これ以降のインストール手順はほぼ同じになる

3. Windows 版が欲しいので「opencv-4.9.0-windows.exe」というような名前のファイルを選ぶ．
   
4. ダウンロードが始まる
   
5. ダウンロードした .exe ファイルを実行する
   
6. 展開（解凍）先は自動設定される．既定（デフォルト）のままでよい．展開（解凍）先は覚えておく．「Extract」をクリック
   
7. 展開（解凍）が始まる．
   
8. 展開（解凍）が終わると，展開（解凍）先に，「opencv」というディレクトリができ，その中にファイルができるので確認する
   
9. 展開してできたディレクトリを， 分かりやすいディレクトリの下に丸ごとコピーする．

   ここでは，「c:\opencv」にファイルを置くことにしている． この「c:\opencv」 は何に変えてもよいが，分かりやすくて，日本語を含まないものがよい

   
10. Windows の システム環境変数 Pathに，c:\opencv\build\bin, c:\opencv\build\x64\vc16\bin を追加することにより，パスを通す．

    Windows で，コマンドプロンプトを管理者として実行

    コマンドプロンプトを管理者として実行: 別ページ »で説明

    次のコマンドを実行．

    「c:\opencv」は，実際にコピーしたディレクトリに合わせること．

    powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";c:\opencv\build\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
    powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";c:\opencv\build\x64\vc16\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
    

    
11. Windows の システム環境変数 OPENCV_DIR に，c:\opencv\build を設定

    Windows で，コマンドプロンプトを管理者として実行

    コマンドプロンプトを管理者として実行: 別ページ »で説明

    次のコマンドを実行

    powershell -command "[System.Environment]::SetEnvironmentVariable(\"OPENCV_DIR\", \"c:\opencv\build\", \"Machine\")"
    

    
12. opencv_version にパスが通っていることを確認する

    そのために，新しく Windows のコマンドプロンプトを開き，次のコマンドを実行する．

    エラーメッセージが出なければOK．

    where opencv_version
    opencv_version
    

    

OpenCV を用いた画像表示の例

Build Tools for Visual Studio 2022 （ビルドツール for Visual Studio 2022）もしくは Visual Studio 2022 のインストール

OpenCV で画像表示を行う C++ プログラム

1. Windows で，コマンドプロンプトを実行
2. OpenCV のサンプルデータ の中の fruits.jpg を使う
   c:\opencv\sources\samples\data にある
   
3. 次のコマンドを実行し，メモ帳を開く．

   cd %USERPROFILE%
   notepad a.cpp
   

   
4. 次のプログラムを，ファイル名 a.cpp で保存．

   このプログラムは，OpenCVライブラリを使用して、指定された画像ファイル（fruits.jpg）を読み込み、画面に表示する。キー入力があるまで画像を表示し続け、キー入力後に画面を閉じてプログラムを終了する。

   #include <opencv2/opencv.hpp>
   
   int main(int argc, char* argv[])
   {
       cv::Mat bgr = cv::imread("c:/opencv/sources/samples/data/fruits.jpg");
       cv::imshow("", bgr);
       cv::waitKey(0);
       cv::destroyAllWindows();
       return 0;
   }
   

   
5. ビルドと実行

   Windows では，Visual Studio の x64 Native Tools コマンドプロンプトを使う．（Windows のスタートメニューで起動できる）．次のように実行して，C++ のプログラムファイル a.cpp を作り，実行する．

   cd %USERPROFILE%
   cl /I"c:\opencv\build\include" a.cpp /link /LIBPATH:"c:\opencv\build\x64\vc16\lib" opencv_world490.lib
   .\a.exe
   

   

   プログラム実行により，画像表示が行われる．画面をクリックし，なにかのキーを押して閉じる．

   

OpenCV で画像表示を行う Python プログラム

1. Windows で，コマンドプロンプトを管理者として実行

   コマンドプロンプトを管理者として実行: 別ページ »で説明

2. numpy のインストール

   python -m pip install -U numpy
   

   
3. OpenCV の Python 用のファイルがあるディレクトリを確認したい．

   カレントディレクトリを移動する操作

   cd c:\opencv\build\python
   

   
4. ファイルを確認

   「cv2」というディレクトリ（フォルダ）があれば OK．

   dir /w
   

   
5. システムの環境変数 PYTHONPATH に「c:\opencv\build\python」を追加する

   OpenCV の Python 用のファイルがあるディレクトリを設定する．

   Windows で，コマンドプロンプトを管理者として実行

   コマンドプロンプトを管理者として実行: 別ページ »で説明

   次のコマンドを実行．

   powershell -command "$oldpythonpath = [System.Environment]::GetEnvironmentVariable(\"PYTHONPATH\", \"Machine\"); $oldpythonpath += \";c:\opencv\build\python\"; [System.Environment]::SetEnvironmentVariable(\"PYTHONPATH\", $oldpythonpath, \"Machine\")"
   

   
6. OpenCV のサンプルデータ の中の fruits.jpg を使う
   c:\opencv\sources\samples\data にある
   
7. Python プログラムの実行

   Python プログラムの実行

   • Windows では python （Python ランチャーは py）
   • Ubuntu では python3

   Python 開発環境（Jupyter Qt Console, Jupyter ノートブック (Jupyter Notebook), Jupyter Lab, Nteract, Spyder, PyCharm, PyScripterなど）も便利である．

   Python のまとめ: 別ページ »にまとめ

   python
   

   このプログラムは、OpenCVを使用して画像ファイル 'fruits.jpg' を読み込み、ウィンドウに表示します。キー入力があるまで画像が表示され続け、キー入力後にウィンドウが閉じます。

   import cv2
   bgr = cv2.imread('c:/opencv/sources/samples/data/fruits.jpg')
   cv2.imshow("", bgr)
   cv2.waitKey(0)
   cv2.destroyAllWindows()
   

   

   画像が表示されるので確認． このあと，ウインドウの右上の「x」をクリックしない．画面の中をクリックしてから，何かのキーを押して閉じる