Instalación de la biblioteca OpenCV en Windows 10

Los pasos que seguiremos serán tres:

1. Descargar una versión gratuita del Visual Studio de Microsoft para poder programar las
diversas aplicaciones.
2. Descargar una versión ya compilada de la biblioteca OpenCV.
3. Configurar el Visual Studio para que pueda usar la librería.

1. Instalar Visual Studio

Vamos a instalar el Visual Studio 2022 Community, al ser una versión gratuita. Si se tiene ya
instalada otra versión (2015, 2017, 2019) del Visual Studio no hará falta.

Para descargar la versión 2022 accedemos a la dirección:

https://visualstudio.microsoft.com/es/

Y descargamos el instalador para Community 2022. Una vez descargado, ejecutamos el

instalador y elegimos la opción “Desarrollo para el escritorio con C++”.

2. Descargar Opencv

Vamos a seguir, aunque con algunas modificaciones, la instalación recomendada en

https://docs.opencv.org/master/

En OpenCV Tutorials / Introduction to OpenCV / Installation in Windows

Para ellos vamos a:

a) Descargar e instalar la biblioteca ya compilada.

b) Actualizar las variables de entorno.
El primer paso es descargarse la biblioteca OpenCV. Hay dos opciones, bajar una versión ya
compilada o los ficheros fuentes y compilarla nosotros. Vamos a seguir la primera opción porque
es la más fácil y es suficiente para los objetivos del curso. Para ello, vamos a la página:

https://opencv.org

Y en Library/Releases encontraremos varias versiones de la biblioteca. A Septiembre de 2023,

la última es la 4.8.0.

Dependiendo del compilador, bajaremos una u otra, ya que, a efectos de curso, todas son útiles.

Visual Studio 2022 (v16): OpenCV 4.8.0, OpenCV 4.7.0

Visual Studio 2017 (v15): OpenCV 4.6.0

Visual Studio 2015 (v14): OpenCV 4.6.0

En este caso, accedemos a la última versión 4.8.0.

Una vez descargada, al ejecutarla nos indica dónde instalarla. En nuestro caso, hemos elegido
el directorio raíz “c:” para que pueda ser usada por otros usuarios.
Así tendremos la biblioteca en el subdirectorio c:\opencv.

El segundo paso es actualizar las variables de entorno para que, al ejecutarse los programas,
éstos sepan dónde encontrar las diversas bibliotecas.

Para ello en “buscar”, escriba y seleccione: “Sistema (Panel de control)”

Pulse en el enlace “Configuración avanzada del sistema”.

Pulse en “Variables de entorno”. En la sección “Variables del sistema”. Pulsamos “Nuevo” y
añadimos OPENCV_DIR con el subdirectorio donde las hemos instalado. En nuestro caso
c:\opencv\build\x64\vc16. Si dispone de Visual Studio 2017 sería c:\opencv\build\x64\vc15 y,
análogamente c:\opencv\build\x64\vc14 para Visual Studio 2015.

Vamos a trabajar con librería dinámicas, “Dynamic-link libraries” o DLLs, que se cargan cuando
son necesarias en el programa mientras se ejecuta. Por ello deben de encontrarse en alguno de
los directorios que están en el PATH. Busque la variable de entorno PATH, selecciónela y pulse
Editar y añadimos “%OPENCV_DIR%\bin”

3. Integrar la biblioteca OpenCV dentro de Visual Studio

Para ello tenemos que indicarle al compilador dónde están los archivos “.h” y, al enlazador, dónde
están las librerías. Esto hay que realizarlo para todos los proyectos del Visual Studio. Por ello
haremos uno vacío e iremos incluyen el fichero fuente “.cpp” necesario para cada uno de los
ejemplos.

