FGo! 1.3.0
Prosty program do uruchamiania FlightGear-a.

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

WYMAGANIA MINIMALNE

System operacyjny GNU/Linux
FlightGear
Python 2.5.2 *
TKinter
Python Imaging Library (PIL) 1.1.6 (with ImageTk module)
Tcl/Tk 8.4

* FGo! jest kompatybilne tylko z Pythonem z serii 2.x.

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

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.

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

URUCHAMIANIE

FGo! nie posiada własnego okna wyświetlającego komunikaty FlightGear-a,
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-a:

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

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

    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.

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


Ustawienia TerraSync-a:

    Ś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.

    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-a 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 FlifhtGear.

Parę opcji jest tam umieszczonych już przy pierwszym starcie programu. Więcej
przykładów można znaleźć w dokumentacji FlightGear-a, 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.

* Jeżeli w polu wyszukiwania lotnisk zostaną wpisane *tylko* wielkie litery,
  program wyszuka tylko kody ICAO zaczynające się od tych liter.
  Dla przykładu, gdy wpisane zostaną litery "EP", wyświetlona zostanie lista
  (prawie) wyłącznie lotnisk znajdujących się na terenie Polski.

* 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).

* Lista scenariuszy może zostać zamknięta środkowym przyciskiem myszki.

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

* Jeżeli pliki  apt.dat.gz uległy zmianie (jeśli dla przykładu zainstalowano
  nową wersję FlightGeara), należy użyć przycisku "Przebuduj Bazę Lotnisk".

* W katalogu "src/pics" znajduje się plik "icon.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-a 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-a 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[MAŁPA]wp[KROPKA]pl>
