OpenCV4.1.0をCMakeを使って導入する方法(Visual Studio 2019)


概要

OpenCVをCMakeを使用してインストールする方法をまとめました。
この手順を理解しておくとWindowsでのあらゆる環境構築が怖くなくなります。(たぶん)

実行環境

インストール&ビルド

Visual Studio

下記からダウンロード&インストールします。
https://visualstudio.microsoft.com/ja/vs/

CMake

下記からダウンロード&インストールします。
GUIを使用してMakeするので.msiをダウンロードします。
https://cmake.org/download/

OpenCV

  1. 下記Gitからバージョンを確認して.zipダウンロードします。
    任意の場所に展開します。(Cドライブの直下にProgramingLibraryというDIRを作成しその中に入れました。)
    https://github.com/opencv/opencv

  2. CMake(GUI)を起動し、OpenCVのDIR PATHを設定します。
    .slnファイルを出力するPATHを設定します。
    (私の場合はライブラリの直下にbuildというフォルダを出力するという自分ルールがあるためC:\ProgramingLibrary\opencv-4.1.0\buildというPATHになっています。)

  3. Config、Generateの順で実行します。
    今回はVisual Studio 2019でのビルドなのでVisual Studio 16 2019を選択し、x64と設定します。

  4. 設定したパスに出力された.slnをVisual Studioで開きます。
    出力したい実行環境になっていることを確認します。(今回はx64 Release)

  5. ALL_BUILDを右クリックしてビルド

  6. INSTALLを右クリックしてビルド

  7. build以下にinstall DIRができていて、中身も生成されていることを確認します。

    パスを通す

    CMAKE_PREFIX_PATH

    システム環境変数から下記画像のようにOpenCVConfig.cmakeがあるDIRのPATHを通します。

    PATH

    PATHに.dllファイルが出力されているDIRのPATHを通す。
    このDIRは定期的に変わるので注意です。

    サンプルプログラム

    画像が読み込んで表示するプログラムです。
    任意の場所にDIRを作成し、DIRの中に下記プログラムと任意の画像(.jpg)を入れます。

CMakeLists.txt
cmake_minimum_required(VERSION 2.8)

set(PROJECT_NAME Test)
project(${PROJECT_NAME})

find_package(OpenCV 4.1.0 EXACT REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS} ${CMAKE_CURRENT_BINARY_DIR}/include)
link_directories(${OpenCV_LIBRARY_DIRS})

file(GLOB SOURCE_CPP *.cpp)
file(GLOB SOURCE_H *.h)

add_executable(${PROJECT_NAME} ${SOURCE_CPP} ${SOURCE_H})
target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBRARIES})
main.cpp
#include <opencv2/opencv.hpp>
#include <iostream>

void main(){

    std::string pattern = "..\\*.jpg";
    std::vector<cv::String> files;
    cv::glob(pattern, files);

    if(files.size() == 0) {
        std::cout << "erorr" <<std::endl;
        exit(-1);   
    }

    cv::Mat image = cv::imread(files[0]);
    std::cout << files[0] << std::endl;
    std::cout << image.size () << std::endl;
    cv::imshow("show", image);
    cv::waitKey (0);
}
  1. 上記同様にCMakeでmakeする。
  2. Generateされた.slnをVSで開く。
  3. 実行環境が合っていることを確認して実行
    (プロジェクト名が非アクティブの場合はプロジェクト名を右クリックしてスタートアッププロジェクトに設定でアクティブにする。)する。
  4. 画像が読み込まれて表示されるプログラム完成

OpenCV contribの導入

まとめ

CMake(GUI)を使えばコマンドラインからは分かりにくい設定も分かりやすいです。
もう環境構築怖くない~