OpenCV.

Gua de Instalacin para Windows

Luis Gilberto Mateos Ortiz, luismattor@gmail.com
Facultad de Ingeniera, UNAM

ndice de contenido
Introduccin..........................................................................................................................................................................2
Instalacin de OpenCV..........................................................................................................................................................2
Procedimiento..................................................................................................................................................................2
Instalacin de MinGW...........................................................................................................................................................3
Procedimiento..................................................................................................................................................................3
Instalacin de codeblocks......................................................................................................................................................4
Procedimiento..................................................................................................................................................................4
Instalacin de gtk-runtime y pkg-config................................................................................................................................4
Procedimiento de instalacin de gtk-runtime..................................................................................................................6
Procedimiento de instalacin de pkg-config....................................................................................................................6
Programa de ejemplo para comprobar que todo est correctamente instalado..................................................................8
Referencias............................................................................................................................................................................ 9

Introduccin
OpenCV es una biblioteca libre de visin artificial originalmente desarrollada por Intel. Desde que apareci su primera versin alfa en el mes de
enero de 1999, se ha utilizado en infinidad de aplicaciones. Desde sistemas de seguridad con deteccin de movimiento, hasta control de procesos
donde se requiere reconocimiento de objetos. Esto se debe a que su publicacin se da bajo licencia BSD, que permite que sea usada libremente
para propsitos comerciales y de investigacin con las condiciones en ella expresadas.
OpenCV es multiplataforma, existiendo versiones para GNU/Linux, Mac OS X y Windows. Contiene ms de 500 funciones que abarcan una gran
gama de reas en el proceso de visin, como reconocimiento de objetos, reconocimiento facial, calibracin de cmaras, visin estreo, aplicaciones
en robtica, etc.
OpenCV contiene diferentes interfaces para diferentes lenguajes de programacin, es posible desarrollar programas OpenCV en C, C++, python e
incluso en telfonos mviles con sistema operativo android.
A continuacin se presenta el proceso de instalacin de los componentes necesarios para desarrollar aplicaciones de visin por computadora
utilizando OpenCV en lenguaje C. Primero se muestra una manera de instalar el paquete OpenCV, este paquete es el que contiene las funciones y
algoritmos de visin. Segundo, se muestra como instalar MinGW, necesario para compilar nuestro cdigo en lenguaje C. Tercero, se muestra
como instalar CodeBlocks, un entorno de desarrollo integrado que facilitar los procesos de edicin de cdigo y compilacin. Cuarto, se presenta
como instalar pkg-config, programa que permitir llamar las bibliotecas necesarias para compilar el programa OpenCV. Finalmente se presenta un
programa ejemplo para comprobar que todo haya sido instalado y configurado correctamente.

Instalacin de OpenCV
El paquete para la instalacin de OpenCV en su versin 2.2 puede ser descargado de la siguiente direccin:
http://sourceforge.net/projects/opencvlibrary/files/opencv-win/2.2/

Ilustracin 1: Descarga del paquete de OpenCV versin 2.2

Procedimiento
Al ejecutar el archivo descargado, se abrir el asistente de instalacin de OpenCV 2.2. Se recomienda seguir los siguientes pasos:
1.

Primera pantalla. Dar click en siguiente

2.

Segunda pantalla. Aceptar el contrato de licencia

3.

Tercera pantalla. Seleccionar Add opencv to the system PATH for all users

4.

Cuarta pantalla. Aceptar instalacin en carpeta C:\OpenCV2.2.

5.

Quinta pantalla. Dar click en siguiente

6.

Sexta pantalla. Dar click en Instalar

Instalacin de MinGW
MinGW (Minimalist GNU for Windows), anteriormente conocido como MinGW32, es una implementacin de los compiladores GCC para la
plataforma Win32, que permite migrar la capacidad de este compilador en entornos Windows.
El paquete para la instalacin de MinGW puede ser descargado de la siguiente direccin:
http://sourceforge.net/projects/mingw/files/

