Fr/Options de ligne de commande
Les options de ligne de commande sont un moyen usuel d'indiquer aux applications quoi faire / comment réagir au démarrage. Avec FlightGear elles sont utilisées pour un grand nombre d'opérations, des plus simples comme la sélection d'un aéronef jusqu'à des formules complexes comme la définition du trafic réseau et des paramètres météo.
La manière la plus simple de traiter ces options pour FlightGear (fgfs) est d'utiliser un outil avec une interface utilisateur graphique comme fgrun sous Windows et GNU/Linux ou le lanceur d'interface graphique sous Mac OS X. Avec cette méthode, nul besoin de s'en soucier.
Néanmoins, il existe des utilisateurs qui ne veulent ou ne peuvent pas exécuter l'interface graphique et qui s'intéressent donc à ce sujet. Ceux qui en ont besoin, ou qui veulent simplement en savoir plus sur FlightGear, mais qui n'ont aucune idée de ce dont nous parlons ici, sont invités à lire la page wiki sur l'usage général de la ligne de commande.
L'emplacement approprié pour stocker ses options personnelles est un fichier nommé fgfsrc. Ce fichier est lu par fgfs à chaque démarrage.
Les listes ci-dessous fournissent les options pour fgfs en incluant une courte description et sont triées par catégories. Gardez bien à l'esprit que le maintien à jour de ces listes sur le wiki n'est pas une tâche facile. De plus, il existe différentes versions de FlightGear qui ne partagent pas exactement les mêmes options. Par conséquent, il vaut mieux vérifier votre version avec fgfs --help --verbose
. Si cette commande échoue, vous devez ajouter l'option --fg-root=[path]
, voir ci-dessous.
C'est triste à dire mais vrai : même cette commande, au moins sous Git, n'est pas tout le temps à jour. A l'heure où nous écrivons cet article, au moins une option supportée n'est pas listée en faisant fgfs --help --verbose
. Alors si vous avez de sérieux problèmes avec une option, le code source est, comme toujours, la meilleure source d'information. Dans le fichier src/Main/options.cxx, toutes les options sont listées avec leur valeur et leur type par défaut "en dur".
Le fichier $FG_ROOT/options.xml est utilisé pour générer la sortie pour fgfs --help [--verbose]
. C'est la raison pour laquelle --fg-root=[path]
doit être ajouté, s'il n'est pas défini comme variable d'environnement ou comme une option dans fgfsrc.
Note du traducteur : la liste suivante est inspirée de celle figurant dans l'article Wiki original en anglais, mais adaptée d'après le contenu du dernier manuel officiel FlightGear en vigueur à la date de la traduction, en l'occurrence pour la version 2.10.0. C'est pourquoi il existe des différences entre la présente liste et celle figurant dans l'article original en anglais. En outre, certains éléments sont repris de l'excellent travail de traduction du manuel FlightGear commencé par David Mézière et autres.
Usage : fgfs [OPTION [OPTION ...]]
Options générales
--help Afficher les options de ligne de commande les plus courantes. --help--verbose Afficher toutes les options de ligne de commande. --version Afficher la version courante de FlightGear. --fg-root=chemin Indiquer à FlightGear où rechercher ses fichiers de données racine si vous ne l'avez pas compilé avec les options par défaut. --fg-scenery=rep[:rep...] Spécifier le(s) répertoire(s) des scènes de base, dans le cas où celles-ci ne se trouvent pas à l'emplacement par défaut $FG_ROOT/Scenery ; ceci peut être particulièrement utile dans le cas où les scènes se trouvent sur un CD-ROM. --fg-aircraft=chemin Spécifier le(s) répertoire(s) des aéronefs ; valeur par défaut : $FG_ROOT/Aircraft. --language=code Sélectionner la langue pour la session courante ; par exemple : pl, nl, it, fr, en, de. --restore-defaults Réinitialiser tous les réglages utilisateur à leurs valeurs par défaut. --enable-save-on-exit Activer la sauvegarde des préférences utilisateur à la sortie du simulateur. --disable-save-on-exit Désactiver la sauvegarde des préférences utilisateur à la sortie du simulateur. --disable-freeze Démarrer FlightGear en mode normal. --enable-freeze Démarrer FlightGear en pause. --control=mode Définir le mode de contrôle principal (joystick, clavier, souris). --enable-auto-coordination Activer l'auto-coordination : la gouverne de direction et les ailerons seront contrôlés conjointement ; recommandé pour les utilisateurs ne disposant pas de pédales ni de joystick avec axe de torsion pour le contrôle du palonnier. --disable-auto-coordination Désactiver l'auto-coordination (valeur par défaut). --browser-app=chemin Spécifier le chemin de votre navigateur web. --config=path Charger d'autres propriétés depuis le répertoire spécifié. --units-feet Mesurer les distances en pieds. --units-meters Mesurer les distances en mètres.
Fonctionnalités
--disable-ai-models Désactiver la génération de trafic artificiel. --enable-ai-models Activer la génération de trafic artificiel. --ai-scenario=nom Activer un scénario intelligent spécifique (par exemple : --ai-scenario=vinson-demo). Peut être utilisé plusieurs fois.
Options sonores
--disable-sound Désactiver les effets sonores. --enable-sound Activer les effets sonores. --show-sound-devices Afficher les périphériques audio disponibles. --disable-intro-music Désactiver la musique d'introduction. --enable-intro-music Activer la musique d'introduction.
Aéronefs
--aircraft=nom Charger l'aéronef spécifié, par exemple : --aircraft=c172p. Vérifiez les choix disponibles dans le répertoire $FG_ROOT/Aircraft et recherchez les fichiers dont les noms se terminent par "-set.xml". Pour spécifier un appareil, indiquez le nom du fichier en supprimant le «-set.xml". Voir aussi l'option --show-aircraft décrite ci-dessous pour lister les appareils disponibles. --show-aircraft Afficher la liste des aéronefs disponibles. --min-status=statut Afficher uniquement les appareils dont le statut déclaré est au moins celui spécifié, parmi les statuts suivants : alpha, beta, early-production, production. Pour une utilisation avec l'option --show-aircraft. --aircraft-dir=répertoire Emplacement relatif du répertoire des aéronefs par rapport au répertoire de l'exécutable ; valeur par défaut : $FG_ROOT/Aircraft. --vehicle=nom Synonyme de --aircraft. --livery=nom Définir la livrée de l'appareil.
Modèle de vol
--fdm=nom Sélectionner le modèle dynamique de vol. Le nom peut être jsb, larcsim, yasim, magic, balloon, external, pipe, ada, ou null. Cette option peut normalement être ignorée, puisque l'option --aircraft sélectionne le bon modèle de vol. --aero=name Spécifie le modèle aéronautique d'avion à charger. Cette option peut normalement être ignorée, puisque l'option --aircraft définit le bon modèle. --model-hz=n Exécuter le modèle dynamique de vol avec le taux 'n' spécifié (itérations par seconde). --speed=n Exécuter le modèle dynamique de vol avec un taux 'n' fois plus rapide que le taux réel. --trim Activer l'application de compensation ("trim") sur le modèle de vol. --notrim Empêcher l'application de compensation ("trim") sur le modèle de vol (applicable uniquement si fdm=jsbsim). --on-ground Démarrer au niveau du sol (valeur par défaut). --in-air Démarrer dans les airs (implique d'utiliser aussi l'option --altitude) --disable-fuel-freeze Autoriser la consommation normale de carburant. --enable-fuel-freeze Geler la consommation de carburant : la quantité de carburant dans le réservoir reste constante.
Position et orientation initiales
--airport=ID Démarrer dans un aéroport donné. L'aéroport est spécifié par son code OACI, par exemple --airport=KJFK pour l'aéroport JFK de New York. Pour un aéroport américain sans code OACI, essayez en préfixant son code de 3 caractères par 'K'. --parking-id=ABCD Démarrer sur un stationnement spécifique dans l'aéroport. --runway=rwy_no Démarrer sur un seuil de piste spécifique (par exemple 28L) ; il faut aussi spécifier un aéroport. Si aucun ID de piste ni de stationnement n'est spécifié, une piste face au vent sera choisie pour le décollage. --vor=ID Spécifier une position de démarrage relative à un VOR ; utile pour s'entraîner aux approches. --ndb=ID Spécifier une position de démarrage relative à un NDB ; utile pour s'entraîner aux approches. --fix=ID Spécifier une position de démarrage relative à un point fixe ; utile pour s'entraîner aux approches. --carrier=nom Démarrer sur un porte-avions. --parkpos=nom Démarrer à une position particulière sur le porte-avions ; doit être utilisé avec --carrier. Par défaut sur une position de catapultage. --offset-distance=nm Démarrer à une distance particulière d'un point de référence (en milles nautiques). --offset-azimuth=degrés Démarrer avec un cap spécifique par rapport à un point de référence (en degrés). --lon=degrés Démarrer à une longitude particulière, en degrés décimaux (valeur négative pour l'ouest). --lat=degrés Démarrer à une latitude particulière, en degrés décimaux (valeur négative pour le sud). --altitude=valeur Démarrer à une altitude spécifique. Implique d'utiliser aussi l'option --in-air. Altitude spécifiée en pieds sauf si vous avez aussi sélectionné --units-meters, auquel cas elle est en mètres. Vous devrez aussi positionner une vitesse initiale avec l'option --vc pour éviter de décrocher immédiatement. --heading=degrés Spécifier l'angle de cap initial (lacet) en degrés. --roll=degrés Spécifier l'angle de roulis initial en degrés. --pitch=degrés Spécifier l'angle de tangage initial en degrés --uBody=unités_par_sec Définir la vitesse initiale le long de l'axe X (en pieds par seconde sauf si vous avez sélectionné également --units-meters, auquel cas elle est en mètres par seconde). --vBody=unités_par_sec Définir la vitesse initiale le long de l'axe Y (en pieds par seconde sauf si vous avez sélectionné également --units-meters, auquel cas elle est en mètres par seconde). --wBody=unités_par_sec Définir la vitesse initiale le long de l'axe Z (en pieds par seconde sauf si vous avez sélectionné également --units-meters, auquel cas elle est en mètres par seconde). --vNorth=N Définir la vitesse initiale le long de l'axe Nord-Sud (en pieds par seconde sauf si vous avez sélectionné également --units-meters, auquel cas elle est en mètres par seconde). --vEast=E Définir la vitesse initiale le long de l'axe Ouest-Est (en pieds par seconde sauf si vous avez sélectionné également --units-meters, auquel cas elle est en mètres par seconde). --vDown=D Définir la vitesse initiale le long de l'axe vertical (en pieds par seconde sauf si vous avez sélectionné également --units-meters, auquel cas elle est en mètres par seconde). --vc=noeuds Spécifier la vitesse initiale par rapport à l'air (en noeuds) ; utile si vous avez sélectionné l'option --altitude, sinon vous allez décrocher immédiatement ! --mach=num Spécifier la vitesse initiale par rapport à l'air (en mach) ; utile si vous avez sélectionné l'option --altitude, sinon vous allez décrocher immédiatement ! --glideslope=degrés Régler l'angle de descente initial en degrés ; peut être positif ou négatif. --roc=fpm Régler le taux de montée initial en pieds par minute ; peut être positif ou négatif.
Options d'environnement
--ceiling=HAUT[:EPAISS] Fixer le plafond à une hauteur spécifique, avec en option une épaisseur spécifique, exprimées en pieds (valeur par défaut : 2000 pieds). --disable-real-weather-fetch Désactiver les données météo en temps réel basées sur le METAR. --enable-real-weather-fetch Activer les données météo en temps réel basées sur le METAR (nécessite une connexion Internet ouverte). --metar=chaîne METAR Utiliser une chaîne METAR spécifique, par exemple --metar=~XXXX012345Z 00000KT 99SM CLR 19/M01 A2992~. Le METAR peut être spécifié dans la plupart des formats courants (américain, européen). Incompatible avec l'option --enable-real-weather-fetch. --random-wind Définir une direction et une force du vent aléatoires. --turbulence=0.0 à 1.0 Spécifier les turbulences de 0.0 (calme) à 1.0 (sévère). --wind=DIR@VIT Spécifier le vent de surface avec une direction DIR en degrés et une vitesse VIT en noeuds. Les valeurs peuvent être spécifiées comme une plage en utilisant le séparateur ':', par exemple --wind=180:220@10:15. --season=param Définir la saison simulée ; les paramètres valides sont summer (par défaut) et winter. --visibility=meters Spécifier la visibilité initiale en mètres. --visibility-miles=miles Spécifier la visibilité initiale en milles.
Options de rendu
--aspect-ratio-multiplier=N Définir un multiplicateur pour le format d'affichage. --bpp=profondeur Spécifier le nombre de bits par pixel. --enable-clouds Activer les couches de nuages en 2D. --disable-clouds Désactiver les couches de nuages en 2D. --enable-clouds3d Activer les couches de nuages en 3D. --disable-clouds3d Désactiver les couches de nuages en 3D. --disable-distance-attenuation Désactiver l'atténuation de lumière de piste due à la distance. --enable-distance-attenuation Activer l'atténuation de lumière de piste due à la distance. --disable-enhanced-lighting Désactiver l'éclairage de piste amélioré. --enable-enhanced-lighting Activer l'éclairage de piste amélioré. --disable-fullscreen Désactiver le mode plein écran. --enable-fullscreen Activer le mode plein écran. --disable-game-mode Désactiver l'affichage plein écran pour les cartes graphiques 3DFX. --enable-game-mode Activer l'affichage plein écran pour les cartes graphiques 3DFX. --disable-horizon-effect Désactiver l'illusion de grossissement des corps célestes près de l'horizon. --enable-horizon-effect Activer l'illusion de grossissement des corps célestes près de l'horizon. --disable-mouse-pointer Désactiver le pointeur de souris supplémentaire. --enable-mouse-pointer Activer le pointeur de souris supplémentaire (utile en mode plein pour les anciennes cartes graphiques type Voodoo). --disable-panel Désactiver le panneau des instruments. --enable-panel Activer le panneau des instruments. --disable-random-buildings Désactiver la génération de bâtiments aléatoires. --enable-random-buildings Activer la génération de bâtiments aléatoires ; notez que ceci prend beaucoup de mémoire. --disable-random-objects Désactiver la génération d'objets aléatoires du paysage. --enable-random-objects Activer la génération d'objets aléatoires du paysage. --disable-random-vegetation Désactiver la génération de végétation aléatoire comme les arbres. --enable-random-vegetation Activer la génération de végétation aléatoire comme les arbres ; nécessite une carte graphique supportant les Shaders GLSL, certaines cartes anciennes ou moins puissantes ne les supportent pas. --disable-rembrandt Désactiver la fonctionnalité expérimentale Rembrandt qui permet l'éclairage amélioré et les ombres en temps réel. --enable-rembrandt Activer la fonctionnalité expérimentale Rembrandt qui permet l'éclairage amélioré et les ombres en temps réel. --disable-skyblend Désactiver la mise à jour de l'aspect du ciel en fonction du temps et de l'environnement. --enable-skyblend Activer la mise à jour de l'aspect du ciel en fonction du temps et de l'environnement. --disable-specular-highlight Désactiver les réflexions spéculaires sur les objets texturés. --enable-specular-highlight Activer les réflexions spéculaires sur les objets texturés. --disable-splash-screen Désactiver l'écran de démarrage. --enable-splash-screen Activer l'écran de démarrage. --disable-textures Désactiver le texturage du terrain. --enable-textures Activer le texturage du terrain. --disable-wireframe Désactiver le mode "fil de fer". --enable-wireframe Activer le mode "fil de fer" ; si vous souhaitez savoir à quoi ressemble le monde de FlightGear vu de l'intérieur, essayez cela ! --fog-disable Désactiver le brouillard / la brume ; pour réduire la puissance nécessaire au rendu, les régions éloignées disparaissent dans le brouillard par défaut. Si vous désactivez le brouillard, vous verrez plus loin, mais votre taux de rafraîchissement va baisser. --fog-fastest Activer la gestion rapide du rendu de brouillard / brume ; affichera un brouillard moins réaliste mais augmentera votre taux de rafraîchissement. --fog-nicest Activer la qualité du rendu de brouillard / brume ; affichera un brouillard plus réaliste mais diminuera votre taux de rafraîchissement. --fov=degrés Définir le champ de vision en degrés. Valeur par défaut : 55,0. --materials-file=fichier Spécifier le fichier des matériaux utilisé pour le rendu du paysage ; par défaut : Materials/regions/materials.xml. --geometry=WxH Définir la résolution de la fenêtre / de l'écran. Par exemple : --geometry=1024x768. --shading-flat Utiliser l'ombrage plat (ombrage de Lambert) ; plus rapide mais moins beau. --shading-smooth Utiliser l'ombrage lissé. --texture-filtering=N Configurer le filtrage de texture anisotrope. Les valeurs sont 1 (par défaut), 2, 4, 8 ou 16. --view-offset=valeur Définir la direction par défaut de la vue avant en spécifiant son décalage par rapport à une vue droit devant. Les valeurs possibles sont LEFT, RIGHT, CENTER, ou une valeur spécifiée en degrés. Utile dans le cas d'un affichage multi-écrans.
Options de l'affichage tête haute (HUD)
--disable-anti-alias-hud Désactiver l’anticrénelage sur l'affichage tête-haute (HUD). --enable-anti-alias-hud Activer l’anticrénelage sur l'affichage tête-haute (HUD). --disable-hud Désactiver l'affichage tête-haute (HUD). --enable-hud Activer l'affichage tête-haute (HUD). --disable-hud-3d Désactiver l'affichage tête-haute (HUD) en 3D. --enable-hud-3d Activer l'affichage tête-haute (HUD) en 3D. --hud-tris Afficher le pourcentage de triangles rendus. Offre principalement un intérêt pour les développeurs graphiques. --hud-culled Afficher le pourcentage de triangles élagués. Offre principalement un intérêt pour les développeurs graphiques.
Options d'avionique
--adf=[radiale:]fréquence Régler la fréquence radio ADF, éventuellement précédée d'une radiale. --com1=frequency Régler la fréquence radio COM1. --com2=frequency Régler la fréquence radio COM2. --dme={nav1|nav2|fréquence} Asservir l'ADF sur l'une des radios NAV, ou définir sa fréquence interne. --failure=système Simuler la panne d'un système avionique spécifique. Les valeurs valides sont pitot, static, vacuum, electrical. Spécifier cette option plusieurs fois pour provoquer des pannes multiples. --nav1=[radiale:]fréquence Régler la fréquence radio NAV1, éventuellement précédée d'une radiale. --nav2=[radiale:]fréquence Régler la fréquence radio NAV2, éventuellement précédée d'une radiale.
Options du temps
--disable-clock-freeze Fonctionnement normal de l'horloge. --enable-clock-freeze Gel de l'horloge. --start-date-sys=aaaa:mm:jj:hh:mm:ss Spécifier la date et l'heure au démarrage en prenant comme référence l'heure de votre système. --start-date-gmt=aaaa:mm:jj:hh:mm:ss Spécifier la date et l'heure au démarrage en prenant comme référence le fuseau horaire de Greenwich. --start-date-lat=aaaa:mm:jj:hh:mm:ss Spécifier la date et l'heure au démarrage en prenant comme référence le fuseau horaire où se trouve l'avion. --time-match-real Synchroniser l'horloge sur l'heure internationale. --time-match-local Synchronise l'horloge sur l'heure locale. --time-offset=[+-]hh:mm:ss Spécifier un décalage de l'heure par rapport à la référence ; cette dernière dépend des autres options choisies. --timeofday=param Spécifier le moment de la journée. Les paramètres valides sont real (heure réelles), dawn (aube), morning (matin), noon (midi), afternoon (afternoon), dusk (crépuscule), evening (soir), midnight (nuit).
Options réseau
--multiplay={in|out},hz,adresse,port Spécifier les paramètres de communication multi-pilote ; plusieurs instances peuvent être utilisées. --callsign Attribuer un nom unique à un joueur. --httpd=port Activer le serveur http sur le port spécifié. --telnet=port Activer le serveur telnet sur le port spécifié. --jpg-httpd=port Activer le serveur http de capture d'écran sur le port spécifié --proxy=[user:password@]host:port Spécifier un serveur proxy à utiliser.
Options de route / points de passage
--wp=ID[@alt] Spécifier un point de passage pour le pilote automatique ; il est possible de spécifier plusieurs points de passage (donc une route) par l'intermédiaire de plusieurs instances de cette commande. --flight-plan=fichier Lire tous les points de passage depuis un fichier.
NB: Ces options sont plutôt destinées aux utilisateurs avancés qui savent ce qu'ils font.
Options d'entrée/sortie
--atlas=params Ouvrir une connexion en utilisant le protocole Atlas (utilisé par Atlas et TerraSync). --atcsim=params Ouvrir une connexion en utilisant le protocole ATC Sim (atc610x). --AV400=params Ouvrir une connexion pour piloter un GPS Garmin série 196/296. --generic=params Ouvrir une connexion en utilisant le protocole générique (défini par XML). --garmin=params Ouvrir une connexion en utilisant le protocole GPS Garmin. --joyclient=params Ouvrir une connexion à un joystick Agwagon. --jsclient=params Ouvrir la connexion à un joystick distant. --native-ctrls=params Ouvrir une connexion en utilisant le protocole de commande natif de FG. --native-fdm=params Ouvrir une connexion en utilisant le protocole FDM natif de FG. --native-gui=params Ouvrir une connexion en utilisant le protocole FDM natif de FG. --native=params Ouvrir une connexion en utilisant le protocole natif de l'interface graphique utilisateur. --nmea=params Ouvrir une connexion en utilisant le protocole NMEA. --opengc=params Ouvrir une connexion en utilisant le protocole OpenGC. --props=params Ouvrir une connexion en utilisant le gestionnaire interactif de propriétés. --pve=params Ouvrir une connexion en utilisant le protocole PVE. --ray=params Ouvrir une connexion en utilisant le protocole du siège mobile de Ray Woodworth. --rul=params Ouvrir une connexion en utilisant le protocole RUL.
Sous Windows, vous devez utiliser une séquence d'échappement spécifique si vous voulez spécifier un port COM supérieur à 9.
Par exemple : --generic=\\.\COM10,out,1,/tmp/data.xml,myproto
Ceci est issu de l'article Microsoft KB suivant : http://msdn.microsoft.com/en-us/library/aa363858%28v=vs.85%29.aspx
Options de mise au point (debug)
--enable-fpe Activer l'arrêt sur exception de virgule flottante. --fgviewer Au lieu de charger le simulateur complet, charger un espion OSG léger ; utile pour vérifier des modèles d'aéronefs. --log-level=niveau Régler le niveau de journalisation. Les valeurs valides sont bulk, debug, info, warn, alert. --prop:[type:]name=value Assigner une valeur à une propriété. --trace-read=prop Trace les lectures d'une propriété donnée ; plusieurs instances sont autorisées. --trace-write=property Trace les écritures d'une propriété donnée ; plusieurs instances sont autorisées.
Les noms des avions FlightGear 1.0 pour la ligne de commande peuvent être utiles selon la version et les avions installés.