Déboguer un SCRIPT à l’aide de PRiSM
Le débogueur est intégré à PRiSM afin de corriger
facilement des scripts .PGM .
Il y a deux façons d'y accéder :
- 1ère possibilités : à partir du menu Fichier >
Exécuter Script (mode débug). Il faut alors indiquer le
chemin du PGM (comme pour la commande classique) mais en plus de la
fenêtre d'exécution habituelle, une fenêtre de déboguage s'ouvre
:
- 2ème possibilité : à partir de la fenêtre
d'exécution des scripts habituelle, l'icône
permet d'ouvrir la fenêtre de déboguage. A cette fin, pour se
donner le temps d'ouvrir cette fenêtre à tout moment, il faut
rajouter l'instruction " PAUSE " au début du
programme pour que le programme s'arrête momentanément ( voir
exemple ci-dessus dans la fenêtre du débogueur ). On pourra alors
ouvrir le déboggeur et s'en servir ou ignorer cette commande et
relancer l'exécution du programme à partir de l'icône 
.
Il est également possible de mettre le programme en " PAUSE "
pendant son exécution grâce à la commande pause 
,
mais il faut être rapide !
Une fois le déboggeur ouvert, on peut remarquer
qu'il se compose de trois parties principales :
- La série des 3 boutons désormais classiques :
"Exécuter", "Pause" et "Stop".
- La fenêtre de renseignements sur toutes les variables utilisées
(numérique et de chaînes, mais pas de variables d'images,
graphiques ou de texte) avec leur nom et en face la valeur prise
par ces dernières (il n'y aura que les variables définies par
défaut qui apparaîtront à l'ouverture du déboggueur : PI, TODEG,
TORAD, TRUE et FALSE ... voir les mots-clés de PRiSM).
- La fenêtre de commandes qui retrace toutes les lignes du
programme.
On rappelle qu'il est impossible, à l'heure
actuelle, de modifier le programme à partir de la fenêtre du
déboggeur.
L'exécution du programme peut être vue à partir de
ce dernier bien que les résultats dus à l'instruction
"PRINT" s'affiche dans la fenêtre d'exécution
classique. En voici la description des différents éléments :
- Le bouton permet de lancer le programme à partir du
niveau où se situe le pointeur rouge
- Pour exécuter le programme pas à pas, il suffit d'appuyer à
chaque fois sur le bouton pause . Les lignes du
programme seront exécutées une à une. Les résultats des variables
seront fournis au fur et à mesure dans la fenêtre prévue à cet
effet et les renseignements de liaison avec l'utilisateur (
commande "PRINT" ) seront également inscrits dans la
fenêtre au fur et à mesure.
- Pour faire repartir le programme , il suffit d'appuyer sur le
bouton " Start " :
- On peut vouloir exécuter un bloc de fonctions sans devoir
appuyer sur le bouton " Pause " à chaque instant. Par
contre, on peut désirer s'arrêter à un instant bien précis. Il
suffit pour celà de placer ce qu'on appelle " un point d'arrêt "
dans le débogueur.
A cette fin, repérer la ligne à la fin de laquelle on désire que le
programme s'arrête (le programme s'arrêtera après l'exécution de
cette ligne). Cliquer une fois sur les commandes de cette ligne
et un bouton rouge apparaît à gauche de la ligne : 
.
Ce bouton indique que cette ligne sera désignée comme point d'arrêt
de l'exécution du programme. En appuyant alors sur le bouton "
Start ", le programme s'exécutera jusqu'à rencontrer ce
bouton, auquel cas il arrêtera son exécution à la fin de la ligne.
On peut rajouter de tel boutons au fur et à mesure pendant le
déboguage.
Pour poursuivre le programme, appuyer de nouveau sur le bouton
"Start" et le programme continuera jusqu'au prochain point
d'arrêt ... ou jusqu'à la prochaine erreur qui aura pour effet de
vider alors complètement le débogueur de son contenu.
- Sinon, le carré noir permet de tout arrêter :
Durant l'exécution du Script, au fur et à mesure
que les fonctions sont exécutées, le débogueur affiche les
variables numériques et de chaînes utilisées, ainsi que leur valeur
numérique ou de caractères en face.
Attention : les variables images, graphiques et textes ne sont pas
affichées.
Remarque : le fait d'utiliser le débogueur
ralenti un peu l'exécution du script ... même si l'exécution a lieu
d'un trait.
Exemple d'application :
Considérons le programme suivant qui possède un
bug très banal ! (le but de cette aide n'est pas d'étudier les cas
les plus durs !). Copiez et collez le programme ci-dessous dans un
fichier texte que vous appellerez par exemple "BUGS.PGM"
REM Test des fonctions Stat et StatWindow
REM Stat calcule les informations statistiques sur la totalité de l'image
REM StatWindow calcule les informations statistiques sur une fenêtre de l'image
PRINT " Démarrer le débogueurs ou continuer "
PAUSE
GetImage Img
Stat Img Moyenne MoyenneQuadratique EcartType Max Min Flux Mediane
Print "Moyenne=" Moyenne
Print "MoyenneQuadratique=" MoyenneQuadratique
Print "EcartType=" EcartType
Print "Max=" Max
Print "Min=" Min
Print "Flux=" Flx
Print "Mediane=" Mediane
|
Le lancer d'une façon ou d'une autre afin d'ouvrir
le déboggeur. Une commande "PAUSE" a été introduite
afin de pouvoir lancer le déboggeur à partir de l'icône. Mais on
peut aussi utiliser le menu pour le lancer directement.
Si on exécute directement ce programme, on se rend
vite compte qu'il réalise la statistique de la totalité d'une image
et qu'il affiche les principaux résultats mais qu'il renvoie le
message d'erreur suivant : " Variable FLX non reconnue " :
Il y a donc une variable non déclaré. Un coup d'oeil avec un
éditeur de texte et l'erreur serait vite réparé mais ce n'est pas
le but de cette partie, alors, utilisons le déboggeur.
On peut, d'une part, exécuter les commandes pas à
pas ...
Le plus simple est de poser des points d'arrêts à des niveaux
stratégiques du script.
Après avoir ouvert le déboggeur, on posera alors un point d'arrêt
au niveau de la fonction pour verifier que le mauvais
fonctionnement ne vient pas d'elle.
Les commandes à venir sont des commandes
d'affichage. On les exécutera pas à pas grâce à la touche "
PAUSE " afin de vérifier que le disfonctionnement ne vient
pas de l'une d'elle.
Lorsqu'on lance l'exécution du script grâce à la commande ,
le programme s'exécute jusqu'à la fonction " Stat ".
Les variables correpondantes prennent alors des valeurs qui sont
affichées dans la partie correspondante.
Cependant, l'erreur ne semble pas là !
On exécute alors la suite du script pas à pas et on suivant en même
temps la petite flèche rouge indiquant la fonction
exécutée par le programme. A partir du moment où on arrive sur le
flux, l'erreur est décelée et alors facilement corrigible grâce à
n'importe quel éditeur de texte.
