OpenCV 4 Installation

OpenCV Optional Tools (Part 2: OpenEXR, zlib, imath)

Introduction

OpenCV Optional Tools (Part 1: NumPy & Eigen)に続き、本稿ではOpenCV Optional Toolsのインストールと設定について、以下の項目の順で述べます。

  • OpenEXR
    • zlib Installation (Prerequired)
    • imath Installation (Optional)
    • OpenEXR Installation

それでは、参りましょう。

OpenEXR

OpenEXRとは、High-Dynamic-Range Image File Formatです。つまり、画像ファイルフォーマットの一種です。数々の便利な機能を備えています。例えば、16-bitまたは32-bitで画素のデータを保存できる、優れたカラーレゾリューション、データコンプレッション、その他多数。

OpenEXRには、zlibimathが要求されています。ただ、OpenEXRインストールの際、imathはOpenEXRによって自動的にインストールされます。zlibは必須項目で、予めインストールされていなければエラーが発生します。

zlib Installation

 zlibはデータコンプレッションライブラリーです。ソースコードはzlib Home Siteからダウンロード出来ます。ライブラリーのインストールは以下の手順で行います。

  • ソースコードをダウンロードして、展開(Un-tar)する。
  • /contribフォルダー内のVisual Studioのソリューションファイルを開いて、コンパイル/インストールする。

先ず、ダウンロードしたソースコードを展開します。ダウンロードされた圧縮ファイルはtar.gz形式です。Windowsでは注意してください。

Downloaded zlib Libraries
Un-tar zlib Libraries

展開されたソースコードフォルダー内の「contrib」->「vstudio」フォルダー内に各MSVCバージョンに合わせたプロジェクトファイルが収納されています。ここでは、vc14フォルダー内のソリューションファイル「zlibvc.sln」をダブルクリックします。

MSVC Solution File of zlib

すると、MSVCが起動され、ソリューションファイルが現在PCにインストールされているバージョンにアップグレードされます。

Launching VC++
Upgrading zlib Solution File

VC++コンパイラーの準備が整った処で、「ReleaseWithoutAsm」と「x64」を選択し、ソリューションをビルドします。

Preparing to Build zlib through VC++
Building zlib Libraries

正常にビルドが終了したことを確認しましょう。

Built zlib Libraries

最後に、「vc14」フォルダー内にライブラリーが保存されていることを確認します。

There they are, “zlib Libraries”.

(Option) 「zlibwapi.dll」ファイルのコピーを取り、「zlib.dll」へとファイル名を変更しておくと、後々便利です。詳しくは、「..\contrib\vstudio」内のreadme.txtを参照してください。

Copy & rename zlib.dll file.

imath

 Pythonバージョンのimathimath · PyPIからダウンロード出来ます。コマンドプロンプトにて”pip install imath” を実行すると、インストール出来ます。ただし、OpenEXRではimathのパッケージがインストールパッケージに含まれていて、こちらが優先されます。

OpenEXR Installation

まず、Visual Studio Command Promptを開き、buildディレクトリーを作成し、そこに移動します。Promptにて、

Command Prompt -> cmake (OpenEXR Directory)\openexr

と入力すると、CMakeによりOpenEXRが設定されます。

OpenEXR Setting Command thru CMake
OpenEXR Settings thru CMake

設定が無事に完了したところで、OpenEXRをビルドします。今回はあえてターゲットを設定せずに試しました。

OpenEXR Build thru CMake Prompt

ここでは、ビルド失敗です。コンパイラーがzlib Libraiesを認識出来なかったようです。

zlib Libraries Undetected

想定内です、問題ない。Contingency Planを用意しております。

ここで、作戦変更です。便利なCMake GUIを使用します。

zlibライブラリーのフォルダーをGUI上で指定して、「Configure」「Generate」「Open Project」と進めるとVisual C++が起動します。

OpenEXR Build thru CMake GUI & MSVC

「Debug」「Release」モードの両方でソリューションをビルドします。

Building OpenEXR Solution thru MSVC
Building OpenEXR Completed

「Debug」「Release」モードの両方でビルドに成功すると、「bin」フォルダーにライブラリーが保存されていますので、確認しましょう。

There they are, the OpenEXR Libraries.

Conclusion

如何でしたか。本稿ではOpenCV Optional Toolsに関し、OpenEXR、zlib Librariesとimathを記載し、インストール手順を列記しました。最後までお読みいただき、ありがとうございました。

返信を残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です