|
Pandore - Une bibliothèque d'opérateurs de traitement d'images |
L'installation dépend du système d'exploitation
INSTALLATION DE PANDORE SOUS UNIX/LINUX/CYGWIN/MINGW
1. PREREQUIS
L'installation complète de la bibliothèque Pandore nécessite de manière:
a. obligatoire:
- un compilateur C++ intégrant les templates.
b. recommandée:
- l'API Qt version >= 4.0.0 pour les opérateurs de visualisation.
Sans cette API les opérateurs 'pvisu' et 'pdraw' ne peuvent pas
fonctionner. Néanmoins, le reste des opérateurs fonctionnent normalement,
et il est alors nécessaire de trouver d'autres programmes de visualisation
des images. Les opérateurs de passerelle ppan2tiff, ppan2bmp et autres
permettent convertir une image Pandore en image tiff ou bmp.
c. optionnelle:
- un interpréteur Perl. Sans cet interpréteur il n'est pas possible de
profiter du préprocesseur permettant la généricité des types lors de la
programmation de nouveaux opérateurs.
2. DÉCOMPRESSION DU LOGICIEL
a. Copier le fichier pandore6.x.x-unix.tgz dans le dossier destination
(ex: /usr/local/pantheon).
b. Décompresser puis détarer le fichier (Dans le cas d'une mise à jour les
nouveaux fichiers remplacent ainsi les anciens.)
gunzip pandore6.x.x-unix.tgz
tar xvf pandore6.x.x-unix.tar
ou directement
tar xvfz pandore6.x.x-unix.tgz (ou gtar xvfz pandore6.x.x-unix.tgz)
Ceci a pour effet de créer le dossier Pandore/ et d'y déposer tous les
fichiers associés.
3. SIMPLE COMPILATION
La plus simple facon de compiler la bibliothèque est d'exécuter les deux
commandes suivantes :
./configure
make (or make -j6)
make install
Si la compilation s'est exécutée correctement, elle a permis de créer :
- la "library" libpandore.so dans le dossier ./lib,
- l'ensemble des exécutables des opérateurs dans le dossier ./bin
- et un fichier './pandore' qui permet de lancer Pandore.
Pour vérifier la bonne installation, exécuter la séquence d'opérateurs
suivante sous l'interpréteur Shell:
pandore
pversion
puis, pour vérifier la bonne installation des opérateurs de visualisation,
exécuter la séquence d'opérateurs suivante sous l'interpréteur Shell:
pbmp2pan examples/tangram.bmp /tmp/tangram.pan
pstatus
pvisu /tmp/tangram.pan
la commande 'pstatus' doit afficher le texte "SUCCESS".
Une fois parfaitement la bibliothèque installée, la commande suivante permet
de supprimer les fichiers devenus inutiles
make clean
4. COMPILATION AVANCEE
Si la compilation précédente ne s'est pas déroulée correctement, il est
possible de modifier la configuration,
a- soit par l'ajout d'arguments lors de l'appel de configure:
--help: affiche la liste des options de configure.
--static: ajoute la version statique de la bibliothèque Pandore (libpandore.a)
--bindir=DIR: permet d'installer le script Shell pandore dans le dossier
'DIR' (mais ne copie ni les exécutables, ni les includes, ni la
library)
(e.g.: configure --bindir=/usr/local/bin)
--prefix=DIR: permet d'installer le script Shell pandore dans le dossier
'DIR/bin' (mais ne copie ni les exécutables, ni les includes,
ni la library)
(e.g.: configure --prefix=/usr/local)
--with-qmake=PATH chemin vers la command qmake.
--with-x11-includes=PATH: permet de spécifier le dossier où se trouve les
includes X11 nécessaires à la compilation de l'opérateur pvisu
(pour la version Motif uniquement).
--with-x11-libraries=PATH: permet de spécifier le dossier où se trouve les
"libraries" X11 : libX11, libXt, libXp, libXext nécessaires
à la compilation de l'opérateur pvisu (pour la version Motif).
--with-motif-includes=PATH: permet de spécifier le dossier où se trouve les
includes motif nécessaires à la compilation de l'opérateur
pvisu (pour la version Motif).
--with-motif-libraries=PATH: permet de spécifier le dossier où se trouve la
"library" motif libXm nécessaire à la compilation de
l'opérateur pvisu (pour la version Motif).
b- soit en modifiant directement les valeurs des variables de configuration
dans le code du fichier ./configure:
* PERL, avec le chemin vers l'interpréteur Perl d'une Version >= 5.0;
(Rem: En l'absence d'interpréteur PERL la capacité d'écriture des
programmes sera bridée, et ne pourra bénéficier du préprocesseur qui\
permet la généricité des types).
* MAKE, avec le chemin vers la commande make;
* CXX, avec le chemin vers le compilateur c++.
* CFLAGS: Les options particulières pour le compilateur (par exemple
-Wall pour l'affichage des Warnings).
* X11INCLUDEPATH: le chemin vers les includes X11.
* X11LIBPATH: le chemin vers les libraries X11.
* MOTIFLIBPATH: le chemin vers les includes Motif.
* MOTIFINCLUDEPATH: le chemin vers les libraries Motif.
5. COMPLÈTE RECOMPILATION
Pour réinstaller la bibliothèque, il suffit d'exécuter la séquence de
commandes suivantes:
make distclean
./configure
make
make install
INSTALLATION DE PANDORE SOUS MACOS X
1. PREREQUIS
L'installation complète de la bibliothèque Pandore nécessite de manière:
a. obligatoire:
- un compilateur C++ intégrant les templates (p. ex. clang++).
b. recommandée:
- l'API Qt version >= 5.0.0 pour les opérateurs de visualisation.
Sans cette API les opérateurs 'pvisu' et 'pdraw' ne peuvent pas
fonctionner. Néanmoins, le reste des opérateurs fonctionnent normalement,
et il est alors nécessaire de trouver d'autres programmes de visualisation
des images. Les opérateurs de passerelle ppan2tiff, ppan2bmp et autres
permettent convertir une image Pandore en image tiff ou bmp.
c. optionnelle:
- un interpréteur Perl. Sans cet interpréteur il n'est pas possible de
profiter du préprocesseur permettant la généricité des types lors de la
programmation de nouveaux opérateurs.
2. DÉCOMPRESSION DU LOGICIEL
a. Copier le fichier pandore6.x.x-unix.tgz dans le dossier destination
(ex: /usr/local/pantheon).
b. Décompresser puis détarer le fichier (Dans le cas d'une mise à jour les
nouveaux fichiers remplacent ainsi les anciens.)
gunzip pandore6.x.x-unix.tgz
tar xvf pandore6.x.x-unix.tar
ou directement
tar xvfz pandore6.x.x-unix.tgz (ou gtar xvfz pandore6.x.x-unix.tgz)
Ceci a pour effet de créer le dossier Pandore/ et d'y déposer tous les
fichiers associés.
3. SIMPLE COMPILATION
La plus simple facon de compiler la bibliothèque est d'exécuter les deux
commandes suivantes :
./configure
make (or make -j6)
make install
Si la compilation s'est exécutée correctement, elle a permis de créer :
- la "library" libpandore.dylib dans le
dossier ./lib,
- l'ensemble des exécutables des opérateurs dans le dossier ./bin
4. EXECUTION EN LIGE DE COMMANDE
Pour utiliser Pandore en ligne de commande dans un terminal, il faut fixer
des variables globales dans le fichier ~/.profile. Donc dans le fichier ~/.profile :
export PANDOREHOME=/home/clouard/pantheon/software/pandore
export PATH=$PANDOREHOME/bin:$PATH
export LD_LIBRARY_PATH=$PANDOREHOME/lib:$LD_LIBRARY_PATH
Une fois ce fichier mis à jour, il suffit de faire :
source ~/.profile
Un test d'installation sur le terminal :
pversion
puis, pour vérifier la bonne installation des opérateurs de visualisation,
exécuter la séquence d'opérateurs suivante sous l'interpréteur Shell:
pbmp2pan examples/tangram.bmp /tmp/tangram.pan
pstatus
pvisu /tmp/tangram.pan
la commande 'pstatus' doit afficher le texte "SUCCESS".
Une fois parfaitement la bibliothèque installée, la commande suivante permet
de supprimer les fichiers devenus inutiles
make clean
5. COMPILATION AVANCEE
Si la compilation précédente ne s'est pas déroulée correctement, il est
possible de modifier la configuration,
a- soit par l'ajout d'arguments lors de l'appel de configure:
--help: affiche la liste des options de configure.
--static: ajoute la version statique de la bibliothèque Pandore (libpandore.a)
--bindir=DIR: permet d'installer le script Shell pandore dans le dossier
'DIR' (mais ne copie ni les exécutables, ni les includes, ni la
library)
(e.g.: configure --bindir=/usr/local/bin)
--prefix=DIR: permet d'installer le script Shell pandore dans le dossier
'DIR/bin' (mais ne copie ni les exécutables, ni les includes,
ni la library)
(e.g.: configure --prefix=/usr/local)
--with-qmake=PATH chemin vers la command qmake.
--with-x11-includes=PATH: permet de spécifier le dossier où se trouve les
includes X11 nécessaires à la compilation de l'opérateur pvisu
(pour la version Motif uniquement).
--with-x11-libraries=PATH: permet de spécifier le dossier où se trouve les
"libraries" X11 : libX11, libXt, libXp, libXext nécessaires
à la compilation de l'opérateur pvisu (pour la version Motif).
--with-motif-includes=PATH: permet de spécifier le dossier où se trouve les
includes motif nécessaires à la compilation de l'opérateur
pvisu (pour la version Motif).
--with-motif-libraries=PATH: permet de spécifier le dossier où se trouve la
"library" motif libXm nécessaire à la compilation de
l'opérateur pvisu (pour la version Motif).
b- soit en modifiant directement les valeurs des variables de configuration
dans le code du fichier ./configure:
* PERL, avec le chemin vers l'interpréteur Perl d'une Version >= 5.0;
(Rem: En l'absence d'interpréteur PERL la capacité d'écriture des
programmes sera bridée, et ne pourra bénéficier du préprocesseur qui\
permet la généricité des types).
* MAKE, avec le chemin vers la commande make;
* CXX, avec le chemin vers le compilateur c++.
* CFLAGS: Les options particulières pour le compilateur (par exemple
-Wall pour l'affichage des Warnings).
* X11INCLUDEPATH: le chemin vers les includes X11.
* X11LIBPATH: le chemin vers les libraries X11.
* MOTIFLIBPATH: le chemin vers les includes Motif.
* MOTIFINCLUDEPATH: le chemin vers les libraries Motif.
5. COMPLÈTE RECOMPILATION
Pour réinstaller la bibliothèque, il suffit d'exécuter la séquence de
commandes suivantes:
make distclean
./configure
make
make install
INSTALLATION DE PANDORE SOUS WINDOWS
1. DECOMPRESSION
Décompresser le fichier pandore6.x.x-windows-src.zip. Cette décompression crée un
nouveau dossier Pandore6.x.x et y dépose tous les sous-dossiers
et tous les fichiers.
2. CONFIGURATION (version binaire)
Pour installer Pandore, il suffit de double cliquer sur le script
configure-binary.bat
ou d'exécuter dans une fenêtre msdos la commande:
configure-binaire
Ce script doit creer le fichier pandore.bat
Passer ensuite a l'etape 6.
3. CONFIGURATION (version à compiler)
Pour complier Pandore, il suffit de double cliquer sur le script
configure-vc++Express.bat pour le compilateur Visual C++ Express
ou
configure-devcpp.bat pour le compilateur de Dev-Cpp
ou d'exécuter dans une fenêtre msdos la commande:
configure-vc++
ou
configure-vc++2005Express
ou
configure-devcpp
NOTE: Pour la version vc++ 2005 Express il peut être nécessaire de modifier
le fichier configure-vc++2005Express.bat pour ajouter aux variables
- CPPFLAGS : le chemin vers le dossier include du SDK, par exemple:
/I"D:\Program Files\Microsoft Platform SDK\include"
- LDFLAGSOP : le chemin vers le dossier lib du SDK, par exemple:
/LIBPATH:"D:\Program Files\Microsoft Platform SDK\lib"
si le SDK se trouve dans le dossier \Program Files\Microsoft Platform SDK.
A defaut, la compilation produit l'erreur: impossible de trouver le fichier "windows.h"
4. SIMPLE COMPILATION (Version open source uniquement)
Pour compiler Pandore, il suffit de double cliquer sur le script
install.bat
ou d'exécuter dans une fenêtre msdos la commande:
install
5. COMPILATION AVANCEE
Il est possible de modifier le compilateur et les options de compilation
en modifiant directement les variables au début du fichier configure-??.bat.
6. UTILISATION DE PANDORE
L'installation génère un fichier pandore.bat.
Ce fichier peut être copié sur le bureau ou ajouté au menu.
Pour utiliser pandore, il suffit de double cliquer sur le script
pandore.bat
Ce script ouvre une session MsDOS et à partir de là, l'ensemble des opérateurs
Pandore sont accessibles. Par exemple, pour tester l'installation, taper :
pversion
ou une séquence plus complexe:
pbmp2pan examples\tangram.bmp image1.pan
pstatus
pvisu image1.pan
La commande 'pstatus' doit afficher SUCCESS.
/I"C:\Documents and Settings\regis\Mes documents\pantheon\pandore\include" /I"C:\Documents and Settings\regis\Mes documents\pantheon\pandore\src\operatorsP0" /Zi /nologo /W3 /WX- /O2 /Oy- /GL /D "WIN32" /D "NDEBUG" /D "_CONSOLE" /D "MAIN" /D "_UNICODE" /D "UNICODE" /EHsc /MT /GS /Gy- /fp:precise /Zc:wchar_t /Zc:forScope /GR /Fp"Release\example.pch" /Fa"Release\" /Fo"Release\" /Fd"Release\vc100.pdb" /Gd /analyze- /errorReport:queueLa ligne de commande de l'édition des liens doit ressembler à ce qui suit:
OUT:"C:\Documents and Settings\regis\Mes documents\pantheon\example\Release\example.exe" /INCREMENTAL:NO /NOLOGO /LIBPATH:"C:\Documents and Settings\regis\Mes documents\pantheon\pandore\lib" "pandore.lib" "kernel32.lib" /MANIFEST /ManifestFile:"Release\example.exe.intermediate.manifest" /ALLOWISOLATION /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DEBUG /PDB:"C:\Documents and Settings\regis\Mes documents\pantheon\example\Release\example.pdb" /SUBSYSTEM:CONSOLE /OPT:REF /OPT:ICF /PGD:"C:\Documents and Settings\regis\Mes documents\pantheon\example\Release\example.pgd" /LTCG /TLBID:1 /DYNAMICBASE /NXCOMPAT /MACHINE:X86 /ERRORREPORT:QUEUE