first commit

This commit is contained in:
Your Name
2022-10-20 20:29:11 +08:00
commit 4d531f8044
3238 changed files with 1387862 additions and 0 deletions

5
man/CMakeLists.txt Normal file
View File

@@ -0,0 +1,5 @@
if(NOT WIN32) # Don't install man pages on Windows
add_subdirectory(it)
add_subdirectory(man1)
add_subdirectory(man5)
endif(NOT WIN32)

2
man/it/CMakeLists.txt Normal file
View File

@@ -0,0 +1,2 @@
add_subdirectory(man1)
add_subdirectory(man5)

View File

@@ -0,0 +1,49 @@
include(GNUInstallDirs)
set(MANPAGES
fgfs.1
)
if(ENABLE_FGCOM)
list(APPEND MANPAGES fgcom.1)
endif(ENABLE_FGCOM)
if(ENABLE_FGELEV)
list(APPEND MANPAGES fgelev.1)
endif(ENABLE_FGELEV)
if(ENABLE_FGJS)
list(APPEND MANPAGES fgjs.1)
endif(ENABLE_FGJS)
if(WITH_FGPANEL)
list(APPEND MANPAGES fgpanel.1)
endif()
if(ENABLE_FGQCANVAS)
list(APPEND MANPAGES fgqcanvas.1)
endif(ENABLE_FGQCANVAS)
if(ENABLE_FGVIEWER)
list(APPEND MANPAGES fgviewer.1)
endif(ENABLE_FGVIEWER)
if(ENABLE_GPSSMOOTH)
list(APPEND MANPAGES GPSsmooth.1 MIDGsmooth.1 UGsmooth.1)
endif(ENABLE_GPSSMOOTH)
if(ENABLE_JS_DEMO)
list(APPEND MANPAGES js_demo.1)
endif(ENABLE_JS_DEMO)
if(ENABLE_JSBSIM)
list(APPEND MANPAGES JSBSim.1)
endif(ENABLE_JSBSIM)
if(ENABLE_METAR)
list(APPEND MANPAGES metar.1)
endif(ENABLE_METAR)
foreach(man ${MANPAGES})
install(FILES ${man} DESTINATION ${CMAKE_INSTALL_MANDIR}/it/man1
COMPONENT doc)
endforeach()

73
man/it/man1/GPSsmooth.1 Normal file
View File

@@ -0,0 +1,73 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH GPSSMOOTH 1 2017-06-24 FlightGear "Pagine man di FlightGear"
.SH NOME
GPSsmooth \- invia dati GPS in formato NMEA a un'istanza di FlightGear
.SH SINTASSI
\fBGPSsmooth\fR \fB\-\-help\fR | \fB\-\-file\fR \fInome_file\fR
[\fB\-\-hertz\fR \fIhertz\fR] [\fB\-\-host\fR \fInomehost\fR]
[\fB\-\-broadcast\fR] [\fB\-\-fdm\-port\fR \fIporta\fR] [\fB\-\-ctrls\-port\fR
\fIporta\fR]
.SH DESCRIZIONE
.B GPSsmooth
è un'utilità che legge un file di testo contenente dati GPS in formato NMEA,
li analizza e li invia a un'istanza di FlightGear per riprodurli.
.SH OPZIONI
.TP
\fB\-\-help\fR
Mostra informazioni sull'utilizzo ed esce.
.TP
\fB\-\-file\fR \fInome_file\fR
Legge dati GPS da \fInome_file\fR. Quest'opzione è obbligatoria se
\fB\-\-help\fR non è specificato.
.TP
\fB\-\-hertz\fR \fIhertz\fR
Specifica la frequenza da utilizzare per inviare i dati all'istanza di
FlightGear. Per impostazione predefinita, gli eventi sono inviati a una
frequenza di \fB60\fR Hz.
.TP
\fB\-\-host\fR \fInomehost\fR
Invia i dati all'istanza di FlightGear in esecuzione su \fInomehost\fR.
Se \fB\-\-host\fR non è specificato, per impostazione predefinita i dati
vengono inviati a \fBlocalhost\fR.
.TP
\fB\-\-broadcast\fR
Invia i dati del modello dei dati di volo e di controllo come pacchetti
broadcast.
.TP
\fB\-\-fdm\-port\fR \fIporta\fR
Imposta la porta a cui devono essere inviati i dati del modello dei dati di
volo. Per impostazione predefinita, i dati vengono inviati alla porta
\fB5505\fR.
.TP
\fB\-\-ctrls\-port\fR \fIporta\fR
Imposta la porta a cui devono essere inviati i dati di controllo. Per
impostazione predefinita, i dati vengono inviati alla porta \fB5506\fR.
.SH "STATI D'USCITA"
.B GPSsmooth
esce con
.B 0
se l'esecuzione ha avuto successo, con
.B \-1
se la sintassi degli argomenti della riga di comando è errata o se si verifica
un errore.
.SH "VEDERE ANCHE"
.BR fgfs (1),
.BR MIDGsmooth (1),
.BR UGsmooth (1)

102
man/it/man1/JSBSim.1 Normal file
View File

@@ -0,0 +1,102 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH JSBSIM 1 2017-06-24 FlightGear "Pagine man di FlightGear"
.SH NOME
JSBSim \- versione autonoma del modello dinamica di volo open source JSBSim
.SH SINTASSI
\fBJSBSim\fR \fI<nome file script>\fR \fI<nomi file output>\fR \fI<opzioni>\fR
.SH DESCRIZIONE
.B JSBSim
è una versione autonoma del modello dinamica di volo open source JSBSim che,
dato un file script, esegue la simulazione e salva i risultati in uno o più
file.
.SH OPZIONI
.TP
\fB\-\-help\fR
Mostra informazioni sull'utilizzo ed esce.
.TP
\fB\-\-version\fR
Mostra il numero di versione di JSBSim ed esce.
.TP
\fB\-\-outputlogfile=\fInomefile\fR
Manda in output i dati elaborati a \fInomefile\fR.
.TP
\fB\-\-logdirectivefile=\fInomefile\fR
Utilizza le direttive di registrazione dei dati specificate in \fInomefile\fR.
Quest'opzione può essere specificata più volte.
.TP
\fB\-\-root=\fIpercorso\fR
Utilizza \fIpercorso\fR come directory radice di JSBSim (la directory dove
risiede il modello dell'aereo, contenente le sottodirectory \fBaircraft\fR,
\fBengine\fR...).
.TP
\fB\-\-aircraft=\fInomefile\fR
Utilizza il modello di aereo specificato in \fInomefile\fR.
.TP
\fB\-\-script=\fInomefile\fR
Esegue lo script di simulazione specificato in \fInomefile\fR.
Quest'opzione è incompatibile con \fB\-\-catalog\fR.
.TP
\fB\-\-realtime\fR
Esegue la simulazione in tempo reale.
.TP
\fB\-\-nice\fR[\fB=\fIperiodo riposo\fR]
Riduce l'utilizzo del processore mettendo in pausa la simulazione tra un frame
e l'altro per \fIperiodo riposo\fR nanosecondi. Se \fIperiodo riposo\fR non è
fornito, l'opzione viene impostata a \fB0.01\fR nanosecondi.
.TP
\fB\-\-nohighlight\fR
Non colora l'output.
.TP
\fB\-\-suspend\fR
Sospende la simulazione dopo averla inizializzata.
.TP
\fB\-\-initfile=\fInomefile\fR
Utilizza il file di inizializzazione \fInomefile\fR.
.TP
\fB\-\-catalog\fR[\fB=\fIaereo\fR]
Stampa tutte le proprietà per il modello di aereo (\fIaereo\fR, se il nome del
modello è fornito come argomento, o per il modello caricato tramite il file di
inizializzazione).
Quest'opzione è incompatibile con \fB\-\-script\fR.
.TP
\fB\-\-property=\fInome\fB=\fIvalore\fR
Imposta la proprietà \fInome\fR a \fIvalore\fR.
.TP
\fB\-\-simulation\-rate=\fIrate\fR
Imposta il rateo di simulazione (dT) a \fIrate\fR. Se \fIrate\fR è minore di
\fB1\fR, è interpretata come un periodo di tempo in secondi; in caso contrario,
è interpretata come una frequenza in Hertz.
.TP
\fB\-\-end=\fIorario\fR
Imposta l'orario di fine della simulazione a \fIorario\fR.
.SH "STATI D'USCITA"
.B JSBSim
esce con
.B 0
se l'esecuzione ha avuto successo, con
.B 1
se la sintassi degli argomenti della riga di comando è errata o se si verifica
un errore.
.SH "VEDERE ANCHE"
.BR fgfs (1),
.UR http://\:jsbsim.sourceforge.net/
il sito Web di JSBSim
.UE

86
man/it/man1/MIDGsmooth.1 Normal file
View File

@@ -0,0 +1,86 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH MIDGSMOOTH 1 2017-06-24 FlightGear "Pagine man di FlightGear"
.SH NOME
MIDGsmooth \- invia dati GPS in formato MIDG a un'istanza di FlightGear
.SH SINTASSI
\fBMIDGsmooth\fR \fB\-\-help\fR
| \fB\-\-infile\fR \fInome_fileinput\fR [\fIopzioni\fR]...
| \fB\-\-serial\fR \fInome_dispositivo\fR \fB\-\-outfile\fR \fInome_fileoutput\fR [\fIopzioni\fR]...
.SH DESCRIZIONE
.B MIDGsmooth
è un'utilità che legge dati GPS in formato MIDG da un file di testo o da un
dispositivo MIDG connesso alla porta seriale, li analizza e li invia a
un'istanza di FlightGear per riprodurli.
.SH OPZIONI
.TP
\fB\-\-help\fR
Mostra informazioni sull'utilizzo ed esce.
.TP
\fB\-\-infile\fR \fInome_fileinput\fR
Legge dati GPS da \fInome_fileinput\fR.
.TP
\fB\-\-serial\fR \fInome_dispositivo\fR
Legge dati GPS dal dispositivo seriale \fInome_dispositivo\fR.
.TP
\fB\-\-outfile\fR \fInome_fileoutput\fR
Salva i dati recuperati dal dispositivo in \fInome_fileoutput\fR.
.TP
\fB\-\-hertz\fR \fIfrequenza\fR
Specifica la frequenza da utilizzare per inviare i dati all'istanza di
FlightGear. Per impostazione predefinita, gli eventi sono inviati a una
frequenza di \fB60\fR Hz.
.TP
\fB\-\-host\fR \fInomehost\fR
Invia i dati all'istanza di FlightGear in esecuzione su \fInomehost\fR.
Se \fB\-\-host\fR non è specificato, per impostazione predefinita i dati
vengono inviati a \fBlocalhost\fR.
.TP
\fB\-\-skip\-seconds\fR \fIsecondi\fR
Non trasmette i primi \fIsecondi\fR secondi di dati.
Quest'opzione è ignorata quando si leggono dati GPS da un dispositivo seriale.
.TP
\fB\-\-broadcast\fR
Invia i dati del modello dei dati di volo e di controllo come pacchetti
broadcast.
.TP
\fB\-\-fdm\-port\fR \fIporta\fR
Imposta la porta a cui devono essere inviati i dati del modello dei dati di
volo. Per impostazione predefinita, i dati vengono inviati alla porta
\fB5505\fR.
.TP
\fB\-\-ctrls\-port\fR \fIporta\fR
Imposta la porta a cui devono essere inviati i dati di controllo. Per
impostazione predefinita, i dati vengono inviati alla porta \fB5506\fR.
.TP
\fB\-\-altitude\-offset\fR \fImetri\fR
Aggiunge l'offset specificato (in metri) all'altitudine inviata a FlightGear.
.SH "STATI D'USCITA"
.B MIDGsmooth
esce con
.B 0
se l'esecuzione ha avuto successo, con
.B \-1\fR
se la sintassi degli argomenti della riga di comando è errata o se si verifica
un errore.
.SH "VEDERE ANCHE"
.BR fgfs (1),
.BR GPSsmooth (1),
.BR UGsmooth (1)

119
man/it/man1/UGsmooth.1 Normal file
View File

@@ -0,0 +1,119 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH UGSMOOTH 1 2017-06-25 FlightGear "Pagine man di FlightGear"
.SH NOME
UGsmooth \- invia dati GPS in formato UGear a un'istanza di FlightGear
.SH SINTASSI
\fBUGsmooth\fR \fB\-\-help\fR
| \fB\-\-infile\fR \fInome_fileinput\fR [\fIopzioni\fR]...
| \fB\-\-flight\fR \fIdir_volo\fR [\fIopzioni\fR]...
| \fB\-\-serial\fR \fInome_dispositivo\fR \fB\-\-outfile\fR \fInome_fileoutput\fR [\fIopzioni\fR]...
.SH DESCRIPTION
.B UGsmooth
è un'utilità che legge dati GPS in formato UGrar da un file di testo, una
directory contenente dati di volo o da un dispositivo connesso alla porta
seriale, li analizza e li invia a un'istanza di FlightGear per riprodurli.
.SH OPZIONI
.TP
\fB\-\-help\fR
Mostra informazioni sull'utilizzo ed esce.
.TP
\fB\-\-infile\fR \fInome_fileinput\fR
Legge dati GPS da \fInome_fileinput\fR.
.TP
\fB\-\-flight\fR \fIdir_volo\fR
Legge dati GPS dalla directory contenente dati di volo \fIdir_volo\fR.
.TP
\fB\-\-serial\fR \fInome_dispositivo\fR
Legge dati GPS dal dispositivo seriale \fInome_dispositivo\fR.
.TP
\fB\-\-outfile\fR \fInome_fileoutput\fR
Salva i dati recuperati dal dispositivo in \fInome_fileoutput\fR.
.TP
\fB\-\-hertz\fR \fIfrequenza\fR
Specifica la frequenza da utilizzare per inviare i dati all'istanza di
FlightGear. Per impostazione predefinita, gli eventi sono inviati a una
frequenza di \fB60\fR Hz.
.TP
\fB\-\-host\fR \fInomehost\fR
Invia i dati all'istanza di FlightGear in esecuzione su \fInomehost\fR.
Se \fB\-\-host\fR non è specificato, per impostazione predefinita i dati
vengono inviati a \fBlocalhost\fR.
.TP
\fB\-\-broadcast\fR
Invia i dati del modello dei dati di volo e di controllo come pacchetti
broadcast.
.TP
\fB\-\-opengc\-port\fR \fIporta\fR
Imposta la porta a cui devono essere inviati i dati OpenGC. Per impostazione
predefinita, i dati vengono inviati alla porta \fB6000\fR.
.TP
\fB\-\-fdm\-port\fR \fIporta\fR
Imposta la porta a cui devono essere inviati i dati del modello dei dati di
volo. Per impostazione predefinita, i dati vengono inviati alla porta
\fB5505\fR.
.TP
\fB\-\-ctrls\-port\fR \fIporta\fR
Imposta la porta a cui devono essere inviati i dati di controllo. Per
impostazione predefinita, i dati vengono inviati alla porta \fB5506\fR.
.TP
\fB\-\-groundtrack\-heading\fR
Calcola la prua dell'aereo a partire dalla velocità indicata dal GPS anziché
utilizzare la prua grezza registrata dal dispositivo.
.TP
\fB\-\-ground\-speed\fR
Calcola la velocità rispetto al suolo a partire dalla velocità indicata dal GPS
anziché utilizzare la velocità grezza registrata dal dispositivo.
.TP
\fB\-\-estimate\-control\-deflections\fR
Stima le deviazioni dei controlli dalle velocità angolari anziché utilizzare
le deviazioni grezze registrate dal dispositivo.
.TP
\fB\-\-altitude\-offset\fR \fImetri\fR
Aggiunge l'offset specificato (in metri) all'altitudine inviata a FlightGear.
.TP
\fB\-\-skip\-seconds\fR \fIsecondi\fR
Non trasmette i primi \fIsecondi\fR secondi di dati.
Quest'opzione è ignorata quando si leggono dati GPS da un dispositivo seriale.
.TP
\fB\-\-no\-real\-time\fR
Non aggiorna il tempo trascorso.
.TP
\fB\-\-ignore\-checksum\fR
Non scarta dati con checksum non validi.
Quest'opzione è ignorata quando si leggono dati GPS da una directory
contenente dati di volo.
.TP
\fB\-\-sg\-swap\fR
Attiva la logica speciale di doppio scambio per il formato doppio stargate
(non standard).
.SH "STATI D'USCITA"
.B UGsmooth
esce con
.B 0
se l'esecuzione ha avuto successo, con
.B \-1\fR
se la sintassi degli argomenti della riga di comando è errata o se si verifica
un errore.
.SH "VEDERE ANCHE"
.BR fgfs (1),
.BR GPSsmooth (1),
.BR MIDGsmooth (1)

152
man/it/man1/fgcom.1 Normal file
View File

