Installation de OpenCV et Astico2D
==================================

CC-BY Edouard.Thiel@univ-amu.fr - 14/09/2021


Sommaire :
    0. Préambule
    1. Sur Ubuntu
    2. Sur Windows
        2.1 Sur Windows 10 avec WSL ou WSL2
        2.2 Sur Windows 10 avec MinGW64
    3. Sur MacOS


0. Préambule
   ---------

    Téléchargez les sources astico2d.tgz puis décompressez l'archive.


1. Sur Ubuntu
   ----------

    Ouvrez un terminal puis tapez :
        sudo apt install g++ make libopencv-dev

    Allez ensuite dans le répertoire de Astico2D avec la commande cd, puis tapez
        make -j all
        ./demo1 IMAGES/chat1.jpg

    Si lors de la compilation il y a des messages d'erreur relatifs à pkg-config
    (par exemple sur Ubuntu <= 18.04), éditez le fichier Makefile, remplacez 
    "OPENCV = opencv4" par "OPENCV = opencv" puis relancez la compilation.


2. Sur Windows
   -----------

2.1 Sur Windows 10 avec WSL ou WSL2
    -------------------------------

    WSL (Windows Subsystem for Linux) permet d'intégrer nativement une machine
    virtuelle Linux dans Windows 10, avec un choix de distributions.

    Avantage : 
      - facile et assez rapide à installer, et ensuite on peut installer tous 
        les logiciels Linux avec apt install.
    Inconvénient : 
      - avec WSL installé on ne peut plus utiliser VirtualBox.

    Pour installer WSL ou WSL2 sous Windows 10, avec une distribution Ubuntu :
        https://docs.microsoft.com/fr-fr/windows/wsl/install-win10

    Installer aussi un serveur X pour l'affichage graphique :
        https://sourceforge.net/projects/vcxsrv/
        Après installation, dans le menu Windows, lancez VcXsrv / XLaunch
        puis acceptez toutes les valeurs par défaut.
        Pour tester, tapez dans le terminal Ubuntu :
            sudo apt install x11-apps
            xclock

    Installation de OpenCV : ouvrez un terminal Ubuntu puis tapez :
        sudo apt install g++ make libopencv-dev

    Dans le répertoire de Astico2D modifiez le fichier Makefile en mettant
        OPENCV  = opencv

    Dans le terminal Ubuntu, allez dans le répertoire de Astico2D avec la commande
    cd, puis tapez
        make -j all
        ./demo1 IMAGES/chat1.jpg


2.2 Sur Windows 10 avec MinGW64
    ---------------------------

    MinGW est un ensemble d'utilitaires GNU pour windows (gcc, make, etc).

    Avantage : 
      - on peut développer avec gcc pour l'API Windows, y compris pour des 
        Windows plus anciens.
    Inconvénients : 
      - il faudra compiler OpenCV (facile mais durée 1 à 2h selon la machine) ;
      - les trackbar (sliders) de OpenCV seront un peu laids et peu pratiques.

    a) Installer Mingw-w64 :
        http://www.mingw-w64.org/doku.php/download/mingw-builds

        cliquer sur Sourceforge ... Enregistrer le fichier
        ouvrir mingw-w64-install.exe
        Setup : laisser par défaut (Threads: posix)
        Destination folder : remplacer par c:\local\mingw64  (créer les sous-répertoires)
        Next, Finish.

        Dans l'aide Windows : 
            taper "Environnement" -> Modifier les variables d'environnement
        dans la fenêtre Propriétés systèmes, Paramètres systèmes avancés,
        en bas Variables d'environnement...
        dans Variables système : cliquer sur Path, modifier, nouveau
        rajouter : c:\local\mingw64\mingw32\bin

        Ouvrir un terminal ("invite de commande")
        taper : echo %PATH%
        et vérifiez que le chemin de mingw apparaît bien.

        tapez :  g++ --version
        pour vérifier que g++ fonctionne.

    b) Sources de OpenCV
        https://github.com/opencv/opencv/releases
        choisir le plus récent, Source code (zip)
        Décompactez le zip sur votre bureau
        on obtient par ex. : C:\Users\thiel\Desktop\opencv-4.5.3

    c) Installer cmake
        https://cmake.org/download/

        choisir Latest Stable Release, Binary distribution, Windows x64 installer, .msi
        cocher Add CMake to the system PATH for all users
        Install CMake to: c:\local\CMake\  (créer le sous-répertoire)

        Exécuter cmake-gui

    d) Compilation de OpenCV
        dans cmake-gui :
            where is the source code :   C:/Users/thiel/Desktop/opencv-4.5.3
            where to build the binaries: c:/local/opencv/build-4.5.3-mingw64
               (créer les sous-répertoires)
            Configure
                Generator : MinGW Makefiles, default, Finish
	        puis attendre... "Configuration done"
            Generate
                ... Generating done
            Quitter

         Ouvrir un terminal
             cd C:\local\opencv\build-4.5.3-mingw64
             mingw32-make
                 ... compilation générale, durée environ 1h ...
             mingw32-make install

         Enfin, dans les variables d'environnement, dans Variables système : 
         cliquer sur Path, modifier, nouveau
             C:\local\opencv\build-4.5.3-mingw64\install\x64\mingw\bin

         Fermer le terminal actuel, ouvrez un nouveau terminal ;
         vérifiez PATH en tapant : echo %PATH%

         Tapez : opencv_version  (affiche par exemple : 4.5.3)

    e) Compilation de Astico2D
        Allez dans le répertoire de Astico2D
        Editez Makefile-mingw, modifiez éventuellement le chemin et la version :
            OPENCVPATH = C:\local\opencv\build-4.5.3-mingw64\install
            VER = 453

        Tapez : make -j all
        demo1.exe IMAGES/chat1.jpg


3. Sur MacOS
   ---------

Si vous disposez d'un Mac, merci de m'indiquer la procédure d'installation
d'un compilateur C++ et de OpenCV pour que puisse la présenter ici.