FGo! - Une interface de lancement simple pour FlightGear.

-------------------------------------------------------------------------------

EXIGENCES MINIMALES

Système d'exploitation : GNU/Linux
FlightGear
Python 2.6.8 *
TKinter
Python Imaging Library (PIL) 1.1.6 (avec module ImageTk) **
Tcl/Tk 8.5

*  FGo! est compatible uniquement avec Python 2.x.
** Cette librairie n'est pas indispensable pour lancer FGo! mais les miniatures
   des aéronefs ne seront pas affichées sans elle.

-------------------------------------------------------------------------------

INSTALLATION

Ce programme ne nécessite aucune installation, mais Python (avec les modules
Tkinter et PIL modules) et la librairie Tcl/Tk doivent être installés avant
le premier lancement de FGo!.
Ceux-ci doivent être disponibles dans les dépôts. Sur les distributions basées
sur Debian, vous pourriez avoir à installer également ces paquetages :
python, python-tk, python-imaging, python-imaging-tk, tcl8.x et tk8.x.

Vous pouvez simplement choisir python-imaging-tk, et votre gestionnaire devrait
automatiquement installer les autres dépendances nécessaires.

Pour Slackware GNU/Linux et systèmes compatibles un SlackBuild est disponible:
ceci va générer un paquet qui permet une installation de Fgo! intégrée dans le
système. Le SlackBuild peut être téléchargé du site http://www.slackbuilds.org.
Sur des systèmes Slackware standard aucun paquet supplémentaire est nécessaire.

-------------------------------------------------------------------------------

LANCEMENT

FGo! n'offre pas sa propre fenêtre pour afficher les messages de FlightGear,
c'est pourquoi la meilleure méthode pour lancer l'application est de
la démarrer à partir de la ligne de commande. Ouvrez un terminal, naviguez
jusqu'au répertoire où FGo! a été décompressé et lancez-le en utilisant
la commande "python fgo" ou "./fgo", ou si votre système offre cette
fonctionnalité, vous pouvez simplement cliquer sur l'icône fgo et choisir dans
les options de dialogue : Exécuter dans un terminal. Dans les deux derniers
cas, vérifiez bien que le fichier fgo est un exécutable.

A partir de la version 1.3.0, vous n'avez pas besoin de naviguer jusqu'à son
répertoire principal avant de le lancer. Vous pouvez maintenant simplement
créer un lien symbolique vers le ficher "fgo", et le placer où vous souhaitez,
ou le lancer à partir d'un autre emplacement avec une commande comme :
python ~/fgo_main_folder/fgo .

-------------------------------------------------------------------------------

CONFIGURATION

Afin d'utiliser FGo! vous devez d'abord le configurer. Ouvrez la fenêtre
de préférences (dans le menu choisissez, : Paramètres => Préférences) et
remplissez les champs vides.

Préférences de FlightGear :

    Chemin vers le fichier exécutable - entrez le chemin vers le fichier
        "fgfs", ou "run_fgfs.sh", si vous utilisez le script
        download_and_compile.sh.

    FG_ROOT - chemin vers le répertoire principal de FlightGear.

    FG_SCENERY - chemin vers les scènes. Vous pouvez spécifier plus d'un chemin
        (séparés par :) dans l'ordre de la couche la plus haute à la couche
        la plus basse.

    Répertoires d'aéronefs additionnels - chemin vers des répertoires
        d'aéronefs additionnels. Plusieurs répertoires, séparés
        par : peuvent être ajoutés. Laissez vide si vous n'utilisez pas
        de répertoires d'aéronefs additionnels.

    Répertoire de travail - paramètre optionnel précisant le répertoire
        de travail de FlightGear. C'est le répertoire où les journaux et les
        captures d'écrans seront sauvegardés. Si vous le laissez vide,
        le répertoire de travail est le répertoire par défaut de l'utilisateur.

Préférences de TerraSync :

    Chemin vers le fichier exécutable - entrez le chemin vers les fichiers
        "terrasync" ou "run_terrasync.sh", si vous utilisez le script
        download_and_compile.sh.

    Chemin des scènes - répertoire où TerraSync sauvegarde les scènes
        téléchargées.

    Port - Numéro de port utilisé par TerraSync.

Divers :

    Changer la langue - choisissez une autre langue. Si non sélectionné, FGo!
        essaiera de détecter la langue du système.

    Source des données aéroport - choisissez la source des données où FGo!
        cherchera les informations à propos des pistes ou des positions
        de parking. Il y a deux options :

        Défaut - FGo! affichera les numéros de pistes en se basant sur
            le fichier ~/.fgo/apt, qui est généré à partir de la base de
            données FG_ROOT/Airports/apt.dat.gz. Les noms de parking seront
            obtenus à partir du répertoire FG_ROOT/AI/Airports.

        Scènes - FGo! affichera les numéros de pistes en se basant sur
            le fichier ~/.fgo/apt, qui est généré à partir de la base de
            données FG_ROOT/Airports/apt.dat.gz. Les noms de parking seront
            obtenus à partir du répertoire FG_SCENERY/Airports
            (ou des répertoires, si plusieurs chemins sont listés).

        De manière générale, l'option "Défaut" dira à FGo! d'afficher la même
        information que FlightGear utilise par défaut en sélectionnant
        l'emplacement de démarrage, alors que l'option "Scènes" dira à FGo!
        de rechercher cette donnée directement dans le répertoire des scènes.
        Dans ce dernier cas, vous pouvez ajouter l'argument
        '--prop:/sim/paths/use-custom-scenery-data=true dans la fenêtre des
        options de ligne de commande pour dire à FlightGear d'utiliser la même
        information.

        Si vous ne savez pas quelle option choisir, le mieux est de conserver
        l'option par défaut.

    Mise à jour de la base de données des aéroports - il faut choisir entre
    deux options :

        Automatique - FGo! tentera de suivre les modifications du fichier
            FG_ROOT/Airports/apt.dat.gz et reconstruira la base de données des
            aéroports lorsque ce sera nécessaire.

        Manuel - le bouton "Reconstruire la base de données des aéroports" doit
            être utilisé à chaque fois que FG_ROOT/Airports/apt.dat.gz
            est modifié.

    Reconstruire la base de données des aéroports - construit
        une nouvelle base de données des aéroports à partir du fichier
        FG_ROOT/Airports/apt.dat.gz actuel. Pratique lorsque le fichier
        apt.dat.gz a été mis à jour.