@@ -0,0 +1,152 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGCOM 1 2017-06-25 FlightGear "Pagine man di FlightGear"
.SH NOME
fgcom \- client VoIP per l'infrastruttura radio di FlightGear
.SH SINTASSI
\fBfgcom\fR [\fB\-\-server=\fIserver\fR] [\fB\-\-host=\fIhostascolto\fR]
[\fB\-\-port=\fIporta\fR] [\fB\-\-callsign=\fInominativo\fR]
[\fB\-\-frequency=\fIfrequenza\fR] [\fB\-\-atis=\fIfrequenza\fR]
[\fB\-\-airport=\fIcodice\fR] [\fB\-\-username=\fInomeutente\fR]
[\fB\-\-password=\fIpassword\fR] [\fB\-\-silence\-threshold=\fIsoglia\fR]
[\fB\-\-debug\fR] [\fB\-\-help\fR] [\fB\-\-version\fR]
.SH DESCRIZIONE
.B fgcom
è l'utilità di FlightGear utilizzata per connettersi ai server voce
multigiocatore.
.PP
Solitamente non è necessario eseguire
.B fgcom
dalla riga di comando, in quanto è già integrato in FlightGear, fatta eccezione
per alcuni casi specifici (come la registrazione di messaggi ATIS o
l'esecuzione di una prova radio, vedi la sezione \fBESEMPI\fR).
.SH OPZIONI
.TP
\fB\-\-server=\fIserver\fR
Connettiti al server FGCom \fIserver\fR. Per impostazione predefinita FGCom
tenta di connettersi a \fBfgcom.flightgear.org\fR.
.TP
\fB\-\-host=\fIhostascolto\fR, \fB\-\-port=\fIporta\fR
Rimani in ascolto sull'interfaccia di rete con indirizzo IP \fIhostascolto\fR
sulla porta \fIporta\fR. Per impostazione predefinita FGCom rimane in ascolto
sull'interfaccia di loopback (\fB127.0.0.1\fR) sulla porta \fB16661\fR.
La porta specificata può essere utilizzata da un'istanza di FlightGear per
comunicare con FGCom e aggiornare la posizione del pilota durante il volo.
.TP
\fB\-\-callsign=\fInominativo\fR
Utilizza il nominativo di chiamata \fInominativo\fR durante la sessione. Per
impostazione predefinita FGCom utilizza \fBguest\fR come nominativo di chiamata.
.TP
\fB\-\-frequency=\fIfrequenza\fR
Imposta la frequenza radio attiva a \fIfrequenza\fR. La frequenza deve essere
specificata nel formato \fIxxx.xxx\fR e deve essere fornita in MHz.
.TP
\fB\-\-atis=\fIfrequenza\fR
Registra un messaggio ATIS su \fIfrequenza\fR MHz. La frequenza deve essere
specificata nel formato \fIxxx.xxx\fR e deve essere fornita in MHz.
.TP
\fB\-\-airport=\fIcodice\fR
Colloca il pilota/controllore presso l'aeroporto con codice ICAO \fIcodice\fR.
Dal momento che alcune frequenze radio potrebbero essere riutilizzate nel
mondo, è essenziale impostare correttamente la posizione del pilota/controllore
per far sì che il server FGCom riesca a determinare il canale vocale corretto.
Si utilizzi sempre quest'opzione quando non si connette un'istanza di FlightGear
a FGCom.
.TP
\fB\-\-username=\fInomeutente\fR, \fB\-\-password=\fIpassword\fR
Accedi al server FGCom con il nome utente \fInomeutente\fR e la password
\fIpassword\fR.
.TP
\fB\-\-silence-threshold=\fIsoglia\fR
Imposta la soglia del silenzio a \fIsoglia\fR dB. Il valore deve essere
compreso fra \fB-60\fR e \fB0\fR. L'impostazione predefinita è \fB-35.0\fR dB.
La soglia del silenzio è il livello al di sotto del quale i suoni catturati dal
microfono sono considerati rumore di sottofondo (e, pertanto, filtrati da
FGCom). Impostare la soglia del silenzio a \fB-60\fR disabilita il filtro;
impostarla a \fB0\fR filtra tutto (muta il microfono).
.TP
\fB\-\-debug\fR
Abilita l'output di debug per scopi di risoluzione dei problemi.
.TP
\fB\-\-help\fR
Visualizza informazioni sull'utilizzo ed esce.
.TP
\fB\-\-version\fR
Visualizza la versione di FGCom ed esce.
.SH "STATI D'USCITA"
.B fgcom
esce con
.B EXIT_SUCCESS
se l'esecuzione ha avuto successo, con
.B EXIT_FAILURE
se la sintassi degli argomenti della riga di comando è errata o si verifica un
errore.
.SH NOTE
FGCom riconosce diverse frequenze speciali utilizzate per scopi di test o per
conversazioni generiche:
.IP \(bu 3
\fB121.000 MHz\fR, \fB121.500 MHz\fR: frequenze "di guardia" riservate per
comunicazioni di emergenza;
.IP \(bu 3
\fB123.450 MHz\fR, \fB123.500 MHz\fR, \fB122.750 MHz\fR: frequenze per
conversazioni generiche;
.IP \(bu 3
\fB700.000 MHz\fR: frequenza stazione radio. A seconda del server FGCom che si
utilizza, verrà riprodotto un messaggio radio preregistrato;
.IP \(bu 3
\fB723.340 MHz\fR: frequenza comunicazioni guardia aerea francese;
.IP \(bu 3
\fB910.000 MHz\fR: frequenza echo test. La propria voce sarà ripetuta dopo un
breve ritardo per consentire di controllare che microfono, altoparlanti/cuffie
e che la connessione al server FGCom funzionino. Il test è limitato a un
massimo di 65 secondi, dopo i quali si sarà disconnessi automaticamente;
.IP \(bu 3
\fB911.000 MHz\fR: "musica d'attesa". La frequenza riproduce continuamente
musica di sottofondo per consentire di controllare che la connessione al
server FGCom funzioni.
.SH BUG
.IP \(bu 3
Al momento non esistono procedure per aggiornare le frequenze utilizzate da
FGCom con quelle utilizzate nel mondo reale, qualora queste cambino. Pertanto,
le prime potrebbero non sempre corrispondere con le seconde. Si utilizzino
sempre le frequenze elencate in FlightGear alla voce \fBIA\fR -> \fBServizi ATC
nelle vicinanze\fR anziché quelle pubblicate sulle carte aeronautiche.
.SH ESEMPI
Connettiti al server FGCom predefinito, sintonizzati sulla frequenza di terra
(\fI121.800 MHz\fR) dell'aeroporto internazionale di San Francisco (\fIKSFO\fR)
e consenti a FlightGear di aggiornare la posizione attuale del pilota
inviandola alla porta \fI16661\fR (quella predefinita):
$ \fBfgcom --frequency=121.800 --airport=KSFO\fR
Esegui una prova radio collegandoti alla frequenza echo test:
$ \fBfgcom --frequency=910.000\fR
Registra un messaggio ATIS sulla frequenza ATIS (\fI118.850 MHz\fR)
dell'aeroporto internazionale di San Francisco (\fIKSFO\fR):
$ \fBfgcom --atis=118.850 --airport=KSFO\fR
.SH "VEDERE ANCHE"
.BR fgfs (1),
.UR http://\:wiki.flightgear.org/\:FGCom_3.0
la pagina "FGCom 3.0" del wiki FlightGear
.UE

130
man/it/man1/fgelev.1 Normal file
View File

@@ -0,0 +1,130 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGELEV 1 2017-06-18 FlightGear "Pagine man di FlightGear"
.SH NOME
fgelev \- Calcola l'altitudine dello scenario di FlightGear per un elenco di
punti dato
.SH SINTASSI
\fBfgelev\fR [\fB\-\-expire\fR \fInum\fR] [\fB\-\-print\-solidness\fR]
[\fB\-\-fg\-root\fR \fIrootdir\fR] [\fB\-\-fg\-scenery\fR \fIscenerydir\fR]
.SH DESCRIZIONE
.B fgelev
è un'utilità autonoma che, dato un elenco di punti sullo standard input, stampa
l'altitudine corrispondente per ognuno di essi sullo standard output. Essa può
anche (facoltativamente) stampare se il materiale che ricopre tale punto è
solido o meno.
L'elenco di punti deve essere nel seguente formato:
\fIid lon lat\fR
dove \fIid\fR è un identificatore arbitrario per il punto, \fIlon\fR è la
longitudine del punto e \fIlat\fR è la latitudine del punto. Longitudini
(latitudini) positive corrispondono a punti collocati nell'emisfero orientale
(settentrionale); quelle negative corrispondono a punti collocati nell'emisfero
occidentale (meridionale).
L'elenco di altitudini restituito da
.B fgelev
ha il seguente formato:
\fIid: elev solid\fR
dove \fIid\fR è l'identificatore del punto fornito come input, \fIelev\fR è
l'altitudine del punto in metri (o \fB-1000\fR se l'altitudine del punto dato
non è stata trovata) e \fIsolid\fR è:
.IP \(bu 3
la stringa
.B solid
se il parametro
.B \-\-print\-solidness
è stato fornito a
.B fgelev
e il materiale che ricopre il punto è solido;
.IP \(bu 3
la stringa
.B \-
se il parametro
.B \-\-print\-solidness
è stato fornito a
.B fgelev
e il materiale che ricopre il punto non è solido;
.IP \(bu 3
assente se il parametro
.B \-\-print\-solidness
non è stato fornito a \fBfgelev\fR.
.SH OPZIONI
.TP
\fB\-\-expire\fR \fInum\fR
Per velocizzare il recupero dei dati relativi all'altitudine,
.B fgelev
utilizza una cache interna. Quest'opzione consente all'utente di specificare
il numero di richieste dopo le quali, se un punto non è stato richiesto, esso
verrà contrassegnato come scaduto. Per impostazione predefinita,
.B fgelev
marca come scaduti i punti non richiesti nelle ultime \fB10\fR richieste.
.TP
\fB\-\-print\-solidness\fR
Richiede a
.B fgelev
di stampare la solidità del materiale che ricopre il punto richiesto. Vedi la
sezione
.B DESCRIZIONE
per ulteriori dettagli.
.TP
\fB\-\-fg\-root\fR \fIrootdir\fR
Imposta la directory radice dei dati di FlightGear (\fB$FG_ROOT\fR) a
\fIrootdir\fR. Se quest'opzione non è impostata,
.B fgelev
utilizza il percorso specificato nella variabile d'ambiente
.B FG_ROOT
o, in sua assenza, la directory dei dati di FlightGear scelta all'atto della
compilazione del programma.
.TP
\fB\-\-fg\-scenery\fR \fIscenerydir\fR
Imposta la directory dello scenario di FlightGear (\fB$FG_SCENERY\fR) a
\fIscenerydir\fR. Se quest'opzione non è impostata,
.B fgelev
utilizza il percorso specificato nella variabile d'ambiente
.B FG_SCENERY
o, in sua assenza, la sottodirectory
.B Scenery
all'interno di \fB$FG_ROOT\fR.
.SH "STATI D'USCITA"
.B fgelev
esce con
.B EXIT_SUCCESS
se l'esecuzione ha avuto successo, con
.B EXIT_FAILURE
se non è in grado di leggere i dati dallo standard input o di caricare lo
scenario.
.SH "VARIABILI D'AMBIENTE"
.IP "\fBFG_ROOT\fR" 4
Se
.B FG_ROOT
è impostata e
.B \-\-fg\-root
non è impostato, specifica la directory radice dei dati da utilizzare.
.IP "\fBFG_SCENERY\fR" 4
Se
.B FG_SCENERY
è impostata e
.B \-\-fg\-scenery
non è impostato, specifica la directory dello scenario da utilizzare.
.SH "VEDERE ANCHE"
.BR fgfs (1)

884
man/it/man1/fgfs.1 Normal file
View File

@@ -0,0 +1,884 @@
.\" Copyright (C) 2002 Cameron Moore
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGFS 1 2017-06-25 FlightGear "Pagine man di FlightGear"
.SH NOME
fgfs \- il simulatore di volo FlightGear
.SH SINTASSI
\fBfgfs\fR [\fIopzioni...\fR]
.SH DESCRIZIONE
.B fgfs
è l'eseguibile principale di FlightGear, un framework di simulazione di volo
libero, open source, multipiattaforma e sofisticato per lo sviluppo e la
ricerca di interessanti idee sulla simulazione di volo.
.SH OPZIONI
Le opzioni sono inizialmente lette dagli argomenti della riga di comando
forniti a \fBfgfs\fR. Il programma quindi controlla l'esistenza di
\fI~/.fgfsrc.\fIhostname\fR (dove
.I hostname
è il nome host della macchina) e di \fI~/.fgfsrc\fR; se almeno uno di questi
file esiste, è letto e analizzato (vedi la pagina di manuale
.BR fgfsrc (5)
per le specifiche complete del formato di file).
Nel caso in cui siano fornite opzioni in conflitto tra loro, prevarranno quelle
lette per ultime.
.SS "Opzioni generali"
.TP
\fB\-\-help\fR, \fB\-h\fR
Mostra informazioni sull'utilizzo delle opzioni della riga di comando più
importanti ed esce.
.TP
\fB\-\-verbose\fR, \fB\-v\fR
Quando combinato con \fB\-\-help\fR/\fB\-h\fR, mostra informazioni
sull'utilizzo di tutte le opzioni della riga di comando, non solo di quelle più
importanti.
.TP
\fB\-\-version\fR
Mostra informazioni sulla versione di
.B fgfs
e di alcune delle librerie utilizzate dal programma (SimGear, OpenSceneGraph,
PLIB), quindi esce.
.TP
\fB\-\-fg\-root=\fIpercorso\fR
Imposta la directory radice dei dati di FlightGear (\fB$FG_ROOT\fR) a
\fIpercorso\fR. Se quest'opzione non è impostata,
.B fgfs
utilizza il percorso specificato nella variabile d'ambiente
.B FG_ROOT
o, in sua assenza, la directory dei dati di FlightGear scelta all'atto della
compilazione del programma.
.TP
\fB\-\-fg\-scenery=\fIpercorso\fR
Imposta le directory dello scenario di FlightGear (\fB$FG_SCENERY\fR) a
\fIpercorso\fR.
È possibile specificare più directory separandole con due punti (\fB:\fR),
come in \fI/primo/percorso\fB:\fI/secondo/percorso\fR (sui sistemi operativi
Microsoft Windows, invece, i percorsi multipli devono essere separati da punti
e virgola): in tal caso,
.B fgfs
seguirà l'ordine in cui i percorsi sono stati specificati per cercare i file
dello scenario, fermandosi non appena è stato trovato il file cercato.
Se quest'opzione non è impostata,
.B fgfs
utilizza il percorso specificato nella variabile d'ambiente
.B FG_SCENERY
o, in sua assenza, la sottodirectory
.B Scenery
all'interno di \fB$FG_ROOT\fR.
.TP
\fB\-\-fg\-aircraft=\fIpercorso\fR
Carica aerei aggiuntivi da \fIpercorso\fR oltre alla sottodirectory
.B Aircraft
all'interno di \fB$FG_ROOT\fR. In alternativa, è possibile utilizzare
.B \-\-aircraft\-dir
per puntare a uno specifico aereo in una data directory.
.TP
\fB\-\-download\-dir=\fIpercorso\fR
Salva gli aerei e lo scenario scaricati tramite il simulatore in \fIpercorso\fR.
La directory di TerraSync può essere impostata in modo specifico con l'opzione
.BR \-\-terrasync\-dir .
.TP
\fB\-\-allow\-nasal\-read=\fIdirectory\fR
Permetti agli script aereo Nasal di leggere file dalle directory elencate in
\fIdirectory\fR (percorsi multipli vanno separati con due punti, o punti e
virgola sui sistemi operativi Microsoft Windows).
Per impostazione predefinita, agli script Nasal è permesso leggere dati solo da
\fB$FG_ROOT\fR e \fB$FG_HOME\fR per motivi di sicurezza.
.TP
\fB\-\-read\-only\fR
Rendi \fB$FG_HOME\fR (il percorso in cui sono salvati i dati di FlightGear
specifici per ogni utente) di sola lettura.
.TP
\fB\-\-language=\fIcodice\fR
Imposta la lingua utilizzata dal simulatore a \fIcodice\fR, dove \fIcodice\fR
è un codice lingua ISO 639-1 a due lettere (ad esempio, \fBen\fR o \fBit\fR).
.TP
\fB\-\-restore\-defaults\fR
Reimposta tutte le impostazioni utente ai loro valori predefiniti.
.TP
\fB\-\-enable\-save\-on\-exit\fR, \fB\-\-disable\-save\-on\-exit\fR
Salva/non salva le impostazioni utente all'uscita dal programma.
.TP
\fB\-\-ignore\-autosave\fR
Ignora le impostazioni utente salvate durante la precedente esecuzione di
FlightGear. Quest'opzione implica \fB\-\-disable\-save\-on\-exit\fR.
.TP
\fB\-\-browser\-app=\fIpercorso\fR
Utilizza il browser Web specificato in \fIpercorso\fR per aprire la
documentazione degli aerei.
.TP
\fB\-\-prop:\fR[\fItipo\fB:\fR]\fInome\fB=\fIvalore\fR
Imposta la proprietà \fInome\fR a \fIvalore\fR. È facoltativamente possibile
specificare il tipo della proprietà impostando \fItipo\fR a \fBstring\fR,
\fBdouble\fR, \fBfloat\fR, \fBlong\fR, \fBint\fR o \fBbool\fR.
.TP
\fB\-\-config=\fIpercorso\fR
Carica direttive di configurazione aggiuntive da \fIpercorso\fR. Il file deve
essere nel formato descritto in
.BR fgfsrc (5).
.TP
\fB\-\-no\-default\-config\fR
Non carica alcun file di configurazione, eccetto quelli esplicitamente
specificati con \fB\-\-config\fR.
.TP
\fB\-\-units\-feet\fR
Utilizza i piedi come unità di misura interna per le distanze.
.TP
\fB\-\-units\-meters\fR
Utilizza i metri come unità di misura interna per le distanze.
.TP
\fB\-\-console\fR
Mostra una finestra console per il debug del simulatore/degli aerei.
Quest'opzione è riconosciuta solo sui sistemi operativi Microsoft Windows; su
altri sistemi, i messaggi di debug sono sempre stampati sullo standard
output/standard error.
.TP
\fB\-\-launcher\fR
Avvia il FlightGear Launcher, un'interfaccia grafica per il simulatore basata
su Qt.
Quest'opzione è disponibile solo se FlightGear è stato compilato con il
supporto a Qt abilitato.
.TP
\fB\-\-json\-report\fR
Stampa un rapporto in formato JSON sullo standard output. Il rapporto fornirà
informazioni utili per scopi di debug, come la versione di FlightGear, i
percorsi utilizzati per lo scenario/gli aerei, le directory di download di
TerraSync e dei dati e i percorsi ai file dei dati di navigazione.
.SS Funzionalità
.TP
\fB\-\-enable\-panel\fR, \fB\-\-disable\-panel\fR
Abilita/disabilita il pannello strumenti aereo a scomparsa se l'aereo scelto
ne è provvisto.
.TP
\fB\-\-enable\-hud\fR, \fB\-\-disable\-hud\fR
Abilita/disabilita l'heads-up display (HUD) se l'aereo scelto ne è provvisto.
.TP
\fB\-\-enable\-anti\-alias\-hud\fR, \fB\-\-disable\-anti\-alias\-hud\fR
Abilita/disabilita l'antialiasing dell'heads-up display.
.TP
\fB\-\-enable\-hud\-3d\fR, \fB\-\-disable\-hud\-3d\fR
Abilita/disabilita la versione 3D dell'heads-up display.
.TP
\fB\-\-hud\-tris\fR
Mostra il numero di triangoli renderizzati durante il disegno dell'heads-up
display.
.TP
\fB\-\-hud\-culled\fR
Mostra il numero di triangoli sottoposti a culling durante il disegno
dell'heads-up display.
.TP
\fB\-\-enable\-random\-objects\fR, \fB\-\-disable\-random\-objects\fR
Mostra/nasconde oggetti casuali nello scenario, come edifici. Gli oggetti
dello scenario aumentano il realismo, ma richiedono più risorse (memoria e
potenza della GPU).
.TP
\fB\-\-enable\-random\-vegetation\fR, \fB\-\-disable\-random\-vegetation\fR
Mostra/nasconde vegetazione casuale.
.TP
\fB\-\-enable\-random\-buildings\fR, \fB\-\-disable\-random\-buildings\fR
Mostra/nasconde edifici casuali.
.TP
\fB\-\-enable\-ai\-models\fR, \fB\-\-disable\-ai\-models\fR
Abilita/disabilita il sottosistema IA interno richiesto per il gioco
multigiocatore, il traffico IA e molte altre animazioni. \fBLa disabilitazione
del sottosistema IA interno è deprecata.\fR
.TP
\fB\-\-enable\-ai\-traffic\fR, \fB\-\-disable\-ai\-traffic\fR
Abilita/disabilita il traffico aereo artificiale.
.TP
\fB\-\-ai\-scenario=\fIscenario\fR
Aggiunge e abilita lo scenario IA \fIscenario\fR. Quest'opzione può essere
ripetuta più volte per abilitare scenari multipli.
.TP
\fB\-\-enable\-freeze\fR
Avvia il simulatore in uno stato bloccato (in pausa).
.TP
\fB\-\-disable\-freeze\fR
Avvia il simulatore in uno stato di esecuzione (non in pausa).
.TP
\fB\-\-enable\-fuel\-freeze\fR
Non fa consumare carburante (mantiene la sua quantità nei serbatoi costante).
.TP
\fB\-\-disable\-fuel\-freeze\fR
Fa consumare il carburante normalmente.
.TP
\fB\-\-enable\-clock\-freeze\fR
Non consente all'orologio di avanzare durante l'esecuzione della simulazione.
.TP
\fB\-\-disable\-clock\-freeze\fR
Fa sì che l'orologio avanzi normalmente.
.TP
\fB\-\-failure=pitot\fR|\fBstatic\fR|\fBvacuum\fR|\fBelectrical\fR
Fa guastare i sistemi pitot, statico, del vuoto o elettrico dell'aereo.
Quest'opzione può essere ripetuta più volte per far guastare più di un sistema.
.TP
\fB\-\-load\-tape=\fInastro\fR
Carica e riproduce il nastro del registratore di volo \fInastro\fR.
.SS "Opzioni audio"
.TP
\fB\-\-show\-sound\-devices\fR
Mostra un elenco di dispositivi audio disponibili ed esce.
.TP
\fB\-\-sound\-device=\fInome\fR
Imposta il dispositivo audio da utilizzare a \fInome\fR, dove
.I nome
è il nome dispositivo visualizzato dall'opzione
.BR \-\-show\-sound\-devices .
.TP
\fB\-\-enable\-sound\fR, \fB\-\-disable\-sound\fR
Abilita/disabilita l'audio nel simulatore.
.SS "Opzioni rendering"
.TP
\fB\-\-terrain\-engine=tilecache\fR|\fBpagedLOD\fR
Seleziona il terrain engine da utilizzare. \fBtilecache\fR è il terrain engine
"tradizionale" (raccomandato); \fBpagedLOD\fR è un terrain engine nuovo e
sperimentale progettato per ridurre al minimo l'utilizzo di memoria caricando
le versioni maggiormente dettagliate degli oggetti dello scenario su richiesta.
Il motore \fBpagedLOD\fR è disponibile solo se FlightGear è stato compilato con
il supporto GDAL.
.TP
\fB\-\-lod\-levels=\fIlivelli\fR
Imposta i livelli del livello di dettaglio a \fIlivelli\fR, dove \fIlivelli\fR
è un elenco separato da spazi di livelli numerici. Quest'opzione è disponibile
solo se il terrain engine in uso è \fBpagedLOD\fR.
.TP
\fB\-\-lod\-res=\fIrisoluzione\fR
Imposta la risoluzione della mesh terreno a \fIrisoluzione\fR. Quest'opzione è
disponibile solo se il terrain engine in uso è \fBpagedLOD\fR.
.TP
\fB\-\-lod\-texturing=bluemarble\fR|\fBraster\fR|\fBdebug\fR
Imposta il metodo per le texture del terreno. Quest'opzione è disponibile solo
se il terrain engine in uso è \fBpagedLOD\fR.
.TP
\fB\-\-lod\-range\-mult=\fImoltiplicatore\fR
Imposta il moltiplicatore intervallo (il punto di transizione da un livello di
dettaglio basso ad alto) a \fImoltiplicatore\fR. Quest'opzione è disponibile
solo se il terrain engine in uso è \fBpagedLOD\fR.
.TP
\fB\-\-enable\-splash\-screen\fR, \fB\-\-disable\-splash\-screen\fR
Mostra/nasconde la schermata di avvio del simulatore durante il caricamento
dell'aereo/dello scenario.
.TP
\fB\-\-enable\-mouse\-pointer\fR, \fB\-\-disable\-mouse\-pointer\fR
Forza/non forza la visualizzazione del puntatore del mouse all'avvio.
.TP
\fB\-\-max\-fps=\fIfrequenza\fR
Limita il framerate massimo del simulatore a \fIfrequenza\fR Hz (frame al
secondo).
.TP
\fB\-\-bpp=\fIprofondità\fR
Utilizza una profondità colore di \fIprofondità\fR bit per pixel per
visualizzare l'aereo e lo scenario.
.TP
\fB\-\-fog\-disable\fR, \fB\-\-fog\-fastest\fR, \fB\-\-fog\-nicest\fR
Seleziona la tecnica di rendering della nebbia/foschia.
.B \-\-fog\-disable
disabilita completamente nebbia e foschia;
.B \-\-fog\-fastest
chiede esplicitamente al driver della scheda video di scegliere l'algoritmo di
rendering più efficiente, ma forse meno accurato, per la nebbia/foschia;
.B \-\-fog\-nicest
lascia la scelta dell'algoritmo al driver, il che porta a risultati di
miglior qualità.
.TP
\fB\-\-enable\-enhanced\-lighting\fR, \fB\-\-disable\-enhanced\-lighting\fR
Abilita/disabilita l'illuminazione pista migliorata. \fBQuest'opzione è
deprecata.\fR
.TP
\fB\-\-enable\-distance\-attenuation\fR, \fB\-\-disable\-distance\-attenuation\fR
Abilita/disabilita l'attenuazione con la distanza delle luci pista (le luci
pista diminuiscono di intensità all'aumento della distanza).
.TP
\fB\-\-enable\-horizon\-effect\fR, \fB\-\-disable\-horizon\-effect\fR
Abilita/disabilita l'illusione di crescita dei corpi celesti in prossimità
dell'orizzonte.
.TP
\fB\-\-enable\-specular\-highlight\fR, \fB\-\-disable\-specular\-highlight\fR
Abilita/disabilita le riflessioni speculari su oggetti texturizzati.
.TP
\fB\-\-fov=\fIgradi\fR
Imposta l'angolo di visione (FOV) a \fIgradi\fR. Angoli di visione grandi
consentono di vedere una parte più ampia del mondo; angoli piccoli consentono
di "zoomare" sui dettagli.
.TP
\fB\-\-aspect\-ratio\-multiplier=\fIfattore\fR
Imposta il moltiplicatore rapporto d'aspetto orizzontale e verticale a
\fIfattore\fR.
.TP
\fB\-\-enable\-fullscreen\fR, \fB\-\-disable\-fullscreen\fR
Abilita/disabilita la modalità a schermo intero.
.TP
\fB\-\-shading\-flat\fR, \fB\-\-shading\-smooth\fR
Utilizza il flat shading/smooth shading. Se il flat shading è attivo, il
simulatore utilizza lo stesso colore per colorare le facce di un oggetto: ciò è
più veloce, ma rende gli spigoli più pronunciati. Lo smooth shading smussa i
cambiamenti di colore fra i vertici, il che porta a risultati di miglior
qualità a spese delle prestazioni.
.TP
\fB\-\-materials\-file=\fIfile\fR
Carica le definizioni dei materiali utilizzati per renderizzare lo scenario da
\fIfile\fR. Per impostazione predefinita, i materiali sono caricati da
\fI$FG_ROOT/regions/materials.xml\fR.
.TP
\fB\-\-texture\-filtering=\fIvalore\fR
Imposta il filtraggio texture anisotropico a \fIvalore\fR. I valori accettabili
sono \fB1\fR (impostazione predefinita), \fB2\fR, \fB4\fR, \fB8\fR o \fB16\fR.
.TP
\fB\-\-enable\-wireframe\fR, \fB\-\-disable\-wireframe\fR
Abilita/disabilita la modalità disegno wireframe (in cui sono rappresentati
solo gli spigoli degli oggetti).
.TP
\fB\-\-geometry=\fIlarghezza\fBx\fIaltezza\fR
Imposta la geometria (dimensioni) della finestra a \fIlarghezza\fBx\fIaltezza\fR
(sia \fIlarghezza\fR sia \fIaltezza\fR sono in pixel).
.TP
\fB\-\-view\-offset=LEFT\fR|\fBRIGHT\fR|\fBCENTER\fR|\fIvalore\fR
Specifica la direzione predefinita per la vista frontale come offset dalla
direzione "davanti a sé". I valori consentiti sono \fBLEFT\fR (-90°),
\fBRIGHT\fR (90°), \fBCENTER\fR (0°) o un valore specifico in gradi.
.SS "Opzioni aereo"
.TP
\fB\-\-aircraft=\fInome\fR, \fB\-\-vehicle=\fInome\fR
Carica un aereo/veicolo da un file set denominato \fRnome\fI\-set.xml\fR. Il
file viene cercato in \fI$FG_ROOT/Aircraft\fR, nella directory a cui punta la
variabile d'ambiente \fBFG_AIRCRAFT\fR e nelle directory fornite a
.BR fgfs (1)
tramite l'opzione \fB\-\-fg\-aircraft\fR.
.TP
\fB\-\-aircraft\-dir=\fIpercorso\fR
Specifica esplicitamente la directory in cui deve essere cercato il file
\fB\-set.xml\fR. Se viene utilizzata quest'opzione, la cache dei percorsi
salvata in \fI~/.fgfs/autosave_X_Y.xml\fR, le directory fornite tramite
l'opzione \fB\-\-fg\-aircraft\fR e la directory specificata nella variabile
d'ambiente \fBFG_AIRCRAFT\fR non sono tenute in considerazione.
.TP
\fB\-\-show\-aircraft\fR
Stampa un elenco di aerei disponibili ed esce.
.TP
\fB\-\-min\-status=alpha\fR|\fBbeta\fR|\fBearly-production\fR|\fBproduction\fR
Non elenca aerei con un livello di stato (stato di sviluppo) minore di quello
specificato. Vedi
.UR http://\:wiki.flightgear.org/\:Aircraft_rating_system
la pagina "Aircraft rating system" del wiki FlightGear
.UE
per una descrizione estesa delle valutazioni degli aerei.
.TP
\fB\-\-fdm=jsb\fR|\fBlarcsim\fR|\fByasim\fR|\fBmagic\fR|\fBballoon\fR|\fBada\fR|\fBexternal\fR|\fBnull\fR
Seleziona il modello core della dinamica di volo da utilizzare fra i seguenti:
.RS 7
.IP \(bu 3
\fBjsb\fR: il
.UR http://\:www.jsbsim.org/
modello dinamica di volo JSBSim
.UE ,
che adotta un approccio alla modellazione guidato dai dati: noti i dati delle
prestazioni di un aereo (massa e bilanciamento, reazioni a terra, propulsioni,
aerodinamica...), li combina per produrre la dinamica globale dell'aereo;
.IP \(bu 3
\fBlarcsim\fR: il
.UR http://\:www.jsbsim.org/
modello dinamica di volo LaRCsim
.UE ,
il modello originariamente utilizzato in FlightGear fino al 2000, sviluppato
presso la NASA, ora non attivo;
.IP \(bu 3
\fByasim\fR: il
.UR http://\:wiki.flightgear.org/\:YASim
modello dinamica di volo YASim
.UE ,
che, note le caratteristiche fisiche e di volo di un aereo, tenta di risolvere
le equazioni in gioco rispettando tali vincoli;
.IP \(bu 3
\fBmagic\fR: il modello di volo "Magic Carpet";
.IP \(bu 3
\fBballoon\fR: una simulazione di volo di una mongolfiera;
.IP \(bu 3
\fBada\fR: un modello dinamica di volo guidato esternamente progettato dalla
Aeronautical Development Agency di Bangalore, India;
.IP \(bu 3
\fBexternal\fR/\fBnull\fR: utilizza un modello dinamica di volo esterno
(l'opzione \fBexternal\fR ha lo stesso significato di \fBnull\fR ed è mantenuta
per motivi di retrocompatibilità).
.RE
.TP
\fB\-\-aero=\fInome\fR
Carica il modello dell'aerodinamica dell'aereo dal file \fRnome\fI.xml\fR nella
directory dell'aereo.
.TP
\fB\-\-model\-hz=\fIn\fR
Esegui il modello dinamica di volo a una frequenza di \fIn\fR Hz (\fIn\fR volte
al secondo).
.TP
\fB\-\-speed=\fIn\fR
Esegui il modello dinamica di volo \fIn\fR volte più velocemente rispetto al
tempo reale.
.TP
\fB\-\-trim\fR, \fB\-\-notrim\fR
Corregge/non tenta di correggere il modello. Quest'opzione è valida solo se il
modello dinamica di volo utilizzato è JSBSim.
.TP
\fB\-\-on\-ground\fR
Posiziona inizialmente l'aereo a terra. Questa è l'opzione predefinita.
.TP
\fB\-\-in\-air\fR
Posiziona inizialmente l'aereo in volo. Quest'opzione è implicita se è
specificato \fB\-\-altitude\fR.
.TP
\fB\-\-enable\-auto\-coordination\fR, \fB\-\-disable\-auto\-coordination\fR
Abilita/disabilita la coordinazione automatica (controllo congiunto del
timone e degli alettoni).
.TP
\fB\-\-livery=\fInome\fR
Carica la livrea dell'aereo da un file denominato \fInome\fR.
.TP
\fB\-\-state=\fIvalore\fR
Imposta lo stato iniziale dell'aereo a \fIvalore\fR. Gli stati che è possibile
utilizzare dipendono dal modello di aereo.
.SS "Opzioni tempo"
.TP
\fB\-\-timeofday=real\fR|\fBdawn\fR|\fBmorning\fR|\fBnoon\fR|\fBafternoon\fR|\fBdusk\fR|\fBevening\fR|\fBmidnight\fR
Avvia il simulatore all'ora del giorno specificata:
.RS 7
.IP \(bu 3
\fBreal\fR: ora reale;
.IP \(bu 3
\fBdawn\fR: l'ora all'istante in cui il Sole è a 90° a Est rispetto
all'orizzonte;
.IP \(bu 3
\fBmorning\fR: l'ora all'istante in cui il Sole è a 75° a Est rispetto
all'orizzonte;
.IP \(bu 3
\fBnoon\fR: l'ora all'istante in cui il Sole è a 0° rispetto all'orizzonte;
.IP \(bu 3
\fBafternoon\fR: l'ora all'istante in cui il Sole è a 75° a Ovest rispetto
all'orizzonte;
.IP \(bu 3
\fBdusk\fR: l'ora all'istante in cui il Sole è a 90° a Ovest rispetto
all'orizzonte;
.IP \(bu 3
\fBevening\fR: l'ora all'istante in cui il Sole è a 100° a Ovest rispetto
all'orizzonte;
.IP \(bu 3
\fBmidnight\fR: l'ora all'istante in cui il Sole è a 180° rispetto
all'orizzonte.
.RE
.TP
\fB\-\-season=summer\fR|\fBwinter\fR
Carica le texture estive/invernali.
.TP
\fB\-\-time\-offset=\fR[\fB+\fR|\fB-\fR]\fIhh\fB:\fImm\fB:\fIss\fR
Aggiungi un offset temporale all'orario di avvio specificato con l'opzione
\fB\-\-timeofday\fR.
.TP
\fB\-\-time\-match\-real\fR
Sincronizza l'orario del simulatore con l'ora reale GMT.
.TP
\fB\-\-time\-match\-local\fR
Sincronizza l'orario del simulatore con l'ora reale locale.
.TP
\fB\-\-start\-date\-sys=\fIyyyy\fB:\fImm\fB:\fIdd\fB:\fIhh\fB:\fImm\fB:\fIss\fR
Specifica la data e l'ora di avvio del simulatore rispetto al fuso orario
locale del sistema.
.TP
\fB\-\-start\-date\-gmt=\fIyyyy\fB:\fImm\fB:\fIdd\fB:\fIhh\fB:\fImm\fB:\fIss\fR
Specifica la data e l'ora di avvio del simulatore rispetto all'ora di
Greenwich.
.TP
\fB\-\-start\-date\-lat=\fIyyyy\fB:\fImm\fB:\fIdd\fB:\fIhh\fB:\fImm\fB:\fIss\fR
Specifica la data e l'ora di avvio del simulatore rispetto al fuso orario
locale dell'aeroporto di partenza.
.SS "Posizione e orientamento iniziali"
.TP
\fB\-\-airport=\fIID\fR
Avvia il simulatore all'aeroporto con codice ICAO \fIID\fR.
.TP
\fB\-\-parking\-id=\fInome\fR
Posiziona l'aereo alla posizione di parcheggio \fInome\fR. Quest'opzione
richiede che l'opzione \fB\-\-airport\fR sia presente.
.TP
\fB\-\-runway=\fInumero\fR
Posiziona l'aereo sulla pista \fInumero\fR. Quest'opzione richiede che
l'opzione \fB\-\-airport\fR sia presente.
.TP
\fB\-\-carrier=\fIname\fR|\fIID\fR
Posiziona l'aereo sulla portaerei AI denominata \fInome\fR/con ID \fIID\fR.
.TP
\fB\-\-parkpos=\fInome\fR
Posiziona l'aereo alla posizione iniziale \fInome\fR. Quest'opzione richiede
che l'opzione \fB\-\-carrier\fR sia presente.
.TP
\fB\-\-vor=\fIID\fR
Posiziona l'aereo sulla verticale del VOR \fIID\fR.
.TP
\fB\-\-vor\-frequency=\fIfrequenza\fR
Imposta la frequenza del VOR a \fIfrequenza\fR. Quest'opzione richiede che
l'opzione \fB\-\-vor\fR sia presente.
.TP
\fB\-\-ndb=\fIID\fR
Posiziona l'aereo sulla verticale dell'NDB \fIID\fR.
.TP
\fB\-\-ndb\-frequency=\fIfrequenza\fR
Imposta la frequenza dell'NDB a \fIfrequenza\fR. Quest'opzione richiede che
l'opzione \fB\-\-ndb\fR sia presente.
.TP
\fB\-\-fix=\fIID\fR
Posiziona l'aereo sulla verticale del punto \fIID\fR.
.TP
\fB\-\-offset\-distance=\fInm\fR
Posiziona l'aereo a \fInm\fR miglia di distanza dal punto di riferimento
specificato dalle opzioni precedenti.
.TP
\fB\-\-offset\-azimuth=\fIgradi\fR
Posiziona l'aereo con prua \fIgradi\fR rispetto al punto di riferimento
specificato dalle opzioni precedenti.
.TP
\fB\-\-lon=\fIgradi\fR, \fB\-\-lat=\fIgradi\fR
Posiziona l'aereo al punto con coordinate (\fIlat\fR, \fIlon\fR). Le
longitudini settentrionali/latitudini orientali devono essere numeri positivi;
le longitudini meridionali/latitudini occidentali devono essere numeri
negativi.
.TP
\fB\-\-altitude=\fIvalore\fR
Posiziona l'aereo a un'altitudine di \fIvalore\fR piedi (metri se è specificata
l'opzione \fB\-\-units\-meters\fR).
.TP
\fB\-\-heading=\fIgradi\fR
Specifica la prua iniziale (imbardata, psi) dell'aereo.
.TP
\fB\-\-roll=\fIgradi\fR
Specifica il rollio iniziale (phi) dell'aereo.
.TP
\fB\-\-pitch=\fIgradi\fR
Specifica il beccheggio iniziale (theta) dell'aereo.
.TP
\fB\-\-uBody=\fIunità_per_s\fR
Specifica la velocità iniziale lungo l'asse X del corpo.
.TP
\fB\-\-vBody=\fIunità_per_s\fR
Specifica la velocità iniziale lungo l'asse Y del corpo.
.TP
\fB\-\-wBody=\fIunità_per_s\fR
Specifica la velocità iniziale lungo l'asse Z del corpo.
.TP
\fB\-\-vNorth=\fIunità_per_s\fR
Specifica la velocità iniziale lungo l'asse Nord-Sud del corpo.
.TP
\fB\-\-vEast=\fIunità_per_s\fR
Specifica la velocità iniziale lungo l'asse Ovest-Est del corpo.
.TP
\fB\-\-vDown=\fIunità_per_s\fR
Specifica la velocità iniziale lungo l'asse verticale del corpo.
.TP
\fB\-\-vc=\fInodi\fR
Imposta la velocità all'aria iniziale dell'aereo a \fInodi\fR nodi.
.TP
\fB\-\-mach=\fInumero\fR
Imposta la velocità all'aria iniziale dell'aereo a Mach \fInumero\fR.
.TP
\fB\-\-glideslope=\fIgradi\fR
Imposta l'angolo di discesa a \fIgradi\fR gradi. Il valore può essere positivo.
.TP
\fB\-\-roc=\fIfpm\fR
Imposta il rateo di salita iniziale a \fIfpm\fR piedi al minuto. Il valore può
essere negativo.
.SS "Opzioni rotta/waypoint"
.TP
\fB\-\-wp=\fIID\fR[\fB@\fIalt\fR]
Inserisce il waypoint (VOR, NDB, punto) \fIID\fR nel pilota automatico. La
parte facoltativa \fB@\fIalt\fR può essere utilizzata per specificare
l'altitudine a cui superare \fIID\fR.
.TP
\fB\-\-flight\-plan=\fIfile\fR
Leggi un piano di volo da \fIfile\fR.
.SS "Opzioni avionica"
.TP
\fB\-\-com1=\fIfrequenza\fR
Imposta la frequenza COM1 a \fIfrequenza\fR MHz.
.TP
\fB\-\-com2=\fIfrequenza\fR
Imposta la frequenza COM2 a \fIfrequenza\fR MHz.
.TP
\fB\-\-nav1=\fR[\fIradiale\fB:\fR]\fIfrequenza\fR
Imposta la frequenza NAV1 a \fIfrequenza\fR MHz. È facoltativamente possibile
specificare un radiale premettendo la prua e due punti alla frequenza.
.TP
\fB\-\-nav2=\fR[\fIradiale\fB:\fR]\fIfrequenza\fR
Imposta la frequenza NAV2 a \fIfrequenza\fR MHz. È facoltativamente possibile
specificare un radiale premettendo la prua e due punti alla frequenza.
.TP
\fB\-\-adf1=\fR[\fIrotazione\fB:\fR]\fIfrequenza\fR, \fB\-\-adf=\fR[\fIrotazione\fB:\fR]\fIfrequenza\fR
Imposta la frequenza ADF1 a \fIfrequenza\fR kHz. È facoltativamente possibile
specificare l'angolo di rotazione del COMPASS CARD premettendo alla frequenza l'angolo e due punti. \fBL'opzione \-\-adf è deprecata.\fR
.TP
\fB\-\-adf2=\fR[\fIrotation\fB:\fR]\fIfrequenza\fR
Imposta la frequenza ADF2 a \fIfrequenza\fR kHz. È facoltativamente possibile
specificare l'angolo di rotazione del COMPASS CARD premettendo alla frequenza l'angolo e due punti.
.TP
\fB\-\-dme=nav1\fR|\fBnav2\fR|\fIfrequenza\fR
Fa dipendere l'ADF dalla radio NAV1/NAV2 o imposta la sua frequenza interna a
\fIfrequenza\fR.
.SS "Opzioni ambiente"
.TP
\fB\-\-metar=\fIMETAR\fR
Simula le condizioni meteo descritte dalla stringa METAR \fIMETAR\fR.
Quest'opzione implica \fB\-\-disable\-real\-weather\-fetch\fR.
.TP
\fB\-\-enable\-real\-weather\-fetch\fR, \fB\-\-disable\-real\-weather\-fetch\fR
Abilita/disabilita il recupero delle condizioni meteo reali basate sui METAR.
Questa funzionalità richiede una connessione a Internet attiva.
.TP
\fB\-\-enable\-clouds\fR, \fB\-\-disable\-clouds\fR
Abilita/disabilita gli strati di nuvole 2D (piatti).
.TP
\fB\-\-enable\-clouds3d\fR, \fB\-\-disable\-clouds3d\fR
Abilita/disabilita gli strati di nuvole 3D (volumetrici).
.TP
\fB\-\-visibility=\fImetri\fR
Imposta la visibilità iniziale a \fImetri\fR metri.
.TP
\fB\-\-visibility\-miles=\fImiglia\fR
Imposta la visibilità iniziale a \fImiglia\fR miglia.
.TP
\fB\-\-wind=\fIdirezione\fR[\fB:\fIdirezionemassima\fR]\fB@\fIvelocità\fR[\fB:\fIraffica\fR]
Specifica la direzione da cui soffia il vento (\fIdirezione\fR) e la sua
velocità (\fIvelocità\fR nodi). Se il vento non deve soffiare da una direzione
fissa, ma da un intervallo di direzioni, specificare l'intervallo come
\fIdirezione\fB:\fIdirezionemassima\fR, dove \fIdirezione\fR e
\fIdirezionemassima\fR sono gli angoli minimi e massimi in gradi. Se si vuole
che il simulatore modelli anche raffiche di vento, impostare \fIraffica\fR alla
loro intensità massima in nodi.
.TP
\fB\-\-random\-wind\fR
Modifica casualmente la direzione e la velocità del vento.
.TP
\fB\-\-turbulence=\fIintensità\fR
Imposta l'intensità della turbolenza a \fIintensità\fR. L'intensità può variare
da \fB0.0\fR (vento calmo) a \fB1.0\fR (intensa).
.TP
\fB\-\-ceiling=\fIft_slm\fR[\fB:\fIspessore_ft\fR]
Crea uno strato di nubi con base ad un'altezza di \fIft_slm\fR piedi sul
livello del mare. È facoltativamente possibile specificare uno spessore
aggiungendo due punti (\fB:\fR) e lo spessore desiderato in piedi; se viene
omesso, il simulatore per impostazione predefinita lo renderà di 2000 ft.
.SS "Opzioni rete"
.TP
\fB\-\-callsign=\fIvalore\fR
Imposta il nominativo di chiamata multigiocatore a \fIvalore\fR. Il nominativo
di chiamata deve consistere al più di dieci lettere e può contenere solo
numeri, lettere dell'alfabeto inglese, trattini (\fB\-\fR) e trattini bassi
(\fB_\fR); i nominativi di chiamata più lunghi vengono troncati e i caratteri
che non rientrano in quelli elencati sopra sono sostituiti da trattini.
.TP
\fB\-\-multiplay=\fR{\fBin\fR|\fBout\fR}\fB,\fIhz\fB,\fIindirizzo\fB,\fIporta\fR
Specifica le impostazioni di comunicazione multigiocatore.
Il primo campo specifica se le impostazioni si applicano alle comunicazioni in
ingresso (\fBin\fR) o in uscita (\fBout\fR). Il secondo campo (\fIhz\fR)
specifica la frequenza (in Hz, volte al secondo) con cui devono essere inviati
i dati. Il terzo campo (\fIindirizzo\fR) deve essere impostato all'indirizzo
IP dell'interfaccia di rete che FlightGear deve utilizzare per inviare/ricevere
i dati, o deve essere lasciato vuoto per far sì che il simulatore utilizzi
tutte le interfacce disponibili. Il quarto campo (\fIporta\fR) deve essere
impostato alla porta da utilizzare (solitamente \fB5000\fR).
.TP
\fB\-\-proxy=\fR[\fInomeutente\fB:\fIpassword\fB@\fR]\fIhost\fB:\fIporta\fR
Specifica il server proxy e la porta da utilizzare. Il nome utente e la
password sono facoltativi; se presenti, devono essere specificati come hash
MD5.
Quest'opzione è utile solo se \fB\-\-real\-weather\-fetch\fR è abilitato.
.TP
\fB\-\-httpd=\fR[\fIindirizzo\fB:\fR]\fIporta\fR
Abilita l'interfaccia Phi (server HTTP) sull'indirizzo e sulla porta
specificati. L'indirizzo è facoltativo.
.TP
\fB\-\-telnet=\fIporta\fR
Abilita l'interfaccia Telnet sulla porta specificata.
.TP
\fB\-\-jpg\-httpd=\fIporta\fR
Abilita l'interfaccia del server schermate HTTP sulla porta specificata.
\fBQuest'opzione è deprecata: si utilizzi l'interfaccia Phi.\fR
.TP
\fB\-\-enable\-terrasync\fR, \fB\-\-disable\-terrasync\fR
Abilita/disabilita il download automatico dello scenario/degli oggetti.
.TP
\fB\-\-terrasync\-dir=\fIdirectory\fR
Imposta la directory dove sarà salvato lo scenario scaricato a \fIdirectory\fR.
.TP
\fB\-\-enable\-fgcom\fR, \fB\-\-disable\-fgcom\fR
Abilita/disabilita l'integrazione FGCom (ATC vocale).
.SS "Opzioni I/O"
.TP
\fB\-\-generic=\fIparametri\fR, \fB\-\-atlas=\fIparametri\fR, \fB\-\-atcsim=\fIparametri\fR, \fB\-\-AV400=\fIparametri\fR, \fB\-\-AV400Sim=\fIparametri\fR, \fB\-\-AV400WSimA=\fIparametri\fR, \fB\-\-AV400WSimB=\fIparametri\fR, \fB\-\-garmin=\fIparametri\fR, \fB\-\-hla=\fIparametri\fR, \fB\-\-hla\-local=\fIparametri\fR, \fB\-\-igc=\fIparametri\fR, \fB\-\-joyclient=\fIparametri\fR, \fB\-\-jsclient=\fIparametri\fR, \fB\-\-native\-ctrls=\fIparametri\fR, \fB\-\-native\-gui=\fIparametri\fR, \fB\-\-native\-fdm=\fIparametri\fR, \fB\-\-native=\fIparametri\fR, \fB\-\-nmea=\fIparametri\fR, \fB\-\-opengc=\fIparametri\fR, \fB\-\-props=\fIparametri\fR, \fB\-\-pve=\fIparametri\fR, \fB\-\-ray=\fIparametri\fR, \fB\-\-rul=\fIparametri\fR
Apre una connessione per pilotare programmi esterni o hardware.
Specificare il protocollo utilizzando l'opzione della riga di comando corretta:
.RS 7
.IP \(bu 3
\fBgeneric\fR: un'interfaccia di comunicazione predefinita e un protocollo di
comunicazione preselezionato;
.IP \(bu 3
\fBatlas\fR: il protocollo Atlas;
.IP \(bu 3
\fBatcsim\fR: il protocollo ATCsim (atc610x);
.IP \(bu 3
\fBAV400\fR: il protocollo Garmin AV400, richiesto per pilotare un GPS serie
Garmin 196/296;
.IP \(bu 3
\fBAV400Sim\fR: l'insieme delle stringhe AV400 richiesto per pilotare un GPS
serie Garmin 400;
.IP \(bu 3
\fBAV400WSimA\fR, \fBAV400WSimB\fR: l'insieme delle stringhe richieste per
pilotare un GPS Garmin WAAS (dove il canale \fBA\fR utilizza una variante del
protocollo AVSim400 e il canale \fBB\fR comunica con l'unità GPS);
.IP \(bu 3
\fBgarmin\fR: il protocollo Garmin GPS;
.IP \(bu 3
\fBhla\fR, \fBhla\-local\fR: il protocollo HLA, remoto o locale;
.IP \(bu 3
\fBigc\fR: il protocollo International Glider Commission;
.IP \(bu 3
\fBjoyclient\fR: il protocollo utilizzato dai joystick Agwagon;
.IP \(bu 3
\fBnative\-ctrls\fR: il protocollo FlightGear Native Controls;
.IP \(bu 3
\fBnative\-gui\fR: il protocollo FlightGear Native GUI;
.IP \(bu 3
\fBnative\-fdm\fR: il protocollo FlightGear Native FDM;
.IP \(bu 3
\fBnative\fR: il protocollo FlightGear Native;
.IP \(bu 3
\fBnmea\fR: il protocollo NMEA (utilizzato per pilotare la maggior parte delle
unità GPS);
.IP \(bu 3
\fBopengc\fR: il protocollo utilizzato da OpenGC, un software utilizzato per
eseguire il rendering di display glass cockpit di alta qualità per cabine di
pilotaggio simulate;
.IP \(bu 3
\fBprops\fR: il protocollo gestore proprietà interattivo;
.IP \(bu 3
\fBpve\fR: il protocollo PVE;
.IP \(bu 3
\fBray\fR: il protocollo sedia mobile Ray Woodworth;
.IP \(bu 3
\fBrul\fR: il protocollo RUL.
.RE
.RS 7
I parametri (\fIparametri\fR) devono essere nel formato
\fImezzo\fB,\fIdirezione\fB,\fIhz\fB,\fIopzioni_mezzo\fR dove \fImezzo\fR è il
mezzo utilizzato dal protocollo (\fBserial\fR, \fBsocket\fR, \fBfile\fR...),
\fIdirezione\fR è la direzione delle comunicazioni (\fBin\fR, \fBout\fR o
\fBbi\fR), \fIhz\fR è la frequenza a cui deve essere gestito il canale (sono
accettati valori in virgola mobile) e \fIopzioni_mezzo\fR sono:
.RE
.RS 7
.IP \(bu 3
per i protocolli seriali, \fIdispositivo\fB,\fIbaud\fR, dove \fIdispositivo\fR
è il nome del dispositivo da aprire e \fIbaud\fR è la velocità di comunicazione
in baud;
.IP \(bu 3
per i protocolli socket, \fImacchina\fB,\fIporta\fB,\fIstile\fR, dove
\fImacchina\fR è il nome della macchina o l'indirizzo IP del server (se il
simulatore deve fungere da client) o è lasciato vuoto (se il simulatore deve
fungere da server), \fIporta\fR è la porta da utilizzare (o è lasciato vuoto
per richiedere al sistema operativo di scegliere una porta fra quelle
disponibili) e \fIstile\fR è \fBtcp\fR o \fBudp\fR;
.IP \(bu 3
per i protocolli file, \fInomefile\fR, dove \fInomefile\fR è il nome del file
in cui devono essere scritti i dati.
.RE
.SS "Opzioni di debug"
.TP
\fB\-\-enable\-fpe\fR
Interrompi l'esecuzione quando si verifica un'eccezione in virgola mobile.
.TP
\fB\-\-fgviewer\fR
Mostra lo scenario e l'aereo in un visualizzatore modelli semplice, senza
caricare il simulatore nella sua interezza.
.TP
\fB\-\-log\-level=bulk\fR|\fBdebug\fR|\fBinfo\fR|\fBwarn\fR|\fBalert\fR
Imposta il livello minimo di registrazione eventi. Gli eventi con gravità
maggiore o uguale al valore specificato verranno registrati; gli altri verranno
scartati.
.TP
\fB\-\-log\-class=all\fR|\fBnone\fR|\fBai\fR|\fBenvironment\fR|\fBflight\fR|\fBgeneral\fR|\fBio\fR|\fBnetwork\fR|\fBsound\fR|\fBterrain\fR|...
Registra solamente gli eventi appartenenti alle classi di log specificate
(\fBall\fR registra tutti gli eventi, \fBnone\fR non ne registra nessuno).
È possibile specificare classi multiple separandole con virgole o barre
verticali, ad esempio: \fB\-\-log\-class=ai,flight\fR.
.TP
\fB\-\-log\-dir=\fIdir\fR
Salva i log nella directory \fIdir\fR. Se \fIdir\fR è \fBdesktop\fR, i log
saranno salvati sul Desktop. Quest'opzione può essere specificata più volte
indicando una directory diversa ogni volta. All'interno della directory
specificata il file di log sarà denominato
\fIFlightGear_\fRYYYY\fI-\fRMM\fI-\fRDD\fI_\fRnum\fI.log\fR, dove
\fIYYYY-MM-DD\fR è la data corrente e \fInum\fR è un numero progressivo che
parte da \fB0\fR.
.TP
\fB\-\-trace\-read=\fIproprietà\fR, \fB\-\-trace\-write=\fIproprietà\fR
Traccia le letture/scritture di una proprietà (stampa un messaggio di log ogni
volta che \fIproprietà\fR viene letta/scritta).
.TP
\fB\-\-developer\fR
Abilita la modalità sviluppatore.
.SH "STATI D'USCITA"
.B fgfs
esce con
.B 0
se l'esecuzione ha avuto successo o con un altro stato (solitamente
.B 1
o \fB-1\fR) se si è verificato un errore.
.SH "VARIABILI D'AMBIENTE"
.IP "\fBCOMPUTERNAME\fR" 4
Specifica il nome host da utilizzare per il sistema. Questa variabile
d'ambiente è presa in considerazione solo sui sistemi operativi Microsoft
Windows.
.IP "\fBFG_AIRCRAFT\fR" 4
Specifica il percorso in cui devono essere ricercati gli aerei.
.IP "\fBFG_LAUNCHER\fR" 4
Se questa variabile d'ambiente è impostata e non è pari a \fB0\fR, sarà
visualizzato il launcher Qt. Questa variabile è utilizzata principalmente sui
sistemi operativi Mac OS X per evitare l'utilizzo di script wrapper.
.IP "\fBFG_ROOT\fR" 4
Specifica la directory radice dei dati da utilizzare.
.IP "\fBFG_SCENERY\fR" 4
Specifica la directory dello scenario da utilizzare.
.IP "\fBHTTP_PROXY\fR" 4
Specifica il proxy HTTP da utilizzare. Dev'essere nel formato
\fBhttp://host:porta/\fR.
.IP "\fBLANG\fR" 4
Specifica la lingua da utilizzare.
.SH FILE
.IP "\fI~/.fgfs\fR" 4
La directory principale in cui sono salvati i file di configurazione e i dati
(aerei/scenario scaricati) di FlightGear.
.IP "\fI~/.fgfsrc.nomehost\fR, \fI~/.fgfsrc\fR" 4
File di configurazione contenenti opzioni della riga di comando per
.BR fgfs (1).

68
man/it/man1/fgjs.1 Normal file
View File

@@ -0,0 +1,68 @@
.\" Copyright (C) 2002 Cameron Moore
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGJS 1 2017-06-24 FlightGear "Pagine man di FlightGear"
.SH NOME
fgjs \- utilità joystick di FlightGear
.SH SINTASSI
\fBfgjs\fR [\fB\-\-help\fR] [\fB\-\-fg\-root=\fIdirectoryroot\fR]
.SH DESCRIZIONE
.B fgjs
è un'utilità joystick per il simulatore di volo FlightGear che consente di
generare interattivamente un file di configurazione per il proprio joystick.
Per utilizzarla, avviare il programma con i joystick connessi. L'utilità per
prima cosa richiederà di muovere ogni joystick nella \fIdead band\fR, ossia
l'area in cui il joystick è centrato e non dovrebbe generare alcun input. In
seguito verrà richiesto di muovere l'asse/premere il pulsante che si preferisce
utilizzare per ogni funzione.
La configurazione sarà salvata nella directory di lavoro corrente in più
file denominati \fIjsI.xml\fR, dove \fII\fR è il numero progressivo assegnato a
ogni joystick rilevato. Sarà necessario spostarli in
.I ~/.fgfs/Input/Joysticks
affinché questi vengano utilizzati da FlightGear.
.SH OPZIONI
.TP
\fB\-\-help\fR
Mostra informazioni sull'utilizzo ed esce.
.TP
\fB\-\-fg\-root=\fIdirectoryroot\fR
Imposta la directory radice dei dati di FlightGear (\fB$FG_ROOT\fR) a
\fIdirectoryroot\fR.
.SH "VARIABILI D'AMBIENTE"
.IP "\fBFG_ROOT\fR" 4
Se
.B FG_ROOT
è impostata e
.B \-\-fg\-root
non è impostato, specifica la directory radice dei dati da utilizzare.
.SH FILE
.IP "\fI~/.fgfsrc.hostname\fR, \fI~/.fgfsrc\fR" 4
File di configurazione contenenti opzioni della riga di comando per
.BR fgfs (1).
L'opzione della riga di comando
.B \-\-fg\-root
è ricercata in tali file se non è fornita come argomento della riga di comando
a \fBfgjs\fR.
.SH "VEDERE ANCHE"
.BR fgfs (1),
.BR js_demo (1),
.UR http://\:wiki.flightgear.org/\:Joystick
la pagina "Joystick" del wiki FlightGear
.UE

46
man/it/man1/fgpanel.1 Normal file
View File

@@ -0,0 +1,46 @@
.\" Copyright (C) 2011 Thorsten Brehm
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGPANEL 1 2017-06-26 FlightGear "Pagine man di FlightGear"
.SH NOME
fgpanel \- Motore di rendering del pannello dei comandi del simulatore di volo
FlightGear
.SH SINTASSI
\fBfgpanel\fR \fB\-\-panel=\fIfile\fR [\fB\-\-fg-root=\fIpercorso\fR]
[\fB\-\-prop:\fInome\fB=\fIvalore\fR]
.SH DESCRIZIONE
.B fgpanel
è un motore di rendering del pannello dei comandi libero, open source,
multipiattaforma e leggero per disegnare pannelli 2D su computer a basso
costo/schede video senza accelerazione 3D a frame rate accettabili.
.SH OPTIONS
.TP
\fB\-\-panel=\fIfile\fR
Mostra il file di descrizione del pannello \fIfile\fR.
.TP
\fB\-\-fg\-root=\fIpercorso\fR
Imposta la directory radice dei dati di FlightGear (\fB$FG_ROOT\fR) a
\fIpercorso\fR.
.TP
\fB\-\-prop:\fInome\fB=\fIvalore\fR
Imposta la proprietà \fInome\fR a \fIvalore\fR.
.SH "VEDERE ANCHE"
.BR fgfs (1),
.UR http://\:wiki.flightgear.org/\:FGPanel
la pagina "FGPanel" del wiki FlightGear
.UE

40
man/it/man1/fgqcanvas.1 Normal file
View File

@@ -0,0 +1,40 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGQCANVAS 1 2017-06-24 FlightGear "Pagine man di FlightGear"
.SH NOME
fgqcanvas \- Un'applicazione canvas remota basata su Qt per FlightGear
.SH SINTASSI
\fBfgqcanvas\fR
.SH DESCRIZIONE
.B fgqcanvas
è un'applicazione basata su Qt che può connettersi a una qualunque istanza di
FlightGear che abbia il server HTTPD incorporato abilitato e visualizzare un
qualunque canvas in tempo reale.
.PP
Per utilizzare \fBfgqcanvas\fR, avviarlo e immettere l'URL al socket Web HTTP,
ad esempio \fIws://localhost:8080/PropertyTreeMirror\fR, quindi immettere il
percorso al canvas che si desidera visualizzare, ad esempio
\fI/canvas/by-index/texture[0]/\fR.
.SH "STATI D'USCITA"
.B fgqcanvas
esce con
.B 0
se l'esecuzione ha avuto successo, con un codice d'uscita diverso da zero se si
è verificato un errore.
.SH "VEDERE ANCHE"
.BR fgfs (1)

92
man/it/man1/fgviewer.1 Normal file
View File

@@ -0,0 +1,92 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGVIEWER 1 2017-06-24 FlightGear "Pagine man di FlightGear"
.SH NOME
fgviewer \- Un'applicazione di visualizzazione di FlightGear alternativa
.SH SINTASSI
\fBfgviewer\fR [\fB\-\-fg\-root\fR \fIrootdir\fR]
[\fB\-\-fg\-scenery\fR \fIscenerydir\fR] [\fB\-\-config\fR \fIconfigfile\fR]
[\fB\-\-prop\fR \fIproprietà\fR \fIvalore\fR] [\fB\-\-renderer\fR \fIrend\fR]
[\fB\-\-hla\fR] [\fB\-\-federation\fR \fIfed\fR]
.SH DESCRIZIONE
.B fgviewer
è un'applicazione di visualizzazione che consente di esaminare lo scenario e
gli oggetti di FlightGear senza avviare
.BR fgfs (1).
.SH OPZIONI
.TP
\fB\-\-fg\-root\fR \fIrootdir\fR
Imposta la directory radice dei dati di FlightGear (\fB$FG_ROOT\fR) a
\fIrootdir\fR. Se quest'opzione non è impostata,
.B fgviewer
utilizza il percorso specificato nella variabile d'ambiente
.B FG_ROOT
o, in sua assenza, la directory dei dati di FlightGear scelta all'atto della
compilazione del programma.
.TP
\fB\-\-fg\-scenery\fR \fIscenerydir\fR
Imposta la directory dello scenario di FlightGear (\fB$FG_SCENERY\fR) a
\fIscenerydir\fR. Se quest'opzione non è impostata,
.B fgelev
utilizza il percorso specificato nella variabile d'ambiente
.B FG_SCENERY
o, in sua assenza, la sottodirectory
.B Scenery
all'interno di \fB$FG_ROOT\fR.
.TP
\fB\-\-config\fR \fIconfigfile\fR
Legge direttive di configurazione da \fIconfigfile\fR.
.TP
\fB\-\-prop\fR \fIproprietà\fR \fIvalore\fR
Imposta la proprietà \fIproprietà\fR a \fIvalore\fR.
.TP
\fB\-\-renderer\fR \fIrend\fR
Utiliizza il renderer \fIrend\fR per eseguire il rendering dello scenario.
Quest'opzione non è attualmente supportata.
.TP
\fB\-\-hla\fR
Abilita la federazione HLA.
.TP
\fB\-\-federation\fR \fIfed\fR
Abilita una federazione personalizzata \fIfed\fR.
.SH "STATI D'USCITA"
.B fgviewer
esce con
.B EXIT_SUCCESS
se l'esecuzione ha avuto successo, con
.B EXIT_FAILURE
se la sintassi degli argomenti della riga di comando è errata o se si verifica
un errore.
.SH "VARIABILI D'AMBIENTE"
.IP "\fBFG_ROOT\fR" 4
Se
.B FG_ROOT
è impostata e
.B \-\-fg\-root
non è impostato, specifica la directory radice dei dati da utilizzare.
.IP "\fBFG_SCENERY\fR" 4
Se
.B FG_SCENERY
è impostata e
.B \-\-fg\-scenery
non è impostato, specifica la directory dello scenario da utilizzare.
.SH FILE
.IP "\fI$FG_ROOT/defaults.xml\fR" 4
File delle impostazioni predefinite caricato all'avvio.
.SH "VEDERE ANCHE"
.BR fgfs (1)

35
man/it/man1/js_demo.1 Normal file
View File

@@ -0,0 +1,35 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH JS_DEMO 1 2017-06-24 FlightGear "Pagine man di FlightGear"
.SH NAME
js_demo \- Applicazione demo joystick per FlightGear
.SH SINTASSI
\fBjs_demo\fR
.SH DESCRIZIONE
.B js_demo
è un'utilità di FlightGear che visualizza i joystick rilevati e fornisce un
modo di monitorarli mentre li si muove lungo i loro assi o si premono i loro
pulsanti.
.SH "STATI D'USCITA"
.B js_demo
esce sempre con \fB0\fR.
.SH "VEDERE ANCHE"
.BR fgfs (1),
.UR http://\:wiki.flightgear.org/\:Input_device
la pagina "Input device" del wiki FlightGear
.UE

83
man/it/man1/metar.1 Normal file
View File

@@ -0,0 +1,83 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH METAR 1 2017-06-24 FlightGear "Pagine man di FlightGear"
.SH NOME
metar \- utilità demo METAR per FlightGear
.SH SINTASSI
\fBmetar\fR \fB\-h\fR | \fB\-\-help\fR | [\fB\-v\fR | \fB\-\-verbose\fR]
[\fB\-e\fR \fIaltitudine\fR | \fB\-\-elevation\fR \fIaltitudine\fR] [\fB\-r\fR |
\fB\-\-report\fR | \fB\-c\fR | \fB\-\-command\-line\fR] \fI<elenco di codici
ICAO aeroporti o stringhe METAR>\fR
.SH DESCRIZIONE
.B metar
è un'utilità demo per FlightGear che recupera un METAR (informazioni
metereologiche codificate) per uno o più aeroporti da Internet e lo visualizza
in una forma leggibile dall'utente. Facoltativamente, può anche stampare gli
argomenti della riga di comando richiesti per avviare
.BR fgfs (1)
all'orario e con le condizioni metereologiche correnti.
.SH OPZIONI
.TP
\fB\-h\fR, \fB\-\-help\fR
Mostra informazioni sull'utilizzo ed esce.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Mostra informazioni di debug durante l'esecuzione dell'operazione richiesta.
.TP
\fB\-e\fR \fIaltitudine\fR, \fB\-\-elevation\fR \fIaltitudine\fR
Imposta l'altitudine dell'aeroporto ad \fIaltitudine\fR metri.
.TP
\fB\-r\fR, \fB\-\-report\fR
Stampa le informazioni metereologiche a schermo in una forma leggibile
dall'utente.
.TP
\fB\-c\fR, \fB\-\-command\-line\fR
Stampa gli argomenti della riga di comando richiesti per avviare FlightGear
all'orario e con le condizioni metereologiche correnti.
.SH "STATI D'USCITA"
.B metar
esce con
.B 0
se l'esecuzione ha avuto successo, con
.B 1
se la sintassi degli argomenti della riga di comando è errata o se si verifica
un errore.
.SH "VARIABILI D'AMBIENTE"
.IP "\fBHTTP_PROXY\fR" 4
Specifica il proxy HTTP da utilizzare. Dev'essere nel formato
\fBhttp://host:porta/\fR.
.SH ESEMPI
Stampa le informazioni metereologiche correnti per KSFO e KOAK:
$ \fBmetar KSFO KOAK\fR
Stampa le informazioni metereologiche correnti per KSFO, così come gli
argomenti della riga di comando richiesti per avviare FlightGear con le
condizioni metereologiche correnti:
$ \fBmetar -c KSFO -r KSFO\fR
Stampa la stringa METAR data sotto forma di un report meteo leggibile
dall'utente:
$ \fBmetar "LOWL 161500Z 19004KT 160V240 9999 FEW035 SCT300 29/23 Q1006 NOSIG"\fR
.SH "VEDERE ANCHE"
.BR fgfs (1),
.UR http://\:wiki.flightgear.org/\:Weather_reports
la pagina "Weather reports" del wiki FlightGear
.UE

View File

@@ -0,0 +1,3 @@
include(GNUInstallDirs)
install(FILES fgfsrc.5 DESTINATION ${CMAKE_INSTALL_MANDIR}/it/man5
COMPONENT doc)

71
man/it/man5/fgfsrc.5 Normal file
View File

@@ -0,0 +1,71 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGFSRC 5 2017-06-25 FlightGear "Pagine man di FlightGear"
.SH NOME
fgfsrc \- file con opzioni della riga di comando di FlightGear
.SH DESCRIZIONE
.B fgfsrc
è un file contenente opzioni della riga di comando letto da
.BR fgfs (1)
all'avvio. Questo file è inteso per coloro che non utilizzano un launcher
grafico per eseguire il simulatore, in modo che questi possano specificare in
tale file la maggior parte delle preferenze che non vengono modificate spesso
(ad esempio, i percorsi degli scenari/aerei personalizzati o le opzioni
relative alle dimensioni della finestra) e specificare solo quelle modificate
di frequente (come l'aeroporto di partenza) sulla riga di comando.
Il file deve essere in formato solo testo e codificato ASCII. Deve contenere
una o più opzioni a riga di comando elencate in
.BR fgfs (1);
ogni opzione deve essere fornita su una riga separata.
Se il primo carattere in una riga diverso da uno spazio bianco è un cancelletto
(\fB#\fR),
.BR fgfs (1)
considera la riga un commento e la ignora. I commenti non devono essere
aggiunti dopo un'opzione in quanto ciò potrebbe far sì che il simulatore non
riesca a gestirli in certe condizioni (in particolare quando l'argomento della
riga di comando fornito in tale riga è nella forma \fB\-\-prop=\fR).
Le variabili nei percorsi, come
.B $HOME
o \fB$FG_HOME\fR, non sono espanse.
.SH FILE
.IP "\fI~/.fgfsrc.nomehost\fR, \fI~/.fgfsrc\fR" 4
File di configurazione contenenti opzioni della riga di comando per
.BR fgfs (1).
Il simulatore gestisce prima gli argomenti della riga di comando, quindi
\fI~/.fgfsrc.nomehost\fR (dove
.I nomehost
è il nome host della macchina) e quindi \fI~/.fgfsrc\fR, se tali file
esistono, in quest'ordine.
.SH ESEMPIO
Il seguente file di configurazione di esempio sincronizza l'orologio del
simulatore con il tempo reale locale, carica dati meteo reali, imposta le
dimensioni della finestra a 1024x768 e abilita gli oggetti scenario casuali e
il traffico IA:
.nf
\-\-time\-match\-local
\-\-enable\-real\-weather\-fetch
\-\-geometry=1024x768
\-\-enable\-random\-objects
\-\-enable\-ai\-traffic
.fi
.SH "VEDERE ANCHE"
.BR fgfs (1)

49
man/man1/CMakeLists.txt Normal file
View File

@@ -0,0 +1,49 @@
include(GNUInstallDirs)
set(MANPAGES
fgfs.1
)
if(ENABLE_FGCOM)
list(APPEND MANPAGES fgcom.1)
endif(ENABLE_FGCOM)
if(ENABLE_FGELEV)
list(APPEND MANPAGES fgelev.1)
endif(ENABLE_FGELEV)
if(ENABLE_FGJS)
list(APPEND MANPAGES fgjs.1)
endif(ENABLE_FGJS)
if(WITH_FGPANEL)
list(APPEND MANPAGES fgpanel.1)
endif()
if(ENABLE_FGQCANVAS)
list(APPEND MANPAGES fgqcanvas.1)
endif(ENABLE_FGQCANVAS)
if(ENABLE_FGVIEWER)
list(APPEND MANPAGES fgviewer.1)
endif(ENABLE_FGVIEWER)
if(ENABLE_GPSSMOOTH)
list(APPEND MANPAGES GPSsmooth.1 MIDGsmooth.1 UGsmooth.1)
endif(ENABLE_GPSSMOOTH)
if(ENABLE_JS_DEMO)
list(APPEND MANPAGES js_demo.1)
endif(ENABLE_JS_DEMO)
if(ENABLE_JSBSIM)
list(APPEND MANPAGES JSBSim.1)
endif(ENABLE_JSBSIM)
if(ENABLE_METAR)
list(APPEND MANPAGES metar.1)
endif(ENABLE_METAR)
foreach(man ${MANPAGES})
install(FILES ${man} DESTINATION ${CMAKE_INSTALL_MANDIR}/man1
COMPONENT doc)
endforeach()

69
man/man1/GPSsmooth.1 Normal file
View File

@@ -0,0 +1,69 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH GPSSMOOTH 1 2017-06-04 FlightGear "FlightGear man pages"
.SH NAME
GPSsmooth \- send NMEA-formatted GPS data to a FlightGear instance
.SH SYNOPSIS
\fBGPSsmooth\fR \fB\-\-help\fR | \fB\-\-file\fR \fIfile_name\fR
[\fB\-\-hertz\fR \fIhertz\fR] [\fB\-\-host\fR \fIhostname\fR]
[\fB\-\-broadcast\fR] [\fB\-\-fdm\-port\fR \fIport\fR] [\fB\-\-ctrls\-port\fR
\fIport\fR]
.SH DESCRIPTION
.B GPSsmooth
is a utility that reads a text file containing GPS data in NMEA format, parses
it and sends it to a FlightGear instance for replaying.
.SH OPTIONS
.TP
\fB\-\-help\fR
Display usage information and exit.
.TP
\fB\-\-file\fR \fIfile_name\fR
Read GPS data from \fIfile_name\fR. This option is mandatory if \fB\-\-help\fR
is not specified.
.TP
\fB\-\-hertz\fR \fIhertz\fR
Specify the frequency to use for sending data to the FlightGear instance.
By default, events are sent at a frequency of \fB60\fR Hz.
.TP
\fB\-\-host\fR \fIhostname\fR
Send the data to the FlightGear instance running on \fIhostname\fR.
If \fB\-\-host\fR is not specified, the default is to send the data to
\fBlocalhost\fR.
.TP
\fB\-\-broadcast\fR
Send flight data model and control data as broadcast packets.
.TP
\fB\-\-fdm\-port\fR \fIport\fR
Set the port flight data model data should be sent to. By default, data is sent
to port \fB5505\fR.
.TP
\fB\-\-ctrls\-port\fR \fIport\fR
Set the port control data should be sent to. By default, data is sent to port
\fB5506\fR.
.SH "EXIT STATUS"
.B GPSsmooth
exits with
.B 0
on success, with
.B \-1
if the syntax of the command-line arguments is wrong or an error occurs.
.SH "SEE ALSO"
.BR fgfs (1),
.BR MIDGsmooth (1),
.BR UGsmooth (1)

99
man/man1/JSBSim.1 Normal file
View File

@@ -0,0 +1,99 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH JSBSIM 1 2017-06-25 FlightGear "FlightGear man pages"
.SH NAME
JSBSim \- standalone version of the JSBSim open source flight dynamics model
.SH SYNOPSIS
\fBJSBSim\fR \fI<script filename>\fR \fI<output filenames>\fR \fI<options>\fR
.SH DESCRIPTION
.B JSBSim
is a standalone version of the JSBSim open source flight dynamics model
library that, given a script file, runs the simulation and outputs the results
to one or more files.
.SH OPTIONS
.TP
\fB\-\-help\fR
Display usage information and exit.
.TP
\fB\-\-version\fR
Display the JSBSim version number and exit.
.TP
\fB\-\-outputlogfile=\fIfilename\fR
Output the processed data to \fIfilename\fR.
.TP
\fB\-\-logdirectivefile=\fIfilename\fR
Use the data logging directives specified in \fIfilename\fR. This option may be
specified multiple times.
.TP
\fB\-\-root=\fIpath\fR
Use \fIpath\fR as the JSBSim root directory (the directory where the aircraft
model resides, containing the \fBaircraft\fR, \fBengine\fR... subdirectories).
.TP
\fB\-\-aircraft=\fIfilename\fR
Use the aircraft model specified in \fIfilename\fR.
.TP
\fB\-\-script=\fIfilename\fR
Run the simulation script specified in \fIfilename\fR.
This option is incompatible with \fB\-\-catalog\fR.
.TP
\fB\-\-realtime\fR
Run the simulation in actual real world time.
.TP
\fB\-\-nice\fR[\fB=\fIsleep period\fR]
Reduce CPU usage by pausing the simulation between frames for
\fIsleep period\fR nanoseconds. If \fIsleep period\fR is not given, it is set
to \fB0.01\fR nanoseconds.
.TP
\fB\-\-nohighlight\fR
Do not colorize the output.
.TP
\fB\-\-suspend\fR
Suspend the simulation after initializing it.
.TP
\fB\-\-initfile=\fIfilename\fR
Use the initialization file \fIfilename\fR.
.TP
\fB\-\-catalog\fR[\fB=\fIaircraft\fR]
Print all properties for the aircraft model (\fIaircraft\fR, if the model name
is passed as an argument, or for the model loaded via the initialization file).
This option is incompatible with \fB\-\-script\fR.
.TP
\fB\-\-property=\fIname\fB=\fIvalue\fR
Set the property named \fIname\fR to \fIvalue\fR.
.TP
\fB\-\-simulation\-rate=\fIrate\fR
Set the simulation rate (dT) to \fIrate\fR. If \fIrate\fR is less than \fB1\fR,
it is interpreted as a time step size in seconds; otherwise, it is interpreted
as a rate in Hertz.
.TP
\fB\-\-end=\fItime\fR
Set the simulation end time to \fItime\fR.
.SH "EXIT STATUS"
.B JSBSim
exits with
.B 0
on success, with
.B 1
if the syntax of the command-line arguments is wrong or an error occurs.
.SH "SEE ALSO"
.BR fgfs (1),
.UR http://\:jsbsim.sourceforge.net/
the JSBSim Web site
.UE

83
man/man1/MIDGsmooth.1 Normal file
View File

@@ -0,0 +1,83 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH MIDGSMOOTH 1 2017-06-25 FlightGear "FlightGear man pages"
.SH NAME
MIDGsmooth \- send MIDG-formatted GPS data to a FlightGear instance
.SH SYNOPSIS
\fBMIDGsmooth\fR \fB\-\-help\fR
| \fB\-\-infile\fR \fIinfile_name\fR [\fIoptions\fR]...
| \fB\-\-serial\fR \fIdev_name\fR \fB\-\-outfile\fR \fIoutfile_name\fR
[\fIoptions\fR]...
.SH DESCRIPTION
.B MIDGsmooth
is a utility that reads GPS data in MIDG format from a text file or from an
MIDG device connected to the serial port, parses it and sends it to a
FlightGear instance for replaying.
.SH OPTIONS
.TP
\fB\-\-help\fR
Display usage information and exit.
.TP
\fB\-\-infile\fR \fIinfile_name\fR
Read GPS data from \fIinfile_name\fR.
.TP
\fB\-\-serial\fR \fIdev_name\fR
Read GPS data from the serial device named \fIdev_name\fR.
.TP
\fB\-\-outfile\fR \fIoutfile_name\fR
Save the data retrieved from the device to \fIoutfile_name\fR.
.TP
\fB\-\-hertz\fR \fIfrequency\fR
Specify the frequency to use for sending data to the FlightGear instance.
By default, events are sent at a frequency of \fB60\fR Hz.
.TP
\fB\-\-host\fR \fIhostname\fR
Send the data to the FlightGear instance running on \fIhostname\fR.
If \fB\-\-host\fR is not specified, the default is to send the data to
\fBlocalhost\fR.
.TP
\fB\-\-skip\-seconds\fR \fIseconds\fR
Do not transmit the first \fIseconds\fR seconds of data.
This option is ignored when reading GPS data from a serial device.
.TP
\fB\-\-broadcast\fR
Send flight data model and control data as broadcast packets.
.TP
\fB\-\-fdm\-port\fR \fIport\fR
Set the port flight data model data should be sent to. By default, data is sent
to port \fB5505\fR.
.TP
\fB\-\-ctrls\-port\fR \fIport\fR
Set the port control data should be sent to. By default, data is sent to port
\fB5506\fR.
.TP
\fB\-\-altitude\-offset\fR \fImeters\fR
Add the specified offset (in meters) to the altitude sent to FlightGear.
.SH "EXIT STATUS"
.B MIDGsmooth
exits with
.B 0
on success, with
.B \-1\fR
if the syntax of the command-line arguments is wrong or an error occurs.
.SH "SEE ALSO"
.BR fgfs (1),
.BR GPSsmooth (1),
.BR UGsmooth (1)

114
man/man1/UGsmooth.1 Normal file
View File

@@ -0,0 +1,114 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH UGSMOOTH 1 2017-06-25 FlightGear "FlightGear man pages"
.SH NAME
UGsmooth \- send UGear-formatted GPS data to a FlightGear instance
.SH SYNOPSIS
\fBUGsmooth\fR \fB\-\-help\fR
| \fB\-\-infile\fR \fIinfile_name\fR [\fIoptions\fR]...
| \fB\-\-flight\fR \fIflight_dir\fR [\fIoptions\fR]...
| \fB\-\-serial\fR \fIdev_name\fR \fB\-\-outfile\fR \fIoutfile_name\fR [\fIoptions\fR]...
.SH DESCRIPTION
.B UGsmooth
is a utility that reads GPS data in UGear format from a text file, a directory
containing flight data or from a device connected to the serial port, parses it
and sends it to a FlightGear instance for replaying.
.SH OPTIONS
.TP
\fB\-\-help\fR
Display usage information and exit.
.TP
\fB\-\-infile\fR \fIinfile_name\fR
Read GPS data from \fIinfile_name\fR.
.TP
\fB\-\-flight\fR \fIflight_dir\fR
Read GPS data from the flight directory named \fIflight_dir\fR.
.TP
\fB\-\-serial\fR \fIdev_name\fR
Read GPS data from the serial device named \fIdev_name\fR.
.TP
\fB\-\-outfile\fR \fIoutfile_name\fR
Save the data retrieved from the device to \fIoutfile_name\fR.
.TP
\fB\-\-hertz\fR \fIfrequency\fR
Specify the frequency to use for sending data to the FlightGear instance.
By default, events are sent at a frequency of \fB60\fR Hz.
.TP
\fB\-\-host\fR \fIhostname\fR
Send the data to the FlightGear instance running on \fIhostname\fR.
If \fB\-\-host\fR is not specified, the default is to send the data to
\fBlocalhost\fR.
.TP
\fB\-\-broadcast\fR
Send flight data model and control data as broadcast packets.
.TP
\fB\-\-opengc\-port\fR \fIport\fR
Set the port OpenGC data should be sent to. By default, data is sent to port
\fB6000\fR.
.TP
\fB\-\-fdm\-port\fR \fIport\fR
Set the port flight data model data should be sent to. By default, data is sent
to port \fB5505\fR.
.TP
\fB\-\-ctrls\-port\fR \fIport\fR
Set the port control data should be sent to. By default, data is sent to port
\fB5506\fR.
.TP
\fB\-\-groundtrack\-heading\fR
Calculate the aircraft heading from the GPS velocity instead of using the raw
heading recorded by the device.
.TP
\fB\-\-ground\-speed\fR
Calculate the ground speed from the GPS velocity instead of using the raw speed
recorded by the device.
.TP
\fB\-\-estimate\-control\-deflections\fR
Estimate control deflections from the angular velocities instead of using the
raw deflections recorded by the device.
.TP
\fB\-\-altitude\-offset\fR \fImeters\fR
Add the specified offset (in meters) to the altitude sent to FlightGear.
.TP
\fB\-\-skip\-seconds\fR \fIseconds\fR
Do not transmit the first \fIseconds\fR seconds of data.
This option is ignored when reading GPS data from a serial device.
.TP
\fB\-\-no\-real\-time\fR
Do not update the elapsed time.
.TP
\fB\-\-ignore\-checksum\fR
Do not discard data with invalid checksums.
This option is ignored when reading GPS data from a flight directory.
.TP
\fB\-\-sg\-swap\fR
Activate the special double swap logic for the (non-standard) stargate double
format.
.SH "EXIT STATUS"
.B UGsmooth
exits with
.B 0
on success, with
.B \-1
if the syntax of the command-line arguments is wrong or an error occurs.
.SH "SEE ALSO"
.BR fgfs (1),
.BR GPSsmooth (1),
.BR MIDGsmooth (1)

150
man/man1/fgcom.1 Normal file
View File

@@ -0,0 +1,150 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGCOM 1 2017-06-04 FlightGear "FlightGear man pages"
.SH NAME
fgcom \- VoIP client for the FlightGear radio infrastructure
.SH SYNOPSIS
\fBfgcom\fR [\fB\-\-server=\fIserver\fR] [\fB\-\-host=\fIlisteninghost\fR]
[\fB\-\-port=\fIport\fR] [\fB\-\-callsign=\fIcallsign\fR]
[\fB\-\-frequency=\fIfrequency\fR] [\fB\-\-atis=\fIfrequency\fR]
[\fB\-\-airport=\fIcode\fR] [\fB\-\-username=\fIuser\fR]
[\fB\-\-password=\fIpass\fR] [\fB\-\-silence\-threshold=\fIthreshold\fR]
[\fB\-\-debug\fR] [\fB\-\-help\fR] [\fB\-\-version\fR]
.SH DESCRIPTION
.B fgcom
is the FlightGear utility used for connecting to multiplayer voice servers.
.PP
It is usually not necessary to run
.B fgcom
from the command line, as it is already integrated into FlightGear, with the
exception of a few specific cases (such as recording ATIS messages or
performing a radio check, see the
.B EXAMPLE
section).
.SH OPTIONS
.TP
\fB\-\-server=\fIserver\fR
Connect to the FGCom server \fIserver\fR. By default, FGCom tries to connect to
\fBfgcom.flightgear.org\fR.
.TP
\fB\-\-host=\fIlisteninghost\fR, \fB\-\-port=\fIport\fR
Listen on the network interface having the IP address \fIlisteninghost\fR, on
port \fIport\fR. By default, FGCom listens on the loopback interface
(\fB127.0.0.1\fR) on port \fB16661\fR.
The specified port can be used by an instance of FlightGear to communicate with
FGCom and update the pilot position as they fly.
.TP
\fB\-\-callsign=\fIcallsign\fR
Use the callsign \fIcallsign\fR during the session. By default, FGCom uses
\fBguest\fR as callsign.
.TP
\fB\-\-frequency=\fIfrequency\fR
Set the active radio frequency to \fIfrequency\fR. The frequency must be
written in the format \fIxxx.xxx\fR and must be given in MHz.
.TP
\fB\-\-atis=\fIfrequency\fR
Record an ATIS message on \fIfrequency\fR MHz. The frequency must be written in
the format \fIxxx.xxx\fR and must be given in MHz.
.TP
\fB\-\-airport=\fIcode\fR
Position the pilot/controller to the airport having the ICAO code \fIcode\fR.
Since some radio frequencies might be reused across the world, it is essential
to set the pilot/controller position correctly to make the FGCom server able to
determine the correct voice channel. Always use this flag if you are not
connecting a FlightGear instance to FGCom.
.TP
\fB\-\-username=\fIuser\fR, \fB\-\-password=\fIpass\fR
Log in to the FGCom server using the username \fIuser\fR and the password
\fIpass\fR.
.TP
\fB\-\-silence-threshold=\fIthreshold\fR
Set the silence threshold to \fIthreshold\fR dB. The value must be between
\fB-60\fR and \fB0\fR. The default is \fB-35.0\fR dB.
The silence threshold is the level below which the sound captured by the
microphone is considered background noise (and, thus, filtered out by FGCom).
Setting the silence threshold to \fB-60\fR turns the filter off; setting it
to \fB0\fR filters everything (mutes the microphone).
.TP
\fB\-\-debug\fR
Enable debug output for troubleshooting purposes.
.TP
\fB\-\-help\fR
Display usage information and exit.
.TP
\fB\-\-version\fR
Display the FGCom version and exit.
.SH "EXIT STATUS"
.B fgcom
exits with
.B EXIT_SUCCESS
on success, with
.B EXIT_FAILURE
if the syntax of the command-line arguments is wrong or an error occurs.
.SH NOTES
FGCom understands several special frequencies used for testing purposes or
general chatting:
.IP \(bu 3
\fB121.000 MHz\fR, \fB121.500 MHz\fR: "guard" frequencies reserved for
emergency communications;
.IP \(bu 3
\fB123.450 MHz\fR, \fB123.500 MHz\fR, \fB122.750 MHz\fR: general chat
frequencies;
.IP \(bu 3
\fB700.000 MHz\fR: radio station frequency. Depending on the FGCom server in
use, a recorded radio message will be played;
.IP \(bu 3
\fB723.340 MHz\fR: French Air Patrol communication frequency;
.IP \(bu 3
\fB910.000 MHz\fR: echo test frequency. Your voice will be echoed back after a
short delay, to allow you to check that your microphone, speakers/headset and
that your connection to the FGCom server works. The test is limited to a
maximum of 65 seconds, after which you will be automatically disconnected;
.IP \(bu 3
\fB911.000 MHz\fR: "music on hold". The frequency continuously plays background
music, allowing you to check that your connection to the FGCom server works.
.SH BUGS
.IP \(bu 3
At the time of writing, there is no mechanism in place to update the
frequencies used by FGCom with the ones used in the real world, should those
change. The former, thus, might not always correspond to the latter. Always use
the frequencies listed in FlightGear under \fBAI\fR -> \fBATC Services in
Range\fR instead of the ones published on aeronautical charts.
.SH EXAMPLE
Connect to the default FGCom server, switch to the San Francisco International
Airport (\fIKSFO\fR) ground frequency (\fI121.800 MHz\fR) and allow FlightGear
to update the current pilot position by sending it to port \fI16661\fR (the
default one):
$ \fBfgcom --frequency=121.800 --airport=KSFO\fR
Perform a radio check by connecting to the echo test frequency:
$ \fBfgcom --frequency=910.000\fR
Record an ATIS message on the San Francisco International Airport (\fIKSFO\fR)
ATIS frequency (\fI118.850 MHz\fR):
$ \fBfgcom --atis=118.850 --airport=KSFO\fR
.SH "SEE ALSO"
.BR fgfs (1),
.UR http://\:wiki.flightgear.org/\:FGCom_3.0
the FlightGear wiki "FGCom 3.0" page
.UE

135
man/man1/fgelev.1 Normal file
View File

@@ -0,0 +1,135 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGELEV 1 2020-11-15 FlightGear "FlightGear man pages"
.SH NAME
fgelev \- Compute FlightGear scenery elevation for a given list of points
.SH SYNOPSIS
\fBfgelev\fR [\fB\-\-expire\fR \fInum\fR] [\fB\-\-print\-solidness\fR]
[\fB\-\-fg\-root\fR \fIrootdir\fR] [\fB\-\-fg\-scenery\fR \fIscenerydir\fR]
[--tile-file osgbfilename] [--use-vpb]
.SH DESCRIPTION
.B fgelev
is a standalone utility that, given a list of points on standard input, prints
the corresponding elevation for each of them on standard output. It can also
(optionally) print whether the material covering that point is solid or not.
The list of points must be in the following form:
\fIid lon lat\fR
where \fIid\fR is an arbitrary identifier for the point, \fIlon\fR is the
longitude of the point and \fIlat\fR is the latitude of the point. Positive
longitudes (latitudes) correspond to points located in the Eastern (Northern)
hemisphere; negative ones correspond to points located in the Western
(Southern) hemisphere.
The list of elevations returned by
.B fgelev
is in the following form:
\fIid: elev solid\fR
where \fIid\fR is the identifier of the point passed as input, \fIelev\fR is
the elevation of the point in meters (or \fB-1000\fR if the elevation of the
given point was not found) and \fIsolid\fR is:
.IP \(bu 3
the string
.B solid
if the parameter
.B \-\-print\-solidness
was passed to
.B fgelev
and the material covering the point is solid;
.IP \(bu 3
the string
.B \-
if the parameter
.B \-\-print\-solidness
was passed to
.B fgelev
and the material covering the point is not solid;
.IP \(bu 3
absent if the parameter
.B \-\-print\-solidness
was not passed to \fBfgelev\fR.
.SH OPTIONS
.TP
\fB\-\-expire\fR \fInum\fR
To speed up elevation data retrieval,
.B fgelev
uses an internal cache. This option lets the user specify the number of
requests after which, if a point was not queried in them, it should be marked
as expired. By default,
.B fgelev
expires points not queried in the last \fB10\fR requests.
.TP
\fB\-\-print\-solidness\fR
Require
.B fgelev
to print the solidness of the material covering the queried point. See the
.B DESCRIPTION
section for more details.
.TP
\fB\-\-fg\-root\fR \fIrootdir\fR
Set the FlightGear data root directory (\fB$FG_ROOT\fR) to \fIrootdir\fR. If
this option is not set,
.B fgelev
uses the path specified in the
.B FG_ROOT
environment variable or, absent that, the FlightGear data directory chosen at
the time the program was compiled.
.TP
\fB\-\-fg\-scenery\fR \fIscenerydir\fR
Set the FlightGear scenery directory (\fB$FG_SCENERY\fR) to \fIscenerydir\fR.
If this option is not set,
.B fgelev
uses the path specified in the
.B FG_SCENERY
environment variable or, absent that, the
.B Scenery
subdirectory inside \fB$FG_ROOT\fR.
.TP
\fB\-\-tile\-file\fR \fIosgbfilename\fR
Use a specific tile file when searching for elevation details, instead
of scanning through the whole world.
.TP
\fB\-\-use\-vpb\fR
If specified, enables WS3.0 scenery behaviour, searching under the vpb/
subdirectory.
.SH "EXIT STATUS"
.B fgelev
exits with
.B EXIT_SUCCESS
on success, with
.B EXIT_FAILURE
if it is unable to read data from standard input or to load the scenery.
.SH ENVIRONMENT
.IP "\fBFG_ROOT\fR" 4
If
.B FG_ROOT
is set and
.B \-\-fg\-root
is not set, it specifies the root data directory to use.
.IP "\fBFG_SCENERY\fR" 4
If
.B FG_SCENERY
is set and
.B \-\-fg\-scenery
is not set, it specifies the scenery directory to use.
.SH "SEE ALSO"
.BR fgfs (1)

853
man/man1/fgfs.1 Normal file
View File

@@ -0,0 +1,853 @@
.\" Copyright (C) 2002 Cameron Moore
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGFS 1 2017-06-25 FlightGear "FlightGear man pages"
.SH NAME
fgfs \- the FlightGear flight simulator
.SH SYNOPSIS
\fBfgfs\fR [\fIoptions...\fR]
.SH DESCRIPTION
.B fgfs
is the main executable for FlightGear, a free, open-source, multi-platform and
sophisticated flight simulator framework for the development and pursuit of
interesting flight simulator ideas.
.SH OPTIONS
Options are first read from the command-line arguments passed to \fBfgfs\fR.
The program then checks for the existence of \fI~/.fgfsrc.\fIhostname\fR (where
.I hostname
is the hostname of the machine) and of \fI~/.fgfsrc\fR; if at least one of
those files exists, it is read and parsed (see the
.BR fgfsrc (5)
man page for the full specifications of the file format).
If conflicting options are given, the ones read last will prevail.
.SS "General options"
.TP
\fB\-\-help\fR, \fB\-h\fR
Display usage information about the most relevant command-line options and
exit.
.TP
\fB\-\-verbose\fR, \fB\-v\fR
When combined with \fB\-\-help\fR/\fB\-h\fR, display usage information about
all command-line options, not just the most relevant ones.
.TP
\fB\-\-version\fR
Display version information about
.B fgfs
and some of the libraries used by the program (SimGear, OpenSceneGraph, PLIB),
then exit.
.TP
\fB\-\-fg\-root=\fIpath\fR
Set the FlightGear data root directory (\fB$FG_ROOT\fR) to \fIpath\fR. If this
option is not set,
.B fgfs
uses the path specified in the
.B FG_ROOT
environment variable or, absent that, the FlightGear data directory chosen at
the time the program was compiled.
.TP
\fB\-\-fg\-scenery=\fIpath\fR
Set the FlightGear scenery directories (\fB$FG_SCENERY\fR) to \fIpath\fR.
You can specify multiple directories by separating them with colons (\fB:\fR),
as in \fI/first/path\fB:\fI/second/path\fR (on Microsoft Windows operating
systems, multiple paths should be separated by semicolons instead): in that
case,
.B fgfs
will follow the order the paths are written in to search for scenery files,
stopping as soon as a match is found.
If this option is not set,
.B fgfs
uses the path specified in the
.B FG_SCENERY
environment variable or, absent that, the
.B Scenery
subdirectory inside \fB$FG_ROOT\fR.
.TP
\fB\-\-fg\-aircraft=\fIpath\fR
Load additional aircraft from \fIpath\fR besides the
.B Aircraft
subdirectory inside \fB$FG_ROOT\fR. Alternatively, you can use
.B \-\-aircraft\-dir
to target a specific aircraft in a given directory.
.TP
\fB\-\-download\-dir=\fIpath\fR
Store aircraft and scenery downloaded via the simulator in \fIpath\fR.
The TerraSync directory may be specifically set with the
.B \-\-terrasync\-dir
option.
.TP
\fB\-\-allow\-nasal\-read=\fIdirs\fR
Allow Nasal aircraft scripts to read files from the directories listed in
\fIdirs\fR (separate multiple paths with colons, or semicolons on Microsoft
Windows operating systems).
By default, Nasal scripts are allowed to read data only from \fB$FG_ROOT\fR
and \fB$FG_HOME\fR, as a security measure.
.TP
\fB\-\-read\-only\fR
Make \fB$FG_HOME\fR (the location where user-specific FlightGear data is
stored) read-only.
.TP
\fB\-\-language=\fIcode\fR
Set the language used by the simulator to \fIcode\fR, where \fIcode\fR is an
ISO 639-1 two-letter locale code (for example, \fBen\fR or \fBit\fR).
.TP
\fB\-\-restore\-defaults\fR
Reset all user settings to their defaults.
.TP
\fB\-\-enable\-save\-on\-exit\fR, \fB\-\-disable\-save\-on\-exit\fR
Save/do not save user settings when the program exits.
.TP
\fB\-\-ignore\-autosave\fR
Ignore the user settings saved the previous time FlightGear was run. This
option implies \fB\-\-disable\-save\-on\-exit\fR.
.TP
\fB\-\-browser\-app=\fIpath\fR
Use the Web browser specified in \fIpath\fR to open aircraft documentation.
.TP
\fB\-\-prop:\fR[\fItype\fB:\fR]\fIname\fB=\fIvalue\fR
Set the property \fIname\fR to \fIvalue\fR. You can optionally specify the
property type by setting \fItype\fR to \fBstring\fR, \fBdouble\fR, \fBfloat\fR,
\fBlong\fR, \fBint\fR or \fBbool\fR.
.TP
\fB\-\-config=\fIpath\fR
Load additional configuration directives from \fIpath\fR. The file should
follow the format described in
.BR fgfsrc (5).
.TP
\fB\-\-no\-default\-config\fR
Do not load any configuration files unless they were explicitly specified with
\fB\-\-config\fR.
.TP
\fB\-\-units\-feet\fR
Use feet as the internal measure unit for distances.
.TP
\fB\-\-units\-meters\fR
Use meters as the internal measure unit for distances.
.TP
\fB\-\-console\fR
Display a console window for simulator/aircraft debugging purposes.
This option is recognized only on Microsoft Windows operating systems; on
other systems, debug messages are always printed to standard output/standard
error.
.TP
\fB\-\-launcher\fR
Start the FlightGear Launcher, a graphical Qt-based interface to the simulator.
This option is available only if FlightGear was compiled with Qt support
enabled.
.TP
\fB\-\-json\-report\fR
Print a report in JSON format on the standard output. The report will give
useful information for debugging purposes, such as the FlightGear version,
the scenery/aircraft paths in use, the TerraSync and the data download
directories and the paths to navigation data files.
.SS Features
.TP
\fB\-\-enable\-panel\fR, \fB\-\-disable\-panel\fR
Enable/disable the pop-up aircraft instrument panel if the chosen airplane has
it.
.TP
\fB\-\-enable\-hud\fR, \fB\-\-disable\-hud\fR
Enable/disable the heads-up display (HUD) if the chosen airplane has it.
.TP
\fB\-\-enable\-anti\-alias\-hud\fR, \fB\-\-disable\-anti\-alias\-hud\fR
Enable/disable heads-up display antialiasing.
.TP
\fB\-\-enable\-hud\-3d\fR, \fB\-\-disable\-hud\-3d\fR
Enable/disable the 3D version of the heads-up display.
.TP
\fB\-\-hud\-tris\fR
Display the number of triangles rendered when painting the heads-up display.
.TP
\fB\-\-hud\-culled\fR
Display the number of triangles culled when painting the heads-up display.
.TP
\fB\-\-enable\-random\-objects\fR, \fB\-\-disable\-random\-objects\fR
Show/hide random scenery objects, such as buildings. Scenery objects increase
realism, but require more resources (memory and graphic card power).
.TP
\fB\-\-enable\-random\-vegetation\fR, \fB\-\-disable\-random\-vegetation\fR
Show/hide random vegetation.
.TP
\fB\-\-enable\-random\-buildings\fR, \fB\-\-disable\-random\-buildings\fR
Show/hide random buildings.
.TP
\fB\-\-enable\-ai\-models\fR, \fB\-\-disable\-ai\-models\fR
Enable/disable the internal AI subsystem, which is required for multiplayer
gaming, AI traffic and many other animations. \fBDisabling the internal AI
subsystem is deprecated.\fR
.TP
\fB\-\-enable\-ai\-traffic\fR, \fB\-\-disable\-ai\-traffic\fR
Enable/disable artificial plane traffic.
.TP
\fB\-\-ai\-scenario=\fIscenario\fR
Add and enable the AI scenario \fIscenario\fR. This option may be repeated
multiple times to enable multiple scenarios.
.TP
\fB\-\-enable\-freeze\fR
Start the simulator in a frozen (paused) state.
.TP
\fB\-\-disable\-freeze\fR
Start the simulator in a running (unpaused) state.
.TP
\fB\-\-enable\-fuel\-freeze\fR
Do not consume any fuel (keep its quantity in the tanks constant).
.TP
\fB\-\-disable\-fuel\-freeze\fR
Consume fuel normally.
.TP
\fB\-\-enable\-clock\-freeze\fR
Do not let the clock advance while running the simulation.
.TP
\fB\-\-disable\-clock\-freeze\fR
Let the clock advance normally.
.TP
\fB\-\-failure=pitot\fR|\fBstatic\fR|\fBvacuum\fR|\fBelectrical\fR
Fail the aircraft pitot, static, vacuum or electrical systems. This option may
be repeated multiple times to fail more than one system.
.TP
\fB\-\-load\-tape=\fItape\fR
Load and replay the flight recorder tape \fItape\fR.
.SS "Audio options"
.TP
\fB\-\-show\-sound\-devices\fR
Show a list of available audio devices and exit.
.TP
\fB\-\-sound\-device=\fIname\fR
Set the sound device to use to \fIname\fR, where
.I name
is the device name shown by the
.B \-\-show\-sound\-devices
option.
.TP
\fB\-\-enable\-sound\fR, \fB\-\-disable\-sound\fR
Enable/disable sound in the simulator.
.SS "Rendering options"
.TP
\fB\-\-terrain\-engine=tilecache\fR|\fBpagedLOD\fR
Choose the terrain engine to use. \fBtilecache\fR is the "traditional" terrain
engine (recommended); \fBpagedLOD\fR is a new, experimental terrain engine
designed to minimize memory usage by loading more detailed versions of scenery
objects on demand.
The \fBpagedLOD\fR engine is available only if FlightGear was compiled with
GDAL support.
.TP
\fB\-\-lod\-levels=\fIlevels\fR
Set the level of detail levels to \fIlevels\fR, where \fIlevels\fR is a
space\-separated list of numeric levels. This option is available only if the
terrain engine in use is \fBpagedLOD\fR.
.TP
\fB\-\-lod\-res=\fIresolution\fR
Set the terrain mesh resolution to \fIresolution\fR. This option is available
only if the terrain engine in use is \fBpagedLOD\fR.
.TP
\fB\-\-lod\-texturing=bluemarble\fR|\fBraster\fR|\fBdebug\fR
Set the terrain texture method. This option is available only if the terrain
engine in use is \fBpagedLOD\fR.
.TP
\fB\-\-lod\-range\-mult=\fImultiplier\fR
Set the range multiplier (the breakpoint from a low to a high level of detail)
to \fImultiplier\fR. This option is available only if the terrain engine in
use is \fBpagedLOD\fR.
.TP
\fB\-\-enable\-splash\-screen\fR, \fB\-\-disable\-splash\-screen\fR
Show/hide the simulator splash screen while loading the aircraft/scenery.
.TP
\fB\-\-enable\-mouse\-pointer\fR, \fB\-\-disable\-mouse\-pointer\fR
Force enable display/do not force display the mouse pointer at startup.
.TP
\fB\-\-max\-fps=\fIfrequency\fR
Limit the maximum frame rate of the simulator to \fIfrequency\fR Hz (frames per
second).
.TP
\fB\-\-bpp=\fIdepth\fR
Use a color depth of \fIdepth\fR bits per pixel to display the aircraft and
scenery.
.TP
\fB\-\-fog\-disable\fR, \fB\-\-fog\-fastest\fR, \fB\-\-fog\-nicest\fR
Choose the fog/haze rendering technique.
.B \-\-fog\-disable
will disable fog/haze entirely;
.B \-\-fog\-fastest
will explicitly ask the graphics card driver to choose the most efficient, but
possibly less accurate, fog/haze rendering algorithm;
.B \-\-fog\-nicest
will leave the algorithm choice to the driver, leading to higher quality
results.
.TP
\fB\-\-enable\-enhanced\-lighting\fR, \fB\-\-disable\-enhanced\-lighting\fR
Enable/disable enhanced runway lighting. \fBThis option is deprecated.\fR
.TP
\fB\-\-enable\-distance\-attenuation\fR, \fB\-\-disable\-distance\-attenuation\fR
Enable/disable runway light distance attenuation (the runway lights become
less intense as distance increases).
.TP
\fB\-\-enable\-horizon\-effect\fR, \fB\-\-disable\-horizon\-effect\fR
Enable/disable the celestial body growth illusion near the horizon.
.TP
\fB\-\-enable\-specular\-highlight\fR, \fB\-\-disable\-specular\-highlight\fR
Enable/disable specular reflections on textured objects.
.TP
\fB\-\-fov=\fIdegrees\fR
Set the field of view angle (FOV) to \fIdegrees\fR. High field of view angles
allow you to see a wider part of the world; low angles allow you to "zoom in"
on details.
.TP
\fB\-\-aspect\-ratio\-multiplier=\fIfactor\fR
Set the horizontal and vertical aspect ratio multiplier to \fIfactor\fR.
.TP
\fB\-\-enable\-fullscreen\fR, \fB\-\-disable\-fullscreen\fR
Enable/disable fullscreen mode.
.TP
\fB\-\-shading\-flat\fR, \fB\-\-shading\-smooth\fR
Use flat/smooth shading. If flat shading is active, the simulator uses the same
color to paint the face of an object: this is faster, but makes edges more
pronounced. Smooth shading smooths color changes between vertices, leading to
higher-quality results, at an expense in performance.
.TP
\fB\-\-materials\-file=\fIfile\fR
Load the definitions of the materials used to render the scenery from
\fIfile\fR. By default, materials are loaded from
\fI$FG_ROOT/regions/materials.xml\fR.
.TP
\fB\-\-texture\-filtering=\fIvalue\fR
Set the anisotropic texture filtering to \fIvalue\fR. The acceptable values are
\fB1\fR (default), \fB2\fR, \fB4\fR, \fB8\fR or \fB16\fR.
.TP
\fB\-\-enable\-wireframe\fR, \fB\-\-disable\-wireframe\fR
Enable/disable the wireframe drawing mode (in which only object edges are
painted).
.TP
\fB\-\-geometry=\fIwidth\fBx\fIheight\fR
Set the window geometry (size) to \fIwidth\fBx\fIheight\fR (both \fIwidth\fR
and \fIheight\fR are in pixels).
.TP
\fB\-\-view\-offset=LEFT\fR|\fBRIGHT\fR|\fBCENTER\fR|\fIvalue\fR
Specify the default forward view direction as an offset from straight ahead.
The allowed values are \fBLEFT\fR (-90°), \fBRIGHT\fR (90°), \fBCENTER\fR (0°)
or a specific number in degrees.
.SS "Aircraft options"
.TP
\fB\-\-aircraft=\fIname\fR, \fB\-\-vehicle=\fIname\fR
Load an aircraft/vehicle from a set file named \fRname\fI\-set.xml\fR. The file
is searched for in \fI$FG_ROOT/Aircraft\fR, in the directory pointed to by the
environment variable \fBFG_AIRCRAFT\fR and in the directories passed to
.BR fgfs (1)
using the \fB\-\-fg\-aircraft\fR option.
.TP
\fB\-\-aircraft\-dir=\fIpath\fR
Explicitly specify the directory in which the \fB\-set.xml\fR file should be
searched for. If this argument is used, the path cache stored in
\fI~/.fgfs/autosave_X_Y.xml\fR, the directories passed with the
\fB\-\-fg\-aircraft\fR option and the directory specified in the
\fBFG_AIRCRAFT\fR environment variable are not taken into account.
.TP
\fB\-\-show\-aircraft\fR
Print a list of available aircraft and exit.
.TP
\fB\-\-min\-status=alpha\fR|\fBbeta\fR|\fBearly-production\fR|\fBproduction\fR
Do not list aircraft having a status level (development status) lower than the
one specified. See
.UR http://\:wiki.flightgear.org/\:Aircraft_rating_system
the FlightGear wiki "Aircraft rating system" page
.UE
for an extended description of aircraft ratings.
.TP
\fB\-\-fdm=jsb\fR|\fBlarcsim\fR|\fByasim\fR|\fBmagic\fR|\fBballoon\fR|\fBada\fR|\fBexternal\fR|\fBnull\fR
Select the core flight dynamics model to use among the following ones:
.RS 7
.IP \(bu 3
\fBjsb\fR: the
.UR http://\:www.jsbsim.org/
JSBSim flight dynamics model
.UE ,
which takes a data\-driven approach to modeling: given the performance data for
an aircraft (mass and balance, ground reactions, propulsions, aerodynamics...),
it assembles it together to produce the global aircraft dynamics;
.IP \(bu 3
\fBlarcsim\fR: the
.UR http://\:www.jsbsim.org/
LaRCsim flight dynamics model
.UE ,
the original model used in FlightGear up to 2000, developed at NASA, now
inactive;
.IP \(bu 3
\fByasim\fR: the
.UR http://\:wiki.flightgear.org/\:YASim
YASim flight dynamics model
.UE ,
which, given the physical and flying characteristics of an aircraft, attempts
to solve for them;
.IP \(bu 3
\fBmagic\fR: the "Magic Carpet" flight model;
.IP \(bu 3
\fBballoon\fR: a hot air balloon simulation;
.IP \(bu 3
\fBada\fR: an externally-driven flight dynamics model designed by the
Aeronautical Development Agency of Bangalore, India;
.IP \(bu 3
\fBexternal\fR/\fBnull\fR: use an external flight dynamics model (the
\fBexternal\fR option has the same meaning as \fBnull\fR and is maintained for
backward compatibility purposes).
.RE
.TP
\fB\-\-aero=\fIname\fR
Load the aircraft aerodynamics model from the file \fRname\fI.xml\fR in the
aircraft directory.
.TP
\fB\-\-model\-hz=\fIn\fR
Run the flight dynamics model at a frequency of \fIn\fR Hz (\fIn\fR times per
second).
.TP
\fB\-\-speed=\fIn\fR
Run the flight dynamics model \fIn\fR times faster than real time.
.TP
\fB\-\-trim\fR, \fB\-\-notrim\fR
Trim/do not attempt to trim the model. This option is only valid if the flight
dynamics module in use is JSBSim.
.TP
\fB\-\-on\-ground\fR
Start the aircraft on the ground. This is the default option.
.TP
\fB\-\-in\-air\fR
Start the aircraft in the air. This option is implied if \fB\-\-altitude\fR
is specified.
.TP
\fB\-\-enable\-auto\-coordination\fR, \fB\-\-disable\-auto\-coordination\fR
Enable/disable auto coordination (joint control of rudder and ailerons).
.TP
\fB\-\-livery=\fIname\fR
Load the aircraft livery from a file named \fIname\fR.
.TP
\fB\-\-state=\fIvalue\fR
Set the initial aircraft state to \fIvalue\fR. The states that can be used are
aircraft\-dependent.
.SS "Time options"
.TP
\fB\-\-timeofday=real\fR|\fBdawn\fR|\fBmorning\fR|\fBnoon\fR|\fBafternoon\fR|\fBdusk\fR|\fBevening\fR|\fBmidnight\fR
Start the simulator at the specified time of day:
.RS 7
.IP \(bu 3
\fBreal\fR: real clock time;
.IP \(bu 3
\fBdawn\fR: the time when the Sun is 90° E on the horizon;
.IP \(bu 3
\fBmorning\fR: the time when the Sun is 75° E on the horizon;
.IP \(bu 3
\fBnoon\fR: the time when the Sun is 0° on the horizon;
.IP \(bu 3
\fBafternoon\fR: the time when the Sun is 75° W on the horizon;
.IP \(bu 3
\fBdusk\fR: the time when the Sun is 90° W on the horizon;
.IP \(bu 3
\fBevening\fR: the time when the Sun is 100° W on the horizon;
.IP \(bu 3
\fBmidnight\fR: the time when the Sun is 180° on the horizon.
.RE
.TP
\fB\-\-season=summer\fR|\fBwinter\fR
Load summer/winter textures.
.TP
\fB\-\-time\-offset=\fR[\fB+\fR|\fB-\fR]\fIhh\fB:\fImm\fB:\fIss\fR
Add a time offset to the startup time specified with the \fB\-\-timeofday\fR
option.
.TP
\fB\-\-time\-match\-real\fR
Synchronize the simulator time with real world GMT time.
.TP
\fB\-\-time\-match\-local\fR
Synchronize the simulator time with real world local time.
.TP
\fB\-\-start\-date\-sys=\fIyyyy\fB:\fImm\fB:\fIdd\fB:\fIhh\fB:\fImm\fB:\fIss\fR
Specify the simulator starting date and time with respect to the local timezone
of the system.
.TP
\fB\-\-start\-date\-gmt=\fIyyyy\fB:\fImm\fB:\fIdd\fB:\fIhh\fB:\fImm\fB:\fIss\fR
Specify the simulator starting date and time with respect to the Greenwich Mean
Time.
.TP
\fB\-\-start\-date\-lat=\fIyyyy\fB:\fImm\fB:\fIdd\fB:\fIhh\fB:\fImm\fB:\fIss\fR
Specify the simulator starting date and time with respect to the timezone of
the starting airport.
.SS "Initial position and orientation"
.TP
\fB\-\-airport=\fIID\fR
Start the simulator at the airport having \fIID\fR as its ICAO code.
.TP
\fB\-\-parking\-id=\fIname\fR
Place the aircraft at the parking position \fIname\fR. This option requires the
\fB\-\-airport\fR option to be present.
.TP
\fB\-\-runway=\fInumber\fR
Place the aircraft on runway \fInumber\fR. This option requires the
\fB\-\-airport\fR option to be present.
.TP
\fB\-\-carrier=\fIname\fR|\fIID\fR
Place the aircraft on the AI carrier named \fIname\fR/having the ID \fIID\fR.
.TP
\fB\-\-parkpos=\fIname\fR
Place the aircraft at the starting position \fIname\fR. This option requires
the \fB\-\-carrier\fR option to be present.
.TP
\fB\-\-vor=\fIID\fR
Place the aircraft over the VOR \fIID\fR.
.TP
\fB\-\-vor\-frequency=\fIfrequency\fR
Set the frequency of the VOR to \fIfrequency\fR. This option requires the
\fB\-\-vor\fR option to be present.
.TP
\fB\-\-ndb=\fIID\fR
Place the aircraft over the NDB \fIID\fR.
.TP
\fB\-\-ndb\-frequency=\fIfrequency\fR
Set the frequency of the NDB to \fIfrequency\fR. This option requires the
\fB\-\-ndb\fR option to be present.
.TP
\fB\-\-fix=\fIID\fR
Place the aircraft over the fix \fIID\fR.
.TP
\fB\-\-offset\-distance=\fInm\fR
Place the aircraft \fInm\fR statute miles away from the reference point
specified by the previous options.
.TP
\fB\-\-offset\-azimuth=\fIdegrees\fR
Place the aircraft at a heading of \fIdegrees\fR degrees with respect to the
reference point specified by the previous options.
.TP
\fB\-\-lon=\fIdegrees\fR, \fB\-\-lat=\fIdegrees\fR
Place the aircraft at the point with the coordinates (\fIlat\fR, \fIlon\fR).
Northern longitudes/eastern latitudes must be positive; southern
longitudes/western latitudes must be negative.
.TP
\fB\-\-altitude=\fIvalue\fR
Place the aircraft at an altitude of \fIvalue\fR feet (meters if the
\fB\-\-units\-meters\fR option was specified).
.TP
\fB\-\-heading=\fIdegrees\fR
Specify the initial heading (yaw) angle (psi) of the aircraft.
.TP
\fB\-\-roll=\fIdegrees\fR
Specify the initial roll angle (phi) of the aircraft.
.TP
\fB\-\-pitch=\fIdegrees\fR
Specify the initial pitch angle (theta) of the aircraft.
.TP
\fB\-\-uBody=\fIunits_per_sec\fR
Specify the initial velocity along the body X axis.
.TP
\fB\-\-vBody=\fIunits_per_sec\fR
Specify the initial velocity along the body Y axis.
.TP
\fB\-\-wBody=\fIunits_per_sec\fR
Specify the initial velocity along the body Z axis.
.TP
\fB\-\-vNorth=\fIunits_per_sec\fR
Specify the initial velocity along the body North-South axis.
.TP
\fB\-\-vEast=\fIunits_per_sec\fR
Specify the initial velocity along the body West-East axis.
.TP
\fB\-\-vDown=\fIunits_per_sec\fR
Specify the initial velocity along the body vertical axis.
.TP
\fB\-\-vc=\fIknots\fR
Set the initial airspeed of the aircraft to \fIknots\fR knots.
.TP
\fB\-\-mach=\fInumber\fR
Set the initial airspeed of the aircraft to Mach \fInumber\fR.
.TP
\fB\-\-glideslope=\fIdegrees\fR
Set the flight path angle to \fIdegrees\fR degrees. The value can be positive.
.TP
\fB\-\-roc=\fIfpm\fR
Set the initial rate of climb to \fIfpm\fR feet per minute. The value can be
negative.
.SS "Route/waypoint options"
.TP
\fB\-\-wp=\fIID\fR[\fB@\fIalt\fR]
Enter the waypoint (VOR, NDB, fix) \fIID\fR into the autopilot. The optional
part \fB@\fIalt\fR can be used to specify the altitude at which \fIID\fR
should be crossed.
.TP
\fB\-\-flight\-plan=\fIfile\fR
Read a flight plan from \fIfile\fR.
.SS "Avionics options"
.TP
\fB\-\-com1=\fIfrequency\fR
Set the COM1 frequency to \fIfrequency\fR MHz.
.TP
\fB\-\-com2=\fIfrequency\fR
Set the COM2 frequency to \fIfrequency\fR MHz.
.TP
\fB\-\-nav1=\fR[\fIradial\fB:\fR]\fIfrequency\fR
Set the NAV1 frequency to \fIfrequency\fR MHz. You can optionally specify a
radial by prefixing the frequency with the heading and a colon.
.TP
\fB\-\-nav2=\fR[\fIradial\fB:\fR]\fIfrequency\fR
Set the NAV2 frequency to \fIfrequency\fR MHz. You can optionally specify a
radial by prefixing the frequency with the heading and a colon.
.TP
\fB\-\-adf1=\fR[\fIrotation\fB:\fR]\fIfrequency\fR, \fB\-\-adf=\fR[\fIrotation\fB:\fR]\fIfrequency\fR
Set the ADF1 frequency to \fIfrequency\fR kHz. You can optionally specify the
rotation angle of its compass card by prefixing the frequency with the angle and
a colon. \fBThe \-\-adf option is deprecated.\fR
.TP
\fB\-\-adf2=\fR[\fIrotation\fB:\fR]\fIfrequency\fR
Set the ADF2 frequency to \fIfrequency\fR kHz. You can optionally specify the
rotation angle of its compass card by prefixing the frequency with the angle and
a colon.
.TP
\fB\-\-dme=nav1\fR|\fBnav2\fR|\fIfrequency\fR
Slave the automatic direction finder to the NAV1/NAV2 radio or set its internal
frequency to \fIfrequency\fR.
.SS "Environment options"
.TP
\fB\-\-metar=\fIMETAR\fR
Simulate the weather conditions described by the METAR string \fIMETAR\fR. This
option implies \fB\-\-disable\-real\-weather\-fetch\fR.
.TP
\fB\-\-enable\-real\-weather\-fetch\fR, \fB\-\-disable\-real\-weather\-fetch\fR
Enable/disable METAR-based real weather fetching. This feature requires an
active Internet connection.
.TP
\fB\-\-enable\-clouds\fR, \fB\-\-disable\-clouds\fR
Enable/disable 2D (flat) cloud layers.
.TP
\fB\-\-enable\-clouds3d\fR, \fB\-\-disable\-clouds3d\fR
Enable/disable 3D (volumetric) cloud layers.
.TP
\fB\-\-visibility=\fImeters\fR
Set the initial visibility to \fImeters\fR meters.
.TP
\fB\-\-visibility\-miles=\fImiles\fR
Set the initial visibility to \fImiles\fR miles.
.TP
\fB\-\-wind=\fIdir\fR[\fB:\fImaxdir\fR]\fB@\fIspeed\fR[\fB:\fIgust\fR]
Specify the direction the wind blows from (\fIdir\fR) and its speed (\fIspeed\fR
knots). If the wind is not meant to blow from a fixed direction, but rather
from a range of directions, specify the range as \fIdir\fB:\fImaxdir\fR, where
\fIdir\fR and \fImaxdir\fR are the minimum and maximum angles in degrees. If
you want the simulator to model wind gusts as well, set \fIgust\fR to their
maximum intensity in knots.
.TP
\fB\-\-random\-wind\fR
Randomize the direction and speed of the wind.
.TP
\fB\-\-turbulence=\fIintensity\fR
Set the turbulence intensity to \fIintensity\fR. The intensity can range from
\fB0.0\fR (calm) to \fB1.0\fR (severe).
.TP
\fB\-\-ceiling=\fIft_asl\fR[\fB:\fIthickness_ft\fR]
Create an overcast ceiling at a height of \fIft_asl\fR feet above the mean sea
level. You can optionally specify a thickness by appending a colon (\fB:\fR)
and the desired thickness in feet; if you omit it, the simulator will default
to 2000 ft.
.SS "Network options"
.TP
\fB\-\-callsign=\fIvalue\fR
Set the multiplayer callsign to \fIvalue\fR. The callsign must be at most ten
characters long and must contain only numbers, letters of the English alphabet,
dashes (\fB\-\fR) and underscores (\fB_\fR); longer callsigns are truncated,
and characters not matching those listed above are replaced with dashes.
.TP
\fB\-\-multiplay=\fR{\fBin\fR|\fBout\fR}\fB,\fIhz\fB,\fIaddress\fB,\fIport\fR
Specify the multiplayer communication settings.
The first field specifies whether the settings apply to inbound (\fBin\fR) or
outbound (\fBout\fR) communications. The second field (\fIhz\fR) specifies the
frequency (in Hz, times per second) at which data should be sent. The third
field (\fIaddress\fR) must be set to the IP address of the network interface
that FlightGear should use to send/receive data, or left blank to let the
simulator use all available interfaces. The fourth field (\fIport\fR) should be
set to the port to use (usually \fB5000\fR).
.TP
\fB\-\-proxy=\fR[\fIusername\fB:\fIpassword\fB@\fR]\fIhost\fB:\fIport\fR
Specify the proxy server and port to use. The username and password are
optional; if they are present, they should be given as MD5 hashes.
This option is only useful if \fB\-\-real\-weather\-fetch\fR is enabled.
.TP
\fB\-\-httpd=\fR[\fIaddress\fB:\fR]\fIport\fR
Enable the Phi interface (HTTP server) on the specified address and port. The
address is optional.
.TP
\fB\-\-telnet=\fIport\fR
Enable the Telnet interface on the specified port.
.TP
\fB\-\-jpg\-httpd=\fIport\fR
Enable the screenshot HTTP server interface on the specified port. \fBThis
option is deprecated: use the Phi interface instead.\fR
.TP
\fB\-\-enable\-terrasync\fR, \fB\-\-disable\-terrasync\fR
Enable/disable automatic scenery/object downloads.
.TP
\fB\-\-terrasync\-dir=\fIdirectory\fR
Set the directory where the downloaded scenery will be stored to
\fIdirectory\fR.
.TP
\fB\-\-enable\-fgcom\fR, \fB\-\-disable\-fgcom\fR
Enable/disable the FGCom (voice ATC) integration.
.SS "I/O options"
.TP
\fB\-\-generic=\fIparams\fR, \fB\-\-atlas=\fIparams\fR, \fB\-\-atcsim=\fIparams\fR, \fB\-\-AV400=\fIparams\fR, \fB\-\-AV400Sim=\fIparams\fR, \fB\-\-AV400WSimA=\fIparams\fR, \fB\-\-AV400WSimB=\fIparams\fR, \fB\-\-garmin=\fIparams\fR, \fB\-\-hla=\fIparams\fR, \fB\-\-hla\-local=\fIparams\fR, \fB\-\-igc=\fIparams\fR, \fB\-\-joyclient=\fIparams\fR, \fB\-\-jsclient=\fIparams\fR, \fB\-\-native\-ctrls=\fIparams\fR, \fB\-\-native\-gui=\fIparams\fR, \fB\-\-native\-fdm=\fIparams\fR, \fB\-\-native=\fIparams\fR, \fB\-\-nmea=\fIparams\fR, \fB\-\-opengc=\fIparams\fR, \fB\-\-props=\fIparams\fR, \fB\-\-pve=\fIparams\fR, \fB\-\-ray=\fIparams\fR, \fB\-\-rul=\fIparams\fR
Open a connection to drive external programs or hardware.
Specify the protocol by using the correct command\-line option:
.RS 7
.IP \(bu 3
\fBgeneric\fR: a predefined communication interface and a preselected
communication protocol;
.IP \(bu 3
\fBatlas\fR: the Atlas protocol;
.IP \(bu 3
\fBatcsim\fR: the ATCsim (atc610x) protocol;
.IP \(bu 3
\fBAV400\fR: the Garmin AV400 protocol, required to drive a Garmin 196/296
series GPS;
.IP \(bu 3
\fBAV400Sim\fR: the set of AV400 strings required to drive a Garmin 400-series
GPS;
.IP \(bu 3
\fBAV400WSimA\fR, \fBAV400WSimB\fR: the set of strings required to drive a
Garmin WAAS GPS (where the \fBA\fR channel uses a variant of the AVSim400
protocol and the \fBB\fR channel communicates with the GPS unit);
.IP \(bu 3
\fBgarmin\fR: the Garmin GPS protocol;
.IP \(bu 3
\fBhla\fR, \fBhla\-local\fR: the HLA protocol, either remote or local;
.IP \(bu 3
\fBigc\fR: the International Glider Commission protocol;
.IP \(bu 3
\fBjoyclient\fR: the protocol used by Agwagon joysticks;
.IP \(bu 3
\fBnative\-ctrls\fR: the FlightGear Native Controls protocol;
.IP \(bu 3
\fBnative\-gui\fR: the FlightGear Native GUI protocol;
.IP \(bu 3
\fBnative\-fdm\fR: the FlightGear Native FDM protocol;
.IP \(bu 3
\fBnative\fR: the FlightGear Native protocol;
.IP \(bu 3
\fBnmea\fR: the NMEA protocol (used to drive most GPS units);
.IP \(bu 3
\fBopengc\fR: the protocol used by OpenGC, a software used to render
high\-quality glass cockpit displays for simulated flightdecks;
.IP \(bu 3
\fBprops\fR: the interactive property manager protocol;
.IP \(bu 3
\fBpve\fR: the PVE protocol;
.IP \(bu 3
\fBray\fR: the Ray Woodworth motion chair protocol;
.IP \(bu 3
\fBrul\fR: the RUL protocol.
.RE
.RS 7
The parameters (\fIparams\fR) must be in the form
\fImedium\fB,\fIdirection\fB,\fIhz\fB,\fImedium_options\fR where \fImedium\fR
is the medium used by the protocol (\fBserial\fR, \fBsocket\fR, \fBfile\fR...),
\fIdirection\fR is the communication direction (\fBin\fR, \fBout\fR or
\fBbi\fR), \fIhz\fR is the frequency the channel should be processed at
(floating point values are accepted) and \fImedium_options\fR are:
.RE
.RS 7
.IP \(bu 3
for serial protocols, \fIdevice\fB,\fIbaud\fR, where \fIdevice\fR is the device
name to be opened and \fIbaud\fR is the communication baud rate;
.IP \(bu 3
for socket protocols, \fImachine\fB,\fIport\fB,\fIstyle\fR, where \fImachine\fR
is the machine name or the IP address of the server (if the simulator should
act as a client) or is left empty (if the simulator should act as a server),
\fIport\fR is the port to use (or is left empty to ask the operating system to
choose an available port) and \fIstyle\fR is \fBtcp\fR or \fBudp\fR;
.IP \(bu 3
for file protocols, \fIfilename\fR, where \fIfilename\fR is the name of the
file data should be written to.
.RE
.SS "Debugging options"
.TP
\fB\-\-enable\-fpe\fR
Abort when a floating\-point exception is encountered.
.TP
\fB\-\-fgviewer\fR
View the scenery and the aircraft in a simple model viewer, without loading the
entire simulator.
.TP
\fB\-\-log\-level=bulk\fR|\fBdebug\fR|\fBinfo\fR|\fBwarn\fR|\fBalert\fR
Set the minimum logging level. Log messages having a severity greater than or
equal to the specified value are recorded; the others are discarded.
.TP
\fB\-\-log\-class=all\fR|\fBnone\fR|\fBai\fR|\fBenvironment\fR|\fBflight\fR|\fBgeneral\fR|\fBio\fR|\fBnetwork\fR|\fBsound\fR|\fBterrain\fR|...
Log only events belonging to the specified log classes (\fBall\fR logs all
events, \fBnone\fR logs none). Multiple classes can be specified by separating
them with commas or pipes, for example: \fB\-\-log\-class=ai,flight\fR.
.TP
\fB\-\-log\-dir=\fIdir\fR
Save the logs in the directory \fIdir\fR. If \fIdir\fR is \fBdesktop\fR, the
logs are saved on the Desktop. This option may be given several times, using a
different directory each time. Inside the specified directory, the log file
will be named \fIFlightGear_\fRYYYY\fI-\fRMM\fI-\fRDD\fI_\fRnum\fI.log\fR,
where \fIYYYY-MM-DD\fR is the current date and \fInum\fR is a progressive
number starting at \fB0\fR.
.TP
\fB\-\-trace\-read=\fIproperty\fR, \fB\-\-trace\-write=\fIproperty\fR
Trace the reads/writes for a property (print a log message whenever
\fIproperty\fR is read from/written to).
.TP
\fB\-\-developer\fR
Enable developer mode.
.SH "EXIT STATUS"
.B fgfs
exits with
.B 0
if the execution completes successfully, or with another status (usually
.B 1
or \fB-1\fR) if an error occurred.
.SH ENVIRONMENT
.IP "\fBCOMPUTERNAME\fR" 4
Specifies the hostname of the system in use. This environment variable is only
taken into account on Microsoft Windows operating systems.
.IP "\fBFG_AIRCRAFT\fR" 4
Specifies the path in which aircraft should be searched for.
.IP "\fBFG_LAUNCHER\fR" 4
If this environment variable is set and is not \fB0\fR, the Qt launcher will be
shown. The variable is mainly used on Mac OS X operating systems to avoid the
use of wrapper scripts.
.IP "\fBFG_ROOT\fR" 4
Specifies the root data directory to use.
.IP "\fBFG_SCENERY\fR" 4
Specifies the scenery directory to use.
.IP "\fBHTTP_PROXY\fR" 4
Specifies the HTTP proxy to use. Must be in the form \fBhttp://host:port/\fR.
.IP "\fBLANG\fR" 4
Specifies the language to use.
.SH FILES
.IP "\fI~/.fgfs\fR" 4
The main directory where FlightGear configuration files and data (downloaded
aircraft/scenery) are stored.
.IP "\fI~/.fgfsrc.hostname\fR, \fI~/.fgfsrc\fR" 4
Configuration files containing command-line options for
.BR fgfs (1).

67
man/man1/fgjs.1 Normal file
View File

@@ -0,0 +1,67 @@
.\" Copyright (C) 2002 Cameron Moore
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGJS 1 2017-06-04 FlightGear "FlightGear man pages"
.SH NAME
fgjs \- FlightGear joystick utility
.SH SYNOPSIS
\fBfgjs\fR [\fB\-\-help\fR] [\fB\-\-fg\-root=\fIrootdir\fR]
.SH DESCRIPTION
.B fgjs
is a joystick utility for the FlightGear flight simulator which allows you to
generate a configuration file for your joystick interactively.
To use it, launch the program with your joystick(s) connected. The utility will
first prompt you to move each joystick around in the \fIdead band\fR, that is,
the area where it is centered and should not generate any input. Afterwards,
you will be asked to move the control/push the button you would like to use for
each function.
The configuration will be saved in the current working directory in several
files named \fIjsI.xml\fR, where \fII\fR is the progressive number assigned to
each detected joystick. You will need to move them to
.I ~/.fgfs/Input/Joysticks
for them to be used by FlightGear.
.SH OPTIONS
.TP
\fB\-\-help\fR
Display usage information and exit.
.TP
\fB\-\-fg\-root=\fIrootdir\fR
Set the FlightGear data root directory (\fB$FG_ROOT\fR) to \fIrootdir\fR.
.SH ENVIRONMENT
.IP "\fBFG_ROOT\fR" 4
If
.B FG_ROOT
is set and
.B \-\-fg\-root
is not set, it specifies the root data directory to use.
.SH FILES
.IP "\fI~/.fgfsrc.hostname\fR, \fI~/.fgfsrc\fR" 4
Configuration files containing command-line options for
.BR fgfs (1).
The
.B \-\-fg\-root
command-line option is searched there if it is not passed as a command-line
argument to \fBfgjs\fR.
.SH "SEE ALSO"
.BR fgfs (1),
.BR js_demo (1),
.UR http://\:wiki.flightgear.org/\:Joystick
the FlightGear wiki "Joystick" page
.UE

44
man/man1/fgpanel.1 Normal file
View File

@@ -0,0 +1,44 @@
.\" Copyright (C) 2011 Thorsten Brehm
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGPANEL 1 2017-02-26 FlightGear "FlightGear man pages"
.SH NAME
fgpanel \- FlightGear Flight Simulator Panel Rendering Engine
.SH SYNOPSIS
\fBfgpanel\fR \fB\-\-panel=\fIfile\fR [\fB\-\-fg-root=\fIpath\fR]
[\fB\-\-prop:\fIname\fB=\fIvalue\fR]
.SH DESCRIPTION
.B fgpanel
is a free, open-source, multi-platform, and lightweight panel rendering engine
to draw 2D panels on a low-cost computer/graphic card without 3D acceleration
at reasonable frame rates.
.SH OPTIONS
.TP
\fB\-\-panel=\fIfile\fR
Display the panel description file \fIfile\fR.
.TP
\fB\-\-fg\-root=\fIpath\fR
Set the FlightGear data root directory (\fB$FG_ROOT\fR) to \fIpath\fR.
.TP
\fB\-\-prop:\fIname\fB=\fIvalue\fR
Set the property named \fIname\fR to \fIvalue\fR.
.SH "SEE ALSO"
.BR fgfs (1),
.UR http://\:wiki.flightgear.org/\:FGPanel
the FlightGear wiki "FGPanel" page
.UE

37
man/man1/fgqcanvas.1 Normal file
View File

@@ -0,0 +1,37 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGQCANVAS 1 2017-02-28 FlightGear "FlightGear man pages"
.SH NAME
fgqcanvas \- A Qt-based remote canvas application for FlightGear
.SH SYNOPSIS
\fBfgqcanvas\fR
.SH DESCRIPTION
.B fgqcanvas
is a Qt-based application that can connect to any FlightGear instance having
the built-in HTTPD server enabled and display any canvas in real time.
.PP
To use \fBfgqcanvas\fR, start it and enter the URL to the HTTP websocket, such
as \fIws://localhost:8080/PropertyTreeMirror\fR, then enter the canvas path
you would like to display, such as \fI/canvas/by-index/texture[0]/\fR.
.SH "EXIT STATUS"
.B fgqcanvas
exits with
.B 0
on success, with an exit code other than zero if an error occurs.
.SH "SEE ALSO"
.BR fgfs (1)

91
man/man1/fgviewer.1 Normal file
View File

@@ -0,0 +1,91 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGVIEWER 1 2017-06-25 FlightGear "FlightGear man pages"
.SH NAME
fgviewer \- An alternative FlightGear viewer application
.SH SYNOPSIS
\fBfgviewer\fR [\fB\-\-fg\-root\fR \fIrootdir\fR]
[\fB\-\-fg\-scenery\fR \fIscenerydir\fR] [\fB\-\-config\fR \fIconfigfile\fR]
[\fB\-\-prop\fR \fIproperty\fR \fIvalue\fR] [\fB\-\-renderer\fR \fIrend\fR]
[\fB\-\-hla\fR] [\fB\-\-federation\fR \fIfed\fR]
.SH DESCRIPTION
.B fgviewer
is a viewer application that allows you to examine FlightGear scenery and
objects without starting
.BR fgfs (1).
.SH OPTIONS
.TP
\fB\-\-fg\-root\fR \fIrootdir\fR
Set the FlightGear data root directory (\fB$FG_ROOT\fR) to \fIrootdir\fR. If
this option is not set,
.B fgviewer
uses the path specified in the
.B FG_ROOT
environment variable or, absent that, the FlightGear data directory chosen at
the time the program was compiled.
.TP
\fB\-\-fg\-scenery\fR \fIscenerydir\fR
Set the FlightGear scenery directory (\fB$FG_SCENERY\fR) to \fIscenerydir\fR.
If this option is not set,
.B fgviewer
uses the path specified in the
.B FG_SCENERY
environment variable or, absent that, the
.B Scenery
subdirectory inside \fB$FG_ROOT\fR.
.TP
\fB\-\-config\fR \fIconfigfile\fR
Read configuration directives from \fIconfigfile\fR.
.TP
\fB\-\-prop\fR \fIproperty\fR \fIvalue\fR
Set the property named \fIproperty\fR to \fIvalue\fR.
.TP
\fB\-\-renderer\fR \fIrend\fR
Use the renderer named \fIrend\fR to render the scenery. This option is
currently not supported.
.TP
\fB\-\-hla\fR
Enable HLA federation.
.TP
\fB\-\-federation\fR \fIfed\fR
Enable a custom federation named \fIfed\fR.
.SH "EXIT STATUS"
.B fgviewer
exits with
.B EXIT_SUCCESS
on success, with
.B EXIT_FAILURE
if the syntax of the command-line arguments is wrong or an error occurs.
.SH ENVIRONMENT
.IP "\fBFG_ROOT\fR" 4
If
.B FG_ROOT
is set and
.B \-\-fg\-root
is not set, it specifies the root data directory to use.
.IP "\fBFG_SCENERY\fR" 4
If
.B FG_SCENERY
is set and
.B \-\-fg\-scenery
is not set, it specifies the scenery directory to use.
.SH FILES
.IP "\fI$FG_ROOT/defaults.xml\fR" 4
Default preferences file loaded on startup.
.SH "SEE ALSO"
.BR fgfs (1)

34
man/man1/js_demo.1 Normal file
View File

@@ -0,0 +1,34 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH JS_DEMO 1 2017-03-04 FlightGear "FlightGear man pages"
.SH NAME
js_demo \- Joystick demo application for FlightGear
.SH SYNOPSIS
\fBjs_demo\fR
.SH DESCRIPTION
.B js_demo
is a FlightGear utility that shows detected joysticks and provides a way to
monitor them as their axes are moved or their buttons are pressed.
.SH "EXIT STATUS"
.B js_demo
always exits with \fB0\fR.
.SH "SEE ALSO"
.BR fgfs (1),
.UR http://\:wiki.flightgear.org/\:Input_device
the FlightGear wiki "Input device" page
.UE

79
man/man1/metar.1 Normal file
View File

@@ -0,0 +1,79 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH METAR 1 2017-06-25 FlightGear "FlightGear man pages"
.SH NAME
metar \- demo METAR utility for FlightGear
.SH SYNOPSIS
\fBmetar\fR \fB\-h\fR | \fB\-\-help\fR | [\fB\-v\fR | \fB\-\-verbose\fR]
[\fB\-e\fR \fIelevation\fR | \fB\-\-elevation\fR \fIelevation\fR] [\fB\-r\fR |
\fB\-\-report\fR | \fB\-c\fR | \fB\-\-command\-line\fR] \fI<list of ICAO airport
IDs or METAR strings>\fR
.SH DESCRIPTION
.B metar
is a demo utility for FlightGear that retrieves a METAR (encoded weather
information) for one or more given airports from the Internet and displays it
in a user-readable form. Optionally, it can also print the command-line
arguments required to start
.BR fgfs (1)
at the current time and with the weather conditions in effect.
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
Display usage information and exit.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Display debugging information while performing the required operation.
.TP
\fB\-e\fR \fIelevation\fR, \fB\-\-elevation\fR \fIelevation\fR
Set the airport elevation to \fIelevation\fR meters.
.TP
\fB\-r\fR, \fB\-\-report\fR
Print the weather information on the screen in a user-readable form.
.TP
\fB\-c\fR, \fB\-\-command\-line\fR
Print the command-line arguments required to start FlightGear at the current
time and with the weather conditions in effect.
.SH "EXIT STATUS"
.B metar
exits with
.B 0
on success, with
.B 1
if the syntax of the command-line arguments is wrong or an error occurs.
.SH ENVIRONMENT
.IP "\fBHTTP_PROXY\fR" 4
Specifies the HTTP proxy to use. Must be in the form
\fBhttp://host:port/\fR.
.SH EXAMPLE
Print the current weather information for KSFO and KOAK:
$ \fBmetar KSFO KOAK\fR
Print the current weather information for KSFO, as well as the command line
arguments required to start FlightGear with the weather conditions in effect:
$ \fBmetar -c KSFO -r KSFO\fR
Print the given METAR string as a user-readable weather report:
$ \fBmetar "LOWL 161500Z 19004KT 160V240 9999 FEW035 SCT300 29/23 Q1006 NOSIG"\fR
.SH "SEE ALSO"
.BR fgfs (1),
.UR http://\:wiki.flightgear.org/\:Weather_reports
the FlightGear wiki "Weather reports" page
.UE

3
man/man5/CMakeLists.txt Normal file
View File

@@ -0,0 +1,3 @@
include(GNUInstallDirs)
install(FILES fgfsrc.5 DESTINATION ${CMAKE_INSTALL_MANDIR}/man5
COMPONENT doc)

68
man/man5/fgfsrc.5 Normal file
View File

@@ -0,0 +1,68 @@
.\" Copyright (C) 2017 Alessandro Menti
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version 2
.\" of the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.TH FGFSRC 5 2017-05-28 FlightGear "FlightGear man pages"
.SH NAME
fgfsrc \- FlightGear command-line options file
.SH DESCRIPTION
.B fgfsrc
is a file containing command-line options read by
.BR fgfs (1)
at startup. This file is meant for those people who do not use a graphical
launcher to run the simulator, so that they will be able to specify most
preferences that do not change often there (for example, custom
scenery/aircraft locations or screen size options), and only those frequently
modified (like the starting airport) on the command line.
The file must be in plain-text format and ASCII-encoded. It must contain one or
more command-line options listed in
.BR fgfs (1);
each option must be given on a separate line.
If the first non-whitespace character in a line is an octothorpe (\fB#\fR),
.BR fgfs (1)
treats the line as a comment and ignores it. Comments should not be added after
an option, because that might cause the simulator to fail under some conditions
(notably, when the command-line argument given on the line is of the form
\fB\-\-prop=\fR).
Variables in paths, like
.B $HOME
or \fB$FG_HOME\fR, are not expanded.
.SH FILES
.IP "\fI~/.fgfsrc.hostname\fR, \fI~/.fgfsrc\fR" 4
Configuration files containing command-line options for
.BR fgfs (1).
The simulator parses command-line arguments first, then
\fI~/.fgfsrc.hostname\fR (where
.I hostname
is the hostname of the machine) and then \fI~/.fgfsrc\fR, if they exist, in
that order.
.SH EXAMPLE
The following example configuration file synchronizes the simulator clock with
the local real-world time, loads real-world weather data, sets the window size
to 1024x768 and enables random scenery objects and AI traffic:
.nf
\-\-time\-match\-local
\-\-enable\-real\-weather\-fetch
\-\-geometry=1024x768
\-\-enable\-random\-objects
\-\-enable\-ai\-traffic
.fi
.SH "SEE ALSO"
.BR fgfs (1)