Ilustracin 2: Descarga del paquete MinGW

Procedimiento
Al ejecutar el archivo descargado, se abrir el asistente de instalacin de MinGW. Se recomienda seguir los siguientes pasos:
1.

Primera pantalla. Dar click en next

2.

Segunda pantalla. Dar click en next

3.

Tercera pantalla. Dar click en next

4.

Cuarta pantalla. Aceptar el contrato de licencia

5.

Quinta pantalla. Aceptar instalacin en carpeta C:\MinGW

6.

Sexta pantalla. Dar click en next

7.

Sptima pantalla. Habilitar los compiladores C y C++

8.

Octava pantalla. Dar click en Install

9.

Finalmente agregar el directorio C:\MinGW\bin a la variable PATH del sistema. Para editar la variable de entorno,

1.

Windows 7. Dar click en Inicio (icono de windows). Posicionar el ratn en el botn Equipo, dar click derecho y elegir
Propiedades. En el panel lateral dar click en configuracin avanzada del sistema. Se abrir la ventana de propiedades del
sistema, dar click en variables de entorno. En la seccin variables del sistema editar la variable Path agregando (a lo ya
existente) la siguiente cadena: ;C:\MinGW\bin (recuerda escribir el punto y coma).

2.

Windows XP. Dar click en Inicio. Posicionar el ratn en el botn Mi PC, dar click derecho y elegir Propiedades. Se abrir la
ventana de propiedades del sistema, ir a la pestaa opciones avanzadas y dar clik en variables de entorno. En la seccin
variables del sistema editar la variable Path agregando (a lo ya existente) la siguiente cadena: ;C:\MinGW\bin (recuerda
escribir el punto y coma).

Instalacin de codeblocks
Code::Blocks es un entorno de desarrollo integrado libre y multiplataforma para el desarrollo de programas en lenguaje C++. Est basado en la
plataforma de interfaces grficas WxWidgets, lo cual quiere decir que puede usarse libremente en diversos sistema operativos, y est licenciado
bajo la Licencia pblica general de GNU.El paquete para la instalacin de MinGW puede ser descargado de la siguiente direccin:
http://www.codeblocks.org/downloads/binaries

Ilustracin 3: Descarga de Code::Blocks

Procedimiento
Al ejecutar el archivo descargado, se abrir el asistente de instalacin de codeblocks. El proceso de instalacin es sencillo. Se recomienda instalar
dejando las opciones predeterminadas.

Instalacin de gtk-runtime y pkg-config

Pkg-config es un software que provee una interfaz unificada para llamar bibliotecas instaladas cuando se est compilando un programa a partir del
cdigo fuente. Da informacin diversa sobre las bibliotecas instaladas. Esta informacin incluye:

Parmetros para el compilador de C o de C++.

Parmetros para el enlazador.
Versin del paquete en cuestin.

El paquete gtk-runtime ser instalado debido a que es una dependencia del paquete pkg-config. El paquete para la instalacin de gtk-runtime
puede ser descargado de la siguiente direccin:
http://sourceforge.net/projects/gtk-win/
El programa pkg-config puede ser descargado de la siguiente direccin:
http://www.gtk.org/download/win32.php

Ilustracin 4: Descarga de gtk-runtime

Ilustracin 5: Descarga de pkg-config

Procedimiento de instalacin de gtk-runtime

Al ejecutar el archivo descargado, se abrir el asistente de instalacin de gtk-config. El proceso de instalacin es sencillo. Se recomienda instalar
dejando las opciones predeterminadas.

Procedimiento de instalacin de pkg-config

Al hacer click sobre el link mostrado en la ilustracin 5 se obtiene un archivo en formato zip llamado pkg-config_0.23-3_win32. Extraemos el
contenido de dicha archivo y obtenemos dos carpetas: bin y manifest. Dentro de la carpeta bin est el ejecutable llamado pkg-config. A
continuacin se describe el procedimiento para configurar adecuadamente pkg-config:
1.

