前のチュートリアル: Androidのカメラプレビューを用いたCVアプリケーションでOpenCLを使用する
次のチュートリアル: ARMベースのLinuxシステム向けのクロスコンパイル


原著者	`@sajarindider`
互換性	OpenCV >= 3.4

以下の手順は macOS (Mavericks) でテスト済みだが、他のバージョンでも動作するはずである。

必要なパッケージ

CMake 3.9 以上
Git
Python 3.x および NumPy 1.5 以降

このチュートリアルでは、お使いのマシンに Python、NumPy、Git がインストール済みであることを前提とする。

覚え書き

macOS 12.2 (Monterey) まで: Python 2.7 がプリインストールされている。
macOS 12.3 以降: Python 2.7 は削除され、デフォルトではいかなるバージョンの Python も含まれない。

最新の OpenCV Python バインディングとの互換性のため、最新の Python 3.x（少なくとも Python 3.8）をインストールすることを推奨する。

覚え書き: Xcode と Xcode Command Line Tools をインストール済みであれば、Git はすでにマシンで利用可能である。

CMakeのインストール

お使いのシステムに合ったバージョンを見つけ、リリースのページから CMake をダウンロードする
.dmg パッケージをインストールし、アプリケーションから起動する。これにより CMake の UI アプリが利用できる
CMake アプリのウィンドウから、メニュー Tools --> How to Install For Command Line Use を選択する。次に、表示されるポップアップの指示に従う。
インストールフォルダはデフォルトで /usr/local/bin/ になる。Install command line links を選択してインストールを完了する。
次を実行して CMake が正しくインストールされたことを確認する:

cmake --version

覚え書き

Homebrew を使って次のように CMake をインストールできる:

@code{.bash} brew install cmake @endcode

OpenCVのソースコードの入手

最新の安定版 OpenCV を使用するか、Git リポジトリから最新のスナップショットを取得できる。

Gitリポジトリから最新開発版OpenCVを入手する

Git クライアントを起動し、OpenCV リポジトリをクローンする。OpenCV contrib リポジトリのモジュールが必要な場合は、それもクローンする。

例:

@code{.bash}
cd ~/<your_working_directory>
git clone https://github.com/opencv/opencv.git
git clone https://github.com/opencv/opencv_contrib.git
@endcode

CMakeを使ったソースからのOpenCVのビルド

生成される Makefile、プロジェクトファイル、オブジェクトファイル、出力バイナリを置くための一時ディレクトリ（ここでは build_opencv と表記する）を作成し、そこに入る。

例:

mkdir build_opencv

cd build_opencv

覚え書き
ソースコードディレクトリをクリーンに保つのは良い習慣である。ビルドディレクトリはソースツリーの外に作成する。
構成（Configuring）。cmake [<some optional parameters>] <path to the OpenCV source directory> を実行する

例:

cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_EXAMPLES=ON ../opencv

あるいは、CMake GUI (cmake-gui) を使用できる:
- OpenCV ソースコードのパスを設定する。例: /Users/your_username/opencv
- バイナリのビルドパスを CMake のビルドディレクトリに設定する。例: /Users/your_username/build_opencv
- 省略可能な引数を設定する
- 実行する: "Configure"
- 実行する: "Generate"
Description of some parameters
- ビルドタイプ: -DCMAKE_BUILD_TYPE=Release（または Debug）。
- 追加モジュールを含める: opencv_contrib リポジトリをクローンしてそのモジュールを含めたい場合は、次を設定する:
  
  -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules
- ドキュメントをビルドするには -DBUILD_DOCS=ON を設定する（doxygen が必要）
- すべてのサンプルをビルドするには -DBUILD_EXAMPLES=ON を設定する
[optional] Building python. Set the following python parameters:
- -DPYTHON3_EXECUTABLE=$(which python3)
- ‘-DPYTHON3_INCLUDE_DIR=$(python3 -c "from sysconfig import get_paths as gp; print(gp()['include’])")`
- `-DPYTHON3_NUMPY_INCLUDE_DIRS=$(python3 -c "import numpy; print(numpy.get_include())")`
ビルドする。ビルドディレクトリで make を実行する。複数スレッドで実行することを推奨する

例:

make -j$(sysctl -n hw.ncpu) # runs the build using all available CPU cores
ビルド後、次のコマンドで OpenCV をシステム全体にインストールできる:

sudo make install
CMake ベースのプロジェクトで find_package(OpenCV) を通じて OpenCV を使用するには、ビルドディレクトリまたはインストールディレクトリを指す OpenCV_DIR 変数を指定する。

例:

cmake -DOpenCV_DIR=~/build_opencv ..

OpenCVインストールの確認

OpenCV をビルド（および任意でインストール）した後、Python を使ってバージョンを確認することでインストールを検証できる:

@code{.bash}
python3 -c "import cv2; print(cv2.__version__)"
@endcode

このコマンドはインストールされている OpenCV のバージョンを出力するはずである。

覚え書き: Homebrew や pip のようなパッケージマネージャを使って OpenCV のリリース版のみをインストールすることもできる（最新の開発版ではない）。

Homebrew によるインストール:

例:

brew install opencv
pip によるインストール:

例:

pip install opencv-python

覚え書き
opencv_contrib の追加モジュールにアクセスするには、pip install opencv-contrib-python を使って opencv-contrib-python パッケージをインストールする。