FGo! - Un semplice programma con interfaccia grafica per avviare FlightGear

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

REQUISITI MINIMI

Sistema operativo GNU/Linux
FlightGear
Python 2.6.8 *
TKinter
Python Imaging Library (PIL) 1.1.6 (con il modulo ImageTk) **
Tcl/Tk 8.5

*  FGo! è compatibile solo con la serie 2.x di Python
** Non è obbligatorio avere questa libreria per utilizzare FGo!, ma 
   senza di essa le miniature degli aerei non verranno mostrate.

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

INSTALLAZIONE

Questo programma non richiede un'installazione, tuttavia Python (con Tkinter 
e i moduli PIL) e la libreria Tcl/Tk devono essere installati prima che FGo!
venga utilizzato per la prima volta. Ciascuno di essi dovrebbe essere
disponibile nelle repository. Nelle distribuzioni basate su Debian può essere
necessario installare i seguenti pacchetti: python, python-tk, python-imaging,
python-imaging-tk, tcl8.x e tk8.x.

Scegliendo semplicemente python-imaging-tk, il gestore dei pacchetti dovrebbe
includere automaticamente tutte le dipendenze necessarie.

Per Slackware GNU/Linux e i sistemi compatibili è disponibile uno SlackBuild,
il quale genera a partire dall'archivio di FGo! un pacchetto che permette una
installazione del programma integrata nel sistema. Lo SlackBuild è disponibile
sul sito http://www.slackbuilds.org. Per i sistemi Slackware standard non sono
necessari pacchetti supplementari.

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

UTILIZZO

FGo! non possiede una propria finestra per mostrare i messaggi di FlightGear,
perciò il modo migliore per avviare il programma è farlo utilizzando la linea
di comando. Aprire un terminale, andare alla directory dove l'archivio di FGo!
è stato decompresso e avviarlo utilizzando il comando "python fgo" oppure
"./fgo"; altrimenti, se il sistema offre questa possibilità, si può cliccare
semplicemente sull'icona di "fgo" e scegliere l'opzione "Esegui nel terminale".
Negli ultimi due casi assicurarsi che il file sia eseguibile.

A partire dalla versione 1.3.8 non è necessario accedere alla directory di FGo!
per poterlo utilizzare. Ora è possibile creare un link simbolico al file "fgo",
mettendolo dove si preferisce, oppure avviare il programma da una directory
qualsiasi con un comando simile a "python ~/directory_di_fgo/fgo".

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

CONFIGURAZIONE

Per poter utilizzare FGo! occorre dapprima configurarlo. Aprire la finestra
delle impostazioni (scegliere Preferenze dal menu Impostazioni) e riempire i
campi vuoti.

Impostazioni di FlightGear

    Percorso del file eseguibile - inserire il percorso del file "fgfs", o di
        "run_fgfs.sh" se si utilizzano gli script "download_and_compile.sh".

    FG_ROOT - percorso della directory principale di FlightGear.

    FG_SCENERY - percorso dello scenario. È possibile specificare più percorsi,
        separandoli tra loro col carattere ":" e ordinandoli dal livello più
	alto a quello più basso.

    Percorso aggiuntivo per gli aerei - è possibile specificare più directory
        separandole tra loro col carattere ":". Lasciare il campo vuoto se non
	si utilizzano percorsi aggiuntivi.

    Directory di lavoro - parametri facoltativi per specificare la directory di
        lavoro di FlightGear: in questa directory verranno salvati i file di
	log e gli screenshot. Se il campo è vuoto verrà utilizzata la directory
	di base dell'utente.

Impostazioni di TerraSync:

    Percorso del file eseguibile - inserire il percorso del file "terrasync", o
        di "run_terrasync.sh" nel caso in cui si stiano utilizzando gli script
	"download_and_compile.sh".

    Percorso dello scenario - la directory in cui TerraSync salva gli scenari
        scaricati.

    Porta - la porta utilizzata da TerraSync.

Altre impostazioni:

    Selezione lingua - scegliere un'altra lingua per il programma. Se nessuna
        lingua è stata selezionata verrà utilizzata quella del sistema.

    Sorgente dati degli aeroporti - selezionare la fonte dove FGo! cercherà le
        informazioni sulla posizione delle piste e dei parcheggi. Due opzioni
        sono disponibili:

        Default - FGo! mostra i numeri delle piste in base al file ~/.fgo/apt,
          generato a partire dal database FG_ROOT/Airports/apt.dat.gz. I numeri
          dei parcheggi verranno prelevati dalla directory FG_ROOT/Airports.

        Scenery - FGo! mostra i numeri delle piste in base al file ~/.fgo/apt,
          generato dal database FG_ROOT/Airports/apt.dat.gz, mentre i numeri
	  dei parcheggi verranno prelevati dalla directory FG_SCENERY/Airports
	  (o dalle directory, se sono stati definiti più percorsi).

        In generale, con l'opzione "Default" FGo! mostra gli stessi dati usati
	da FlightGear quando viene selezionata la località di partenza, mentre
	scegliendo "Scenery" FGo! cerca i dati nella directory dello scenario.
        In quest'ultimo caso si può aggiungere, nella finestra delle opzioni,
        l'argomento '--prop:/sim/paths/use-custom-scenery-data=true', per far
	sì che FlightGear utilizzi gli stessi dati.

        Se non si è sicuri su quale opzione scegliere è preferibile attenersi
	alle impostazioni predefinite.

    Aggiornamento database degli aeroporti - sono disponibili due opzioni:

        Automatico - FGo! proverà a tenere conto delle modifiche apportate al
	  file FG_ROOT/Airports/apt.dat.gz, ricostruendo quando necessario il
	  database degli aeroporti.

        Manuale - Il pulsante "Ricostruire database degli aeroporti" va
	  utilizzato ogni volta che il file FG_ROOT/Airports/apt.dat.gz è stato
	  modificato.

    Ricostruire database degli aeroporti - ricostruire il database a partire
        dal file FG_ROOT/Airports/apt.dat.gz corrente. Utile nel caso in cui il
        file apt.dat.gz sia stato aggiornato.

