#FGExtend
Version 2020.06.04
Auteur: Xavier De Goër
Contact: FGExtend@flightgear.fr

Licence : freeware
Je devrais écrire ici le baratin habituel "à vos risques et périls".

Problème connu:
Le chemin complet du dossier d'installation NE DOIT PAS COMPORTER D'ESPACE.

IMPORTANT:FGExtend NE FONCTIONNERA QUE SI FLIGHTGEAR EST LANCE AVEC L'OPTION --telnet (voir plus bas).

*** NOTE IMPORTANTE AUX UTILISATEURS DE Windows10 ***
Il faut donner les droits d'exécution en mode administrateur à FGExtend, mais aussi à Mumble, à Python et à wget.
Plus de détail: http://windowsreport.com/createprocess-failed-code-740/

Nouveautés de la version 2020.06.04
1) Utilisation du script Python permettant le téléchargement des sous-répertoires "Buildings"/"Pylons"/"Roads".
2) Reprise du dialogue de configuration (meilleure lisibilité, flexibilité Terrasync, abandon de TerraGIT).
3) Demande optionelle de confirmation avant la sortie du programme.

Nouveautés de la version 2019.02.14
1) Affichage de la liste des ATCs sous forme d'arbre (le mode liste antérieur reste disponible).
2) Introduction d'une note de qualité de scène des aéroports gérés: 
   0 - Non noté
   1 - Pas de parking avion
   2 - Parking avion
   3 - Bâtiments non réalistes
   4 - Bâtiments réalistes
   5 - Scène très réaliste
3) Possibilité de trouver la liste des aéroports gérés dans un rayon donné (en Nm):
   Entrer le rayon souhaité dans le champs "Find", optionnellement suivi de ";Q", Q étant la qualité de scène minimale souhaitée.  

Nouveautés de la version 2018.09.08
1) Contournement d'une fuite mémoire de FGFS liée aux connexions "telnet";les connexions sont maintenues tant qu'elles ne tombent pas d'elles mêmes, précédemment il y avait environ 3 connexions établies et fermées par seconde.

Nouveautés de la version 2018.06.18
1) Ajoût d'un bouton permettant de basculer le mode transpondeur du 777 (et probablement de bien d'autres avions) sur ALT.

Nouveautés de la version 2017.12.10
1) Correction de 3 bugs concernant la fonctionnalité "Terrasync"
2) Ajoût d'une alarme (warning dans fgfs toutes les 65 secondes) si la fonctionnalité "Terrasync" est supposée être utilisée (le dossier déclaré dans la configuration existe) mais est désactivée (case à cocher).
3) Ajoût d'une blacklist dans la configuration pour ne pas charger/mettre à jour certaines tuiles.
4) Renommage du fichier FGExtend.py en terra5.py (évite de le lancer par erreur).
5) TerraGIT n'est plus supporté, le protocole étant régulièrement modifié.
6) Version Mac bêta.2 intégrée.

Nouveautés de la version 2017.09.01

1) MySQL n'est plus utilisé, neammoins je maintiendrai la base à jour pour les utilisateurs des versions précédentes.
2) Mise à jour des données locales automatique au démarrage, sur option dans la configuration.

Nouveautés de la version 2017.08.20

1) 2 lignes de visuialisation de l'état de la connexion avec Flightgear / Mumble.
2) Boutons Dep. et Dest. pour afficher directements les infos corresondantes.
3) Bouton FIR pour afficher les fréquences des FIR à portée.

Nouveautés de la version 2017.02.24

1) Nouvelle case à cocher pour permettre de NE PAS mettre à jour les répertoires Airports et Models à partir de Terrasync
(le problème ne se pose pas avec terraGIT, qui ne propose plus l'update de ces répertoires, d'après ce que je crois voir).

Pourquoi?
En cas d'utilisation des passerelles automatiques créées dynamiquement, il faut enlever les passerelles statiques (au sens informatique),
tant dans $FGDATA que dans $FGSCENERY (sinon, les passerelles créées dynamiquement vont se positionnner SUR celles de la scène,
ce qui est du plus mauvais effet).

2) Sauvegarde de votre configuration dans un fichier .cfg, ce qui permet de garder le paramétrage même en cas d'utilisation d'un FGExtend.dat nouvellement mis à jour.
Le .dat est chargé d'abord, et si le .cfg existe son contenu va ensuite écraser les valeurs lues dans le .dat

Remerciements
-------------
à Daweed(AFR6938), pour son activité de bêta testeur, pour m'avoir botté les f... afin d'obtenir une version Windows, m'avoir aidé à la déboguer, et pour l'hébergement des données.
à Theddy(U974), Pour avoir rédigé en très très grande partie ce document, pour son activité de bêta testeur, et pour sa contribution à la démystification de l'énigme "Windows10". 
à BL99, pour son activité de bêta testeur, et pour sa contribution à la démystification de l'énigme "Windows10".
à Claudy. 
J'en oublie sûrement, manifestez vous, je me ferai un plaisir de refaire un post pour vous citer.

Commuter simplement vos fréquences radios lors de vos sessions multiplayer avec Flightgear et Mumble, tout en profitant du téléchargement des scènes via TerraGit(git) ou Terrasync(http).
Tout devient alors plus simple lors de vos changements de fréquence radio, il vous suffira de sélectionner la fréquence ATC de votre choix, soit par le menu "Paramètres radio (F12)" dans Flightgear
ou directement via le bloc radio de votre aéronef et v'lan, l'action sera répercutée automatiquement sur Mumble.
(Fréquence active de COM1)

