Fr/Options de ligne de commande
Jump to navigation
Jump to search
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.