FGo! - Prosty program do uruchamiania symulatora FlightGear.

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

WYMAGANIA MINIMALNE

System operacyjny GNU/Linux
FlightGear
Python 2.6.8 *
TKinter
Python Imaging Library (PIL) 1.1.6 (z modułem ImageTk) **
Tcl/Tk 8.5

*  FGo! jest kompatybilne tylko z Pythonem z serii 2.x.
** Biblioteka ta nie jest wymagana do uruchomienia programu, jednak bez niej
   nie będą wyświetlane miniatury samolotów.

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

INSTALACJA

Program nie wymaga instalacji, lecz przed pierwszym uruchomieniem należy
upewnić się, że w systemie zostały zainstalowane następujące elementy:
interpretator Pythona (z modułami Tkinter i PIL) oraz biblioteki Tcl/Tk.
Wszystkie one powinny być dostępne w repozytoriach.
W dystrybucjach opartych na Debianie, wymagane są następujące pakiety:
python, python-tk, python-imaging, python-imaging-tk, tcl8.x i tk8.x.

W menadżerze pakietów wystarczy wybrać pakiet python-imaging-tk, reszta
zależności powinna zostać zainstalowana automatycznie razem z nim.

Dla Slackware GNU/Linux i kompatybilnych systemów jest dostępny skrypt
SlackBuild. Skrypt ten generuje pakiet, który pozwala na instalację programu
dla całego systemu. Można go pobrać pod adresem http://www.slackbuilds.org.
W standardowym systemie Slackware nie ma potrzeby instalowania dodatkowych
paczek.

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

URUCHAMIANIE

FGo! nie posiada własnego okna wyświetlającego komunikaty wysyłane przez
FlightGear, dlatego najlepiej uruchamiać program z linii poleceń. Otwórz
terminal, przejdź do katalogu do którego rozpakowałeś aplikację i uruchom FGo!
komendą "python fgo", albo "./fgo". W tym ostatnim przypadku upewnij się,
że plik "fgo" jest plikiem wykonywalnym. Jeżeli Twój manager plików oferuje
taką możliwość, możesz też po prostu kliknąć na ikonie "fgo" i w oknie
dialogowym wybrać opcję: Uruchom w terminalu.

Począwszy od wersji 1.3.0, nie trzeba już przed uruchomieniem programu
przechodzić do jego katalogu głównego. Można teraz stworzyć symboliczne
dowiązanie do pliku "fgo" i umieścić je w wygodnym miejscu, albo można też
uruchomić program z każdego położenia komendą w stylu:
python ~/katalog_główny_fgo/fgo.

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

KONFIGURACJA

Zanim będziesz mógł korzystać z programu, powinieneś go skonfigurować. Otwórz
okno preferencji (Menu Ustawienia => Preferencje) i wypełnij puste pola.

Ustawienia FlightGear:

    Ścieżka do pliku wykonywalnego - podaj ścieżkę do pliku "fgfs" 
    	lub do pliku "run_fgfs.sh", jeśli używasz skryptu 
    	download_and_compile.sh.

    FG_ROOT - ścieżka do katalogu głównego FlightGear.

    FG_SCENERY - ścieżka do scenerii. Możesz podać więcej niż jedną ścieżkę
        (rozdzieloną dwukropkiem) w kolejności od najwyższej do najniższej
        warstwy.

    Dodadkowy katalog z samolotami - ścieżka do dodatkowego katalogu z 
        samolotami. Można podać wiele, rozdzielonych dwukropkiem ścieżek. 
        Pozostaw to pole puste jeżeli nie używasz dodatkowych katalogów.

    Katalog roboczy - opcjonalny parametr określający katalog roboczy
        FlightGear. To tam będą zapisywane logi czy screenshoty. Jeżeli
        pozostawiony pusty, katalogiem roboczym będzie katalog domowy
        użytkownika.

Ustawienia TerraSync:

    Ścieżka do pliku wykonywalnego - podaj ścieżkę do pliku "terrasync", albo
        jeśli używasz skryptu download_and_compile.sh, do pliku
        "run_terrasync.sh".

    Ścieżka do scenerii - katalog, w którym program TerraSync zapisuje pobraną
        scenerię.

    Port - numer portu używanego przez TerraSync.

Różne:

    Zmień język - wybierz inny język. Jeżeli język nie został wybrany,
        program postara się wybrać język systemowy.

    Źródło danych o lotniskach - wybierz źródło danych, z którego program
        będzie czerpał dane o pasach startowych i pozycjach parkingowych.
        Są dwie opcje:

        Domyślne - FGo! będzie pokazywać dane o pasach startowych w oparciu o
            informacje zgromadzone w pliku ~/.fgo/apt, który został
            wygenerowany na podstawie informacji pochodzących z pliku
            FG_ROOT/Airports/apt.dat.gz.
            
            Informacje o parkingach zostaną pobrane z katalogu:
            FG_ROOT/AI/Airports.

        Sceneria - FGo! będzie pokazywać dane o pasach startowych w oparciu o
            informacje zgromadzone w pliku ~/.fgo/apt, który został
            wygenerowany na podstawie informacji pochodzących z pliku
            FG_ROOT/Airports/apt.dat.gz.
            
            Informacje o parkingach, zostaną pobrane z katalogu:
            FG_SCENERY/Airports - lub katalogów, jeśli zostały podane ścieżki
            do wielu scenerii.

        Podsumowując:
        Gdy zostanie wybrana opcja "Domyślne", program będzie korzystał z
        tych samych danych, z których domyślnie korzysta FlightGear.
        Tymczasem, gdy zostanie wybrana opcja "Sceneria", FGo! będzie szukało
        tych informacji bezpośrednio w scenerii. W tym ostatnim przypadku,
        można w oknie linii poleceń dodać opcję:
        --prop:/sim/paths/use-custom-scenery-data=true, aby upewnić się, że
        FlightGear także będzie pobierał informacje bezpośrednio ze scenerii.

        Jeśli nie jesteś pewny którą opcję wybrać, najlepiej pozostaw
        ustawienia domyślne.

    Aktualizowanie bazy lotnisk - dwie opcje do wyboru:
        Automatyczne - Program będzie starał się śledzić zmiany w pliku
            FG_ROOT/Airports/apt.dat.gz file i przebuduje własną bazę lotnisk
            gdy będzie to konieczne.

        Ręczne - Trzeba użyć przycisku "Przebuduj Bazę Lotnisk" za każdym 
            razem, gdy plik FG_ROOT/Airports/apt.dat.gz ulega modyfikacji.

    Przebuduj Bazę Lotnisk - zbuduj nową bazę lotnisk na podstawie danych z
        pliku: FG_ROOT/Airports/apt.dat.gz. Przycisk ten powinien zostać użyty,
        jeśli baza danych apt.dat.gz uległa zmianie.

