Appariteur

Installation Linux

Les fichiers sont regroupés et compressés avec zip et pas avec tar/gz pour éviter de faire deux versions, l'une pour Linux l'autre pour Windows.

Sous Linux, on extrait avec (zip/unzip seront peut-être à installer)

unzip Appariteur.zip

et cela dans le répertoire où on veut voir apparaître tous les fichiers (ils ne sont pas rangés dans un répertoire comme cela aurait été fait avec tar, toujours pour la compatibilité avec Windows).

Installer Emacs, Maxima, gnuplot et FreeFem++
- Appariteur demande une version de Maxima ultérieure à 5.44 (il peut être utilisé avec une version antérieure mais il est possible que certaine commandes ne fonctionnent pas).
  Le mieux est sans doute de procéder à une installation depuis les sources dans un répertoire local. Choisir Gcl (Gnu Common Lisp) comme Lisp (ce qui suppose d'installer au préalable gcl).
  
  Donc un .configure et make à faire. Inutile de faire le make install
  
  Le make install copie les fichiers à des endroits où ils pourront être trouvés sans qu'il soit nécessaire de préciser leur chemin d'accès. C'est intéressant mais pas quand les versions changent souvent. Ce n'est pas trop le cas de Maxima mais c'est celui de FreeFem++.
- Il est également préférable de télécharger et compiler la version la plus récente de FreeFem++ (d'autant qu'à partir de la version 4.0 ce travail est devenu bien plus facile) dans un répertoire local.
  Se contenter d'un .configure puis d'un make. Inutile de faire le make install (voir le commentaire pour Maxima)
  
  (Pour que la fenêtre graphique s'affiche à la position whd remplacer
```
int Height = glutscreenscale*2*H/3,Width = glutscreenscale*W*2/3, iii0=100,jjj0=100;
```
  par
```
 int Height = glutscreenscale*2*H/5,Width = glutscreenscale*W*2/5, iii0=1200,jjj0=25;
```
  dans src/Graphic/ffglut.cpp). Les 1200 et 25 sont les positions du coin haut gauche où on souhaite que la fenêtre apparaisse. C'est à ajuster. De même que les hauteurs et largeurs.
  
  Puis relancer (ou lancer) si ça n'a pas été déjà fait un make.
- Pour Emacs... Disons qu'une version plus récente que la 24.5 est demandée (mais ça n'a guère d'importance, du moins si on ne va pas chercher une antiquité comme la 19.1)
- Quand à gnuplot, il est vraisemblablement déjà installé.
Dans Personnel.el, chercher
```
(file-exists-p (setq repertoire-freefem "/home/vinsard/logiciels/FreeFem-sources-4.8"))
```
et remplacer /home/vinsard/logiciels/FreeFem-sources-4.8 par le chemin du début de l'arborescence de FreeFem++
La commande
```
/home/vinsard/logiciels/FreeFem-sources-4.8/src/nw/FreeFem++ -nw -?
```
doit renvoyer l'aide de la ligne de commande de FreeFem++.
(j'ai laissé mon propre chemin plutôt que d'utiliser une variable comme 'chemin-d-acces-au-repertoire-superieur-de-freefem++' parce qu'il me semble que le gain en clarté excède la perte en généralité.
Si la compilation de maxima est locale, chercher (dans Personnel.el)
```
(file-exists-p (setq chemin-maxima "/home/vinsard/logiciels/maxima-5.44.0"))
```
et remplacer /home/vinsard/logiciels/maxima-5.44.0 par le chemin qui du répertoire ou est installé Maxima
Dans NeoApp, remplacer /media/vinsard/C32/NeoAppariteur par le chemin menant au répertoire où sont placés les fichiers d'appariteurs.
NeoApp doit aussi être mis en exécutable (en principe il l'est déjà) par
```
chmod +x NeoApp
```
À partir de là Appariteur se lance par
```
./NeoApp
```
(dans le répertoire où il est placé)
Optionnellement, dans l'environnement de bureau
- Placer la commande NeoApp de manière qu'elle soit exécutable à partir une icône (en positionnant le répertoire par défaut sur celui où sont placés les fichiers d'appariteur). Un fichier image NeoApp.png est fourni pour le dessin de l'icône.
- Activer le mécanisme d'élévation ou abaissement des fenêtres au moyen d'une touche (F3 par exemple) dans le gestionnaire de fenêtre.
(c'est utile parce que le Frame Emacs d'Appariteur occupe tout l'écran et qu'il faudra l'utiliser au cas où les fenêtres graphiques qu'il génère se retrouvent en dessous du Frame Emacs).

Installation Windows 10

Installer Emacs, Maxima, gnuplot et FreeFem++
Il n'est pas nécessaire d'installer Cygwin en entier. On trouve
- Emacs
- Maxima
- FreeFem++
  Le seul inconvénient est que la compilation est déjà faite, il ne sera pas possible de régler l'endroit où la fenêtre graphique s'affiche.
  Je ne sais pas faire de cross-compilation (je suis d'ailleurs preneur de toute information) qui permettrait de régler ce problème.
  Je ne sais pas non plus procéder à la compilation directement avec les outils complets de Cygwin (idem pour l'information).
- Gnuplot
Noter qu'il y aura une modification à faire dans les sources Maxima pour rendre le process gnuplot qu'il lance autonome. C'est contenu dans le fichier plotbis.lisp fourni et (en principe) ce sera transparent.
(En principe) L'installation des programmes doit modifier la variable d'environnement PATH, ce qui a pour effet qu'on peut les lançer à la ligne de commande où qu'on soit dans l'arborescence.

Mais le mieux est de vérifier en tapant PATH dans un terminal cmd.

S'ils n'y sont pas, il faut modifier PATH comme expliqué (par exemple) ici

Et tester, programme par programme que le chemin d'accès est correct. On tape
```
	      gnuplot -h
	      emacs --version
	      Freefem++ -nw
	      maxima maxima -h
	    
```
et les réponses ne doivent pas être qu'ils ne sont pas trouvés.
Le lancement d'Appariteur se fait à la ligne de commande par
```
emacs -Q -L C:\Users\vinsard\NeoAppariteur --load Appariteur.el
```
étant entendu que la commande est tapée dans le répertoire (mutatis mutandis) C:\Users\vinsard\NeoAppariteur où sont placés les fichiers.

Si les fontes ne sont pas satisfaisantes, on peut les changer buffer par buffer (Shift-click droit) ou globalement en mettant quelque chose comme
```
emacs -Q -fn "Courier" -L C:\Users\vinsard\NeoAppariteur --load Appariteur.el
```
ou
```
emacs -Q -fn "Microsoft Sans Serif" -L C:\Users\vinsard\NeoAppariteur --load Appariteur.el
```
dans NeoApp.cmd

Pour mettre cela dans une icône et qu'Appariteur soit lancé sans terminal cmd depuis un click sur un icone épinglée sur la barre de tâche, il faut partir de NeoApp.cmd qui contient
```
emacs -Q -L c:/Users/vinsard/NeoAppariteur --load Appariteur.el
```
Il faut copier ce fichier (click droit copier) ; puis refaire un click droit et sélectionner Nouveau->raccourci. Ça créera un fichier NeoApp.exe dont les propriétés peuvent être changées (le répertoire d'exécution doit être, mutatis mutandis, c:/Users/vinsard/NeoAppariteur et on peut l'associer à l'icône NeoApp.ico (pas NeoApp.png) pour disposer d'un lanceur qui peut être épinglé à la barre de tâche.

(C'est le mode d'emploi qu'on obtient en tapant
```
 pin bat shortcut to taskbar windows 10
```
dans google)
Quelques remarques sur le fonctionnement d'Appariteur sous Windows 10
- Le répertoire temporaire est (toujours mutatis mutandis)
```
C:/Users/vinsard/AppData/Local/Temp/jmaxima{une chaîne de caractères au hasard}
```
  Il est éliminé lorsqu'on sort proprement (i.e. C-x C-c) d'Emacs. Mais pas si on n'en sort pas proprement (i.e. en cliquant sur la petite croix de la fenêtre). Sous Linux, le répertoire temporaire est /tmp/jmaxima{chaîne de caractères au hasard} il est certain que ce répertoire est éliminé lors du redémarrage de la machine. Pour Windows aussi sans doute, mais je n'en suis pas 4 fois sûr.
  Donc à vérifier de temps en temps.
- L'action Dessus/dessous (dans le menu Action d'Appariteur) n'a pas grand sens sous Linux dès lors qu'on utilise un gestionnaire de fenêtre qui réalise bien mieux cette fonction.
  Par contre, le gestionnaire de fenêtre de Windows 10 ne semble pas adapté à « l'abaissement et élévation des fenêtres » (ou alors je n'ai pas trouvé, ce qui est sans doute le cas). D'où l'implantation de cette action qui fait en sorte que les fenêtres graphiques se placent au dessus du Frame Emacs (ou en dessous si on le veut).
- Je n'utilise pas vraiment Windows dans la vie de tous les jours, aussi cette adaptation d'Appariteur n'est pas aussi bien (ou moins mal) testée que sous Linux. Ce serait bien de m'avertir de problèmes éventuels (même s'ils sont bénins, un petit caillou dans la chaussure du soldat est le prélude à sa déroute).