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. 2. 3. 4. Primera pantalla. Dar click en siguiente Segunda pantalla. Aceptar el contrato de licencia Tercera pantalla. Seleccionar Add opencv to the system PATH for all users Cuarta pantalla. Aceptar instalacin en carpeta C:\OpenCV2.2.

5. 6.

Quinta pantalla. Dar click en siguiente 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. 2. 3. 4. 5. 6. 7. 8. 9. Primera pantalla. Dar click en next Segunda pantalla. Dar click en next Tercera pantalla. Dar click en next Cuarta pantalla. Aceptar el contrato de licencia Quinta pantalla. Aceptar instalacin en carpeta C:\MinGW Sexta pantalla. Dar click en next Sptima pantalla. Habilitar los compiladores C y C++ Octava pantalla. Dar click en Install 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). 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).

2.

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. 2. 3. Debemos copiar el ejecutable pkg-config a la carpeta bin del directorio de instalacin de MinGW (C:\MinGW\bin por default). Se debe crear la carpeta pkg-config en el directorio de instalacin de MinGW ( C:\MinGW\pkg-config). 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 Cflags: -I${includedir_old} -I${includedir_new} -lopencv_video220 -lopencv_features2d220

4. 5.

Copiar opencv.pc a C:\MinGW\pkg-config 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