Visual Studio trabaja con lo que denomina “Soluciones”. Para obtenerlas, creamos un proyecto
y elegimos la opción para que sea un proyecto vacío, ya que, come hemos indicado antes,
iremos incluyen el fichero “.cpp” necesario para cada uno de los ejemplos y que se hayan
disponibles en el curso para ser descargados. Por último, hay que indicar el nombre y el directorio
donde será creada, por ejemplo “ProyectosOCV”.
Para cada aplicación hay dos modos: Release y Debug. Este último permite depurar los
programas, mientras que el primero tiene como finalidad que éstos sean lo más rápidos y
pequeños posibles. Aunque el código fuente sea el mismo, las bibliotecas que se van a enlazar
van a ser diferentes. En el caso de OpenCV veremos más adelante que se añade una “d” al
nombre para referirse a las que se utilizan en modo Debug. Por otro lado, los programas pueden
funcionar en arquitecturas de 32 y/o 64 bits. Estos dos aspectos están reflejados en la parte
superior del IDE. Como vamos a usar bibliotecas compiladas en x64, esta será siempre la opción
elegida. Sí que tendremos que elegir entre la opción Ddebug o Release, lo que no afectará a los
ejemplos del curso.
Vamos a indicar primero, dónde están los archivos de inclusión. Para ello tenemos que acceder
a las propiedades del proyecto y, por tanto, vamos a: “Ver -> Página de Propiedades”.

En la parte superior de la ventana vemos que los cambios que haremos serán válidos para la
configuración Debug, Release o ambas, todas las configuraciones. Como vamos a indicar dónde
están los archivos include, elegimos “todas la configuraciones”.

En “Directorios de VC++” se encuentra “Directorios de Archivos de Inclusión”. Lo seleccionamos

y editamos para añadir “$(OPENCV_DIR)\..\..\include”, que, si hicimos la instalación en el
directorio raíz corresponde c:\opencv\build\include. Por último, damos a “Aceptar”

Para las bibliotecas hay que realizar dos pasos: indicar dónde están y decir cuales interesan.
Para el primero, seleccionamos “Ver -> Página de Propiedades”. La configuración, “todas la
config.” Y seleccionamos “Vinculador-> General -> Directorio de bibliotecas adicionales”, donde
añadimos $(OPENCV_DIR)\lib
El segundo paso hay que indicar qué bibliotecas se tiene que usar y tendremos que usar la
configuración Debug o Release ya que los ficheros son distintos. Para ello seleccionamos “Ver -
> Página de Propiedades” y “Vinculador-> entrada -> Dependencias adicionales” y añadimos los
nombres. Como se ha comentado antes, la letra “d” indica que la biblioteca es para la opción
debug, además todas empiezan por opencv, e indican el número de la versión. Como vamos a
trabajar con la versión ya compilada, la biblioteca es: opencv_world480.lib, si estamos en modo
release y opencv_world480d.lib si estamos en modo debug. El número “480” hace referencia a
la versión de las OpenCV que tengamos.

Para cambiar entre release y debug tenemos la ventana principal de IDE

4. Compilación del primer programa.

Como se comentó anteriormente, hemos creado un proyecto vacío, así que tenemos que insertar
manualmente el código fuente. Esto nos permitirá ir cambiando éste sin necesidad de tener que
crear un proyecto para cada ejemplo y tener que repetir el proceso anterior de definir los ficheros
de inclusión y las bibliotecas.

Para ello, en el explorador de soluciones, si situamos el ratón en el proyecto y apretamos el botón

derecho, se nos desplegará otro menú. En él, tendremos la opción de “agregar” un “elemento
existente”, que serán cada uno de los ejemplos que vamos a usar en el curso.

Una vez añadido, el fichero lo tendremos en “Archivos de origen”, y si cliqueamos el ratón dos
veces, nos mostrará el código.

Si elegimos la opción “Compilar / compilar solución”, nos mostrará que se ha compilado sin error.
Pero si le damos la opción de “Depurar/ Iniciar Sin Depurar” nos dará un error de ejecución del
programa, ya que no ha encontrado la imagen que queríamos mostrar por pantalla.
El mensaje nos dirá “Error al cargar la imagen:ivvi.jpg”, aunque físicamente está allí. Por ello, si
usamos el IDE para lanzar, debemos poner las imágenes en el siguiente subdirectorio:

C:\Users\Nombre_de_Usuario \source\repos\ProyectosOCV\Proyect1

Donde Nombre_de_Usuario es el usuario que somos y ProyectosOCV el nombre que hemos

dado a la solución y Project1 el del proyecto que aparece en el explorador de soluciones.

11 de septiembre de 2023