Dans ce post, nous allons fournir des instructions étape par étape sur la façon d’installer OpenCV 3 (C++ et Python) sur Windows.
Si vous souhaitez installer OpenCV 4 à partir des sources, veuillez consulter ce tutoriel : Installer OpenCV à partir des sources sur Windows
Nous avons utilisé Windows Power Shell pour exécuter les commandes. Sinon, vous pouvez aussi utiliser l’invite de commande.
Etape 1 : Installer Visual Studio
Télécharger et installer Visual Studio 2015 community edition à partir de https://www.visualstudio.com/vs/older-downloads/. Si vous avez des difficultés à rechercher Visual Studio 2015, utilisez ce lien. Si vous n’avez pas de compte Visual Studio Dev Essentials, créez un compte et connectez-vous. Exécutez le programme d’installation, sélectionnez « Custom » dans « type of installation ».
Dans l’écran suivant, au sein de Programming Languages, sélectionnez Visual C++ et Python tools for Visual Studio. Cliquez sur suivant.
Maintenant, cliquez sur suivant. Il faudra un certain temps pour terminer l’installation.
Nous avons terminé l’installation de Visual Studio 2015.
Note : Comme Visual Studio 2017 ne parvient pas à compiler Dlib, nous sommes revenus à Visual Studio 2015.
Etape 2 : Installer CMake
Télécharger et installer CMake v3.10.0 à partir de https://cmake.org/download/.
Pendant l’installation, sélectionnez « Add. CMake au PATH du système »
Étape 3 : Installer Anaconda (une distribution python)
Télécharger et installer Anaconda version 64 bits à partir de https://www.continuum.io/downloads.
Note : Dlib expédie un binaire préconstruit pour Python 3 et non pour Python 2. Construire les liaisons Python de Dlib à partir des sources est un problème car vous devez d’abord construire Boost.Python.
Il est donc conseillé d’installer Anaconda 3. Dans le cas où vous voulez construire les bindings Python d’OpenCV pour Python 2, vous pouvez également installer Anaconda 2 mais vous ne pourrez pas utiliser Dlib dans Python 2.
Lors de l’installation d’Anaconda, assurez-vous de cocher les deux options :
- Ajouter Anaconda à ma variable d’environnement PATH
- Enregistrer Anaconda comme mon Python par défaut
.
Étape 4 : Télécharger et extraire opencv-3.3.1 et opencv_contrib-3.3.1
Voir https://github.com/opencv/opencv/releases et télécharger opencv-3.3.1 code source zip
Aller sur https://github.com/opencv/opencv_contrib/releases et télécharger opencv_contrib-3.3.1 code source zip
Extraire les deux fichiers zip. Bien que vous puissiez garder les dossiers opencv et opencv_contrib n’importe où, je vous suggère de les garder tous les deux dans le même répertoire. J’ai placé ces deux dossiers dans le répertoire « Mes documents ».
NOTE : A partir de maintenant, nous ferons référence au chemin d’accès au dossier opencv-3.3.1 comme OPENCV_PATH. Par exemple, dans mon cas, OPENCV_PATH est C:/Users/Vaibhaw Chandel/Documents/opencv-3.3.1
Selon l’endroit où vous avez conservé le dossier opencv-3.3.1, ce chemin serait différent.
Étape 5 : Générer le projet Visual Studio à l’aide de CMake
Lancer Cmake, dans la case « Where is the source code » écrire la valeur de OPENCV_PATH (qui est le chemin vers le dossier opencv-3.3.1) et le chemin vers le répertoire de construction. Nous choisirons le répertoire de construction comme OPENCV_PATH/build
Maintenant cliquez sur configure.
Il vous sera demandé la permission de créer le dossier de construction. Cliquez sur Oui.
Lorsque vous êtes invité à sélectionner un compilateur, sélectionnez Visual Studio 14 2015 Win64.
Cliquez sur finish et dans la fenêtre suivante gardez les paramètres par défaut cochés.
Cliquez sur finish. Maintenant, CMake va regarder dans les répertoires du système et générer les makefiles.
Étape 5.1 : Modifications supplémentaires à la configuration de CMake
Nous allons apporter quelques modifications à la configuration par défaut générée par CMake. Cliquez sur les images pour voir une version plus grande.
- Cochez « INSTALL_C_EXAMPLES » et « INSTALL_PYTHON_EXAMPLES »
- Dans le drapeau « OPENCV_EXTRA_MODULES_PATH », donnez le chemin du répertoire des modules dans opencv_contrib-3.3.1. Dans notre cas, nous avons gardé opencv_contrib-3.3.1 dans le dossier Documents donc le chemin est « C:/Users/Vaibhaw Chandel/Documents/opencv_contrib-3.3.1/modules »
Maintenant cliquez sur configurer pour appliquer ces changements.
- Sur Windows 10 , le module opencv_saliency ne parvient pas à se construire. Nous allons donc le désactiver. Décochez BUILD_opencv_saliency
Maintenant, cliquez à nouveau sur configurer pour inclure cette modification.
Étape 5.2 : Ajouter les chemins Python pour Python2 et Python3 (optionnel)
Cette section est seulement pour les personnes qui veulent générer le binaire OpenCV pour Python2 et Python 3. Si vous allez utiliser un seul Python soit 2 ou 3, vous devriez sauter cette section.
CMake n’a pas pu trouver les chemins pour mes fichiers Python3.
J’ai donc ajouté manuellement des chemins pour Python3.
Maintenant cliquez à nouveau sur configurer. Une fois la configuration terminée, recherchez opencv_python dans la barre de recherche, les deux BUILD_opencv_python2 et BUILD_opencv_python3 seront automatiquement cochés. Maintenant, nous sommes sûrs que les binaires OpenCV pour Python2 et Python 3 seront générés après la compilation.
Étape 5.3 : Générer les fichiers de construction
Si CMake est capable de configurer sans aucune erreur, il devrait dire « Configuration terminée ».
Cliquez sur générer.
Note : Chaque fois que vous apportez des modifications(cocher/décocher des cases ou changer le chemin) à la configuration générée par CMake, cliquez toujours sur configurer et générer.
Etape 6 : Compiler OpenCV
Etape 6.1 : Compiler opencv en mode Release
Ouvrir l’invite de commande Windows (cmd).
Aller dans le répertoire OPENCV_PATH/build et exécuter cette commande
cmake.exe --build . --config Release --target INSTALL
Etape 6.2 : Compiler opencv en mode débogage
Ouvrir à nouveau l’interface graphique de CMake comme mentionné à l’étape 5.
- Recherchez « python » dans la boîte de recherche
- Décochez INSTALL_PYTHON_EXAMPLES, BUILD_opencv_python3 et BUILD_opencv_python2
- Cliquez sur configure
- Cliquez sur generate
Maintenant dans l’invite de commande de windows
Allez dans le répertoire OPENCV_PATH/build et exécutez cette commande
cmake.exe --build . --config Debug --target INSTALL
Maintenant que nous avons compilé OpenCV, nous allons découvrir comment tester un projet OpenCV en utilisant CMake.
Etape 7 : Mise à jour des variables d’environnement du système
Etape 7.1 : Mettre à jour la variable d’environnement – PATH
D’abord, nous allons ajouter le chemin des fichiers dll d’OpenCV à notre PATH système. Appuyez sur la touche Windows Super, recherchez « variables d’environnement »
Cliquez sur Variables d’environnement Variables dans la fenêtre Propriétés système
Sous Variables système, Sélectionnez Chemin d’accès et cliquez sur modifier
Cliquez sur Nouveau, et donnez le chemin d’accès à OPENCV_PATH\64\\bin et cliquez sur Ok. Selon l’endroit où vous avez conservé le dossier opencv-3.3.1 et la version de Visual Studio que vous avez utilisée pour compiler OpenCV, ce chemin serait différent. Dans mon cas, le chemin complet est:
C:\Users\Vaibhaw Chandel\Documents\opencv-3.3.1\build\install\x64\vc14\bin
Maintenant cliquez sur Ok pour enregistrer. Ne fermez pas encore la fenêtre des variables d’environnement. Nous mettrons à jour la variable OPENCV_DIR à l’étape suivante.
Étape 7.2 : Mise à jour de la variable d’environnement utilisateur – OPENCV_DIR
Cliquez sur Nouveau dans « Variables utilisateur » (moitié supérieure de la fenêtre latérale droite). Sous le nom de la variable, écrivez OPENCV_DIR et sous la valeur de la variable, écrivez OPENCV_PATH\build\install.
Comme vous pouvez le voir dans mon cas, la valeur de la variable est:
C:\Users\Vaibhaw Chandel\Documents\opencv-3.3.1\build\install
Ce répertoire contient le fichier « OpenCVConfig.cmake ». Celui-ci est utilisé par CMake pour configurer les variables OpenCV_LIBS et OpenCV_INCLUDE_DIRS afin de générer les fichiers du projet.
Maintenant cliquez sur ok pour enregistrer et fermer la fenêtre des variables d’environnement.
Note : Si vous avez une fenêtre Command Prompt/Power Shell ouverte avant la mise à jour de ces valeurs, vous devez fermer et ouvrir à nouveau une nouvelle fenêtre Command Prompt/Power Shell.
Etape 8 : Test du code C++
Téléchargez ce code redEyeRemover et extrayez-le dans un dossier.
Ouvrez maintenant Windows Power Shell et naviguez dans ce répertoire.
Créez un fichier nommé CMakeLists.txt et mettez ce code dans ce fichier.
cmake_minimum_required(VERSION 2.8)project( redEyeRemover )find_package( OpenCV REQUIRED )include_directories( ${OpenCV_INCLUDE_DIRS} )add_executable( removeRedEyes removeRedEyes.cpp )target_link_libraries( removeRedEyes ${OpenCV_LIBS} )
Ce fichier contient des informations sur les chemins d’inclusion et de bibliothèque d’opencv.
Nous allons maintenant compiler removeRedEyes.cpp et l’exécuter.
# create build directorymkdir buildcd build# create Visual Studio project files using cmakecmake -G "Visual Studio 14 2015 Win64" ..
Vous pouvez voir dans la capture d’écran ci-dessous que CMake a trouvé l’OpenCV sur ma machine.
Nous allons maintenant construire notre application.
# build our applicationcmake --build . --config Release# once the build is complete, it will generate exe file in build\Release directory
Comme notre code C++ suppose que les fichiers jpg sont dans le répertoire actuel, nous allons nous déplacer vers le répertoire RedEyeRemover et exécuter removeRedEyes.exe à partir de là.
cd ...\build\Release\removeRedEyes.exe
Après avoir exécuté l’application, vous verrez deux fenêtres d’images, une avec des yeux rouges et une autre avec des yeux noirs.
Étape 9 : tester le code Python
Étape 9.1 : Vérification rapide
Une façon rapide de vérifier si OpenCV pour Python est installé correctement ou non est d’importer cv2 dans l’interpréteur python.
Ouvrir l’invite de commande sous Windows, exécuter la commande python. Cela ouvrira l’interpréteur Python. Exécutez ces deux commandes
import cv2print(cv2.__version__)
Anaconda est livré avec un interpréteur Python riche en fonctionnalités appelé IPython. J’ai testé ces commandes dans IPython.
Si OpenCV pour Python est installé correctement, l’exécution de la commande « import cv2 » ne donnera aucune erreur. Si une erreur apparaît, cela signifie que l’installation a échoué.
Etape 9.2 : Tester l’application redEyeRemover
Ouvrir Windows Power Shell et naviguer dans le répertoire où vous avez extrait RedEyeRemover.zip
Exécutez maintenant le code python comme ceci :
python .\removeRedEyes.py
Si le programme s’exécute avec succès, vous verrez deux fenêtres d’image l’une avec des yeux rouges l’autre avec des yeux noirs.