OpenCV.

Gua de Instalacin para Windows

Luis Gilberto Mateos Ortiz, luismattor@gmail.com
Facultad de Ingeniera, !"M
ndice de contenido
Introduccin.......................................................................................................................................................................... 2
Instalacin de OpenCV.......................................................................................................................................................... 2
Procedimiento.................................................................................................................................................................. 2
Instalacin de MinGW........................................................................................................................................................... 3
Procedimiento.................................................................................................................................................................. 3
Instalacin de codeblocks......................................................................................................................................................
Procedimiento..................................................................................................................................................................
Instalacin de gtk!runtime " pkg!con#ig................................................................................................................................
Procedimiento de instalacin de gtk!runtime..................................................................................................................$
Procedimiento de instalacin de pkg!con#ig....................................................................................................................$
Programa de e%emplo para comprobar &ue todo est' correctamente instalado..................................................................(
)e#erencias............................................................................................................................................................................ *
Introduccin
OpenCV es una biblioteca libre de +isin arti#icial originalmente desarrollada por Intel. ,esde &ue apareci su primera +ersin al#a en el mes de
enero de -***. se /a utili0ado en in#inidad de aplicaciones. ,esde sistemas de seguridad con deteccin de mo+imiento. /asta control de procesos
donde se re&uiere reconocimiento de ob%etos. 1sto se debe a &ue su publicacin se da ba%o licencia 23,. &ue permite &ue sea usada libremente
para propsitos comerciales " de in+estigacin con las condiciones en ella e4presadas.
OpenCV es multiplata#orma. e4istiendo +ersiones para G5678inu4. Mac O3 9 " Windo:s. Contiene m's de ;<< #unciones &ue abarcan una gran
gama de 'reas en el proceso de +isin. como reconocimiento de ob%etos. reconocimiento #acial. calibracin de c'maras. +isin est=reo. aplicaciones
en robtica. etc.
OpenCV contiene di#erentes inter#aces para di#erentes lengua%es de programacin. es posible desarrollar programas OpenCV en C. C>>. p"t/on e
incluso en tel=#onos m+iles con sistema operati+o android.
? continuacin se presenta el proceso de instalacin de los componentes necesarios para desarrollar aplicaciones de +isin por computadora
utili0ando OpenCV en lengua%e C. Primero se muestra una manera de instalar el pa&uete OpenCV. este pa&uete es el &ue contiene las #unciones "
algoritmos de +isin. 3egundo. se muestra como instalar MinGW. necesario para compilar nuestro cdigo en lengua%e C. @ercero. se muestra
como instalar Code2locks. un entorno de desarrollo integrado &ue #acilitar' los procesos de edicin de cdigo " compilacin. Cuarto. se presenta
como instalar pkg!con#ig. programa &ue permitir' llamar las bibliotecas necesarias para compilar el programa OpenCV. Ainalmente se presenta un
programa e%emplo para comprobar &ue todo /a"a sido instalado " con#igurado correctamente.
Instalacin de OpenCV
1l pa&uete para la instalacin de OpenCV en su +ersin 2.2 puede ser descargado de la siguiente direccinB
/ttpB77source#orge.net7pro%ects7openc+librar"7#iles7openc+!:in72.27
Procedimiento
?l e%ecutar el arc/i+o descargado. se abrir' el asistente de instalacin de OpenCV 2.2. 3e recomienda seguir los siguientes pasosB
-. Primera pantalla. ,ar click en CsiguienteD
2. 3egunda pantalla. ?ceptar el contrato de licencia
3. @ercera pantalla. 3eleccionar C?dd openc+ to t/e s"stem P?@E #or all usersD
. Cuarta pantalla. ?ceptar instalacin en carpeta CBFOpenCV2.2.
Ilustracin 1: Descarga del paquete de OpenCV versin 2.2
;. Guinta pantalla. ,ar click en CsiguienteD
$. 3e4ta pantalla. ,ar click en CInstalarD
Instalacin de MinGW
MinGW HMinimalist GNU !r "ind!#sI. anteriormente conocido como MinGW32. es una implementacin de los compiladores GCC para la
plata#orma Win32. &ue permite migrar la capacidad de este compilador en entornos Windo:s.
1l pa&uete para la instalacin de MinGW puede ser descargado de la siguiente direccinB
/ttpB77source#orge.net7pro%ects7ming:7#iles7
Procedimiento
?l e%ecutar el arc/i+o descargado. se abrir' el asistente de instalacin de MinGW. 3e recomienda seguir los siguientes pasosB
-. Primera pantalla. ,ar click en Cne4tD
2. 3egunda pantalla. ,ar click en Cne4tD
3. @ercera pantalla. ,ar click en Cne4tD
. Cuarta pantalla. ?ceptar el contrato de licencia
;. Guinta pantalla. ?ceptar instalacin en carpeta CBFMinGW
$. 3e4ta pantalla. ,ar click en Cne4tD
J. 3=ptima pantalla. Eabilitar los compiladores C " C>>
(. Octa+a pantalla. ,ar click en CInstallD
*. Ainalmente agregar el directorio CBFMinGWFbin a la +ariable P?@E del sistema. Para editar la +ariable de entorno.
Ilustracin 2: Descarga del paquete MinG"
-. Windo:s J. ,ar click en Inicio Hicono de :indo:sI. Posicionar el ratn en el botn C1&uipoD. dar click derec/o " elegir
CPropiedadesD. 1n el panel lateral dar click en Ccon#iguracin a+an0ada del sistemaD. 3e abrir' la +entana de propiedades del
sistema. dar click en C+ariables de entornoD. 1n la seccin C+ariables del sistemaD editar la +ariable CPat/D agregando Ha lo "a
e4istenteI la siguiente cadenaB CKCBFMinGWFbinD Hrecuerda escribir el punto " comaI.
2. Windo:s 9P. ,ar click en Inicio. Posicionar el ratn en el botn CMi PCD. dar click derec/o " elegir CPropiedadesD. 3e abrir' la
+entana de propiedades del sistema. ir a la pestaLa Copciones a+an0adasD " dar clik en C+ariables de entornoD. 1n la seccin
C+ariables del sistemaD editar la +ariable CPat/D agregando Ha lo "a e4istenteI la siguiente cadenaB CKCBFMinGWFbinD Hrecuerda
escribir el punto " comaI.
Instalacin de codeblocks
CodeBB2locks es un entorno de desarrollo integrado libre " multiplata#orma para el desarrollo de programas en lengua%e C>>. 1st' basado en la
plata#orma de inter#aces gr'#icas W4Widgets. lo cual &uiere decir &ue puede usarse libremente en di+ersos sistema operati+os. " est' licenciado
ba%o la 8icencia pMblica general de G56.1l pa&uete para la instalacin de MinGW puede ser descargado de la siguiente direccinB
/ttpB77:::.codeblocks.org7do:nloads7binaries
#rocedi$iento
?l e%ecutar el arc/i+o descargado. se abrir' el asistente de instalacin de codeblocks. 1l proceso de instalacin es sencillo. 3e recomienda instalar
de%ando las opciones predeterminadas.
Instalacin de gtk-runtime y pkg-config
Pkg!con#ig es un so#t:are &ue pro+ee una inter#a0 uni#icada para llamar bibliotecas instaladas cuando se est' compilando un programa a partir del
cdigo #uente. ,a in#ormacin di+ersa sobre las bibliotecas instaladas. 1sta in#ormacin inclu"eB
Par'metros para el compilador de C o de C>>.
Par'metros para el enla0ador.
Versin del pa&uete en cuestin.
Ilustracin $: Descarga de C!de::%l!c&s
1l pa&uete gtk!runtime ser' instalado debido a &ue es una dependencia del pa&uete pkg!con#ig. 1l pa&uete para la instalacin de gtk!runtime
puede ser descargado de la siguiente direccinB
/ttpB77source#orge.net7pro%ects7gtk!:in7
1l programa pkg!con#ig puede ser descargado de la siguiente direccinB
/ttpB77:::.gtk.org7do:nload7:in32.p/p
Ilustracin ': Descarga de gt&(runtime
Ilustracin ): Descarga de p&g(c!nig
#rocedi$iento de instalacin de gt%&runti$e
?l e%ecutar el arc/i+o descargado. se abrir' el asistente de instalacin de gtk!con#ig. 1l proceso de instalacin es sencillo. 3e recomienda instalar
de%ando las opciones predeterminadas.
Procedimiento de instalacin de pkg-config
?l /acer click sobre el link mostrado en la ilustracin ; se obtiene un arc/i+o en #ormato 0ip llamado pkg!con#igN<.23!3N:in32. 14traemos el
contenido de dic/a arc/i+o " obtenemos dos carpetasB bin " mani#est. ,entro de la carpeta bin est' el e%ecutable llamado Cpkg!con#igD. ?
continuacin se describe el procedimiento para con#igurar adecuadamente pkg!con#igB
-. ,ebemos copiar el e%ecutable Cpkg!con#igD a la carpeta bin del directorio de instalacin de MinGW HCBFMinGWFbin por de#aultI.
2. 3e debe crear la carpeta pkg!con#ig en el directorio de instalacin de MinGW H CBFMinGWFpkg!con#igI.
3. 3e debe crear un arc/i+o llamado openc+.pc con el siguiente te4toB
O Package In#ormation #or pkg!con#ig
pre#i4PCB7OpenCV2.2
e4ecNpre#i4PQRpre#i4S
libdirPQRe4ecNpre#i4S7lib
includedirNoldPQRpre#i4S7include7openc+
includedirNne:PQRpre#i4S7include
5ameB OpenCV
,escriptionB Open 3ource Computer Vision 8ibrar"
VersionB 2.2.<
8ibsB !8QRlibdirS !lopenc+Ncore22< !lopenc+Nimgproc22< !lopenc+N/ig/gui22< !lopenc+Nml22< !lopenc+N+ideo22< !lopenc+N#eatures2d22<
!lopenc+Ncalib3d22< !lopenc+Nob%detect22< !lopenc+Ncontrib22< !lopenc+Nlegac"22< !lopenc+N#lann22<
C#lagsB !IQRincludedirNoldS !IQRincludedirNne:S
. Copiar openc+.pc a CBFMinGWFpkg!con#ig
;. ?gregar una +ariable de entorno llamada PTGNCO5AIGNP?@E al sistema " cu"o +alor sea el pat/ donde se locali0an los arc/i+os .pc de
pkg!con#ig HCBFMinGWFpkg!con#igI
Windo:s J. ,ar click en Inicio Hicono de :indo:sI. Posicionar el ratn en el botn C1&uipoD. dar click derec/o " elegir
CPropiedadesD. 1n el panel lateral dar click en Ccon#iguracin a+an0ada del sistemaD. 3e abrir' la +entana de propiedades del
sistema. dar click en C+ariables de entornoD. 1n la seccin C+ariables del usuarioD agregar la +ariable CPTGNCO5AIGNP?@ED con
el +alor CBFMinGWFpkg!con#ig.
Windo:s 9P. ,ar click en Inicio. Posicionar el ratn en el botn CMi PCD. dar click derec/o " elegir CPropiedadesD. 3e abrir' la
+entana de propiedades del sistema. ir a la pestaLa Copciones a+an0adasD " dar clik en C+ariables de entornoD. 1n la seccin
C+ariables del usuarioD agregar la +ariable CPTGNCO5AIGNP?@ED con el +alor CBFMinGWFpkg!con#ig.
Ilustracin *: Creacin de la varia+le de ent!rn! ,-G(CON.IG(,/01
Ilustracin 2: Creacin del arc3iv! !pencv.pc en la carpeta C:4MinG"4p&g(c!nig
#rogra$a de e'e$plo para co$probar (ue todo est) correcta$ente instalado
?brir codeblocks. Ir a AileU5e:UPro%ect. Crear una aplicacin de consola utili0ando lengua%e C. Poner como titulo de pro"ecto @estOpenCV.
1n el arc/i+o main.c creado poner el siguiente cdigoB
Oinclude Vstdlib./U
Oinclude Vc+./U
Oinclude V/ig/gui./U
int mainHint argc. N@CE?)W arg+XYI
R
c+5amedWindo:H ZImagenZ. < IK
c+WaitTe"H<IK
return <K
S
,espu=s ir al menu Pro%ect " /acer click en C2uild OptionsD. 1n el panel lateral i0&uierdo /acer click en C@estOpenCVD. 1n la pestaLa CCompiler
settingsD /acer click en la pestaLa Cot/er optionsD " escribir
[pkg!con#ig openc+ !!c#lags[
HnotaB tener cuidado de colocar el car'cter [ al inicio " al #inalI
1n la pestaLa C8inker settingsD. en la seccin COt/er linker optionsD escribirB
[pkg!con#ig openc+ !!libs[
Ilustracin 5: C!niguracin de las !pci!nes de c!mpilacin del pr!6ect! mediante p&g(c!nig
,amos click en COTD para aceptar los cambios " compilamos el pro"ecto presionando la tecla A* o /aciendo click en C2uild and runD en el menM
C2uildD. 1l resultado se muestra en la ilustracin *.
*e+erencias
/ttpB77es.:ikipedia.org7:iki7OpenCV
/ttpB77es.:ikipedia.org7:iki7MinGW
/ttpB77es.:ikipedia.org7:iki7CodeBB2locks
/ttpB77es.:ikipedia.org7:iki7Pkg!con#ig
Ilustracin 7: 89ecucin del pr!grama e9empl!