La complétion des trois premières entrées est nécessaire pour un fonctionnement
nominal du programme - le reste est optionnel. Lorsque vous avez terminé
la configuration, cliquez sur le bouton "Enregistrer les préférences".
Après quelques instants, dans la fenêtre principale apparaitra une liste des
aéronefs et aéroports disponibles.

Les modifications dans les paramètres de FlightGear sont appliqués
immédiatement après avoir cliqué sur le bouton "Enregistrer les préférences",
cependant les modifications liées à TerraSync aux à la langue peuvent
nécessiter de redémarrer FGo!.

-------------------------------------------------------------------------------

ITEMS DU MENU PRINCIPAL

Fichier :

    Charger - charger un fichier de configuration spécifique.

    Enregistrer sous... - sauvegarde les paramètres dans un fichier
        de configuration spécifique.

    Enregistrer et quitter - sauvegarde les paramètres et quitte l'application.

    Quitter - quitte l'application.

Paramètres :

    Afficher uniquement les aéroports installés - seuls les aéroports présents
        dans les scènes actuellement installées sur le disque dur sont
        affichées dans la liste des aéroports.

    Mettre àjour la liste des aéroports installés - balaye le disque dur pour
        des scènes installées et met à jour la liste des aéroports
        en conséquence. Fonctionne uniquement si l'option "Afficher uniquement
        les aéroports installés" est activée.

    Préférences - affiche la fenêtre des préférences.

Outils :

    METAR - affiche le rapport METAR pour l'aéroport sélectionné (ou le plus
        proche). Ces rapports sont téléchargés à partir de l'adresse
        http://weather.noaa.gov/

Aide :

    Aide - ouvre la fenêtre "Aide".

    A propos - ouvre la fenêtre "A propos de".

-------------------------------------------------------------------------------

FENETRE D'OPTIONS EN LIGNE DE COMMANDE

Dans la fenêtre de texte du bas, vous pouvez écrire des options de ligne
de commande qui seront passées à FlightGear.

Peu d'options sont proposées par défaut, pour plus d'exemples consultez
la documentation de FlightGear ou le Wiki à l'adresse :
http://wiki.flightgear.org/index.php/Command_Line_Options

-------------------------------------------------------------------------------

TRUCS & ASTUCES

* Si la source des données d'aéroport a été positionnée à "Scènes", alors
  l'information sur les positions de parking d'aéroport peut ne pas être
  disponible jusqu'à ce que les scènes correspondantes soient installées.

* Vous pouvez démarrer un vol à partir d'un porte-avions. Dans le panneau
  du milieu cliquez sur le code ICAO de l'aéroport actuel (juste en-dessous
  de l'image de l'aéronef) et choisissez parmi les porte-avions disponibles.
  Le code ICAO sera alors modifié en nom du bateau, et sera surligné en bleu
  de manière à vous indiquer que vous êtes à présent en mode "porte-avions".
  Le scénario correspondant sera automatiquement sélectionné. Pour pouvoir
  choisir à nouveau des aéroports, vous devez cliquer sur le nom du
  porte-avions, et à partir de la liste de la fenêtre choisissez "None".

* Dans la liste "Sélectionnez un scénario", vous pouvez effectuer un clic droit
  sur n'importe quel scénario pour obtenir sa description (si elle est
  disponible).

* La résolution de la fenêtre est sauvegardée lorsque le bouton
  "Enregistrer et quitter" est cliqué.

* Si vous souhaitez distinguer le lanceur FGo! d'autres fichiers, vous pouvez
  remplacer son icône par défaut par l'image appelée "fgo.png" présente
  dans le répertoire "fgo/data/pics".

-------------------------------------------------------------------------------

ANOMALIES CONNUES ET LIMITATIONS

* FGo! ne sait pas si TerraSync a été effectivement fermé avant qu'une nouvelle
  instance n'en soit lancée. Si la case à cocher "TerraSync" est décochée puis
  à nouveau cochée sur une courte période de temps, le message "error binding
  to port 5501" peut s'afficher dans une console. Il indique qu'une ancienne
  instance de TerraSync n'a pas encore fini de télécharger les données. Dans ce
  cas, attendez jusqu'à ce que le téléchargement soit terminé et cochez
  à nouveau la case TerraSync.

* Les noms de places de parking très longs ne rentrent pas dans le bouton
  parking.

-------------------------------------------------------------------------------

                                                Merci d'utiliser ce logiciel,
                                             Robert 'erobo' Leda  <erobo@wp.pl>