Per far sì che il programma funzioni correttamente, i primi tre campi devono
essere stati completati, mentre il resto è facoltativo. Al termine della
configurazione cliccare sul pulsante "Salva impostazioni". Dopo alcuni istanti,
nella finestra principale di FGo! dovrebbero apparire le liste degli aerei e
degli aeroporti disponibili.

Modifiche alle impostazioni di FlightGear vengono applicate immediatamente dopo
aver cliccato sul pulsante "Salva impostazioni", mentre cambiamenti riguardanti
TerraSync e l'impostazione della lingua richiedono il riavvio di FGo!.

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

VOCI DEL MENU PRINCIPALE

File:

    Carica - carica il file di configurazione specificato.

    Salva come... - salva le modifiche nel file di configurazione specificato.

    Salva ed esci - salva le modifiche ed esce dal programma.

    Esci - esce dal programma.

Impostazioni:

    Mostra solo gli aeroporti installati - verranno mostrati nella lista solo
        gli aeroporti presenti nello scenario installato sull'hard disk.

    Aggiorna la lista degli aeroporti installati - cerca gli scenari installati
        sull'hard disk e aggiorna la lista degli aeroporti. Funziona solo se l'
        opzione "Mostra solo gli aeroporti installati" è stata selezionata.

    Preferenze - apre la finestra delle preferenze.

Strumenti:

    METAR - mostra il rapporto METAR per l'aeroporto selezionato (o quello più
        vicino). I rapporti vengono prelevati da http://weather.noaa.gov/.

Aiuto:

    Aiuto - apre la finestra della guida di FGo!.

    Informazioni su FGo! - mostra informazioni sul programma.

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

FINESTRA DELLE OPZIONI A LINEA DI COMANDO

Nella finestra più in basso è possibile aggiungere opzioni a linea di comando
che verranno passate a FlightGear.

Alcune opzioni sono preimpostate, per altri esempi consultare la documentazione
di FlightGear o visitare la pagina Wiki:

http://wiki.flightgear.org/index.php/Command_Line_Options

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

SUGGERIMENTI

* Se la sorgente dati degli aeroporti è impostata su "Scenario", può darsi che
  le informazioni sulla posizione dei parcheggi non siano disponibili fino al
  momento in cui lo scenario corrispondente viene installato.

* È possibile iniziare un volo partendo da una portaerei. Nel pannello centrale
  cliccare sul codice ICAO dell'aeroporto (immediatamente sotto l'immagine del
  velivolo) e scegliere una delle navi disponibili. Il codice verrà sostituito
  dal nome della nave selezionata, inoltre il nome sarà evidenziato in blu per
  indicare che ci si trova in "modalità portaerei". Lo scenario corrispondente
  verrà automaticamente selezionato.
  Per scegliere di nuovo un aeroporto occorre cliccare sul nome della portaerei
  e selezionare il trattino (-).

* Nella lista "Seleziona situazione" è possibile cliccare con il tasto destro
  del mouse su una qualsiasi per leggerne la descrizione (se è disponibile).

* La risoluzione della finestra viene salvata premendo il pulsante "Salva ed
  esci".

* Se si desidera distinguere l'avviatore di FGo! dagli altri file è possibile
  sostituire l'icona predefinita con l'immagine "fgo.png" che si trova nella
  directory "fgo/data/pics".

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

DIFETTI CONOSCIUTI E LIMITI

* FGo! non verifica se TerraSync è stato realmente chiuso prima di avviarne una
  nuova istanza. Se la casella "TerraSync" è stata deselezionata e selezionata
  nuovamente entro breve tempo, nel terminale può apparire il messaggio "error
  binding to port 5501". Ciò sta a indicare che la vecchia istanza di TerraSync
  non ha ancora finito di scaricare i dati. In tal caso attendere fino a quando
  i dati sono stati scaricati e selezionare di nuovo la casella "TerraSync".

* I nomi di parcheggio molto lunghi fuoriescono dai limiti del pulsante.

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

                    Ringrazio chi utilizza questo software,
                      Robert 'erobo' Leda  <erobo@wp.pl>
