はじめに

このチュートリアルでは、数学バックエンドとして ARM Performance Libraries (ARMPL) を使い、Windows (AArch64) 上でOpenCVをビルドする方法を説明する。ARMPLはArmベースのハードウェア向けに最適化されたBLASおよびLAPACKルーチンを提供しており、DFTやDCTなどのOpenCVの処理を大幅に高速化できる。

ステップ1: ARM Performance Librariesのダウンロードとインストール

ブラウザを開き、ARM Performance Libraries Downloadsページへアクセスする。
Windows / AArch64 の項目から、希望するツールチェーン用のインストーラーをダウンロードする:

ファイル	アーキテクチャ	Size
`arm-performance-libraries_26.01_Windows.msi`	AArch64	約240 MiB

ダウンロードした .msi インストーラーを実行し、画面の指示に従う。デフォルトのインストールディレクトリは次の通りである:
C:\Program Files\Arm Performance Libraries\armpl_26.01

ステップ2: システム環境変数の設定

OpenCVのCMakeスクリプト（およびARMPLランタイム自体）は、ビルド時と実行時の両方でライブラリファイルを見つける必要がある。システムの PATH 変数に次のエントリを追加する:

システムのプロパティを開き、詳細設定をクリックし、続いて環境変数をクリックする。
システム環境変数の項目で Path を選択し、編集をクリックする。
以下の2つのパスを追加する（バージョン番号が異なる場合は調整する）:

C:\Program Files\Arm Performance Libraries\armpl_26.01\lib

C:\Program Files\Arm Performance Libraries\armpl_26.01\bin
すべてのダイアログでOKをクリックして保存する。

ステップ3: OpenCVのクローン

git clone https://github.com/opencv/opencv.git

cd opencv

extraモジュールも必要な場合:

git clone https://github.com/opencv/opencv_contrib.git

ステップ4: CMakeによる設定

ビルドディレクトリを作成し、ARMPLサポートを有効にしてCMakeを実行する。

OpenMPなし（シングルスレッドARMPL）:

mkdir build && cd build
 
cmake -G "Visual Studio 17 2022" -A ARM64 ^
      -DWITH_ARMPL=ON ^
      -DARMPL_ROOT_DIR="C:\Program Files\Arm Performance Libraries\armpl_26.01" ^
      -DWITH_OPENMP=OFF ^
      ..

OpenMPあり（マルチスレッドARMPL）:

ARMPLはシリアル版とOpenMP対応版の両方のライブラリを同梱している。マルチスレッド版を使うには、CMakeでOpenMPを有効にする:

mkdir build && cd build
 
cmake -G "Visual Studio 17 2022" -A ARM64 ^
      -DWITH_ARMPL=ON ^
      -DARMPL_ROOT_DIR="C:\Program Files\Arm Performance Libraries\armpl_26.01" ^
      -DWITH_OPENMP=ON ^
      ..

覚え書き: WITH_OPENMP=ON を有効にすると、CMakeはARMPLのマルチスレッド版である armpl_lp64_mp をリンクする。無効にするとシリアル版の armpl_lp64 をリンクする。シンボルの衝突を避けるため、有効にできる版は一度に1つだけにすべきである。

ステップ5: ビルドとインストール

生成された .sln ファイルをVisual Studioで開いてRelease構成をビルドするか、またはコマンドラインからビルドする:

cmake --build . --config Release --parallel

cmake --install . --config Release

ステップ6: ビルドの検証

ビルドが成功したら、次を実行してOpenCVがARMPLを検出していることを確認する:

opencv_version --verbose 2>&1 | findstr /i armpl

次のような行が表示されるはずである:

ARMPL: YES (armpl_26.01)

あるいは、CMakeの設定ログで次の行を確認する:

-- ARMPL support: YES

トラブルシューティング

CMakeがARMPLを見つけられない:

ARMPL_ROOT_DIR が include\ と lib\ の両方のサブディレクトリを含むフォルダを指していることを確認する:

C:\Program Files\Arm Performance Libraries\armpl_26.01
    bin\
    include\
    lib\

実行時エラー: DLLが見つからない:

lib\ と bin\ の両方のディレクトリがシステムの PATH に含まれていること、およびそれらを追加した後で新しいコマンドプロンプトを開いたことを確認する（変更はすでに開いているセッションには反映されない）。

OpenMPに関するリンカーエラー:

WITH_OPENMP=ON のときにシンボル重複エラーが表示される場合は、シリアル版のARMPLライブラリも同時にリンクしていないことを確認する。-DWITH_OPENMP=ON を一貫して指定し、CMakeを再実行する前にビルドディレクトリをクリーンにする。

目次