Do poprawnego działania programu potrzebne jest wypełnienie pierwszych trzech
pól. Reszta ustawień jest opcjonalna. Po ustawieniu tego co trzeba, kliknij
przycisk "Zapisz ustawienia". Po paru chwilach, w oknie głównym powinny
pojawić listy dostępnych samolotów i lotnisk.

Zmiany ustawień dotyczących FlightGear są uwzględniane przez FGo!
natychmiast po kliknięciu przycisku "Zapisz ustawienia". Zmiany pozostałych
ustawień mogą wymagać ponownego uruchomienia programu.

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

ELEMENTY GŁÓWNEGO MENU

Plik:

    Wczytaj - wczytaj zapisany wcześniej plik konfiguracyjny.

    Zapisz jako... - zapisz aktualne ustawienia do pliku.

    Zapisz i Wyjdź - zapisz ustawienia i zamknij program.

    Zakończ - zamknij program.

Ustawienia:

    Pokaż tylko zainstalowane lotniska - na liście lotnisk będą pokazywane
        tylko lotniska zainstalowane na twardym dysku.

    Odśwież listę zainstalowanych lotnisk - przeskanuj twardy dysk w
        poszukiwaniu zainstalowanej scenerii i odśwież listę lotnisk.
        Opcja ta działa tylko w przypadku, gdy opcja "Pokaż tylko zainstalowane
        lotniska" jest aktywna.

    Preferencje - otwórz okno preferencji.

Narzędzia:

    METAR - pokaż raport pogodowy dla wybranego (lub pobliskiego) lotniska.
        Raporty te są pobierana ze strony http://weather.noaa.gov/

Pomoc:

    Pomoc - otwórz okno pomocy.

    O programie - otwórz okno z informacjami o programie.

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

OKNO LINII POLECEŃ

W oknie tekstowym umieszczonym na dole głównego okna aplikacji można wpisywać
opcje, z którymi zostanie uruchomiony FlightGear.

Parę opcji jest tam umieszczonych już przy pierwszym starcie programu. Więcej
przykładów można znaleźć w dokumentacji FlightGear, lub na wiki, pod adresem:
http://wiki.flightgear.org/index.php/Command_Line_Options

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

TIPS&TRICKS

* Jeżeli źródłem danych o lotniskach jest sceneria, to informacje o pozycjach
  parkingowych mogą być niedostępne dla wybranego lotniska do czasu
  zainstalowania odpowiedniej scenerii.

* Możesz wystartować na pokładzie lotniskowca. Kliknij na kodzie lotniska
  znajdującym się na środkowym panelu (zaraz pod obrazkiem przedstawiającym
  wybrany samolot) i wybierz któryś z dostępnych okrętów. Kod lotniska
  zostanie zastąpiony nazwą wybranej jednostki i zmieni kolor na niebieski,
  by zaznaczyć, że program znajduje się teraz w trybie wyboru lotniskowca.
  Dodatkowo, FGo! automatycznie wybierze odpowiedni dla danego okrętu
  scenariusz.
  Aby móc z powrotem startować z lotnisk, należy kliknąć nazwę lotniskowca
  i z listy która się ukaże, wybrać opcję "Żaden".

* Na liście scenariuszy można kliknąć prawym przyciskiem myszki na
  każdym z nich, aby zobaczyć jego opis (o ile opis ten jest dostępny).

* Gdy zostanie użyta opcja "Zapisz i Wyjdź", FGo! zapamięta rozmiar swojego
  okna.

* W katalogu "fgo/data/pics" znajduje się plik "fgo.png", którego można użyć 
  jako ikony dla pliku uruchamiającego program.

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

ZNANE BŁĘDY I OGRANICZENIA

* FGo! nie śledzi czy sesja TerraSync została zakończona. Gdy TerraSync
  zostanie w krótkim odstępie czasu wyłączony i ponownie wyłączony, w
  konsoli może pojawić się następujący komunikat: error binding to port 5501.
  Wskazuje on na to, że nowa sesja TerraSync nie może zostać uruchomiona
  ponieważ poprzednia sesja nie zakończyła jeszcze ściągania scenerii z
  internetu. W takiej sytuacji należy poczekać, aż download dobiegnie końca
  i ponownie zaznaczyć pole TerraSync.

* Długie nazwy pozycji parkingowych nie mieszczą się w przycisku Parking.

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

                                            Dziękuję za używanie tego programu,
                                             Robert 'erobo' Leda  <erobo@wp.pl>
