Compile OpenCV under CodeBlocks / MinGW on Windows

Per maggiori informazioni sulla Libreria OpenCV fare riferimento

• al sito ufficiale: http://opencv.willowgarage.com/wiki/
• alla pagine su OpenCV di questo sito http://www.pklab.net/index.php?id=342&Lang=IT

Per maggiori informazioni su Code::Blocks fare riferimento al sito ufficiale: http://www.codeblocks.org/

Prerequisiti

Partire dando una lettura a OpenCv Installation Guide (http://opencv.willowgarage.com/wiki/InstallGuide) e Compile OpenCV under MinGW (http://opencv.willowgarage.com/wiki/MinGW)

Questa guida è stata realizzata utilizzando:

• OpenCV 2.2 - http://opencv.willowgarage.com/wiki/
• CMake 2.8.3 - http://www.cmake.org/
• Code::Blocks 10.5 http://www.codeblocks.org/ + TDM-2 mingw32 4.4.1 - http://tdm-gcc.tdragon.net/
• (opzionale) TBB 3.0 Update 5 (tbb30_20101215) - http://www.threadingbuildingblocks.org
• (opzionale) Eigen 2.0.15 - http://eigen.tuxfamily.org/index.php?title=Main_Page
• (opzionale) SVN 1.6.11
• (opzionale) DoxyGen 1.6.3

Configurare la compilazione di OpenCV

Si suppone che Cmake e Code::Blocks siano installati e funzionanti

• Scompattare OpenCV nella cartella desiderata, ad esempio C:\LIBS\OpenCV2.2
• Creare una cartella che conterrà i file compilati, ad esempio C:\LIBS\OpenCV2.2\CodeBlocks.
• Lanciare CMake-gui e impostare:
  • Where is the source code: C:\LIBS\OpenCV2.2
  • Where to buil the binaries: C:\LIBS\OpenCV2.2\CodeBlocks
• Click su Configure, Cmake richiede il compilatore da utilizzare scegliere Code::Blocks MinGW.
• A questo punto compare la lista dei parametri di configurazione con i valori predefiniti. Se è necessario, modificare la voce relativa e premere nuovamente Configure. Accertarsi che i parametri relativi al compilatore siano corretti. In caso contrario CMake non ha rilevato il compilatore, probabilmente perchè i percorsi del compilatore non sono nella PATH:

CMAKE_AR                   = C:/Programmi/CodeBlocks/MinGW/bin/ar.exe
CMAKE_CODEBLOCK_EXECUTABLE = C:/Programmi/CodeBlocks/codeblocks.exe
CMAKE_CXX_COMPILER         = C:/Programmi/CodeBlocks/MinGW/bin/g++.exe
CMAKE_C_COMPILER           = C:/Programmi/CodeBlocks/MinGW/bin/gcc.exe
CMAKE_LINKER               = C:/Programmi/CodeBlocks/MinGW/bin/ld.exe
CMAKE_MAKE_PROGRAM         = C:/Programmi/CodeBlocks/MinGW/bin/mingw32-make.exe

• In questo esempio la compilazione della documentazione con doxygen presenta un bug, infatti se attivata viene generato un numero infinito di cartelle html in doc, per questo motivo ho disattivato la creazione della documentazione.

BUILD_DOXYGEN_DOCS = NO

• Modificare i parametri desiderati come ad esempio BUILD_EXAMPLES, BUILD_NEW_PYTON_SUPPORT, WITH_QT ecc..

mingw32 SSE/SSE2 instabilities

La versione 2.2 di OpenCV compilata con MinGW32 presenta malfunzionamenti se è attiva l'ottimizzazione SSE/SSE2 O3. Gli sviluppattori consigliano di utilizzare l'ottimizzazione -O2. Vedi https://code.ros.org/trac/opencv/ticket/583
Nella configurazione di CMake, assicurarsi di aver disattivato l'opzione di default per -O3 ed impostare i flag per -O2 nel seguente modo:

USE_O3 = False
CMAKE_CXX_FLAGS_RELEASE = -O2 -DNDEBUG

per trovare la voce USE_O3 è necessario attivare l'opzione "advanced" in CMake

Aggiungere il supporto per la libreria Intel® Threading Building Blocks (TBB) ad OpenCV

Per compilare OpenCV + il supporto TBB con MinGW è necessario disporre delle versioni TBB binarie compilate con MinGW. Fare riferimento a Compilare TBB con CodeBlock / MinGW su Windows (http://www.pklab.net/index.php?id=356&Lang=IT) per dettagli sulla procedura.

Supponiamo di avere la versione binaria corretta di TBB in C:\LIBS\tbb30_20101215oss\Build\windows_ia32_gcc_mingw_release. A questo punto precedere con CMake nel modo seguente:

Impostare

WITH_TBB = YES

Click su Configure. CMake rigenera la configurazione. Ora compaiono nuovi parametri di configurazione per TBB da impostare

TBB_INCLUDE_DIR = C:\LIBS\tbb30_20101215oss\include
TBB_LIB_DIR     = C:\LIBS\tbb30_20101215oss\Build\windows_ia32_gcc_mingw_release 

Aggiungere il supporto per la libreria Eigen ad OpenCV

Eigen è una C++ template library per algebra lineare, vettori matrici e relativi algoritmi.

Supponiamo di avere scompattato la libreria in C:\LIBS\Eigen2. Procedere con CMake nel modo seguente e Impostare

WITH_EIGEN2 = YES

Click su Configure, CMake rigenera la configurazione. A questo punto compaiono nuovi parametri di configurazione per EIGEN da impostare

EIGEN2_INCLUDE_PATH = C:\LIBS\Eigen2

Compilare OpenCV

Una volta completata la configurazione

1. Click su Configure
2. Click su Generate. CMake genera i Makefile necessari 
3. Chiudere CMake
4. Aprire una finestra dos in C:\LIBS\OpenCV2.2\CodeBlocks
5. Lanciare la compilazione con

C:\LIBS\OpenCV2.2\CodeBlocks> mingw32-make.exe 

...attendere con pazienza diversi minuti...

Se la compilazione ha successo troverete i file nelle cartelle CodeBlocks\Lib, CodeBlocks\Bin e CodeBlocks\Include.

A questo punto è necessario rendere disponibili le DLL di OpenCV e delle librerie utilizzate, alle applicazioni che si andranno a realizzare. Sono possibili 3 soluzioni

• Copiare le DLL in C:\Windows\ o in un percorso presente nella PATH
• Copiare le DLL nella stessa cartella della applicazione
• Impostare la PATH con il percorso che contiene le DLL

Dopo la compilazione, le DLL sono state create in C:\LIBS\OpenCV2.2\CodeBlocks\Bin. Se è stato utilizzato il supporto TBB allora saranno necessarie anche le DLL relative che in questo esempio saranno in C:\LIBS\tbb30_20101215oss\Build\windows_ia32_gcc_mingw_release\bin

Compilare un esempio di OpenCV con Code::Blocks

Creare un nuovo progetto e impostare il compilatore affinchè sia in grado di reperire i file di OpenCV ovvero:

• In: Project / Build options / Linker settings / Link Libraries : C:\LIBS\OpenCV2.2\CodeBlocks\lib\*.dll.a
• In: Project / Build options / Search Directories / Compiler: C:\LIBS\OpenCV2.2\CodeBlocks\include
• In: Project / Build options / Search Directories / Linker: C:\LIBS\OpenCV2.2\CodeBlocks\Lib

Rimuovere il file Main.cpp creato di default, aprire uno dei file di esempio (C:\LIBS\OpenCV2.2\Samples\Cpp\dft.cpp) e compilare !