Pandore - Une bibliothèque d'opérateurs de traitement d'images

La programmation d'applications

Ce tutoriel présente la façon de construire une nouvelle application. On rappelle qu'une application est un enchaînement d'opérateurs Pandore.
L'exemple utilisé pour ce tutoriel est la segmentation d'une image par seuillage binaire. La valeur de seuil est prise comme celle qui maximise la variance entre les deux classes de pixels (algorithme de Otsu).
Il existe trois façons de créer une application :

1. Sous la forme d'un script de commandes.
2. Sous la forme d'un programme C++.
3. Sous l'interface de programmation visuelle Ariane

Tous les fichiers ci-dessous se trouvent dans le dossier 'examples' de Pandore.

1. Exemple sous UNIX / Linux / Mac OS X / CYGWIN

a. Programmation sous la forme d'un script Shell

1. Ecrire le code de l'application dans le fichier Shell.
   
2. Comme exemple, récupérer le fichier exemple : example1.sh

3. Mettre les droits d'exécution sur le fichier example1.sh: chmod u+x example1.sh

4. Récupérer l'image exemple : tangram.pan

5. Exécuter le fichier sur l'image exemple par :
   ./example1.sh tangram.pan sortie.pan

6. Pour vérifier le résultat faire: pvisu sortie.pan

b. Programmation sous la forme d'un programme C++

1. Ecrire le code de l'application dans le fichier C++.
   
2. Comme exemple récupérer le fichier : example2.cpp

3. Récupérer le fichier Makefile.unix : Makefile.unix (ou Makefile.sun sous Solaris)

4. Renommer le fichier Makefile.unix en Makefile: mv Makefile.unix Makefile

5. Compiler le programme par: make example2

6. Récupérer l'image exemple : tangram.pan

7. Exécuter le fichier sur l'image exemple par:
   ./example2 tangram.pan sortie.pan

8. Pour vérifier le résultat faire: pvisu sortie.pan

c. Programmation C++ avec une fenêtre de visualisation d'images intermédiaires

1. Ecrire le code de l'application dans le fichier C++.
   
2. Comme exemple récupérer le fichier : viewer_example.cpp

3. Récupérer le fichier Makefile.unix : Makefile.unix (ou Makefile.sun sous Solaris)

4. Renommer le fichier Makefile.unix en Makefile: mv Makefile.unix Makefile

5. Compiler le programme par: make viewer_example

6. Exécuter le programme: ./viewer_example

2. Exemple sous Windows

a. Programmation sous la forme d'un script Batch

1. Ecrire le code de l'application dans le fichier batch.
   
2. Récupérer le fichier exemple : example1.bat

3. Si ce n'est pas encore fait, exécuter le fichier pandore.bat.

4. Récupérer l'image exemple : tangram.pan

5. Exécuter le fichier sur l'image exemple par : example1 tangram.pan sortie.pan

6. Pour vérifier le résultat faire: pvisu sortie.pan

b. Programmation sous la forme d'un programme C++

1. Ecrire le code de l'application dans le fichier batch.
   
2. Récupérer le fichier exemple : example2.cpp

3. Récupérer le fichier Makefile.msdos : Makefile.msdos

4. Renommer le fichier Makefile.msdos en Makefile: ren Makefile.msdos Makefile

5. Compiler le programme par : nmake example2.exe

6. Récupérer l'image exemple : tangram.pan

7. Exécuter le fichier sur l'image exemple par: example2 tangram.pan sortie.pan

8. Pour vérifier le résultat faire: pvisu sortie.pan

c. Programmation C++ avec une fenêtre de visualisation d'images intermédiaires

1. Ecrire le code de l'application dans le fichier C++.
   
2. Comme exemple récupérer le fichier : viewer_example.cpp

3. Récupérer le fichier Makefile.msdos : Makefile.msdos

4. Renommer le fichier Makefile.msdos en Makefile: ren Makefile.msdos Makefile

5. Compiler le programme par: nmake viewer_example.exe

6. Exécuter le programme: viewer_example

d. Sous forme d'un projet Visual C++

1. Copier le dossier Pandore/examples/visual dans le dossier destination

2. Configurer le menu tools::options, choisir l'onglet Directories
   • sélectionner menu : Include Files
     1. ajouter le dossier include de Pandore
     2. ajouter le dossier src\operatorsP0 de Pandore
   • sélectionner menu : Library Files
     1. ajouter le dossier lib dans Pandore
3. Compiler le projet