Debemos copiar el ejecutable pkg-config a la carpeta bin del directorio de instalacin de MinGW (C:\MinGW\bin por default).

2.

Se debe crear la carpeta pkg-config en el directorio de instalacin de MinGW ( C:\MinGW\pkg-config).

3.

Se debe crear un archivo llamado opencv.pc con el siguiente texto:

# Package Information for pkg-config

prefix=C:/OpenCV2.2
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir_old=${prefix}/include/opencv
includedir_new=${prefix}/include

Name: OpenCV
Description: Open Source Computer Vision Library
Version: 2.2.0
Libs: -L${libdir} -lopencv_core220 -lopencv_imgproc220 -lopencv_highgui220 -lopencv_ml220
-lopencv_calib3d220 -lopencv_objdetect220 -lopencv_contrib220 -lopencv_legacy220 -lopencv_flann220

-lopencv_video220

-lopencv_features2d220

Cflags: -I${includedir_old} -I${includedir_new}

4.

Copiar opencv.pc a C:\MinGW\pkg-config

5.

Agregar una variable de entorno llamada PKG_CONFIG_PATH al sistema y cuyo valor sea el path donde se localizan los archivos .pc de
pkg-config (C:\MinGW\pkg-config)

Windows 7. Dar click en Inicio (icono de windows). Posicionar el ratn en el botn Equipo, dar click derecho y elegir
Propiedades. En el panel lateral dar click en configuracin avanzada del sistema. Se abrir la ventana de propiedades del
sistema, dar click en variables de entorno. En la seccin variables del usuario agregar la variable PKG_CONFIG_PATH con
el valor C:\MinGW\pkg-config.

Windows XP. Dar click en Inicio. Posicionar el ratn en el botn Mi PC, dar click derecho y elegir Propiedades. Se abrir la
ventana de propiedades del sistema, ir a la pestaa opciones avanzadas y dar clik en variables de entorno. En la seccin
variables del usuario agregar la variable PKG_CONFIG_PATH con el valor C:\MinGW\pkg-config.

Ilustracin 6: Creacin del archivo opencv.pc en la carpeta C:\MinGW\pkg-config

Ilustracin 7: Creacin de la variable de entorno PKG-CONFIG-PATH

Programa de ejemplo para comprobar que todo est correctamente instalado

Abrir codeblocks. Ir a File>New>Project. Crear una aplicacin de consola utilizando lenguaje C. Poner como titulo de proyecto TestOpenCV.
En el archivo main.c creado poner el siguiente cdigo:

#include <stdlib.h>
#include <cv.h>
#include <highgui.h>

int main(int argc, _TCHAR* argv[])

{
cvNamedWindow( "Imagen", 0 );
cvWaitKey(0);
return 0;
}

Despus ir al menu Project y hacer click en Build Options. En el panel lateral izquierdo hacer click en TestOpenCV. En la pestaa Compiler
settings hacer click en la pestaa other options y escribir
`pkg-config opencv --cflags`
(nota: tener cuidado de colocar el carcter ` al inicio y al final)
En la pestaa Linker settings, en la seccin Other linker options escribir:
`pkg-config opencv --libs`

Ilustracin 8: Configuracin de las opciones de compilacin del proyecto mediante pkg-config

Damos click en OK para aceptar los cambios y compilamos el proyecto presionando la tecla F9 o haciendo click en Build and run en el men
Build. El resultado se muestra en la ilustracin 9.

Ilustracin 9: Ejecucin del programa ejemplo

Referencias
http://es.wikipedia.org/wiki/OpenCV
http://es.wikipedia.org/wiki/MinGW
http://es.wikipedia.org/wiki/Code::Blocks
http://es.wikipedia.org/wiki/Pkg-config