* Léger et rapide
* Prise en main facile
* Présence de grands aéroports français et des 5 FIR

##Contenu du package Windows:
 - FGExtend.exe (ewécutable)
 - FGExtend.dat (Base de donnèes locale)
 - terra5.py (script de mise à jour terrasync)
 - FGExtend.ico
 - wget.exe (pour mettre à jour de la base de données locale)

##Contenu du package Linux:
 - FGExtend (exécutable)
 - FGExtend.dat
 - terra5.py
 - FGExtend.ico

##Pré-requis:
* Un client Mumble doit être installé et configuré au préalable sur votre ordinateur (celui qui fait tourner FGExtend).
(http://www.mumble.com/)

Sous linux et MacOS wget doit être installé
Sous windows il est fourni dans le zip (aucune installation à faire).

##Installation (Windows)
*Décompresser l'archive dans un dossier de votre choix.

*** NOTE IMPORTANTE AUX UTILISATEURS DE Windows10 ***
Il faut donner les droits d'exécution en mode administrateur à FGExtend, mais aussi à Mumble,à Python et à wget.
Plus de détail: http://windowsreport.com/createprocess-failed-code-740/

##Installation (Linux)
Là ça ce complique... je rigole :)
*Décompresser l'archive dans un dossier de votre choix.
Je vous l'avais dit que ça allait être compliqué...

## Tous systèmes
*Configuration
 Lancer FGExtend et appuyer sur le bouton "Configure".
 Si FG ne tourne pas sur la même machine que FGExtend, Renseigner la rubrique "IP/URL" par l'adresse IP de la machine faisant fonctionner Flightgear (ex: 192.168.xx.xx).
 Le port utilisé pour communiquer avec FG est également modifiable.
 Les valeurs par défaut peuvent être restaurées à tout moment.
 Valider vos modifications par l'appui sur la touche "OK".

Si vous n'utilisez pas de certificat Mumble, Renseignez votre/vos noms d'utilisateur pour chaque serveur Mumble (Bouton "Edit" sous la liste des serveurs).

#Initialisation d'un répertoire TerraSync
Cocher la case "Active".
Renseigner le champs Directory (chemin absolu), Le contenu doit se terminer par "Scenery" (Case sensitive).
Cliquer sur le bouton "Initialize Directory".
Répondre aux éventuelles questions.
Etre patient durant le clonage initial (1 à 3H avec un ADSL "standard").

Pour voir s'afficher dans FG l'avancée du téléchargement des tuiles, cocher la case "Show downloading progress in FG as Copilot messages".
*Note: Les messages concernant des erreurs ou des warnings seront affichés même si cette case est décochée.
Pour les utilisateurs Windows: Une fois le fonctionnement validé, cocher la case "Hide git terminal window" pour ne plus voir le terminal sous-jacent.

***** BIEN SUR, IL FAUT EXPLIQUER à FG de prendre en compte ce répertoire scènes (à travers votre lanceur préféré ou en ligne de commande). *****

***** De même, il est nécessaire d'expliquer à FG via votre lanceur (ou ligne de commande), qu'il doit activer l'option telnet: *****
Ajouter l'option suivante dans la ligne de commande (ou passer par "Propriétés" via FGRun par exemple): --telnet=5401

--- Info ---
La taille des tuiles gérées est de 1X1 degré.

Logique du chargement ou mise à jour des tuiles:
1)Tuile de destination;Si celle-ci est modifiée, le processus reprend.
2)Tuile supposée "précédente" en fonction du cap d'arrivée à destination (grand cercle entre la position courante et la destination).
3)Les 7 autres tuiles autour de celle de destination.
4)Les tuiles qui seront survolées, ou à proximité latéralement, fonction du cap de l'avion.
  Si le cap est modifié d'au moins 10 degrés, ou que la tuile survolée change, le processus reprend pour éviter de "courir derrière l'avion" si le débit réseau est insuffisant.   
------------

Conseils avant le premier vol
-----------------------------
-Positionner votre avion sur le terrain de départ
-entrer dans le route manager de FG une destination très proche (mais pas le terrain de départ, car ça plante FG)
-le chargement de la tuile de destination devrait démarrer.

Ensuite, tout devrait être totalement transparent si vous partez du terrain précédent:
- soit le vol est court et votre tuile de destination sera déjà chargée
- soit le vol est long et elle aura le temps de se charger.

* Ajout/Modification d'ATC
Il est possible d'ajouter/modifier/détruire des ATCs/fréquences, mais cela n'aura aucun interêt si vous n'avez pas d'accès administrateur
sur les serveurs Mumble pour pouvoir créer les salons correspondants.

Bloc-notes
----------
Vous pouvez prendre des notes ATC par ATC.
Ces notes sont stockées dans des fichiers texte dans le sous répertoire "notes" du répertoire de FGExtend.

Exemple de ce que je fais(LEMD):
ALT 1998 *****
33L (322) ILS 109.9 AKOKI (22Nm)
ATIS 118.25 - 130.85
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------
Vos retours sont les bienvenus.








