----------------------------------------------------------------------------------------------------
Manual de Instalación y configuración de la librería ARUCO  en Linux
----------------------------------------------------------------------------------------------------

Requisitos: cuenta con privilegios de administración

- Librería OpenCV instalada y configurada


Más información en  http://www.uco.es/investiga/grupos/ava/node/26


1) Instalar la librería ARUCO:

ARUCO es una librería OpenSource con licencia BSD desarrollada por el grupo AVA de la Universidad de Córdoba para la implementación de aplicaciones de Realidad Aumentada mediante la detección de marcadores codificados. Está basada en la libraría OpenCV, por lo que debemos tener esta librería instalada en nuestro ordenador (Manual de instalación de OpenCV)

Podemos descargar el código fuente de la librería desde la web del proyecto ARUCO (http://sourceforge.net/projects/aruco/)


aruco-3.1.12.zip


1) Actualizar lista de paquetes: 

Ejecutaremos  los siguientes comandos en la consola:


sudo apt-get update
sudo apt-get upgrade

 
(... nos pedirá la clave de nuestra cuenta con privilegios de admimistración)


2) Instalar paquetes adicionales (Librerías OpenGL/Glut/OGRE): 

Estas librerías son opcionales y nos permiten utilizar las funciones de renderizado de gráficos 3D.

Ejecutaremos  los siguientes comandos en la consola:


sudo apt-get -y install freeglut3 freeglut3-dev binutils-gold
sudo apt-get -y install libogre-1.9.0v5 libogre-1.9-dev 

 



3) Instalar la librería ARUCO:

Descargaremos la versión para Linux (aruco-3.1.12.zip ):



wget https://sourceforge.net/projects/aruco/files/3.1.12/aruco-3.1.12.zip
 

Descomprimiremos el fichero 


unzip aruco-3.1.12.zip
cd aruco-3.1.12
 
 
4) Compilar la librería ARUCO:

Ejecutaremos  los siguientes comandos en la consola:


mkdir build
cd build

cmake -D BUILD_SHARED_LIBS=OFF  -D CMAKE_INSTALL_PREFIX=/usr/local ..

make


(......Puede tardar algún tiempo en compilar la librería)

La opción -D BUILD_SHARED_LIBS=OFF deberá  quitarse si queremos compilarla como una libraría dinámica compartida.


sudo make install


(... nos pedirá la clave de nuestra cuenta para instalar los ficheros de la librería)



5) Configurar variables de entorno:

Ejecutaremos  los siguientes comandos en la consola:

sudo sh -c 'echo "/usr/local/lib" >> /etc/ld.so.conf.d/aruco.conf'
sudo ldconfig



6) Compilación con CMAKE: (ej9.cpp)

- Crear una carpeta y colocar en ella el código fuente que deseamos compilar (ej9.cpp)

- Crear un fichero en esa carpeta llamado CMakeLists.txt con el siguiente contenido:


--------
Aruco Version 3.1
-----------------


CMAKE_MINIMUM_REQUIRED(VERSION 2.8)
FIND_PACKAGE( OpenCV 4.5 REQUIRED )
FIND_PACKAGE ( aruco REQUIRED )
LINK_LIBRARIES( ${OpenCV_LIBS}  ${aruco_LIBS})
SET(CMAKE_CXX_FLAGS " -fopenmp")

ADD_EXECUTABLE ( ej9   ej9.cpp )

--------------


- Ejecutar en la consola:

cd 'Directorio del programa'
cmake .
make

./ej9



7) Utilidades: 

- En la siguiente carpeta tenemos varios programas ya compilados para probar la librería y gestionar los marcadores (una copia de los mismos está disponible en ‘/usr/local/bin’):

cd ~/aruco-3.1.12/build/utils




----------------------------------------------------------------------------------------------------
Visión por Computador (1782)
Grado Ingeniería Electrónica y Automática Industrial
Dpto. Ingeniería de Sistemas y Automática
Universidad Miguel Hernández