Introducción
En el presente artículo se describirán los pasos necesarios para instalar el software de OpenCV y su correspondiente librería para desarrollar sketches con él utilizando Processing.
Durante el desarrollo de la instalación se utilizó GNU/Linux Mint 12 sin emgbargo el procedimiento debe ser compatible con Ubuntu.
Aviso! La versión de OpenCV que se encuentra en los repositorios del sistema operativo (2.1.0-7build1) es un poco antigua, sin embargo se encontraron problemas para compilar la parte nativa de la librería con una versión mas reciente. Por este motivo se decidió utilizar la versión disponible y experimentar posteriormente una posible actualización.
Procedimiento
Instalar OpenCV
$ sudo aptitude install libcv-dev libhighgui-dev libcvaux-dev opencv-doc
Instalar la librería de Processing
Nota! Se recomienda descargar la última versión disponible de la página web del desarrollador. En este caso se utilizó opencv_01.zip.
Crear el directorio donde se almacenarán las librerías de Processing del usuario.
$ mkdir -p ~/sketchbook/libraries ; cd ~/sketchbook/libraries
Descargar la librería y los ejemplos de la misma.
$ wget http://ubaa.net/shared/processing/opencv/download/opencv_01.zip
$ wget http://ubaa.net/shared/processing/opencv/download/opencv_examples.zip
Descomprimir los paquetes recién descargados
$ unzip opencv_01.zip
$ rm opencv_01.zip
$ unzip opencv_examples.zip
$ rm opencv_examples.zip
Ubicar correctamente el directorio con los ejemplos.
$ mv OpenCV\ examples/ OpenCV/examples
Recompilar el módulo nativo de la librería
La librería incluye una librería del sistema operativo (libOpenCV.so) enlazada dinámicamente con OpenCV. La incluída con la distribución de la librería recién instalada fue compilada con versiones anteriores de OpenCV motivo por el cual no se cumplen sus dependencias y en el momento de compilar los sketches se obtiene el siguiente mensaje de error.
!!! required library not found : /home/jimezam/sketchbook/libraries/OpenCV/library/libOpenCV.so: libcxcore.so.1: cannot open shared object file: No such file or directory
Verify that the java.library.path property is correctly set and 'libcxcore.so', 'libcv.so', 'libcvaux.so', 'libml.so', and 'libhighgui.so' are placed (or linked) in one of your system shared libraries folder
Exception in thread "Animation Thread" java.lang.UnsatisfiedLinkError: hypermedia.video.OpenCV.capture(III)V
at hypermedia.video.OpenCV.capture(Native Method)
at hypermedia.video.OpenCV.capture(OpenCV.java:945)
at sketch_jan12b.setup(sketch_jan12b.java:35)
at processing.core.PApplet.handleDraw(Unknown Source)
at processing.core.PApplet.run(Unknown Source)
at java.lang.Thread.run(Thread.java:662)
Por este motivo es necesario recompilar el módulo nativo con las versiones actuales. Para hacer esto se deben seguir los siguientes pasos.
$ cd ~/sketchbook/libraries/OpenCV/library/
Crear una copia de seguridad del módulo nativo a recompilarse.
$ mv libOpenCV.so libOpenCV.so.OLD
Generar la cabecera del módulo nativo de Java (JNI).
$ javah -classpath OpenCV.jar -jni hypermedia.video.OpenCV
Recompilar el módulo nativo.
$ g++ -shared ../source/cpp/OpenCV.cpp -o libOpenCV.so -I/usr/include/opencv/ -I/usr/lib/jvm/java-1.6.0-openjdk/include/ -I. -lcv -lhighgui -fPIC
Finalmente se obtienen los siguientes archivos.
$ ls -l
-rw-rw-r– 1 jimezam jimezam 10748 2012-01-12 14:43 hypermedia_video_OpenCV.h
-rwxr-xr-x 1 jimezam jimezam 80088 2009-05-27 13:15 libOpenCV.jnilib
-rwxrwxr-x 1 jimezam jimezam 41953 2012-01-12 16:16 libOpenCV.so
-rwxr-xr-x 1 jimezam jimezam 42861 2009-05-27 13:15 libOpenCV.so.OLD
-rwxr—– 1 jimezam jimezam 515184 2009-05-27 13:15 OpenCV.dll
-rw-r–r– 1 jimezam jimezam 12116 2009-05-27 13:15 OpenCV.jar
Instalar los perfiles de reconocimiento
Los perfiles de reconocimiento son archivos XML donde se estructura el conocimiento que le permite a la librería reconocer rostros sin la necesidad de mayor entrenamiento. La versión actual de los paquetes de OpenCV en los repositorios instala estos perfiles en una ubicación que no permite que sean utilizados fácilmente desde Processing. Los siguientes pasos corrígen esta situación.
$ sudo cp -R /usr/share/doc/opencv-doc/examples/haarcascades /usr/share/opencv/
$ sudo gunzip /usr/share/opencv/haarcascades/*.gz
Sketch de prueba
Una vez instalada la librería se podrán desarrollar sketches con ella, a continuación se presenta el sketch mas sencillo posible que muestra la imagen proveniente de la cámara web utilizando OpenCV.
import hypermedia.video.*;
OpenCV opencv;
void setup()
{
size(640, 480);
opencv = new OpenCV(this);
opencv.capture(width,height);
}
void draw()
{
opencv.read();
background(opencv.image());
}
Enlaces
- OpenCV – Open Source Computer Vision
http://opencv.willowgarage.com/wiki/ - Librería para Processing
http://ubaa.net/shared/processing/opencv/ - Documentación del API
http://ubaa.net/shared/processing/opencv/opencv.html - Código fuente
http://blog.jorgeivanmeza.com/wp-content/uploads/2012/01/OpenCV_HelloWorld.zip
Adicionalmente el wiimote vibrará cuando el caballero se encuentre con ella.
