FlightGear wiki - User contributions [en]

Pl/SimpleTime

2026-06-18T12:17:33Z

PlayeRom: /* Więcej informacji */

== Przegląd ==

Funkcja "simple time" stara się zapewnić, aby połączone sesje multiplayer FlightGeara miały spójne i płynnie zmieniające się animacje, niezależnie od liczby klatek na sekundę czy opóźnień sieciowych między nimi.

Na przykład podczas tankowania w trybie multiplayer, każdy pilot będzie widział tę samą względną pozycję obydwu samolotów.

Funkcja ta jest dostępna od wersji 2024.1.

== Używanie "simple time" ==

"Simple time" można włączyć w oknie dialogowym "Tryb czasu" z menu '''Plik''' -> '''Tryb czasu''' lub z wiersza poleceń za pomocą: <code>--prop:bool:/sim/time/simple-time/enabled=true</code>.

Opcja ta nie ma żadnych ustawień konfiguracyjnych.

== Jak to działa? ==

Gdy używany jest "simple time", FlightGear zawsze dołącza do pakietów sieciowych czas UTC danego komputera. Znaczniki czasu otrzymanych pakietów zawsze będą nieco w przeszłości z powodu opóźnień w sieci, więc samoloty w trybie multiplayer są pozycjonowane przy użyciu ekstrapolacji, czyli przewidywania, gdzie będą "teraz" na podstawie tego, gdzie były jakiś czas temu, używając informacji o prędkości samolotu, także zawartej w pakietach sieciowych.

Tak więc przy uruchomionych wielu instancjach FlightGeara, tak długo jak ich zegary są zsynchronizowane z dokładnością do kilku dziesiątych sekundy (zazwyczaj za pomocą protokołu NTP (''Network Time Protocol''), który jest standardowym sposobem ustawiania przez komputery zegarów zgodnie z globalnym standardem), a opóźnienia sieciowe nie przekraczają kilku dziesiątych sekundy, każdy pilot będzie widział spójny widok wszystkich samolotów.

== Radzenie sobie z pakietami multiplayer, które nie używają "simple time" ==

Jeśli korzystamy z "simple time", ale czasy pakietów danego samolotu multiplayer nie mieszczą się w granicach sekundy lub dwóch od naszego czasu UTC, zakładamy, że samolot nie używa "simple time". Wówczas stosujemy wygładzoną wersję różnicy czasu jako kompensacji (zakładając w zasadzie zerowe opóźnienie sieci). W ten sposób samolot innego pilota sesji multiplayer, będzie się nam wydawał poruszać płynnie, ale obaj piloci prawdopodobnie nie będą widzieć samolotów w takich samych położeniach.

== Rejestrator lotu ==

Jeśli używany jest "simple time", to nagrania lotu również będą zawierać czas UTC, zarówno dla samolotu użytkownika, jak i innych samolotów multiplayer, o ile nagranie zostało wykonane za pomocą menu '''Plik''' -> '''Rejestrator lotu'''. W ten sposób nagranie może odtworzyć oryginalną pozycję słońca itd.

== Testowanie ==

Funkcję "simple time" można przetestować za pomocą skryptu <code>flightgear/scripts/python/recordreplay.py</code>.

== Więcej informacji ==

Szczegóły można znaleźć w: {{flightgear source |path=docs-mini/README-simple-time.md}}

Zobacz także instrukcję dla funkcji [[Real Time manual|"Real time"]], która jest bardziej konfigurowalnym systemem, rozwiązującym niektóre z tych samych problemów.

[[en:SimpleTime]]

Pl/SimpleTime

2026-06-18T12:16:08Z

PlayeRom: /* Przegląd */

== Przegląd ==

Funkcja "simple time" stara się zapewnić, aby połączone sesje multiplayer FlightGeara miały spójne i płynnie zmieniające się animacje, niezależnie od liczby klatek na sekundę czy opóźnień sieciowych między nimi.

Na przykład podczas tankowania w trybie multiplayer, każdy pilot będzie widział tę samą względną pozycję obydwu samolotów.

Funkcja ta jest dostępna od wersji 2024.1.

== Używanie "simple time" ==

"Simple time" można włączyć w oknie dialogowym "Tryb czasu" z menu '''Plik''' -> '''Tryb czasu''' lub z wiersza poleceń za pomocą: <code>--prop:bool:/sim/time/simple-time/enabled=true</code>.

Opcja ta nie ma żadnych ustawień konfiguracyjnych.

== Jak to działa? ==

Gdy używany jest "simple time", FlightGear zawsze dołącza do pakietów sieciowych czas UTC danego komputera. Znaczniki czasu otrzymanych pakietów zawsze będą nieco w przeszłości z powodu opóźnień w sieci, więc samoloty w trybie multiplayer są pozycjonowane przy użyciu ekstrapolacji, czyli przewidywania, gdzie będą "teraz" na podstawie tego, gdzie były jakiś czas temu, używając informacji o prędkości samolotu, także zawartej w pakietach sieciowych.

Tak więc przy uruchomionych wielu instancjach FlightGeara, tak długo jak ich zegary są zsynchronizowane z dokładnością do kilku dziesiątych sekundy (zazwyczaj za pomocą protokołu NTP (''Network Time Protocol''), który jest standardowym sposobem ustawiania przez komputery zegarów zgodnie z globalnym standardem), a opóźnienia sieciowe nie przekraczają kilku dziesiątych sekundy, każdy pilot będzie widział spójny widok wszystkich samolotów.

== Radzenie sobie z pakietami multiplayer, które nie używają "simple time" ==

Jeśli korzystamy z "simple time", ale czasy pakietów danego samolotu multiplayer nie mieszczą się w granicach sekundy lub dwóch od naszego czasu UTC, zakładamy, że samolot nie używa "simple time". Wówczas stosujemy wygładzoną wersję różnicy czasu jako kompensacji (zakładając w zasadzie zerowe opóźnienie sieci). W ten sposób samolot innego pilota sesji multiplayer, będzie się nam wydawał poruszać płynnie, ale obaj piloci prawdopodobnie nie będą widzieć samolotów w takich samych położeniach.

== Rejestrator lotu ==

Jeśli używany jest "simple time", to nagrania lotu również będą zawierać czas UTC, zarówno dla samolotu użytkownika, jak i innych samolotów multiplayer, o ile nagranie zostało wykonane za pomocą menu '''Plik''' -> '''Rejestrator lotu'''. W ten sposób nagranie może odtworzyć oryginalną pozycję słońca itd.

== Testowanie ==

Funkcję "simple time" można przetestować za pomocą skryptu <code>flightgear/scripts/python/recordreplay.py</code>.

== Więcej informacji ==

Szczegóły można znaleźć w: {{flightgear file|docs-mini/README-simple-time.md}}

Zobacz także instrukcję dla funkcji [[Real Time manual|"Real time"]], która jest bardziej konfigurowalnym systemem, rozwiązującym niektóre z tych samych problemów.

[[en:SimpleTime]]

Pl/Nowy we FlightGear

2026-06-17T17:19:40Z

PlayeRom: /* Latanie */

'''Witaj we [[FlightGear]]!''' Postaramy się pomóc Ci wzbić się w wirtualne powietrze w najkrótszym możliwym czasie. Przedstawimy Ci również niektóre funkcje tego symulatora lotu oraz kilka informacji o jego społeczności.

== Instalacja i konfiguracja ==
=== Wymagania sprzętowe ===
Aby FlightGear działał płynnie, wymaga karty graficznej ze sterownikami OpenGL 4.0 lub nowszymi. Zwykle nie stanowi to problemu, ale zapoznaj się z [[Pl/Wymagania_sprzętowe|zaleceniami sprzętowymi]], aby lepiej to zrozumieć.

=== Pobieranie FlightGeara ===
Możesz pobrać najnowsze pliki ze strony [https://www.flightgear.org/download/ Pobieranie FlightGear]. Wybierz pliki źródłowe lub binarne odpowiednie dla Twojego systemu. Dostępne są również pliki binarne {{Wikipedia|AppImage|AppImage}} dla Linuksa dla wersji 2020.3 LTS i nowszych. Większość użytkowników Linuksa odkryje, że większość dystrybucji ma spakowaną wersję FlightGeara (nazwa pakietu może brzmieć <code>fgfs</code> lub <code>flightgear</code>).

W zależności od Twoich umiejętności technicznych możesz wybrać deweloperską wersję [[Git]] FlightGeara, która zazwyczaj ma więcej funkcji i może być wymagana przez niektóre najnowsze rozwijane statki powietrzne, ale może być niestabilna i jest bardziej skomplikowana do zdobycia dla użytkowników innych niż Windows. Ogólnie rzecz biorąc, wersja deweloperska nie jest zalecana dla przeciętnego użytkownika, ale jeśli chcesz przeprowadzić kilka testów, dostępna jest wersja nocna do [https://www.flightgear.org/download/nightly/ pobrania]. Jeśli używasz kopii FlightGeara kontrolowanej przez system Git, możesz zsynchronizować swoje statki powietrzne za pomocą kontrolowanego przez system repozytorium rozwojowego statków powietrznych [[Pl/FGAddon|FGAddon]].

=== Instalacja w systemie Windows ===
Po pobraniu instalatora uruchom go i postępuj zgodnie z jego instrukcjami, aby zainstalować FlightGear.

Defender SmartScreen w systemie Windows może zablokować instalację po prostu dlatego, że plik binarny nie jest podpisany kluczem, który Microsoft uznaje. Oczywiście klucz jest płatny. W takim przypadku musimy kliknąć niepozorny link "Więcej informacji". Dopiero wtedy pojawi się przycisk "Uruchom mimo to". Możesz bezpiecznie zaufać, że nie jest to niebezpieczna aplikacja, pod warunkiem, że pobrałeś ją z oficjalnych źródeł.

Jeśli z jakiegoś powodu używasz oprogramowania antywirusowego innej firmy, może ono blokować instalację FlightGeara. Nie jest to coś, na co mamy wpływ, więc to od Ciebie zależy, jak chcesz to rozwiązać.

Za pomocą instalatora Windows możesz wybrać miejsce instalacji FlightGeara. Katalog [[Pl/$FG_ROOT|$FG_ROOT]] będzie miał ścieżkę <code><wybrany katalog>/fgdata_2024_1</code>.

=== Instalacja w systemie macOS ===
Instalacja FlightGeara w systemie macOS jest bardzo prosta. Wystarczy przeciągnąć i upuścić ikonę FlightGeara do folderu <code>/Applications</code>. To wszystko.

Gdy uruchamiasz FlightGeara po raz pierwszy, jego ikona w Docku podskakuje przez kilka sekund podczas ładowania informacji o statkach powietrznych i lotniskach. Gdy pojawi się graficzny program uruchamiający, wybierz statek powietrzny i lotnisko, a następnie kliknij "Lećmy!", aby uruchomić symulator. Możesz skonfigurować więcej opcji za pomocą graficznego programu uruchamiającego. Zobacz [http://flightgear.sourceforge.net/manual/next/pl/getstart-plch4.html#start-jak-uruchomic-program oficjalną instrukcję] po więcej szczegółów.

Jeśli chcesz uruchomić FlightGeara z wiersza poleceń, uruchom aplikację Terminal i wpisz następujące polecenia.

cd /Applications/FlightGear.app/Contents/MacOS
./fgfs --options.....

Zmienne [[Pl/$FG_ROOT|$FG_ROOT]] i [[$FG_SCENERY]] nie są ustawione w systemie macOS. Jeśli chcesz samodzielnie określić te zmienne do użycia w wierszu poleceń, uruchom następujące polecenia w aplikacji Terminal:

FG_ROOT=/Applications/FlightGear.app/Contents/Resources/data
FG_SCENERY=[[Pl/$FG_ROOT|$FG_ROOT]]/Scenery

Po uruchomieniu graficznego programu uruchamiającego będziesz mieć alias do [[Pl/$FG_ROOT|$FG_ROOT]] w ścieżce <code>$HOME/Documents/FlightGear/<version></code>, dzięki czemu możesz przeglądać folder danych za pomocą Findera.

Uwaga: Po zainstalowaniu FlightGeara użytkownicy komputerów Mac mogą zlokalizować swój folder [[Pl/$FG_ROOT|$FG_ROOT]], otwierając folder Aplikacje w Finderze, klikając prawym przyciskiem myszy FlightGear i wybierając "Pokaż zawartość pakietu". To przeniesie Cię do wnętrza folderu FlightGear. Masz teraz dostęp do wszystkich plików, w tym Data/Aircraft, aby [[Pl/Instalowanie_samolotów#macOS|zainstalować nowe statki powietrzne]].

=== Instalacja ze źródeł ===
Główny artykuł: [[Building FlightGear|Kompilacja FlightGeara]]

=== Pobieranie scenerii ===
Z FlightGearem instalowany jest ograniczony zestaw [[scenery|scenerii]]. Dla FlightGear 2024.1 składa się on z:
* obszaru wokół wyróżnionego lotniska dla tej wersji, czyli [[Keflavik_Airport|Międzynarodowego Portu Lotniczego Keflavik]] (BIKF)
* lotniska używanego w samouczku dla [[Pl/Cessna 172P|Cessny 172P]], czyli [[Hilo_International_Airport|Międzynarodowego Portu Lotniczego Hilo]] (PHTO)

We FlightGear sceneria jest zazwyczaj przechowywana w katalogu [[Pl/$FG_ROOT|$FG_ROOT]] i dzieli się na trzy rodzaje danych:
* '''Airports''' zawiera dane o lotniskach, takie jak wykorzystanie pasów startowych i miejsca postojowe.
* '''Objects''' i '''Models''' to budynki, mosty, wieże radiowe itp., które reprezentują trójwymiarowe struktury.
* '''Terrain''' reprezentuje kontury, wzniesienia i rodzaj terenu, nad którym latasz/kołujesz.

Obecnym sposobem "instalowania" nowej scenerii jest włączenie [[TerraSync]], które automatycznie pobierze i zaktualizuje każde odwiedzane miejsce - nawet w locie! Jeśli masz wolne połączenie internetowe i/lub wolny komputer, możesz zamiast tego użyć menedżera scenerii, na przykład [[TerraMaster]]. Dodatkowo możesz ręcznie pobrać i zainstalować nowe części scenerii, oficjalną [[World Scenery|scenerię świata]] lub niestandardową scenerię.

Sceneria jest również dostępna na [https://www.flightgear.org/download/mirrors/ stronie mirrorów] witryny FlightGear i można ją zainstalować, postępując zgodnie z instrukcją [[Howto: Install scenery|Jak zainstalować scenerię]]. '''Jest to zalecane dla użytkowników ze słabym połączeniem internetowym lub słabymi komputerami!'''

Niestandardowa sceneria jest dostępna w wielu miejscach. Na przykład na {{forum link|f=5|text=forum FlightGear}} lub w repozytoriach. Wyszukiwanie w Internecie powinno pozwolić je znaleźć. Zobacz stronę [[Suggested_custom_scenery|sugerowanej niestandardowej scenerii]] po kilka najnowszych wydań.

FlightGear 2020.3.7 LTS i nowsze dodały eksperymentalną obsługę trójwymiarowych budynków, dróg i obiektów opartych na danych OpenStreetMap dla całego świata do automatycznie pobieranych danych TerraSync - zobacz notatki o [[OSM2City 1st Worldbuild|1. światowej kompilacji OSM2City]] (marzec 2021). Ręczne pobieranie struktur 3D dla regionów lub całych krajów jest dostępne na stronie wiki z [[Areas populated with osm2city scenery|pobraniami osm2City]].

=== Pobieranie statków powietrznych ===
Dodatkowe [[Pl/Samoloty|statki powietrzne]] można pobrać i zainstalować za pomocą [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz przejść na stronę internetową FlightGeara i przejść do strony [http://www.flightgear.org/download/ pobierania], a następnie wybrać link do pobrania statków powietrznych pasujący do Twojej wersji FlightGeara. Ponadto istnieje wiele [[hangars|hangarów]] innych firm. Informacje o instalacji znajdziesz w [[Pl/Instalowanie samolotów|Jak zainstalować statek powietrzny]].

== Uruchamianie FlightGeara ==
=== Uruchamianie FlightGeara ===
Najłatwiejszym sposobem uruchomienia FlightGeara jest użycie ikony na pulpicie. Uruchamia to interfejs graficzny [[FlightGear Qt launcher|Launchera]], w którym możesz wybrać statek powietrzny, pozycję startową itp.  Pamiętaj, że Launcher ma tylko podstawowe opcje, aby Ci pomóc. Wiele opcji dotyczących grafiki, scenerii, [[Weather|pogody]], [https://www.flightgear.org/tours/simulating-the-ever-changing-scenery/ środowiska], [[Input_device|urządzeń wejściowych]] itp. jest dostępnych z [[menu|menu]] wewnątrz symulatora.

Wielu użytkowników wybiera jednak uruchamianie FlightGeara bezpośrednio z wiersza poleceń. Nazwa pliku wykonywalnego to <code>fgfs</code> (lub plik AppImage, np. "flightgear-2024.1.6-linux-amd64.AppImage") i można go uruchomić bez opcji. Jeśli "nie został znaleziony", prawdopodobnie nie znajduje się w Twojej [https://en.wikipedia.org/wiki/PATH_(variable) ścieżce]. Lokalizacja zależy od Twojego konkretnego systemu i wyborów dokonanych podczas kompilacji i instalacji. Istnieje lista [[Pl/Opcje_wiersza_poleceń|parametrów wiersza poleceń]], których należy użyć do zmiany wielu opcji, takich jak wybrany statek powietrzny. Najważniejsze z nich:

fgfs --launcher # otwiera Launcher FlightGeara
fgfs --show-aircraft # wyświetla listę zainstalowanych statków powietrznych
fgfs --aircraft=c172p # uruchamia FG z statkiem powietrznym "c172p" (z listy)

Launcher umożliwia również użytkownikom dodawanie parametrów wiersza poleceń dla opcji, które są zwykle zmieniane z poziomu menu wewnątrz symulatora, a także dość zaawansowanych opcji dostępnych tylko z wiersza poleceń.

=== Konfiguracja renderowania i interfejsu użytkownika ===
[[File:Rendering options 2024.1.png|thumb|Okno dialogowe Widok > Opcje renderowania.]]
Jeśli jakość renderowania lub liczba klatek na sekundę jest zbyt niska, kliknij "Widok > Opcje renderowania", aby dostosować ustawienia graficzne. Dla nowszego sprzętu zaleca się ustawienie "jakości grafiki" na wysoką i zaznaczenie "użyj miejsca na dysku dla szybszego ładowania", "animowane rękawy" i "satelitarna fotosceneria".

Jeśli tekst menu wydaje się zbyt mały na ekranach o wysokiej rozdzielczości lub dużych ekranach, możesz ręcznie [[Menubar#How to Change the Default Menubar Font Size|zmienić rozmiar czcionki paska menu]], edytując plik danych, lub po prostu kliknąć "Debuguj > Zmień styl GUI".

=== Używanie klawiatury i/lub myszy ===
Użytkownicy z ograniczonym dostępem do [[joystick|joysticka]] lub innych kontrolerów czasami używają klawiatury lub myszy do sterowania swoim statkiem powietrznym. Używanie klawiatury do latania może być trudne, a mysz jest zalecana zamiast klawiatury do latania, jednak nawet tani joystick znacznie poprawiłby wrażenia.

Aby uzyskać pomoc dotyczącą poleceń klawiatury, gdy FlightGear jest uruchomiony, przejdź do menu ''Pomoc'', spójrz w ''Podstawowe klawisze'' (dla poleceń związanych z symulatorem), ''Wspólne klawisze statków powietrznych'' (dla poleceń uniwersalnych dla wszystkich statków powietrznych) i ''Pomoc dla statku powietrznego'' (dla poleceń specyficznych dla Twojego statku). Jeśli główne menu jest ukryte, naciśnij {{key press|F10}}. Jeśli przychodzisz z innych symulatorów, sprawdź [[key commands compared to other simulators|porównanie poleceń klawiatury z innymi symulatorami]], aby uzyskać przegląd różnic między poleceniami klawiatury tego symulatora a FlightGear.

Aby użyć myszy do latania statkiem powietrznym, naciśnij {{key press|Tab}} (kursor powinien zmienić się w krzyżyk) i przesuwaj myszą, aby kierować statkiem powietrznym. Naciśnij ponownie {{key press|Tab}}, aby rozglądać się (kursor powinien pokazywać dwustronną strzałkę), i naciśnij {{key press|Tab}} ponownie, aby wrócić do trybu normalnego, używanego do klikania elementów w kokpicie. Możesz kliknąć "Plik > Urządzenia wejściowe > Konfiguracja myszy", aby dostosować czułość myszy.

Dla większości użytkowników nieposiadających kontroli osi steru kierunku, trudno jest ręcznie koordynować ruchy [[aileron|lotki]] i [[rudder|steru kierunku]] podczas zakrętu. Aby włączyć autokoordynację i ułatwić latanie, możesz kliknąć "Ustawienia", następnie kliknąć przycisk "Pokaż więcej" po prawej stronie "Ogólne", a na końcu kliknąć "Włącz autokoordynację" w Launcherze.

=== Pierwszy raz w kokpicie ===
Orientacja w kokpicie może być wyzwaniem za pierwszym razem.

Możesz użyć {{key press|Ctrl|V}}, aby przełączyć się na widok kokpitu. Jeśli tekst na panelu jest zbyt mały, możesz użyć trybu widoku myszy (naciśnij Tab, aż uzyskasz kursor w kształcie podwójnej strzałki), aby przesuwać widok, i kółko myszy, aby przybliżać, lub przesuwać widok za pomocą czapki joysticka i przybliżać za pomocą {{key press|X}} i {{key press|Shift|X}}.

Jednym z pierwszych kroków, które wielu podejmuje po wejściu do nieznanego kokpitu, jest naciśnięcie {{key press|Ctrl|C}} w celu podświetlenia wszystkich "gorących punktów", czyli elementów sterujących przyrządami, przycisków, pokręteł itp. Wiele statków powietrznych oferuje również specjalne menu pomocy.

Niektóre funkcje, takie jak rozrusznik lub iskrowniki, mogą być trudne w użyciu lub po prostu nie mieć klikalnych "gorących punktów", zwłaszcza w modelach statków powietrznych w fazie rozwoju. W większości przypadków możesz użyć klawiatury. Klawiatura zawsze działa zgodnie z przypisaniami wymienionymi w menu "Pomoc > Pomoc dla statku powietrznego" lub "Pomoc > Wspólne klawisze statków powietrznych", ale czasami niektóre klawisze są przypisywane ponownie przez statek powietrzny lub konfigurację. Ponownie, pamiętaj, aby sprawdzić wszystkie okna dialogowe pomocy.

=== Uruchamianie silnika ===
Chcesz już lecieć, ale silnik jest wyłączony. Cóż, włączanie silników nie zawsze jest łatwe. Większość statków powietrznych ma wpis ''autostart'' w swoim niestandardowym menu, ale oto ogólna procedura, która powinna działać w wielu przypadkach:

Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem tłokowym, potrzebujesz (po upewnieniu się, że gra nie jest wstrzymana {{key press|p}}):
# Paliwo: niektóre statki powietrzne rozpoczynają symulację bez paliwa. Możesz je dodać w ''Wyposażenie'' > ''Paliwo i ładunek''.
# Prawidłowa mieszanka paliwowa: zazwyczaj jest ''bogata'', więc wciśnij czerwony pokrętło do samego końca lub użyj klawisza {{key press|m}}, aby wzbogacić ({{key press|Shift|m}} zuboża).
# Iskrowniki ustawione na ''Both'': obróć kluczyk lub naciśnij {{key press|}}} trzy razy, aby przejść przez ''R'', ''L'' do ''Both''.
# Przepustnica: niektóre silniki lepiej uruchamiają się przy odrobinie gazu.
# Uruchom rozrusznik: kliknij pozycję ''Start'' kluczyka na panelu lub naciśnij {{key press|s}}. Przytrzymaj rozrusznik przez wystarczający czas, nawet 10 sekund.

Uruchamianie wszystkich silników w statku powietrznym z wieloma silnikami jest podobne do uruchamiania pojedynczego silnika - z tą różnicą, że musisz powtórzyć tę samą sekwencję rozruchu dla każdego silnika. FlightGear oferuje wygodny sposób, aby zrobić to dla wszystkich silników jednocześnie: naciśnij {{key press|~}} i cała powyższa procedura zadziała dla wszystkich silników. Należy jednak pamiętać, że domyślny panel 2D jest podłączony do ''tylko jednego silnika'' i sztuczka z {{key press|~}} może nie zadziałać. Dodaj też trochę gazu, aby upewnić się, że wszystkie silniki są włączone.

Te instrukcje mogą nie działać dla odrzutowców, śmigłowców lub innych typów statków powietrznych o złożonych procedurach rozruchu. Sprawdź instrukcje w menu pomocy statku powietrznego (naciśnij {{key press|?}}) i/lub spójrz na [[Aircraft|artykuł o tym statku powietrznym na tej wiki]]. Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem odrzutowym, musisz:
# Ustawić odcięcie ''ON''
# Włączyć rozrusznik
# Gdy silniki osiągną około 5% N1, ustawić odcięcie ''OFF''
# Wyłączyć rozrusznik, gdy silnik osiągnie prędkość roboczą

== Nauka latania ==
=== Podręcznik FlightGear ===
FlightGear ma oficjalny [https://www.flightgear.org/support/manual/ podręcznik], który obejmuje podstawy latania. Jako początkujący, możesz chcieć zacząć od [https://flightgear.gitlab.io/getstart/release-{{current release|cr}}/pl/HTML/getstart-plch8.html Rozdziału 8: Podstawowy poradnik symulatora lotu].

=== Samouczki ===
Wiele statków powietrznych ma własne interaktywne [[tutorials|samouczki]]. Dzięki samouczkom możesz nauczyć się obsługiwać konkretny statek powietrzny, ale także nauczyć się latać. Możesz uzyskać dostęp do samouczków, przechodząc do ''Pomoc'' > ''Samouczek''. Świetnym miejscem na rozpoczęcie jest samouczek dla statku powietrznego [[Cessna 172P]], powszechnie używanego w rzeczywistości do nauki latania statkami powietrznymi o stałych skrzydłach.

Jeśli samouczek zaczyna się bez pasa startowego i w otoczeniu wody, Twoja instalacja FlightGeara nie ma scenerii dla lotniska, na którym samouczek miał się odbyć. Aby uzyskać scenerię, zobacz sekcję [[#Getting scenery|#Pobieranie scenerii]] powyżej.

== Twój pierwszy lot ==
=== Realizm ===
Jednym z najczęstszych pytań, jakie zadają początkujący piloci na temat każdego symulatora lotu, ale zwłaszcza FlightGeara, jest "Dlaczego mój statek powietrzny cały czas skręca w lewo?" Chociaż może to być spowodowane podmuchami wiatru przecinającymi pas startowy, bardziej prawdopodobne jest, że wynika to z [[Understanding Propeller Torque and P-Factor|momentu obrotowego śmigła i efektu P]].

W niektórych innych symulatorach lotu, pomimo haseł marketingowych głoszących co innego, niektóre ustawienia są obniżone, aby statek powietrzny był łatwiejszy w pilotażu. Zmniejsza to efekty takie jak powyższy. Realizm we FlightGear jest zawsze podkręcony do maksimum.

Oto niektóre punkty realizmu FlightGeara, które mogą dezorientować początkujących pilotów:
* "Syndrom skręcania w lewo" z wyżej wymienionych powodów.
* Błąd skrętu kompasu: Kompas, poddany siłom lotu, ma tendencję do skręcania w przeciwnym kierunku na krótki okres, zanim ustabilizuje się na prawidłowym kursie. Nie jest to usterka (zobacz także artykuł Wikipedii {{wikipedia|Aircraft compass turns}}).
* Wskaźnik prędkości pionowej (VSI) również jest obarczony błędem.
* [[Horizontal Situation Indicator|Wskaźnik sytuacji poziomej]] (HSI) jest napędzany przez żyroskop (dlatego czasami nazywa się go żyroskopem kierunkowym), który podlega ''dryfowi żyroskopowemu''. Wskaźnik będzie odchylać się od aktualnego kursu i musi być okresowo (co ~15 minut) kalibrowany, aby zgadzał się z kursem kompasu magnetycznego.
* Nie możesz po prostu przerwać skrętu lub wznoszenia poprzez wycentrowanie drążka lub pałki sterowniczej. Musisz skręcić lub popchnąć drążek w drugą stronę, aby wrócić do lotu poziomego. Ale nawet wtedy samolot nie utrzyma samodzielnie swojej wysokości ani kursu. Częstym błędem jest próba znalezienia pozycji drążka, przy której można puścić stery. Chociaż za pomocą trymowania można zostawić samolot na kilka sekund, trzeba użyć autopilota lub stale regulować drążek.

Na statek powietrzny w locie działa wiele sił, a także na [[avionics and instruments|awionikę i przyrządy]] używane do sterowania i nawigacji, co może być sprzeczne z intuicją. Piloci muszą nauczyć się rozpoznawać te zjawiska i kompensować ich skutki. ''FlightGear modeluje błędy przyrządów, które istnieją w rzeczywistym świecie''. Jeśli nie chcesz tego, naciśnij {{key press|h}}, aby włączyć HUD.

=== Lotniska i pomoce nawigacyjne ===
Gdy po raz pierwszy uruchamiasz FlightGear, czy to z wiersza poleceń, czy z interfejsu Launchera, możesz zastanawiać się, jak określić, jakie lotniska są dostępne. Program uruchamiający wyświetla listę lotnisk, ale nie zobaczysz szczegółów, takich jak częstotliwości wieży lub [[ILS|ILS]]. Nie znajdziesz mapy pokazującej [[VOR|VOR-y]] i ich częstotliwości. Co możesz zrobić? Zobacz [[Getting aeronautical charts|Pozyskiwanie map lotniczych]].

W symulatorze dostępna jest mapa, której możesz użyć w ''Menu główne'' > ''Wyposażenie'' > ''Mapa'', która pozwoli Ci zobaczyć dane nawigacyjne oraz pozycję lotnisk i pomocy. Aby uzyskać więcej pomocy dotyczącej nawigacji, zobacz [[Understanding navigation|Zrozumienie nawigacji]].

=== Latanie z autopilotem ===
Ogólny [[autopilot|autopilot]] jest dostępny w menu ''Autopilot > Ustawienia autopilota'', podczas gdy wiele statków powietrznych ma własny ''specyficzny'' autopilot, często będący modelem rzeczywistego.

W przypadku statków powietrznych, które mają własny autopilot, powinieneś używać elementów sterujących autopilotem dostępnych w wirtualnym kokpicie. Oznacza to klikanie na panelu przyrządów w wirtualnym kokpicie. Menu Autopilot może być wyszarzone i niedostępne, gdy statek powietrzny dostarcza własny autopilot w niektórych statkach powietrznych, w tym Airbuses i [[Cessna 172P|C172P]].

Cessna 172 jest wyposażona w [[Bendix/King KAP140 Autopilot|autopilot Bendix/King KAP140]] w swoim wirtualnym kokpicie. Możesz używać zarówno urządzenia autopilota w kokpicie, jak i [[Autopilot#Autopilot Settings|ustawień autopilota]] z menu.

== Zaawansowane ==
=== Latanie ===
{{Main article|Pl/Samoloty|Statki powietrzne}}

* Jeśli nadal latasz lekkimi cywilnymi statkami powietrznymi, [[Cessna 182S]], która jest bardziej złożona niż C172P, oraz [[Piper PA28 Warrior II|PA28]] to dobre wybory.
* Jeśli interesuje Cię latanie liniami lotniczymi, sugeruje się rodziny [[Airbus A320 family|Airbus A320]], Boeing [[Boeing 777|777]]/[[Boeing 787-8 Dreamliner|787]], [[MD-11]] i [[MD-80]].
* Jeśli fascynują Cię samoloty myśliwskie, wybierz wysoko oceniany wojskowy statek powietrzny (taki jak [[General Dynamics F-16 Fighting Falcon|F-16]]/[[F-15]]) z [[Aircraft#Modern military aircraft|tej listy]] i włącz obrażenia w trybie wieloosobowym lub zainstaluj [[Bombable]].
* Jeśli przechodzisz na śmigłowce, zaleca się latanie [[Eurocopter EC130 B4]].

Oprócz zwykłych statków powietrznych dostępne są również szczegółowe [[Space Shuttle|wahadłowce kosmiczne]].

=== Sceneria ===
Fascynujące jest odkrywanie [[scenery|scenerii]] (lub po prostu testowanie grafiki/szybkości klatek) za pomocą [[UFO|UFO]]. Po pierwsze, [[#Configuring rendering and UI|zwiększ swoją jakość grafiki]]. Jeśli początkowo nie widzisz budynków, pozostaw FG otwarte i odczekaj chwilę, aż [[TerraSync]] zakończy pobieranie i budynki się pojawią.
Istnieje wiele [[Suggested airports|dobrze rozwiniętych lotnisk]] i obszarów scenerii. Możesz również eksplorować obiekty scenerii na [https://scenery.flightgear.org/map mapie modeli].

=== Tryb wieloosobowy ===
FlightGear ma kilka serwerów wieloosobowych, które pozwolą Ci latać w bardziej ożywionych przestworzach; zobacz [[Howto: Multiplayer|Tryb wieloosobowy]]. Istnieją również [[OpenRadar]] i [[ATC-pie]], samodzielne programy, które pozwolą Ci być [[Air traffic control|kontrolerem ruchu lotniczego]].

Dostępna jest również [[MPMap|mapa wieloosobowa]], która pozwala zobaczyć, kto jest aktualnie online, a nawet jakie [[navaids|pomoce nawigacyjne]] są w pobliżu.

=== Elementy menu ===
Aby szybko zapoznać się z użyciem każdej pozycji menu w FlightGear, zobacz [[menu]].

=== Dodatki ===
FlightGear ma wiele [[Addon|dodatków]] innych firm zawierających ulepszenia. Dla początkujących, [[Logbook Add-on|Dziennik lotów]] i dodatek [[Which Runway Add-on|Który pas]] mogą być najbardziej przydatnymi dodatkami.

== Społeczność FlightGear ==
=== Uzyskiwanie pomocy ===
Ta strona została zaprojektowana, aby zapewnić użytkownikowi najważniejsze informacje, które musi wiedzieć o korzystaniu z FlightGeara po raz pierwszy. Oprócz [[Pl/Portal:Użytkownik|portalu użytkownika]] tej wiki, istnieją inne strony, które możesz chcieć przeczytać:
*[[Troubleshooting problems|Rozwiązywanie problemów]], aby pomóc Ci z najczęstszymi problemami;
*[[Pl/FAQ|Często zadawane pytania]];
...oraz kanały komunikacji, które mogą być używane do uzyskania informacji lub poproszenia o pomoc:
*[[Pl/Podręcznik FlightGear|Podręcznik FlightGear]], ''obowiązkowa lektura'' dla początkujących;
*{{forum link|text=Forum FlightGear}} i jego podfora;
*[[Discord|Serwer Discord FlightGear]], najszybszy sposób na uzyskanie pomocy;
*[[FlightGear IRC channel|Kanał IRC FlightGear]];
*[[Mailing list|Lista mailingowa użytkowników FlightGeara]], największa szansa na kontakt z głównymi deweloperami;
*Dokumenty dołączone do pakietu wydaniowego.

=== Dostosowywanie FlightGear bez kompilacji ===
[https://www.flightgear.org/download/ Nasza strona internetowa] oferuje prekompilowane pliki binarne do pobrania i instalacji na Windows, macOS i Linux. Ponadto większość dystrybucji Linuksa udostępnia spakowaną wersję w swoich repozytoriach.

Chociaż instalacja jest binarna, większość systemów FlightGear jest otwarta na konfigurację poprzez pliki [[XML]] i [[NASAL scripting|skrypty NASAL]]. Masz swobodę ''i jesteś zachęcany'' do wprowadzania zmian w modelach lotu statków powietrznych, scenerii, teksturach, [[shader|shaderach]] OpenGL i każdej innej funkcji, którą chcesz zmienić dla własnej satysfakcji lub podzielić się z innymi użytkownikami FlightGeara. Jeśli to zamierzasz zrobić, spójrz na [[Pl/Portal:Developer|portal dewelopera]].

=== Jak możesz pomóc ===
{{Main article|Volunteer|Wolontariusz}}
FlightGear to projekt open source, oparty na wolontariacie. Oznacza to, że wszystko, co tu znajdziesz, pochodzi z pasji, wolnego czasu i niczego więcej. Obejmuje to symulator, scenerię, statki powietrzne, wiki, {{forum link|text=forum}} i wszystko inne. Wolontariusze, w istocie ''ludzie, którzy coś robią'', są fundamentalni dla tego projektu. Bez nich nie zrobiłby ani jednego kroku do przodu. Dlatego ważne jest, aby współtwórcy dobrze się bawili tym, co robią.

Jeśli planujesz wnieść wkład w ten projekt, powinieneś zapoznać się z kilkoma artykułami, które dadzą Ci pewne wskazówki:
*[[Howto:Understand the FlightGear development process|Jak zrozumieć proces rozwoju FlightGeara]]
*[[Implementing new features for FlightGear|Wdrażanie nowych funkcji dla FlightGeara]]
*[[How the FlightGear project works|Jak działa projekt FlightGear]]

Dziedzin, w których ich pomoc byłaby doceniona, jest wiele:
;Testowanie:
*[[Building FlightGear|Skompiluj]] najnowszy kod Git
*[https://gitlab.com/flightgear/flightgear/-/issues Zgłaszaj raporty o błędach]
*Uruchamianie FlightGeara za pomocą programu valgrind w celu wykrycia wycieków pamięci

;Wsparcie:
*Pomoc nowym użytkownikom w pobieraniu, kompilowaniu, instalowaniu i uruchamianiu FlightGeara ({{forum link|text=na forum}} lub na [[Discord|Discordzie]])
*Dostarczanie pomysłów i sugestii, zobacz: [[Feature Requests / Proposals / Ideas|Prośby o funkcje / Propozycje / Pomysły]]
*Pomoc w [[Portal:Wiki|oczyszczeniu tej wiki]]
*Pomoc w dostarczaniu nowych treści dla brakujących stron wiki

;Rozwój:
*Podstawowy kod źródłowy:
**Dostarczanie [[Howto:Start core development|wkładu w kod źródłowy, dane i dokumentację]]
**Dostarczanie [[Bugs|poprawek błędów]] lub nowych funkcji
*Rozwój statków powietrznych (modelowanie 3D, tekstury, modele lotu, skrypty)
*Rozwój scenerii (teren, modele, pogoda)
*Zaangażowanie w którykolwiek z innych projektów powiązanych z FlightGearem

[[Category:FlightGear]]

[[ca:Nou a FlightGear]]
[[de:Neu bei FlightGear]]
[[en:New to FlightGear]]
[[es:Nuevo en FlightGear]]
[[fi:Uusi_käyttäjä]]
[[fr:Nouveau sur flightgear]]
[[it:Nuovo per FlightGear]]
[[ja:FlightGear入門]]
[[nl:Nieuw bij FlightGear]]
[[pt:Novo no FlightGear]]
[[sr:Novi u FlightGear-u]]
[[th:New to FlightGear]]
[[zh:FlightGear新手]]

Pl/Nowy we FlightGear

2026-06-17T13:01:08Z

PlayeRom: /* Pierwszy raz w kokpicie */

'''Witaj we [[FlightGear]]!''' Postaramy się pomóc Ci wzbić się w wirtualne powietrze w najkrótszym możliwym czasie. Przedstawimy Ci również niektóre funkcje tego symulatora lotu oraz kilka informacji o jego społeczności.

== Instalacja i konfiguracja ==
=== Wymagania sprzętowe ===
Aby FlightGear działał płynnie, wymaga karty graficznej ze sterownikami OpenGL 4.0 lub nowszymi. Zwykle nie stanowi to problemu, ale zapoznaj się z [[Pl/Wymagania_sprzętowe|zaleceniami sprzętowymi]], aby lepiej to zrozumieć.

=== Pobieranie FlightGeara ===
Możesz pobrać najnowsze pliki ze strony [https://www.flightgear.org/download/ Pobieranie FlightGear]. Wybierz pliki źródłowe lub binarne odpowiednie dla Twojego systemu. Dostępne są również pliki binarne {{Wikipedia|AppImage|AppImage}} dla Linuksa dla wersji 2020.3 LTS i nowszych. Większość użytkowników Linuksa odkryje, że większość dystrybucji ma spakowaną wersję FlightGeara (nazwa pakietu może brzmieć <code>fgfs</code> lub <code>flightgear</code>).

W zależności od Twoich umiejętności technicznych możesz wybrać deweloperską wersję [[Git]] FlightGeara, która zazwyczaj ma więcej funkcji i może być wymagana przez niektóre najnowsze rozwijane statki powietrzne, ale może być niestabilna i jest bardziej skomplikowana do zdobycia dla użytkowników innych niż Windows. Ogólnie rzecz biorąc, wersja deweloperska nie jest zalecana dla przeciętnego użytkownika, ale jeśli chcesz przeprowadzić kilka testów, dostępna jest wersja nocna do [https://www.flightgear.org/download/nightly/ pobrania]. Jeśli używasz kopii FlightGeara kontrolowanej przez system Git, możesz zsynchronizować swoje statki powietrzne za pomocą kontrolowanego przez system repozytorium rozwojowego statków powietrznych [[Pl/FGAddon|FGAddon]].

=== Instalacja w systemie Windows ===
Po pobraniu instalatora uruchom go i postępuj zgodnie z jego instrukcjami, aby zainstalować FlightGear.

Defender SmartScreen w systemie Windows może zablokować instalację po prostu dlatego, że plik binarny nie jest podpisany kluczem, który Microsoft uznaje. Oczywiście klucz jest płatny. W takim przypadku musimy kliknąć niepozorny link "Więcej informacji". Dopiero wtedy pojawi się przycisk "Uruchom mimo to". Możesz bezpiecznie zaufać, że nie jest to niebezpieczna aplikacja, pod warunkiem, że pobrałeś ją z oficjalnych źródeł.

Jeśli z jakiegoś powodu używasz oprogramowania antywirusowego innej firmy, może ono blokować instalację FlightGeara. Nie jest to coś, na co mamy wpływ, więc to od Ciebie zależy, jak chcesz to rozwiązać.

Za pomocą instalatora Windows możesz wybrać miejsce instalacji FlightGeara. Katalog [[Pl/$FG_ROOT|$FG_ROOT]] będzie miał ścieżkę <code><wybrany katalog>/fgdata_2024_1</code>.

=== Instalacja w systemie macOS ===
Instalacja FlightGeara w systemie macOS jest bardzo prosta. Wystarczy przeciągnąć i upuścić ikonę FlightGeara do folderu <code>/Applications</code>. To wszystko.

Gdy uruchamiasz FlightGeara po raz pierwszy, jego ikona w Docku podskakuje przez kilka sekund podczas ładowania informacji o statkach powietrznych i lotniskach. Gdy pojawi się graficzny program uruchamiający, wybierz statek powietrzny i lotnisko, a następnie kliknij "Lećmy!", aby uruchomić symulator. Możesz skonfigurować więcej opcji za pomocą graficznego programu uruchamiającego. Zobacz [http://flightgear.sourceforge.net/manual/next/pl/getstart-plch4.html#start-jak-uruchomic-program oficjalną instrukcję] po więcej szczegółów.

Jeśli chcesz uruchomić FlightGeara z wiersza poleceń, uruchom aplikację Terminal i wpisz następujące polecenia.

cd /Applications/FlightGear.app/Contents/MacOS
./fgfs --options.....

Zmienne [[Pl/$FG_ROOT|$FG_ROOT]] i [[$FG_SCENERY]] nie są ustawione w systemie macOS. Jeśli chcesz samodzielnie określić te zmienne do użycia w wierszu poleceń, uruchom następujące polecenia w aplikacji Terminal:

FG_ROOT=/Applications/FlightGear.app/Contents/Resources/data
FG_SCENERY=[[Pl/$FG_ROOT|$FG_ROOT]]/Scenery

Po uruchomieniu graficznego programu uruchamiającego będziesz mieć alias do [[Pl/$FG_ROOT|$FG_ROOT]] w ścieżce <code>$HOME/Documents/FlightGear/<version></code>, dzięki czemu możesz przeglądać folder danych za pomocą Findera.

Uwaga: Po zainstalowaniu FlightGeara użytkownicy komputerów Mac mogą zlokalizować swój folder [[Pl/$FG_ROOT|$FG_ROOT]], otwierając folder Aplikacje w Finderze, klikając prawym przyciskiem myszy FlightGear i wybierając "Pokaż zawartość pakietu". To przeniesie Cię do wnętrza folderu FlightGear. Masz teraz dostęp do wszystkich plików, w tym Data/Aircraft, aby [[Pl/Instalowanie_samolotów#macOS|zainstalować nowe statki powietrzne]].

=== Instalacja ze źródeł ===
Główny artykuł: [[Building FlightGear|Kompilacja FlightGeara]]

=== Pobieranie scenerii ===
Z FlightGearem instalowany jest ograniczony zestaw [[scenery|scenerii]]. Dla FlightGear 2024.1 składa się on z:
* obszaru wokół wyróżnionego lotniska dla tej wersji, czyli [[Keflavik_Airport|Międzynarodowego Portu Lotniczego Keflavik]] (BIKF)
* lotniska używanego w samouczku dla [[Pl/Cessna 172P|Cessny 172P]], czyli [[Hilo_International_Airport|Międzynarodowego Portu Lotniczego Hilo]] (PHTO)

We FlightGear sceneria jest zazwyczaj przechowywana w katalogu [[Pl/$FG_ROOT|$FG_ROOT]] i dzieli się na trzy rodzaje danych:
* '''Airports''' zawiera dane o lotniskach, takie jak wykorzystanie pasów startowych i miejsca postojowe.
* '''Objects''' i '''Models''' to budynki, mosty, wieże radiowe itp., które reprezentują trójwymiarowe struktury.
* '''Terrain''' reprezentuje kontury, wzniesienia i rodzaj terenu, nad którym latasz/kołujesz.

Obecnym sposobem "instalowania" nowej scenerii jest włączenie [[TerraSync]], które automatycznie pobierze i zaktualizuje każde odwiedzane miejsce - nawet w locie! Jeśli masz wolne połączenie internetowe i/lub wolny komputer, możesz zamiast tego użyć menedżera scenerii, na przykład [[TerraMaster]]. Dodatkowo możesz ręcznie pobrać i zainstalować nowe części scenerii, oficjalną [[World Scenery|scenerię świata]] lub niestandardową scenerię.

Sceneria jest również dostępna na [https://www.flightgear.org/download/mirrors/ stronie mirrorów] witryny FlightGear i można ją zainstalować, postępując zgodnie z instrukcją [[Howto: Install scenery|Jak zainstalować scenerię]]. '''Jest to zalecane dla użytkowników ze słabym połączeniem internetowym lub słabymi komputerami!'''

Niestandardowa sceneria jest dostępna w wielu miejscach. Na przykład na {{forum link|f=5|text=forum FlightGear}} lub w repozytoriach. Wyszukiwanie w Internecie powinno pozwolić je znaleźć. Zobacz stronę [[Suggested_custom_scenery|sugerowanej niestandardowej scenerii]] po kilka najnowszych wydań.

FlightGear 2020.3.7 LTS i nowsze dodały eksperymentalną obsługę trójwymiarowych budynków, dróg i obiektów opartych na danych OpenStreetMap dla całego świata do automatycznie pobieranych danych TerraSync - zobacz notatki o [[OSM2City 1st Worldbuild|1. światowej kompilacji OSM2City]] (marzec 2021). Ręczne pobieranie struktur 3D dla regionów lub całych krajów jest dostępne na stronie wiki z [[Areas populated with osm2city scenery|pobraniami osm2City]].

=== Pobieranie statków powietrznych ===
Dodatkowe [[Pl/Samoloty|statki powietrzne]] można pobrać i zainstalować za pomocą [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz przejść na stronę internetową FlightGeara i przejść do strony [http://www.flightgear.org/download/ pobierania], a następnie wybrać link do pobrania statków powietrznych pasujący do Twojej wersji FlightGeara. Ponadto istnieje wiele [[hangars|hangarów]] innych firm. Informacje o instalacji znajdziesz w [[Pl/Instalowanie samolotów|Jak zainstalować statek powietrzny]].

== Uruchamianie FlightGeara ==
=== Uruchamianie FlightGeara ===
Najłatwiejszym sposobem uruchomienia FlightGeara jest użycie ikony na pulpicie. Uruchamia to interfejs graficzny [[FlightGear Qt launcher|Launchera]], w którym możesz wybrać statek powietrzny, pozycję startową itp.  Pamiętaj, że Launcher ma tylko podstawowe opcje, aby Ci pomóc. Wiele opcji dotyczących grafiki, scenerii, [[Weather|pogody]], [https://www.flightgear.org/tours/simulating-the-ever-changing-scenery/ środowiska], [[Input_device|urządzeń wejściowych]] itp. jest dostępnych z [[menu|menu]] wewnątrz symulatora.

Wielu użytkowników wybiera jednak uruchamianie FlightGeara bezpośrednio z wiersza poleceń. Nazwa pliku wykonywalnego to <code>fgfs</code> (lub plik AppImage, np. "flightgear-2024.1.6-linux-amd64.AppImage") i można go uruchomić bez opcji. Jeśli "nie został znaleziony", prawdopodobnie nie znajduje się w Twojej [https://en.wikipedia.org/wiki/PATH_(variable) ścieżce]. Lokalizacja zależy od Twojego konkretnego systemu i wyborów dokonanych podczas kompilacji i instalacji. Istnieje lista [[Pl/Opcje_wiersza_poleceń|parametrów wiersza poleceń]], których należy użyć do zmiany wielu opcji, takich jak wybrany statek powietrzny. Najważniejsze z nich:

fgfs --launcher # otwiera Launcher FlightGeara
fgfs --show-aircraft # wyświetla listę zainstalowanych statków powietrznych
fgfs --aircraft=c172p # uruchamia FG z statkiem powietrznym "c172p" (z listy)

Launcher umożliwia również użytkownikom dodawanie parametrów wiersza poleceń dla opcji, które są zwykle zmieniane z poziomu menu wewnątrz symulatora, a także dość zaawansowanych opcji dostępnych tylko z wiersza poleceń.

=== Konfiguracja renderowania i interfejsu użytkownika ===
[[File:Rendering options 2024.1.png|thumb|Okno dialogowe Widok > Opcje renderowania.]]
Jeśli jakość renderowania lub liczba klatek na sekundę jest zbyt niska, kliknij "Widok > Opcje renderowania", aby dostosować ustawienia graficzne. Dla nowszego sprzętu zaleca się ustawienie "jakości grafiki" na wysoką i zaznaczenie "użyj miejsca na dysku dla szybszego ładowania", "animowane rękawy" i "satelitarna fotosceneria".

Jeśli tekst menu wydaje się zbyt mały na ekranach o wysokiej rozdzielczości lub dużych ekranach, możesz ręcznie [[Menubar#How to Change the Default Menubar Font Size|zmienić rozmiar czcionki paska menu]], edytując plik danych, lub po prostu kliknąć "Debuguj > Zmień styl GUI".

=== Używanie klawiatury i/lub myszy ===
Użytkownicy z ograniczonym dostępem do [[joystick|joysticka]] lub innych kontrolerów czasami używają klawiatury lub myszy do sterowania swoim statkiem powietrznym. Używanie klawiatury do latania może być trudne, a mysz jest zalecana zamiast klawiatury do latania, jednak nawet tani joystick znacznie poprawiłby wrażenia.

Aby uzyskać pomoc dotyczącą poleceń klawiatury, gdy FlightGear jest uruchomiony, przejdź do menu ''Pomoc'', spójrz w ''Podstawowe klawisze'' (dla poleceń związanych z symulatorem), ''Wspólne klawisze statków powietrznych'' (dla poleceń uniwersalnych dla wszystkich statków powietrznych) i ''Pomoc dla statku powietrznego'' (dla poleceń specyficznych dla Twojego statku). Jeśli główne menu jest ukryte, naciśnij {{key press|F10}}. Jeśli przychodzisz z innych symulatorów, sprawdź [[key commands compared to other simulators|porównanie poleceń klawiatury z innymi symulatorami]], aby uzyskać przegląd różnic między poleceniami klawiatury tego symulatora a FlightGear.

Aby użyć myszy do latania statkiem powietrznym, naciśnij {{key press|Tab}} (kursor powinien zmienić się w krzyżyk) i przesuwaj myszą, aby kierować statkiem powietrznym. Naciśnij ponownie {{key press|Tab}}, aby rozglądać się (kursor powinien pokazywać dwustronną strzałkę), i naciśnij {{key press|Tab}} ponownie, aby wrócić do trybu normalnego, używanego do klikania elementów w kokpicie. Możesz kliknąć "Plik > Urządzenia wejściowe > Konfiguracja myszy", aby dostosować czułość myszy.

Dla większości użytkowników nieposiadających kontroli osi steru kierunku, trudno jest ręcznie koordynować ruchy [[aileron|lotki]] i [[rudder|steru kierunku]] podczas zakrętu. Aby włączyć autokoordynację i ułatwić latanie, możesz kliknąć "Ustawienia", następnie kliknąć przycisk "Pokaż więcej" po prawej stronie "Ogólne", a na końcu kliknąć "Włącz autokoordynację" w Launcherze.

=== Pierwszy raz w kokpicie ===
Orientacja w kokpicie może być wyzwaniem za pierwszym razem.

Możesz użyć {{key press|Ctrl|V}}, aby przełączyć się na widok kokpitu. Jeśli tekst na panelu jest zbyt mały, możesz użyć trybu widoku myszy (naciśnij Tab, aż uzyskasz kursor w kształcie podwójnej strzałki), aby przesuwać widok, i kółko myszy, aby przybliżać, lub przesuwać widok za pomocą czapki joysticka i przybliżać za pomocą {{key press|X}} i {{key press|Shift|X}}.

Jednym z pierwszych kroków, które wielu podejmuje po wejściu do nieznanego kokpitu, jest naciśnięcie {{key press|Ctrl|C}} w celu podświetlenia wszystkich "gorących punktów", czyli elementów sterujących przyrządami, przycisków, pokręteł itp. Wiele statków powietrznych oferuje również specjalne menu pomocy.

Niektóre funkcje, takie jak rozrusznik lub iskrowniki, mogą być trudne w użyciu lub po prostu nie mieć klikalnych "gorących punktów", zwłaszcza w modelach statków powietrznych w fazie rozwoju. W większości przypadków możesz użyć klawiatury. Klawiatura zawsze działa zgodnie z przypisaniami wymienionymi w menu "Pomoc > Pomoc dla statku powietrznego" lub "Pomoc > Wspólne klawisze statków powietrznych", ale czasami niektóre klawisze są przypisywane ponownie przez statek powietrzny lub konfigurację. Ponownie, pamiętaj, aby sprawdzić wszystkie okna dialogowe pomocy.

=== Uruchamianie silnika ===
Chcesz już lecieć, ale silnik jest wyłączony. Cóż, włączanie silników nie zawsze jest łatwe. Większość statków powietrznych ma wpis ''autostart'' w swoim niestandardowym menu, ale oto ogólna procedura, która powinna działać w wielu przypadkach:

Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem tłokowym, potrzebujesz (po upewnieniu się, że gra nie jest wstrzymana {{key press|p}}):
# Paliwo: niektóre statki powietrzne rozpoczynają symulację bez paliwa. Możesz je dodać w ''Wyposażenie'' > ''Paliwo i ładunek''.
# Prawidłowa mieszanka paliwowa: zazwyczaj jest ''bogata'', więc wciśnij czerwony pokrętło do samego końca lub użyj klawisza {{key press|m}}, aby wzbogacić ({{key press|Shift|m}} zuboża).
# Iskrowniki ustawione na ''Both'': obróć kluczyk lub naciśnij {{key press|}}} trzy razy, aby przejść przez ''R'', ''L'' do ''Both''.
# Przepustnica: niektóre silniki lepiej uruchamiają się przy odrobinie gazu.
# Uruchom rozrusznik: kliknij pozycję ''Start'' kluczyka na panelu lub naciśnij {{key press|s}}. Przytrzymaj rozrusznik przez wystarczający czas, nawet 10 sekund.

Uruchamianie wszystkich silników w statku powietrznym z wieloma silnikami jest podobne do uruchamiania pojedynczego silnika - z tą różnicą, że musisz powtórzyć tę samą sekwencję rozruchu dla każdego silnika. FlightGear oferuje wygodny sposób, aby zrobić to dla wszystkich silników jednocześnie: naciśnij {{key press|~}} i cała powyższa procedura zadziała dla wszystkich silników. Należy jednak pamiętać, że domyślny panel 2D jest podłączony do ''tylko jednego silnika'' i sztuczka z {{key press|~}} może nie zadziałać. Dodaj też trochę gazu, aby upewnić się, że wszystkie silniki są włączone.

Te instrukcje mogą nie działać dla odrzutowców, śmigłowców lub innych typów statków powietrznych o złożonych procedurach rozruchu. Sprawdź instrukcje w menu pomocy statku powietrznego (naciśnij {{key press|?}}) i/lub spójrz na [[Aircraft|artykuł o tym statku powietrznym na tej wiki]]. Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem odrzutowym, musisz:
# Ustawić odcięcie ''ON''
# Włączyć rozrusznik
# Gdy silniki osiągną około 5% N1, ustawić odcięcie ''OFF''
# Wyłączyć rozrusznik, gdy silnik osiągnie prędkość roboczą

== Nauka latania ==
=== Podręcznik FlightGear ===
FlightGear ma oficjalny [https://www.flightgear.org/support/manual/ podręcznik], który obejmuje podstawy latania. Jako początkujący, możesz chcieć zacząć od [https://flightgear.gitlab.io/getstart/release-{{current release|cr}}/pl/HTML/getstart-plch8.html Rozdziału 8: Podstawowy poradnik symulatora lotu].

=== Samouczki ===
Wiele statków powietrznych ma własne interaktywne [[tutorials|samouczki]]. Dzięki samouczkom możesz nauczyć się obsługiwać konkretny statek powietrzny, ale także nauczyć się latać. Możesz uzyskać dostęp do samouczków, przechodząc do ''Pomoc'' > ''Samouczek''. Świetnym miejscem na rozpoczęcie jest samouczek dla statku powietrznego [[Cessna 172P]], powszechnie używanego w rzeczywistości do nauki latania statkami powietrznymi o stałych skrzydłach.

Jeśli samouczek zaczyna się bez pasa startowego i w otoczeniu wody, Twoja instalacja FlightGeara nie ma scenerii dla lotniska, na którym samouczek miał się odbyć. Aby uzyskać scenerię, zobacz sekcję [[#Getting scenery|#Pobieranie scenerii]] powyżej.

== Twój pierwszy lot ==
=== Realizm ===
Jednym z najczęstszych pytań, jakie zadają początkujący piloci na temat każdego symulatora lotu, ale zwłaszcza FlightGeara, jest "Dlaczego mój statek powietrzny cały czas skręca w lewo?" Chociaż może to być spowodowane podmuchami wiatru przecinającymi pas startowy, bardziej prawdopodobne jest, że wynika to z [[Understanding Propeller Torque and P-Factor|momentu obrotowego śmigła i efektu P]].

W niektórych innych symulatorach lotu, pomimo haseł marketingowych głoszących co innego, niektóre ustawienia są obniżone, aby statek powietrzny był łatwiejszy w pilotażu. Zmniejsza to efekty takie jak powyższy. Realizm we FlightGear jest zawsze podkręcony do maksimum.

Oto niektóre punkty realizmu FlightGeara, które mogą dezorientować początkujących pilotów:
* "Syndrom skręcania w lewo" z wyżej wymienionych powodów.
* Błąd skrętu kompasu: Kompas, poddany siłom lotu, ma tendencję do skręcania w przeciwnym kierunku na krótki okres, zanim ustabilizuje się na prawidłowym kursie. Nie jest to usterka (zobacz także artykuł Wikipedii {{wikipedia|Aircraft compass turns}}).
* Wskaźnik prędkości pionowej (VSI) również jest obarczony błędem.
* [[Horizontal Situation Indicator|Wskaźnik sytuacji poziomej]] (HSI) jest napędzany przez żyroskop (dlatego czasami nazywa się go żyroskopem kierunkowym), który podlega ''dryfowi żyroskopowemu''. Wskaźnik będzie odchylać się od aktualnego kursu i musi być okresowo (co ~15 minut) kalibrowany, aby zgadzał się z kursem kompasu magnetycznego.
* Nie możesz po prostu przerwać skrętu lub wznoszenia poprzez wycentrowanie drążka lub pałki sterowniczej. Musisz skręcić lub popchnąć drążek w drugą stronę, aby wrócić do lotu poziomego. Ale nawet wtedy samolot nie utrzyma samodzielnie swojej wysokości ani kursu. Częstym błędem jest próba znalezienia pozycji drążka, przy której można puścić stery. Chociaż za pomocą trymowania można zostawić samolot na kilka sekund, trzeba użyć autopilota lub stale regulować drążek.

Na statek powietrzny w locie działa wiele sił, a także na [[avionics and instruments|awionikę i przyrządy]] używane do sterowania i nawigacji, co może być sprzeczne z intuicją. Piloci muszą nauczyć się rozpoznawać te zjawiska i kompensować ich skutki. ''FlightGear modeluje błędy przyrządów, które istnieją w rzeczywistym świecie''. Jeśli nie chcesz tego, naciśnij {{key press|h}}, aby włączyć HUD.

=== Lotniska i pomoce nawigacyjne ===
Gdy po raz pierwszy uruchamiasz FlightGear, czy to z wiersza poleceń, czy z interfejsu Launchera, możesz zastanawiać się, jak określić, jakie lotniska są dostępne. Program uruchamiający wyświetla listę lotnisk, ale nie zobaczysz szczegółów, takich jak częstotliwości wieży lub [[ILS|ILS]]. Nie znajdziesz mapy pokazującej [[VOR|VOR-y]] i ich częstotliwości. Co możesz zrobić? Zobacz [[Getting aeronautical charts|Pozyskiwanie map lotniczych]].

W symulatorze dostępna jest mapa, której możesz użyć w ''Menu główne'' > ''Wyposażenie'' > ''Mapa'', która pozwoli Ci zobaczyć dane nawigacyjne oraz pozycję lotnisk i pomocy. Aby uzyskać więcej pomocy dotyczącej nawigacji, zobacz [[Understanding navigation|Zrozumienie nawigacji]].

=== Latanie z autopilotem ===
Ogólny [[autopilot|autopilot]] jest dostępny w menu ''Autopilot > Ustawienia autopilota'', podczas gdy wiele statków powietrznych ma własny ''specyficzny'' autopilot, często będący modelem rzeczywistego.

W przypadku statków powietrznych, które mają własny autopilot, powinieneś używać elementów sterujących autopilotem dostępnych w wirtualnym kokpicie. Oznacza to klikanie na panelu przyrządów w wirtualnym kokpicie. Menu Autopilot może być wyszarzone i niedostępne, gdy statek powietrzny dostarcza własny autopilot w niektórych statkach powietrznych, w tym Airbuses i [[Cessna 172P|C172P]].

Cessna 172 jest wyposażona w [[Bendix/King KAP140 Autopilot|autopilot Bendix/King KAP140]] w swoim wirtualnym kokpicie. Możesz używać zarówno urządzenia autopilota w kokpicie, jak i [[Autopilot#Autopilot Settings|ustawień autopilota]] z menu.

== Zaawansowane ==
=== Latanie ===
{{Main article|Aircraft|Statki powietrzne}}

* Jeśli nadal latasz lekkimi cywilnymi statkami powietrznymi, [[Cessna 182S]], która jest bardziej złożona niż C172P, oraz [[Piper PA28 Warrior II|PA28]] to dobre wybory.
* Jeśli interesuje Cię latanie liniami lotniczymi, sugeruje się rodziny [[Airbus A320 family|Airbus A320]], Boeing [[Boeing 777|777]]/[[Boeing 787-8 Dreamliner|787]], [[MD-11]] i [[MD-80]].
* Jeśli fascynują Cię samoloty myśliwskie, wybierz wysoko oceniany wojskowy statek powietrzny (taki jak [[General Dynamics F-16 Fighting Falcon|F-16]]/[[F-15]]) z [[Aircraft#Modern military aircraft|tej listy]] i włącz obrażenia w trybie wieloosobowym lub zainstaluj [[Bombable]].
* Jeśli przechodzisz na śmigłowce, zaleca się latanie [[Eurocopter EC130 B4]].

Oprócz zwykłych statków powietrznych dostępne są również szczegółowe [[Space Shuttle|wahadłowce kosmiczne]].

=== Sceneria ===
Fascynujące jest odkrywanie [[scenery|scenerii]] (lub po prostu testowanie grafiki/szybkości klatek) za pomocą [[UFO|UFO]]. Po pierwsze, [[#Configuring rendering and UI|zwiększ swoją jakość grafiki]]. Jeśli początkowo nie widzisz budynków, pozostaw FG otwarte i odczekaj chwilę, aż [[TerraSync]] zakończy pobieranie i budynki się pojawią.
Istnieje wiele [[Suggested airports|dobrze rozwiniętych lotnisk]] i obszarów scenerii. Możesz również eksplorować obiekty scenerii na [https://scenery.flightgear.org/map mapie modeli].

=== Tryb wieloosobowy ===
FlightGear ma kilka serwerów wieloosobowych, które pozwolą Ci latać w bardziej ożywionych przestworzach; zobacz [[Howto: Multiplayer|Tryb wieloosobowy]]. Istnieją również [[OpenRadar]] i [[ATC-pie]], samodzielne programy, które pozwolą Ci być [[Air traffic control|kontrolerem ruchu lotniczego]].

Dostępna jest również [[MPMap|mapa wieloosobowa]], która pozwala zobaczyć, kto jest aktualnie online, a nawet jakie [[navaids|pomoce nawigacyjne]] są w pobliżu.

=== Elementy menu ===
Aby szybko zapoznać się z użyciem każdej pozycji menu w FlightGear, zobacz [[menu]].

=== Dodatki ===
FlightGear ma wiele [[Addon|dodatków]] innych firm zawierających ulepszenia. Dla początkujących, [[Logbook Add-on|Dziennik lotów]] i dodatek [[Which Runway Add-on|Który pas]] mogą być najbardziej przydatnymi dodatkami.

== Społeczność FlightGear ==
=== Uzyskiwanie pomocy ===
Ta strona została zaprojektowana, aby zapewnić użytkownikowi najważniejsze informacje, które musi wiedzieć o korzystaniu z FlightGeara po raz pierwszy. Oprócz [[Pl/Portal:Użytkownik|portalu użytkownika]] tej wiki, istnieją inne strony, które możesz chcieć przeczytać:
*[[Troubleshooting problems|Rozwiązywanie problemów]], aby pomóc Ci z najczęstszymi problemami;
*[[Pl/FAQ|Często zadawane pytania]];
...oraz kanały komunikacji, które mogą być używane do uzyskania informacji lub poproszenia o pomoc:
*[[Pl/Podręcznik FlightGear|Podręcznik FlightGear]], ''obowiązkowa lektura'' dla początkujących;
*{{forum link|text=Forum FlightGear}} i jego podfora;
*[[Discord|Serwer Discord FlightGear]], najszybszy sposób na uzyskanie pomocy;
*[[FlightGear IRC channel|Kanał IRC FlightGear]];
*[[Mailing list|Lista mailingowa użytkowników FlightGeara]], największa szansa na kontakt z głównymi deweloperami;
*Dokumenty dołączone do pakietu wydaniowego.

=== Dostosowywanie FlightGear bez kompilacji ===
[https://www.flightgear.org/download/ Nasza strona internetowa] oferuje prekompilowane pliki binarne do pobrania i instalacji na Windows, macOS i Linux. Ponadto większość dystrybucji Linuksa udostępnia spakowaną wersję w swoich repozytoriach.

Chociaż instalacja jest binarna, większość systemów FlightGear jest otwarta na konfigurację poprzez pliki [[XML]] i [[NASAL scripting|skrypty NASAL]]. Masz swobodę ''i jesteś zachęcany'' do wprowadzania zmian w modelach lotu statków powietrznych, scenerii, teksturach, [[shader|shaderach]] OpenGL i każdej innej funkcji, którą chcesz zmienić dla własnej satysfakcji lub podzielić się z innymi użytkownikami FlightGeara. Jeśli to zamierzasz zrobić, spójrz na [[Pl/Portal:Developer|portal dewelopera]].

=== Jak możesz pomóc ===
{{Main article|Volunteer|Wolontariusz}}
FlightGear to projekt open source, oparty na wolontariacie. Oznacza to, że wszystko, co tu znajdziesz, pochodzi z pasji, wolnego czasu i niczego więcej. Obejmuje to symulator, scenerię, statki powietrzne, wiki, {{forum link|text=forum}} i wszystko inne. Wolontariusze, w istocie ''ludzie, którzy coś robią'', są fundamentalni dla tego projektu. Bez nich nie zrobiłby ani jednego kroku do przodu. Dlatego ważne jest, aby współtwórcy dobrze się bawili tym, co robią.

Jeśli planujesz wnieść wkład w ten projekt, powinieneś zapoznać się z kilkoma artykułami, które dadzą Ci pewne wskazówki:
*[[Howto:Understand the FlightGear development process|Jak zrozumieć proces rozwoju FlightGeara]]
*[[Implementing new features for FlightGear|Wdrażanie nowych funkcji dla FlightGeara]]
*[[How the FlightGear project works|Jak działa projekt FlightGear]]

Dziedzin, w których ich pomoc byłaby doceniona, jest wiele:
;Testowanie:
*[[Building FlightGear|Skompiluj]] najnowszy kod Git
*[https://gitlab.com/flightgear/flightgear/-/issues Zgłaszaj raporty o błędach]
*Uruchamianie FlightGeara za pomocą programu valgrind w celu wykrycia wycieków pamięci

;Wsparcie:
*Pomoc nowym użytkownikom w pobieraniu, kompilowaniu, instalowaniu i uruchamianiu FlightGeara ({{forum link|text=na forum}} lub na [[Discord|Discordzie]])
*Dostarczanie pomysłów i sugestii, zobacz: [[Feature Requests / Proposals / Ideas|Prośby o funkcje / Propozycje / Pomysły]]
*Pomoc w [[Portal:Wiki|oczyszczeniu tej wiki]]
*Pomoc w dostarczaniu nowych treści dla brakujących stron wiki

;Rozwój:
*Podstawowy kod źródłowy:
**Dostarczanie [[Howto:Start core development|wkładu w kod źródłowy, dane i dokumentację]]
**Dostarczanie [[Bugs|poprawek błędów]] lub nowych funkcji
*Rozwój statków powietrznych (modelowanie 3D, tekstury, modele lotu, skrypty)
*Rozwój scenerii (teren, modele, pogoda)
*Zaangażowanie w którykolwiek z innych projektów powiązanych z FlightGearem

[[Category:FlightGear]]

[[ca:Nou a FlightGear]]
[[de:Neu bei FlightGear]]
[[en:New to FlightGear]]
[[es:Nuevo en FlightGear]]
[[fi:Uusi_käyttäjä]]
[[fr:Nouveau sur flightgear]]
[[it:Nuovo per FlightGear]]
[[ja:FlightGear入門]]
[[nl:Nieuw bij FlightGear]]
[[pt:Novo no FlightGear]]
[[sr:Novi u FlightGear-u]]
[[th:New to FlightGear]]
[[zh:FlightGear新手]]

Pl/Nowy we FlightGear

2026-06-17T12:58:12Z

PlayeRom: /* Uruchamianie silnika */

'''Witaj we [[FlightGear]]!''' Postaramy się pomóc Ci wzbić się w wirtualne powietrze w najkrótszym możliwym czasie. Przedstawimy Ci również niektóre funkcje tego symulatora lotu oraz kilka informacji o jego społeczności.

== Instalacja i konfiguracja ==
=== Wymagania sprzętowe ===
Aby FlightGear działał płynnie, wymaga karty graficznej ze sterownikami OpenGL 4.0 lub nowszymi. Zwykle nie stanowi to problemu, ale zapoznaj się z [[Pl/Wymagania_sprzętowe|zaleceniami sprzętowymi]], aby lepiej to zrozumieć.

=== Pobieranie FlightGeara ===
Możesz pobrać najnowsze pliki ze strony [https://www.flightgear.org/download/ Pobieranie FlightGear]. Wybierz pliki źródłowe lub binarne odpowiednie dla Twojego systemu. Dostępne są również pliki binarne {{Wikipedia|AppImage|AppImage}} dla Linuksa dla wersji 2020.3 LTS i nowszych. Większość użytkowników Linuksa odkryje, że większość dystrybucji ma spakowaną wersję FlightGeara (nazwa pakietu może brzmieć <code>fgfs</code> lub <code>flightgear</code>).

W zależności od Twoich umiejętności technicznych możesz wybrać deweloperską wersję [[Git]] FlightGeara, która zazwyczaj ma więcej funkcji i może być wymagana przez niektóre najnowsze rozwijane statki powietrzne, ale może być niestabilna i jest bardziej skomplikowana do zdobycia dla użytkowników innych niż Windows. Ogólnie rzecz biorąc, wersja deweloperska nie jest zalecana dla przeciętnego użytkownika, ale jeśli chcesz przeprowadzić kilka testów, dostępna jest wersja nocna do [https://www.flightgear.org/download/nightly/ pobrania]. Jeśli używasz kopii FlightGeara kontrolowanej przez system Git, możesz zsynchronizować swoje statki powietrzne za pomocą kontrolowanego przez system repozytorium rozwojowego statków powietrznych [[Pl/FGAddon|FGAddon]].

=== Instalacja w systemie Windows ===
Po pobraniu instalatora uruchom go i postępuj zgodnie z jego instrukcjami, aby zainstalować FlightGear.

Defender SmartScreen w systemie Windows może zablokować instalację po prostu dlatego, że plik binarny nie jest podpisany kluczem, który Microsoft uznaje. Oczywiście klucz jest płatny. W takim przypadku musimy kliknąć niepozorny link "Więcej informacji". Dopiero wtedy pojawi się przycisk "Uruchom mimo to". Możesz bezpiecznie zaufać, że nie jest to niebezpieczna aplikacja, pod warunkiem, że pobrałeś ją z oficjalnych źródeł.

Jeśli z jakiegoś powodu używasz oprogramowania antywirusowego innej firmy, może ono blokować instalację FlightGeara. Nie jest to coś, na co mamy wpływ, więc to od Ciebie zależy, jak chcesz to rozwiązać.

Za pomocą instalatora Windows możesz wybrać miejsce instalacji FlightGeara. Katalog [[Pl/$FG_ROOT|$FG_ROOT]] będzie miał ścieżkę <code><wybrany katalog>/fgdata_2024_1</code>.

=== Instalacja w systemie macOS ===
Instalacja FlightGeara w systemie macOS jest bardzo prosta. Wystarczy przeciągnąć i upuścić ikonę FlightGeara do folderu <code>/Applications</code>. To wszystko.

Gdy uruchamiasz FlightGeara po raz pierwszy, jego ikona w Docku podskakuje przez kilka sekund podczas ładowania informacji o statkach powietrznych i lotniskach. Gdy pojawi się graficzny program uruchamiający, wybierz statek powietrzny i lotnisko, a następnie kliknij "Lećmy!", aby uruchomić symulator. Możesz skonfigurować więcej opcji za pomocą graficznego programu uruchamiającego. Zobacz [http://flightgear.sourceforge.net/manual/next/pl/getstart-plch4.html#start-jak-uruchomic-program oficjalną instrukcję] po więcej szczegółów.

Jeśli chcesz uruchomić FlightGeara z wiersza poleceń, uruchom aplikację Terminal i wpisz następujące polecenia.

cd /Applications/FlightGear.app/Contents/MacOS
./fgfs --options.....

Zmienne [[Pl/$FG_ROOT|$FG_ROOT]] i [[$FG_SCENERY]] nie są ustawione w systemie macOS. Jeśli chcesz samodzielnie określić te zmienne do użycia w wierszu poleceń, uruchom następujące polecenia w aplikacji Terminal:

FG_ROOT=/Applications/FlightGear.app/Contents/Resources/data
FG_SCENERY=[[Pl/$FG_ROOT|$FG_ROOT]]/Scenery

Po uruchomieniu graficznego programu uruchamiającego będziesz mieć alias do [[Pl/$FG_ROOT|$FG_ROOT]] w ścieżce <code>$HOME/Documents/FlightGear/<version></code>, dzięki czemu możesz przeglądać folder danych za pomocą Findera.

Uwaga: Po zainstalowaniu FlightGeara użytkownicy komputerów Mac mogą zlokalizować swój folder [[Pl/$FG_ROOT|$FG_ROOT]], otwierając folder Aplikacje w Finderze, klikając prawym przyciskiem myszy FlightGear i wybierając "Pokaż zawartość pakietu". To przeniesie Cię do wnętrza folderu FlightGear. Masz teraz dostęp do wszystkich plików, w tym Data/Aircraft, aby [[Pl/Instalowanie_samolotów#macOS|zainstalować nowe statki powietrzne]].

=== Instalacja ze źródeł ===
Główny artykuł: [[Building FlightGear|Kompilacja FlightGeara]]

=== Pobieranie scenerii ===
Z FlightGearem instalowany jest ograniczony zestaw [[scenery|scenerii]]. Dla FlightGear 2024.1 składa się on z:
* obszaru wokół wyróżnionego lotniska dla tej wersji, czyli [[Keflavik_Airport|Międzynarodowego Portu Lotniczego Keflavik]] (BIKF)
* lotniska używanego w samouczku dla [[Pl/Cessna 172P|Cessny 172P]], czyli [[Hilo_International_Airport|Międzynarodowego Portu Lotniczego Hilo]] (PHTO)

We FlightGear sceneria jest zazwyczaj przechowywana w katalogu [[Pl/$FG_ROOT|$FG_ROOT]] i dzieli się na trzy rodzaje danych:
* '''Airports''' zawiera dane o lotniskach, takie jak wykorzystanie pasów startowych i miejsca postojowe.
* '''Objects''' i '''Models''' to budynki, mosty, wieże radiowe itp., które reprezentują trójwymiarowe struktury.
* '''Terrain''' reprezentuje kontury, wzniesienia i rodzaj terenu, nad którym latasz/kołujesz.

Obecnym sposobem "instalowania" nowej scenerii jest włączenie [[TerraSync]], które automatycznie pobierze i zaktualizuje każde odwiedzane miejsce - nawet w locie! Jeśli masz wolne połączenie internetowe i/lub wolny komputer, możesz zamiast tego użyć menedżera scenerii, na przykład [[TerraMaster]]. Dodatkowo możesz ręcznie pobrać i zainstalować nowe części scenerii, oficjalną [[World Scenery|scenerię świata]] lub niestandardową scenerię.

Sceneria jest również dostępna na [https://www.flightgear.org/download/mirrors/ stronie mirrorów] witryny FlightGear i można ją zainstalować, postępując zgodnie z instrukcją [[Howto: Install scenery|Jak zainstalować scenerię]]. '''Jest to zalecane dla użytkowników ze słabym połączeniem internetowym lub słabymi komputerami!'''

Niestandardowa sceneria jest dostępna w wielu miejscach. Na przykład na {{forum link|f=5|text=forum FlightGear}} lub w repozytoriach. Wyszukiwanie w Internecie powinno pozwolić je znaleźć. Zobacz stronę [[Suggested_custom_scenery|sugerowanej niestandardowej scenerii]] po kilka najnowszych wydań.

FlightGear 2020.3.7 LTS i nowsze dodały eksperymentalną obsługę trójwymiarowych budynków, dróg i obiektów opartych na danych OpenStreetMap dla całego świata do automatycznie pobieranych danych TerraSync - zobacz notatki o [[OSM2City 1st Worldbuild|1. światowej kompilacji OSM2City]] (marzec 2021). Ręczne pobieranie struktur 3D dla regionów lub całych krajów jest dostępne na stronie wiki z [[Areas populated with osm2city scenery|pobraniami osm2City]].

=== Pobieranie statków powietrznych ===
Dodatkowe [[Pl/Samoloty|statki powietrzne]] można pobrać i zainstalować za pomocą [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz przejść na stronę internetową FlightGeara i przejść do strony [http://www.flightgear.org/download/ pobierania], a następnie wybrać link do pobrania statków powietrznych pasujący do Twojej wersji FlightGeara. Ponadto istnieje wiele [[hangars|hangarów]] innych firm. Informacje o instalacji znajdziesz w [[Pl/Instalowanie samolotów|Jak zainstalować statek powietrzny]].

== Uruchamianie FlightGeara ==
=== Uruchamianie FlightGeara ===
Najłatwiejszym sposobem uruchomienia FlightGeara jest użycie ikony na pulpicie. Uruchamia to interfejs graficzny [[FlightGear Qt launcher|Launchera]], w którym możesz wybrać statek powietrzny, pozycję startową itp.  Pamiętaj, że Launcher ma tylko podstawowe opcje, aby Ci pomóc. Wiele opcji dotyczących grafiki, scenerii, [[Weather|pogody]], [https://www.flightgear.org/tours/simulating-the-ever-changing-scenery/ środowiska], [[Input_device|urządzeń wejściowych]] itp. jest dostępnych z [[menu|menu]] wewnątrz symulatora.

Wielu użytkowników wybiera jednak uruchamianie FlightGeara bezpośrednio z wiersza poleceń. Nazwa pliku wykonywalnego to <code>fgfs</code> (lub plik AppImage, np. "flightgear-2024.1.6-linux-amd64.AppImage") i można go uruchomić bez opcji. Jeśli "nie został znaleziony", prawdopodobnie nie znajduje się w Twojej [https://en.wikipedia.org/wiki/PATH_(variable) ścieżce]. Lokalizacja zależy od Twojego konkretnego systemu i wyborów dokonanych podczas kompilacji i instalacji. Istnieje lista [[Pl/Opcje_wiersza_poleceń|parametrów wiersza poleceń]], których należy użyć do zmiany wielu opcji, takich jak wybrany statek powietrzny. Najważniejsze z nich:

fgfs --launcher # otwiera Launcher FlightGeara
fgfs --show-aircraft # wyświetla listę zainstalowanych statków powietrznych
fgfs --aircraft=c172p # uruchamia FG z statkiem powietrznym "c172p" (z listy)

Launcher umożliwia również użytkownikom dodawanie parametrów wiersza poleceń dla opcji, które są zwykle zmieniane z poziomu menu wewnątrz symulatora, a także dość zaawansowanych opcji dostępnych tylko z wiersza poleceń.

=== Konfiguracja renderowania i interfejsu użytkownika ===
[[File:Rendering options 2024.1.png|thumb|Okno dialogowe Widok > Opcje renderowania.]]
Jeśli jakość renderowania lub liczba klatek na sekundę jest zbyt niska, kliknij "Widok > Opcje renderowania", aby dostosować ustawienia graficzne. Dla nowszego sprzętu zaleca się ustawienie "jakości grafiki" na wysoką i zaznaczenie "użyj miejsca na dysku dla szybszego ładowania", "animowane rękawy" i "satelitarna fotosceneria".

Jeśli tekst menu wydaje się zbyt mały na ekranach o wysokiej rozdzielczości lub dużych ekranach, możesz ręcznie [[Menubar#How to Change the Default Menubar Font Size|zmienić rozmiar czcionki paska menu]], edytując plik danych, lub po prostu kliknąć "Debuguj > Zmień styl GUI".

=== Używanie klawiatury i/lub myszy ===
Użytkownicy z ograniczonym dostępem do [[joystick|joysticka]] lub innych kontrolerów czasami używają klawiatury lub myszy do sterowania swoim statkiem powietrznym. Używanie klawiatury do latania może być trudne, a mysz jest zalecana zamiast klawiatury do latania, jednak nawet tani joystick znacznie poprawiłby wrażenia.

Aby uzyskać pomoc dotyczącą poleceń klawiatury, gdy FlightGear jest uruchomiony, przejdź do menu ''Pomoc'', spójrz w ''Podstawowe klawisze'' (dla poleceń związanych z symulatorem), ''Wspólne klawisze statków powietrznych'' (dla poleceń uniwersalnych dla wszystkich statków powietrznych) i ''Pomoc dla statku powietrznego'' (dla poleceń specyficznych dla Twojego statku). Jeśli główne menu jest ukryte, naciśnij {{key press|F10}}. Jeśli przychodzisz z innych symulatorów, sprawdź [[key commands compared to other simulators|porównanie poleceń klawiatury z innymi symulatorami]], aby uzyskać przegląd różnic między poleceniami klawiatury tego symulatora a FlightGear.

Aby użyć myszy do latania statkiem powietrznym, naciśnij {{key press|Tab}} (kursor powinien zmienić się w krzyżyk) i przesuwaj myszą, aby kierować statkiem powietrznym. Naciśnij ponownie {{key press|Tab}}, aby rozglądać się (kursor powinien pokazywać dwustronną strzałkę), i naciśnij {{key press|Tab}} ponownie, aby wrócić do trybu normalnego, używanego do klikania elementów w kokpicie. Możesz kliknąć "Plik > Urządzenia wejściowe > Konfiguracja myszy", aby dostosować czułość myszy.

Dla większości użytkowników nieposiadających kontroli osi steru kierunku, trudno jest ręcznie koordynować ruchy [[aileron|lotki]] i [[rudder|steru kierunku]] podczas zakrętu. Aby włączyć autokoordynację i ułatwić latanie, możesz kliknąć "Ustawienia", następnie kliknąć przycisk "Pokaż więcej" po prawej stronie "Ogólne", a na końcu kliknąć "Włącz autokoordynację" w Launcherze.

=== Pierwszy raz w kokpicie ===
Orientacja w kokpicie może być wyzwaniem za pierwszym razem.

Możesz użyć {{key press|Ctrl|V}}, aby przełączyć się na widok kokpitu. Jeśli tekst na panelu jest zbyt mały, możesz użyć trybu widoku myszy (naciśnij Tab, aż uzyskasz kursor w kształcie podwójnej strzałki), aby przesuwać widok, i kółko myszy, aby przybliżać, lub przesuwać widok za pomocą czapki joysticka i przybliżać za pomocą {{key press|X}} i {{key press|Shift|X}}.

Jednym z pierwszych kroków, które wielu podejmuje po wejściu do nieznanego kokpitu, jest naciśnięcie {{key press|Ctrl|C}} w celu podświetlenia wszystkich "gorących punktów", czyli elementów sterujących przyrządami, przycisków, pokręteł itp. Wiele statków powietrznych oferuje również specjalne menu pomocy.

Niektóre funkcje, takie jak rozrusznik lub magneto, mogą być trudne w użyciu lub po prostu nie mieć klikalnych "gorących punktów", zwłaszcza w modelach statków powietrznych w fazie rozwoju. W większości przypadków możesz użyć klawiatury. Klawiatura zawsze działa zgodnie z przypisaniami wymienionymi w menu "Pomoc > Pomoc dla statku powietrznego" lub "Pomoc > Wspólne klawisze statków powietrznych", ale czasami niektóre klawisze są przypisywane ponownie przez statek powietrzny lub konfigurację. Ponownie, pamiętaj, aby sprawdzić wszystkie okna dialogowe pomocy.

=== Uruchamianie silnika ===
Chcesz już lecieć, ale silnik jest wyłączony. Cóż, włączanie silników nie zawsze jest łatwe. Większość statków powietrznych ma wpis ''autostart'' w swoim niestandardowym menu, ale oto ogólna procedura, która powinna działać w wielu przypadkach:

Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem tłokowym, potrzebujesz (po upewnieniu się, że gra nie jest wstrzymana {{key press|p}}):
# Paliwo: niektóre statki powietrzne rozpoczynają symulację bez paliwa. Możesz je dodać w ''Wyposażenie'' > ''Paliwo i ładunek''.
# Prawidłowa mieszanka paliwowa: zazwyczaj jest ''bogata'', więc wciśnij czerwony pokrętło do samego końca lub użyj klawisza {{key press|m}}, aby wzbogacić ({{key press|Shift|m}} zuboża).
# Iskrowniki ustawione na ''Both'': obróć kluczyk lub naciśnij {{key press|}}} trzy razy, aby przejść przez ''R'', ''L'' do ''Both''.
# Przepustnica: niektóre silniki lepiej uruchamiają się przy odrobinie gazu.
# Uruchom rozrusznik: kliknij pozycję ''Start'' kluczyka na panelu lub naciśnij {{key press|s}}. Przytrzymaj rozrusznik przez wystarczający czas, nawet 10 sekund.

Uruchamianie wszystkich silników w statku powietrznym z wieloma silnikami jest podobne do uruchamiania pojedynczego silnika - z tą różnicą, że musisz powtórzyć tę samą sekwencję rozruchu dla każdego silnika. FlightGear oferuje wygodny sposób, aby zrobić to dla wszystkich silników jednocześnie: naciśnij {{key press|~}} i cała powyższa procedura zadziała dla wszystkich silników. Należy jednak pamiętać, że domyślny panel 2D jest podłączony do ''tylko jednego silnika'' i sztuczka z {{key press|~}} może nie zadziałać. Dodaj też trochę gazu, aby upewnić się, że wszystkie silniki są włączone.

Te instrukcje mogą nie działać dla odrzutowców, śmigłowców lub innych typów statków powietrznych o złożonych procedurach rozruchu. Sprawdź instrukcje w menu pomocy statku powietrznego (naciśnij {{key press|?}}) i/lub spójrz na [[Aircraft|artykuł o tym statku powietrznym na tej wiki]]. Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem odrzutowym, musisz:
# Ustawić odcięcie ''ON''
# Włączyć rozrusznik
# Gdy silniki osiągną około 5% N1, ustawić odcięcie ''OFF''
# Wyłączyć rozrusznik, gdy silnik osiągnie prędkość roboczą

== Nauka latania ==
=== Podręcznik FlightGear ===
FlightGear ma oficjalny [https://www.flightgear.org/support/manual/ podręcznik], który obejmuje podstawy latania. Jako początkujący, możesz chcieć zacząć od [https://flightgear.gitlab.io/getstart/release-{{current release|cr}}/pl/HTML/getstart-plch8.html Rozdziału 8: Podstawowy poradnik symulatora lotu].

=== Samouczki ===
Wiele statków powietrznych ma własne interaktywne [[tutorials|samouczki]]. Dzięki samouczkom możesz nauczyć się obsługiwać konkretny statek powietrzny, ale także nauczyć się latać. Możesz uzyskać dostęp do samouczków, przechodząc do ''Pomoc'' > ''Samouczek''. Świetnym miejscem na rozpoczęcie jest samouczek dla statku powietrznego [[Cessna 172P]], powszechnie używanego w rzeczywistości do nauki latania statkami powietrznymi o stałych skrzydłach.

Jeśli samouczek zaczyna się bez pasa startowego i w otoczeniu wody, Twoja instalacja FlightGeara nie ma scenerii dla lotniska, na którym samouczek miał się odbyć. Aby uzyskać scenerię, zobacz sekcję [[#Getting scenery|#Pobieranie scenerii]] powyżej.

== Twój pierwszy lot ==
=== Realizm ===
Jednym z najczęstszych pytań, jakie zadają początkujący piloci na temat każdego symulatora lotu, ale zwłaszcza FlightGeara, jest "Dlaczego mój statek powietrzny cały czas skręca w lewo?" Chociaż może to być spowodowane podmuchami wiatru przecinającymi pas startowy, bardziej prawdopodobne jest, że wynika to z [[Understanding Propeller Torque and P-Factor|momentu obrotowego śmigła i efektu P]].

W niektórych innych symulatorach lotu, pomimo haseł marketingowych głoszących co innego, niektóre ustawienia są obniżone, aby statek powietrzny był łatwiejszy w pilotażu. Zmniejsza to efekty takie jak powyższy. Realizm we FlightGear jest zawsze podkręcony do maksimum.

Oto niektóre punkty realizmu FlightGeara, które mogą dezorientować początkujących pilotów:
* "Syndrom skręcania w lewo" z wyżej wymienionych powodów.
* Błąd skrętu kompasu: Kompas, poddany siłom lotu, ma tendencję do skręcania w przeciwnym kierunku na krótki okres, zanim ustabilizuje się na prawidłowym kursie. Nie jest to usterka (zobacz także artykuł Wikipedii {{wikipedia|Aircraft compass turns}}).
* Wskaźnik prędkości pionowej (VSI) również jest obarczony błędem.
* [[Horizontal Situation Indicator|Wskaźnik sytuacji poziomej]] (HSI) jest napędzany przez żyroskop (dlatego czasami nazywa się go żyroskopem kierunkowym), który podlega ''dryfowi żyroskopowemu''. Wskaźnik będzie odchylać się od aktualnego kursu i musi być okresowo (co ~15 minut) kalibrowany, aby zgadzał się z kursem kompasu magnetycznego.
* Nie możesz po prostu przerwać skrętu lub wznoszenia poprzez wycentrowanie drążka lub pałki sterowniczej. Musisz skręcić lub popchnąć drążek w drugą stronę, aby wrócić do lotu poziomego. Ale nawet wtedy samolot nie utrzyma samodzielnie swojej wysokości ani kursu. Częstym błędem jest próba znalezienia pozycji drążka, przy której można puścić stery. Chociaż za pomocą trymowania można zostawić samolot na kilka sekund, trzeba użyć autopilota lub stale regulować drążek.

Na statek powietrzny w locie działa wiele sił, a także na [[avionics and instruments|awionikę i przyrządy]] używane do sterowania i nawigacji, co może być sprzeczne z intuicją. Piloci muszą nauczyć się rozpoznawać te zjawiska i kompensować ich skutki. ''FlightGear modeluje błędy przyrządów, które istnieją w rzeczywistym świecie''. Jeśli nie chcesz tego, naciśnij {{key press|h}}, aby włączyć HUD.

=== Lotniska i pomoce nawigacyjne ===
Gdy po raz pierwszy uruchamiasz FlightGear, czy to z wiersza poleceń, czy z interfejsu Launchera, możesz zastanawiać się, jak określić, jakie lotniska są dostępne. Program uruchamiający wyświetla listę lotnisk, ale nie zobaczysz szczegółów, takich jak częstotliwości wieży lub [[ILS|ILS]]. Nie znajdziesz mapy pokazującej [[VOR|VOR-y]] i ich częstotliwości. Co możesz zrobić? Zobacz [[Getting aeronautical charts|Pozyskiwanie map lotniczych]].

W symulatorze dostępna jest mapa, której możesz użyć w ''Menu główne'' > ''Wyposażenie'' > ''Mapa'', która pozwoli Ci zobaczyć dane nawigacyjne oraz pozycję lotnisk i pomocy. Aby uzyskać więcej pomocy dotyczącej nawigacji, zobacz [[Understanding navigation|Zrozumienie nawigacji]].

=== Latanie z autopilotem ===
Ogólny [[autopilot|autopilot]] jest dostępny w menu ''Autopilot > Ustawienia autopilota'', podczas gdy wiele statków powietrznych ma własny ''specyficzny'' autopilot, często będący modelem rzeczywistego.

W przypadku statków powietrznych, które mają własny autopilot, powinieneś używać elementów sterujących autopilotem dostępnych w wirtualnym kokpicie. Oznacza to klikanie na panelu przyrządów w wirtualnym kokpicie. Menu Autopilot może być wyszarzone i niedostępne, gdy statek powietrzny dostarcza własny autopilot w niektórych statkach powietrznych, w tym Airbuses i [[Cessna 172P|C172P]].

Cessna 172 jest wyposażona w [[Bendix/King KAP140 Autopilot|autopilot Bendix/King KAP140]] w swoim wirtualnym kokpicie. Możesz używać zarówno urządzenia autopilota w kokpicie, jak i [[Autopilot#Autopilot Settings|ustawień autopilota]] z menu.

== Zaawansowane ==
=== Latanie ===
{{Main article|Aircraft|Statki powietrzne}}

* Jeśli nadal latasz lekkimi cywilnymi statkami powietrznymi, [[Cessna 182S]], która jest bardziej złożona niż C172P, oraz [[Piper PA28 Warrior II|PA28]] to dobre wybory.
* Jeśli interesuje Cię latanie liniami lotniczymi, sugeruje się rodziny [[Airbus A320 family|Airbus A320]], Boeing [[Boeing 777|777]]/[[Boeing 787-8 Dreamliner|787]], [[MD-11]] i [[MD-80]].
* Jeśli fascynują Cię samoloty myśliwskie, wybierz wysoko oceniany wojskowy statek powietrzny (taki jak [[General Dynamics F-16 Fighting Falcon|F-16]]/[[F-15]]) z [[Aircraft#Modern military aircraft|tej listy]] i włącz obrażenia w trybie wieloosobowym lub zainstaluj [[Bombable]].
* Jeśli przechodzisz na śmigłowce, zaleca się latanie [[Eurocopter EC130 B4]].

Oprócz zwykłych statków powietrznych dostępne są również szczegółowe [[Space Shuttle|wahadłowce kosmiczne]].

=== Sceneria ===
Fascynujące jest odkrywanie [[scenery|scenerii]] (lub po prostu testowanie grafiki/szybkości klatek) za pomocą [[UFO|UFO]]. Po pierwsze, [[#Configuring rendering and UI|zwiększ swoją jakość grafiki]]. Jeśli początkowo nie widzisz budynków, pozostaw FG otwarte i odczekaj chwilę, aż [[TerraSync]] zakończy pobieranie i budynki się pojawią.
Istnieje wiele [[Suggested airports|dobrze rozwiniętych lotnisk]] i obszarów scenerii. Możesz również eksplorować obiekty scenerii na [https://scenery.flightgear.org/map mapie modeli].

=== Tryb wieloosobowy ===
FlightGear ma kilka serwerów wieloosobowych, które pozwolą Ci latać w bardziej ożywionych przestworzach; zobacz [[Howto: Multiplayer|Tryb wieloosobowy]]. Istnieją również [[OpenRadar]] i [[ATC-pie]], samodzielne programy, które pozwolą Ci być [[Air traffic control|kontrolerem ruchu lotniczego]].

Dostępna jest również [[MPMap|mapa wieloosobowa]], która pozwala zobaczyć, kto jest aktualnie online, a nawet jakie [[navaids|pomoce nawigacyjne]] są w pobliżu.

=== Elementy menu ===
Aby szybko zapoznać się z użyciem każdej pozycji menu w FlightGear, zobacz [[menu]].

=== Dodatki ===
FlightGear ma wiele [[Addon|dodatków]] innych firm zawierających ulepszenia. Dla początkujących, [[Logbook Add-on|Dziennik lotów]] i dodatek [[Which Runway Add-on|Który pas]] mogą być najbardziej przydatnymi dodatkami.

== Społeczność FlightGear ==
=== Uzyskiwanie pomocy ===
Ta strona została zaprojektowana, aby zapewnić użytkownikowi najważniejsze informacje, które musi wiedzieć o korzystaniu z FlightGeara po raz pierwszy. Oprócz [[Pl/Portal:Użytkownik|portalu użytkownika]] tej wiki, istnieją inne strony, które możesz chcieć przeczytać:
*[[Troubleshooting problems|Rozwiązywanie problemów]], aby pomóc Ci z najczęstszymi problemami;
*[[Pl/FAQ|Często zadawane pytania]];
...oraz kanały komunikacji, które mogą być używane do uzyskania informacji lub poproszenia o pomoc:
*[[Pl/Podręcznik FlightGear|Podręcznik FlightGear]], ''obowiązkowa lektura'' dla początkujących;
*{{forum link|text=Forum FlightGear}} i jego podfora;
*[[Discord|Serwer Discord FlightGear]], najszybszy sposób na uzyskanie pomocy;
*[[FlightGear IRC channel|Kanał IRC FlightGear]];
*[[Mailing list|Lista mailingowa użytkowników FlightGeara]], największa szansa na kontakt z głównymi deweloperami;
*Dokumenty dołączone do pakietu wydaniowego.

=== Dostosowywanie FlightGear bez kompilacji ===
[https://www.flightgear.org/download/ Nasza strona internetowa] oferuje prekompilowane pliki binarne do pobrania i instalacji na Windows, macOS i Linux. Ponadto większość dystrybucji Linuksa udostępnia spakowaną wersję w swoich repozytoriach.

Chociaż instalacja jest binarna, większość systemów FlightGear jest otwarta na konfigurację poprzez pliki [[XML]] i [[NASAL scripting|skrypty NASAL]]. Masz swobodę ''i jesteś zachęcany'' do wprowadzania zmian w modelach lotu statków powietrznych, scenerii, teksturach, [[shader|shaderach]] OpenGL i każdej innej funkcji, którą chcesz zmienić dla własnej satysfakcji lub podzielić się z innymi użytkownikami FlightGeara. Jeśli to zamierzasz zrobić, spójrz na [[Pl/Portal:Developer|portal dewelopera]].

=== Jak możesz pomóc ===
{{Main article|Volunteer|Wolontariusz}}
FlightGear to projekt open source, oparty na wolontariacie. Oznacza to, że wszystko, co tu znajdziesz, pochodzi z pasji, wolnego czasu i niczego więcej. Obejmuje to symulator, scenerię, statki powietrzne, wiki, {{forum link|text=forum}} i wszystko inne. Wolontariusze, w istocie ''ludzie, którzy coś robią'', są fundamentalni dla tego projektu. Bez nich nie zrobiłby ani jednego kroku do przodu. Dlatego ważne jest, aby współtwórcy dobrze się bawili tym, co robią.

Jeśli planujesz wnieść wkład w ten projekt, powinieneś zapoznać się z kilkoma artykułami, które dadzą Ci pewne wskazówki:
*[[Howto:Understand the FlightGear development process|Jak zrozumieć proces rozwoju FlightGeara]]
*[[Implementing new features for FlightGear|Wdrażanie nowych funkcji dla FlightGeara]]
*[[How the FlightGear project works|Jak działa projekt FlightGear]]

Dziedzin, w których ich pomoc byłaby doceniona, jest wiele:
;Testowanie:
*[[Building FlightGear|Skompiluj]] najnowszy kod Git
*[https://gitlab.com/flightgear/flightgear/-/issues Zgłaszaj raporty o błędach]
*Uruchamianie FlightGeara za pomocą programu valgrind w celu wykrycia wycieków pamięci

;Wsparcie:
*Pomoc nowym użytkownikom w pobieraniu, kompilowaniu, instalowaniu i uruchamianiu FlightGeara ({{forum link|text=na forum}} lub na [[Discord|Discordzie]])
*Dostarczanie pomysłów i sugestii, zobacz: [[Feature Requests / Proposals / Ideas|Prośby o funkcje / Propozycje / Pomysły]]
*Pomoc w [[Portal:Wiki|oczyszczeniu tej wiki]]
*Pomoc w dostarczaniu nowych treści dla brakujących stron wiki

;Rozwój:
*Podstawowy kod źródłowy:
**Dostarczanie [[Howto:Start core development|wkładu w kod źródłowy, dane i dokumentację]]
**Dostarczanie [[Bugs|poprawek błędów]] lub nowych funkcji
*Rozwój statków powietrznych (modelowanie 3D, tekstury, modele lotu, skrypty)
*Rozwój scenerii (teren, modele, pogoda)
*Zaangażowanie w którykolwiek z innych projektów powiązanych z FlightGearem

[[Category:FlightGear]]

[[ca:Nou a FlightGear]]
[[de:Neu bei FlightGear]]
[[en:New to FlightGear]]
[[es:Nuevo en FlightGear]]
[[fi:Uusi_käyttäjä]]
[[fr:Nouveau sur flightgear]]
[[it:Nuovo per FlightGear]]
[[ja:FlightGear入門]]
[[nl:Nieuw bij FlightGear]]
[[pt:Novo no FlightGear]]
[[sr:Novi u FlightGear-u]]
[[th:New to FlightGear]]
[[zh:FlightGear新手]]

Pl/Nowy we FlightGear

2026-06-17T12:53:22Z

PlayeRom: /* Uruchamianie silnika */

'''Witaj we [[FlightGear]]!''' Postaramy się pomóc Ci wzbić się w wirtualne powietrze w najkrótszym możliwym czasie. Przedstawimy Ci również niektóre funkcje tego symulatora lotu oraz kilka informacji o jego społeczności.

== Instalacja i konfiguracja ==
=== Wymagania sprzętowe ===
Aby FlightGear działał płynnie, wymaga karty graficznej ze sterownikami OpenGL 4.0 lub nowszymi. Zwykle nie stanowi to problemu, ale zapoznaj się z [[Pl/Wymagania_sprzętowe|zaleceniami sprzętowymi]], aby lepiej to zrozumieć.

=== Pobieranie FlightGeara ===
Możesz pobrać najnowsze pliki ze strony [https://www.flightgear.org/download/ Pobieranie FlightGear]. Wybierz pliki źródłowe lub binarne odpowiednie dla Twojego systemu. Dostępne są również pliki binarne {{Wikipedia|AppImage|AppImage}} dla Linuksa dla wersji 2020.3 LTS i nowszych. Większość użytkowników Linuksa odkryje, że większość dystrybucji ma spakowaną wersję FlightGeara (nazwa pakietu może brzmieć <code>fgfs</code> lub <code>flightgear</code>).

W zależności od Twoich umiejętności technicznych możesz wybrać deweloperską wersję [[Git]] FlightGeara, która zazwyczaj ma więcej funkcji i może być wymagana przez niektóre najnowsze rozwijane statki powietrzne, ale może być niestabilna i jest bardziej skomplikowana do zdobycia dla użytkowników innych niż Windows. Ogólnie rzecz biorąc, wersja deweloperska nie jest zalecana dla przeciętnego użytkownika, ale jeśli chcesz przeprowadzić kilka testów, dostępna jest wersja nocna do [https://www.flightgear.org/download/nightly/ pobrania]. Jeśli używasz kopii FlightGeara kontrolowanej przez system Git, możesz zsynchronizować swoje statki powietrzne za pomocą kontrolowanego przez system repozytorium rozwojowego statków powietrznych [[Pl/FGAddon|FGAddon]].

=== Instalacja w systemie Windows ===
Po pobraniu instalatora uruchom go i postępuj zgodnie z jego instrukcjami, aby zainstalować FlightGear.

Defender SmartScreen w systemie Windows może zablokować instalację po prostu dlatego, że plik binarny nie jest podpisany kluczem, który Microsoft uznaje. Oczywiście klucz jest płatny. W takim przypadku musimy kliknąć niepozorny link "Więcej informacji". Dopiero wtedy pojawi się przycisk "Uruchom mimo to". Możesz bezpiecznie zaufać, że nie jest to niebezpieczna aplikacja, pod warunkiem, że pobrałeś ją z oficjalnych źródeł.

Jeśli z jakiegoś powodu używasz oprogramowania antywirusowego innej firmy, może ono blokować instalację FlightGeara. Nie jest to coś, na co mamy wpływ, więc to od Ciebie zależy, jak chcesz to rozwiązać.

Za pomocą instalatora Windows możesz wybrać miejsce instalacji FlightGeara. Katalog [[Pl/$FG_ROOT|$FG_ROOT]] będzie miał ścieżkę <code><wybrany katalog>/fgdata_2024_1</code>.

=== Instalacja w systemie macOS ===
Instalacja FlightGeara w systemie macOS jest bardzo prosta. Wystarczy przeciągnąć i upuścić ikonę FlightGeara do folderu <code>/Applications</code>. To wszystko.

Gdy uruchamiasz FlightGeara po raz pierwszy, jego ikona w Docku podskakuje przez kilka sekund podczas ładowania informacji o statkach powietrznych i lotniskach. Gdy pojawi się graficzny program uruchamiający, wybierz statek powietrzny i lotnisko, a następnie kliknij "Lećmy!", aby uruchomić symulator. Możesz skonfigurować więcej opcji za pomocą graficznego programu uruchamiającego. Zobacz [http://flightgear.sourceforge.net/manual/next/pl/getstart-plch4.html#start-jak-uruchomic-program oficjalną instrukcję] po więcej szczegółów.

Jeśli chcesz uruchomić FlightGeara z wiersza poleceń, uruchom aplikację Terminal i wpisz następujące polecenia.

cd /Applications/FlightGear.app/Contents/MacOS
./fgfs --options.....

Zmienne [[Pl/$FG_ROOT|$FG_ROOT]] i [[$FG_SCENERY]] nie są ustawione w systemie macOS. Jeśli chcesz samodzielnie określić te zmienne do użycia w wierszu poleceń, uruchom następujące polecenia w aplikacji Terminal:

FG_ROOT=/Applications/FlightGear.app/Contents/Resources/data
FG_SCENERY=[[Pl/$FG_ROOT|$FG_ROOT]]/Scenery

Po uruchomieniu graficznego programu uruchamiającego będziesz mieć alias do [[Pl/$FG_ROOT|$FG_ROOT]] w ścieżce <code>$HOME/Documents/FlightGear/<version></code>, dzięki czemu możesz przeglądać folder danych za pomocą Findera.

Uwaga: Po zainstalowaniu FlightGeara użytkownicy komputerów Mac mogą zlokalizować swój folder [[Pl/$FG_ROOT|$FG_ROOT]], otwierając folder Aplikacje w Finderze, klikając prawym przyciskiem myszy FlightGear i wybierając "Pokaż zawartość pakietu". To przeniesie Cię do wnętrza folderu FlightGear. Masz teraz dostęp do wszystkich plików, w tym Data/Aircraft, aby [[Pl/Instalowanie_samolotów#macOS|zainstalować nowe statki powietrzne]].

=== Instalacja ze źródeł ===
Główny artykuł: [[Building FlightGear|Kompilacja FlightGeara]]

=== Pobieranie scenerii ===
Z FlightGearem instalowany jest ograniczony zestaw [[scenery|scenerii]]. Dla FlightGear 2024.1 składa się on z:
* obszaru wokół wyróżnionego lotniska dla tej wersji, czyli [[Keflavik_Airport|Międzynarodowego Portu Lotniczego Keflavik]] (BIKF)
* lotniska używanego w samouczku dla [[Pl/Cessna 172P|Cessny 172P]], czyli [[Hilo_International_Airport|Międzynarodowego Portu Lotniczego Hilo]] (PHTO)

We FlightGear sceneria jest zazwyczaj przechowywana w katalogu [[Pl/$FG_ROOT|$FG_ROOT]] i dzieli się na trzy rodzaje danych:
* '''Airports''' zawiera dane o lotniskach, takie jak wykorzystanie pasów startowych i miejsca postojowe.
* '''Objects''' i '''Models''' to budynki, mosty, wieże radiowe itp., które reprezentują trójwymiarowe struktury.
* '''Terrain''' reprezentuje kontury, wzniesienia i rodzaj terenu, nad którym latasz/kołujesz.

Obecnym sposobem "instalowania" nowej scenerii jest włączenie [[TerraSync]], które automatycznie pobierze i zaktualizuje każde odwiedzane miejsce - nawet w locie! Jeśli masz wolne połączenie internetowe i/lub wolny komputer, możesz zamiast tego użyć menedżera scenerii, na przykład [[TerraMaster]]. Dodatkowo możesz ręcznie pobrać i zainstalować nowe części scenerii, oficjalną [[World Scenery|scenerię świata]] lub niestandardową scenerię.

Sceneria jest również dostępna na [https://www.flightgear.org/download/mirrors/ stronie mirrorów] witryny FlightGear i można ją zainstalować, postępując zgodnie z instrukcją [[Howto: Install scenery|Jak zainstalować scenerię]]. '''Jest to zalecane dla użytkowników ze słabym połączeniem internetowym lub słabymi komputerami!'''

Niestandardowa sceneria jest dostępna w wielu miejscach. Na przykład na {{forum link|f=5|text=forum FlightGear}} lub w repozytoriach. Wyszukiwanie w Internecie powinno pozwolić je znaleźć. Zobacz stronę [[Suggested_custom_scenery|sugerowanej niestandardowej scenerii]] po kilka najnowszych wydań.

FlightGear 2020.3.7 LTS i nowsze dodały eksperymentalną obsługę trójwymiarowych budynków, dróg i obiektów opartych na danych OpenStreetMap dla całego świata do automatycznie pobieranych danych TerraSync - zobacz notatki o [[OSM2City 1st Worldbuild|1. światowej kompilacji OSM2City]] (marzec 2021). Ręczne pobieranie struktur 3D dla regionów lub całych krajów jest dostępne na stronie wiki z [[Areas populated with osm2city scenery|pobraniami osm2City]].

=== Pobieranie statków powietrznych ===
Dodatkowe [[Pl/Samoloty|statki powietrzne]] można pobrać i zainstalować za pomocą [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz przejść na stronę internetową FlightGeara i przejść do strony [http://www.flightgear.org/download/ pobierania], a następnie wybrać link do pobrania statków powietrznych pasujący do Twojej wersji FlightGeara. Ponadto istnieje wiele [[hangars|hangarów]] innych firm. Informacje o instalacji znajdziesz w [[Pl/Instalowanie samolotów|Jak zainstalować statek powietrzny]].

== Uruchamianie FlightGeara ==
=== Uruchamianie FlightGeara ===
Najłatwiejszym sposobem uruchomienia FlightGeara jest użycie ikony na pulpicie. Uruchamia to interfejs graficzny [[FlightGear Qt launcher|Launchera]], w którym możesz wybrać statek powietrzny, pozycję startową itp.  Pamiętaj, że Launcher ma tylko podstawowe opcje, aby Ci pomóc. Wiele opcji dotyczących grafiki, scenerii, [[Weather|pogody]], [https://www.flightgear.org/tours/simulating-the-ever-changing-scenery/ środowiska], [[Input_device|urządzeń wejściowych]] itp. jest dostępnych z [[menu|menu]] wewnątrz symulatora.

Wielu użytkowników wybiera jednak uruchamianie FlightGeara bezpośrednio z wiersza poleceń. Nazwa pliku wykonywalnego to <code>fgfs</code> (lub plik AppImage, np. "flightgear-2024.1.6-linux-amd64.AppImage") i można go uruchomić bez opcji. Jeśli "nie został znaleziony", prawdopodobnie nie znajduje się w Twojej [https://en.wikipedia.org/wiki/PATH_(variable) ścieżce]. Lokalizacja zależy od Twojego konkretnego systemu i wyborów dokonanych podczas kompilacji i instalacji. Istnieje lista [[Pl/Opcje_wiersza_poleceń|parametrów wiersza poleceń]], których należy użyć do zmiany wielu opcji, takich jak wybrany statek powietrzny. Najważniejsze z nich:

fgfs --launcher # otwiera Launcher FlightGeara
fgfs --show-aircraft # wyświetla listę zainstalowanych statków powietrznych
fgfs --aircraft=c172p # uruchamia FG z statkiem powietrznym "c172p" (z listy)

Launcher umożliwia również użytkownikom dodawanie parametrów wiersza poleceń dla opcji, które są zwykle zmieniane z poziomu menu wewnątrz symulatora, a także dość zaawansowanych opcji dostępnych tylko z wiersza poleceń.

=== Konfiguracja renderowania i interfejsu użytkownika ===
[[File:Rendering options 2024.1.png|thumb|Okno dialogowe Widok > Opcje renderowania.]]
Jeśli jakość renderowania lub liczba klatek na sekundę jest zbyt niska, kliknij "Widok > Opcje renderowania", aby dostosować ustawienia graficzne. Dla nowszego sprzętu zaleca się ustawienie "jakości grafiki" na wysoką i zaznaczenie "użyj miejsca na dysku dla szybszego ładowania", "animowane rękawy" i "satelitarna fotosceneria".

Jeśli tekst menu wydaje się zbyt mały na ekranach o wysokiej rozdzielczości lub dużych ekranach, możesz ręcznie [[Menubar#How to Change the Default Menubar Font Size|zmienić rozmiar czcionki paska menu]], edytując plik danych, lub po prostu kliknąć "Debuguj > Zmień styl GUI".

=== Używanie klawiatury i/lub myszy ===
Użytkownicy z ograniczonym dostępem do [[joystick|joysticka]] lub innych kontrolerów czasami używają klawiatury lub myszy do sterowania swoim statkiem powietrznym. Używanie klawiatury do latania może być trudne, a mysz jest zalecana zamiast klawiatury do latania, jednak nawet tani joystick znacznie poprawiłby wrażenia.

Aby uzyskać pomoc dotyczącą poleceń klawiatury, gdy FlightGear jest uruchomiony, przejdź do menu ''Pomoc'', spójrz w ''Podstawowe klawisze'' (dla poleceń związanych z symulatorem), ''Wspólne klawisze statków powietrznych'' (dla poleceń uniwersalnych dla wszystkich statków powietrznych) i ''Pomoc dla statku powietrznego'' (dla poleceń specyficznych dla Twojego statku). Jeśli główne menu jest ukryte, naciśnij {{key press|F10}}. Jeśli przychodzisz z innych symulatorów, sprawdź [[key commands compared to other simulators|porównanie poleceń klawiatury z innymi symulatorami]], aby uzyskać przegląd różnic między poleceniami klawiatury tego symulatora a FlightGear.

Aby użyć myszy do latania statkiem powietrznym, naciśnij {{key press|Tab}} (kursor powinien zmienić się w krzyżyk) i przesuwaj myszą, aby kierować statkiem powietrznym. Naciśnij ponownie {{key press|Tab}}, aby rozglądać się (kursor powinien pokazywać dwustronną strzałkę), i naciśnij {{key press|Tab}} ponownie, aby wrócić do trybu normalnego, używanego do klikania elementów w kokpicie. Możesz kliknąć "Plik > Urządzenia wejściowe > Konfiguracja myszy", aby dostosować czułość myszy.

Dla większości użytkowników nieposiadających kontroli osi steru kierunku, trudno jest ręcznie koordynować ruchy [[aileron|lotki]] i [[rudder|steru kierunku]] podczas zakrętu. Aby włączyć autokoordynację i ułatwić latanie, możesz kliknąć "Ustawienia", następnie kliknąć przycisk "Pokaż więcej" po prawej stronie "Ogólne", a na końcu kliknąć "Włącz autokoordynację" w Launcherze.

=== Pierwszy raz w kokpicie ===
Orientacja w kokpicie może być wyzwaniem za pierwszym razem.

Możesz użyć {{key press|Ctrl|V}}, aby przełączyć się na widok kokpitu. Jeśli tekst na panelu jest zbyt mały, możesz użyć trybu widoku myszy (naciśnij Tab, aż uzyskasz kursor w kształcie podwójnej strzałki), aby przesuwać widok, i kółko myszy, aby przybliżać, lub przesuwać widok za pomocą czapki joysticka i przybliżać za pomocą {{key press|X}} i {{key press|Shift|X}}.

Jednym z pierwszych kroków, które wielu podejmuje po wejściu do nieznanego kokpitu, jest naciśnięcie {{key press|Ctrl|C}} w celu podświetlenia wszystkich "gorących punktów", czyli elementów sterujących przyrządami, przycisków, pokręteł itp. Wiele statków powietrznych oferuje również specjalne menu pomocy.

Niektóre funkcje, takie jak rozrusznik lub magneto, mogą być trudne w użyciu lub po prostu nie mieć klikalnych "gorących punktów", zwłaszcza w modelach statków powietrznych w fazie rozwoju. W większości przypadków możesz użyć klawiatury. Klawiatura zawsze działa zgodnie z przypisaniami wymienionymi w menu "Pomoc > Pomoc dla statku powietrznego" lub "Pomoc > Wspólne klawisze statków powietrznych", ale czasami niektóre klawisze są przypisywane ponownie przez statek powietrzny lub konfigurację. Ponownie, pamiętaj, aby sprawdzić wszystkie okna dialogowe pomocy.

=== Uruchamianie silnika ===
Chcesz już lecieć, ale silnik jest wyłączony. Cóż, włączanie silników nie zawsze jest łatwe. Większość statków powietrznych ma wpis ''autostart'' w swoim niestandardowym menu, ale oto ogólna procedura, która powinna działać w wielu przypadkach:

Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem tłokowym, potrzebujesz (po upewnieniu się, że gra nie jest wstrzymana {{key press|p}}):
# Paliwo: niektóre statki powietrzne rozpoczynają symulację bez paliwa. Możesz je dodać w ''Wyposażenie'' > ''Paliwo i ładunek''.
# Prawidłowa mieszanka paliwowa: zazwyczaj jest ''bogata'', więc wciśnij czerwony pokrętło do samego końca lub użyj klawisza {{key press|m}}, aby wzbogacić ({{key press|Shift|m}} zuboża).
# Iskrowniki ustawione na ''Both'': obróć kluczyk lub naciśnij {{key press|}}} ''trzy razy'', aby przejść przez ''R'', ''L'', ''Both''.
# Przepustnica: niektóre silniki lepiej uruchamiają się przy odrobinie gazu.
# Uruchom rozrusznik: kliknij pozycję ''Start'' kluczyka na panelu lub naciśnij {{key press|s}}. Przytrzymaj rozrusznik przez wystarczający czas, nawet 10 sekund.

Uruchamianie wszystkich silników w statku powietrznym z wieloma silnikami jest podobne do uruchamiania pojedynczego silnika - z tą różnicą, że musisz powtórzyć tę samą sekwencję rozruchu dla każdego silnika. FlightGear oferuje wygodny sposób, aby zrobić to dla wszystkich silników jednocześnie: naciśnij {{key press|~}} i cała powyższa procedura zadziała dla wszystkich silników. Należy jednak pamiętać, że domyślny panel 2D jest podłączony do ''tylko jednego silnika'' i sztuczka z {{key press|~}} może nie zadziałać. Dodaj też trochę gazu, aby upewnić się, że wszystkie silniki są włączone.

Te instrukcje mogą nie działać dla odrzutowców, śmigłowców lub innych typów statków powietrznych o złożonych procedurach rozruchu. Sprawdź instrukcje w menu pomocy statku powietrznego (naciśnij {{key press|?}}) i/lub spójrz na [[Aircraft|artykuł o tym statku powietrznym na tej wiki]]. Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem odrzutowym, musisz:
# Ustawić odcięcie ''ON''
# Włączyć rozrusznik
# Gdy silniki osiągną około 5% N1, ustawić odcięcie ''OFF''
# Wyłączyć rozrusznik, gdy silnik osiągnie prędkość roboczą

== Nauka latania ==
=== Podręcznik FlightGear ===
FlightGear ma oficjalny [https://www.flightgear.org/support/manual/ podręcznik], który obejmuje podstawy latania. Jako początkujący, możesz chcieć zacząć od [https://flightgear.gitlab.io/getstart/release-{{current release|cr}}/pl/HTML/getstart-plch8.html Rozdziału 8: Podstawowy poradnik symulatora lotu].

=== Samouczki ===
Wiele statków powietrznych ma własne interaktywne [[tutorials|samouczki]]. Dzięki samouczkom możesz nauczyć się obsługiwać konkretny statek powietrzny, ale także nauczyć się latać. Możesz uzyskać dostęp do samouczków, przechodząc do ''Pomoc'' > ''Samouczek''. Świetnym miejscem na rozpoczęcie jest samouczek dla statku powietrznego [[Cessna 172P]], powszechnie używanego w rzeczywistości do nauki latania statkami powietrznymi o stałych skrzydłach.

Jeśli samouczek zaczyna się bez pasa startowego i w otoczeniu wody, Twoja instalacja FlightGeara nie ma scenerii dla lotniska, na którym samouczek miał się odbyć. Aby uzyskać scenerię, zobacz sekcję [[#Getting scenery|#Pobieranie scenerii]] powyżej.

== Twój pierwszy lot ==
=== Realizm ===
Jednym z najczęstszych pytań, jakie zadają początkujący piloci na temat każdego symulatora lotu, ale zwłaszcza FlightGeara, jest "Dlaczego mój statek powietrzny cały czas skręca w lewo?" Chociaż może to być spowodowane podmuchami wiatru przecinającymi pas startowy, bardziej prawdopodobne jest, że wynika to z [[Understanding Propeller Torque and P-Factor|momentu obrotowego śmigła i efektu P]].

W niektórych innych symulatorach lotu, pomimo haseł marketingowych głoszących co innego, niektóre ustawienia są obniżone, aby statek powietrzny był łatwiejszy w pilotażu. Zmniejsza to efekty takie jak powyższy. Realizm we FlightGear jest zawsze podkręcony do maksimum.

Oto niektóre punkty realizmu FlightGeara, które mogą dezorientować początkujących pilotów:
* "Syndrom skręcania w lewo" z wyżej wymienionych powodów.
* Błąd skrętu kompasu: Kompas, poddany siłom lotu, ma tendencję do skręcania w przeciwnym kierunku na krótki okres, zanim ustabilizuje się na prawidłowym kursie. Nie jest to usterka (zobacz także artykuł Wikipedii {{wikipedia|Aircraft compass turns}}).
* Wskaźnik prędkości pionowej (VSI) również jest obarczony błędem.
* [[Horizontal Situation Indicator|Wskaźnik sytuacji poziomej]] (HSI) jest napędzany przez żyroskop (dlatego czasami nazywa się go żyroskopem kierunkowym), który podlega ''dryfowi żyroskopowemu''. Wskaźnik będzie odchylać się od aktualnego kursu i musi być okresowo (co ~15 minut) kalibrowany, aby zgadzał się z kursem kompasu magnetycznego.
* Nie możesz po prostu przerwać skrętu lub wznoszenia poprzez wycentrowanie drążka lub pałki sterowniczej. Musisz skręcić lub popchnąć drążek w drugą stronę, aby wrócić do lotu poziomego. Ale nawet wtedy samolot nie utrzyma samodzielnie swojej wysokości ani kursu. Częstym błędem jest próba znalezienia pozycji drążka, przy której można puścić stery. Chociaż za pomocą trymowania można zostawić samolot na kilka sekund, trzeba użyć autopilota lub stale regulować drążek.

Na statek powietrzny w locie działa wiele sił, a także na [[avionics and instruments|awionikę i przyrządy]] używane do sterowania i nawigacji, co może być sprzeczne z intuicją. Piloci muszą nauczyć się rozpoznawać te zjawiska i kompensować ich skutki. ''FlightGear modeluje błędy przyrządów, które istnieją w rzeczywistym świecie''. Jeśli nie chcesz tego, naciśnij {{key press|h}}, aby włączyć HUD.

=== Lotniska i pomoce nawigacyjne ===
Gdy po raz pierwszy uruchamiasz FlightGear, czy to z wiersza poleceń, czy z interfejsu Launchera, możesz zastanawiać się, jak określić, jakie lotniska są dostępne. Program uruchamiający wyświetla listę lotnisk, ale nie zobaczysz szczegółów, takich jak częstotliwości wieży lub [[ILS|ILS]]. Nie znajdziesz mapy pokazującej [[VOR|VOR-y]] i ich częstotliwości. Co możesz zrobić? Zobacz [[Getting aeronautical charts|Pozyskiwanie map lotniczych]].

W symulatorze dostępna jest mapa, której możesz użyć w ''Menu główne'' > ''Wyposażenie'' > ''Mapa'', która pozwoli Ci zobaczyć dane nawigacyjne oraz pozycję lotnisk i pomocy. Aby uzyskać więcej pomocy dotyczącej nawigacji, zobacz [[Understanding navigation|Zrozumienie nawigacji]].

=== Latanie z autopilotem ===
Ogólny [[autopilot|autopilot]] jest dostępny w menu ''Autopilot > Ustawienia autopilota'', podczas gdy wiele statków powietrznych ma własny ''specyficzny'' autopilot, często będący modelem rzeczywistego.

W przypadku statków powietrznych, które mają własny autopilot, powinieneś używać elementów sterujących autopilotem dostępnych w wirtualnym kokpicie. Oznacza to klikanie na panelu przyrządów w wirtualnym kokpicie. Menu Autopilot może być wyszarzone i niedostępne, gdy statek powietrzny dostarcza własny autopilot w niektórych statkach powietrznych, w tym Airbuses i [[Cessna 172P|C172P]].

Cessna 172 jest wyposażona w [[Bendix/King KAP140 Autopilot|autopilot Bendix/King KAP140]] w swoim wirtualnym kokpicie. Możesz używać zarówno urządzenia autopilota w kokpicie, jak i [[Autopilot#Autopilot Settings|ustawień autopilota]] z menu.

== Zaawansowane ==
=== Latanie ===
{{Main article|Aircraft|Statki powietrzne}}

* Jeśli nadal latasz lekkimi cywilnymi statkami powietrznymi, [[Cessna 182S]], która jest bardziej złożona niż C172P, oraz [[Piper PA28 Warrior II|PA28]] to dobre wybory.
* Jeśli interesuje Cię latanie liniami lotniczymi, sugeruje się rodziny [[Airbus A320 family|Airbus A320]], Boeing [[Boeing 777|777]]/[[Boeing 787-8 Dreamliner|787]], [[MD-11]] i [[MD-80]].
* Jeśli fascynują Cię samoloty myśliwskie, wybierz wysoko oceniany wojskowy statek powietrzny (taki jak [[General Dynamics F-16 Fighting Falcon|F-16]]/[[F-15]]) z [[Aircraft#Modern military aircraft|tej listy]] i włącz obrażenia w trybie wieloosobowym lub zainstaluj [[Bombable]].
* Jeśli przechodzisz na śmigłowce, zaleca się latanie [[Eurocopter EC130 B4]].

Oprócz zwykłych statków powietrznych dostępne są również szczegółowe [[Space Shuttle|wahadłowce kosmiczne]].

=== Sceneria ===
Fascynujące jest odkrywanie [[scenery|scenerii]] (lub po prostu testowanie grafiki/szybkości klatek) za pomocą [[UFO|UFO]]. Po pierwsze, [[#Configuring rendering and UI|zwiększ swoją jakość grafiki]]. Jeśli początkowo nie widzisz budynków, pozostaw FG otwarte i odczekaj chwilę, aż [[TerraSync]] zakończy pobieranie i budynki się pojawią.
Istnieje wiele [[Suggested airports|dobrze rozwiniętych lotnisk]] i obszarów scenerii. Możesz również eksplorować obiekty scenerii na [https://scenery.flightgear.org/map mapie modeli].

=== Tryb wieloosobowy ===
FlightGear ma kilka serwerów wieloosobowych, które pozwolą Ci latać w bardziej ożywionych przestworzach; zobacz [[Howto: Multiplayer|Tryb wieloosobowy]]. Istnieją również [[OpenRadar]] i [[ATC-pie]], samodzielne programy, które pozwolą Ci być [[Air traffic control|kontrolerem ruchu lotniczego]].

Dostępna jest również [[MPMap|mapa wieloosobowa]], która pozwala zobaczyć, kto jest aktualnie online, a nawet jakie [[navaids|pomoce nawigacyjne]] są w pobliżu.

=== Elementy menu ===
Aby szybko zapoznać się z użyciem każdej pozycji menu w FlightGear, zobacz [[menu]].

=== Dodatki ===
FlightGear ma wiele [[Addon|dodatków]] innych firm zawierających ulepszenia. Dla początkujących, [[Logbook Add-on|Dziennik lotów]] i dodatek [[Which Runway Add-on|Który pas]] mogą być najbardziej przydatnymi dodatkami.

== Społeczność FlightGear ==
=== Uzyskiwanie pomocy ===
Ta strona została zaprojektowana, aby zapewnić użytkownikowi najważniejsze informacje, które musi wiedzieć o korzystaniu z FlightGeara po raz pierwszy. Oprócz [[Pl/Portal:Użytkownik|portalu użytkownika]] tej wiki, istnieją inne strony, które możesz chcieć przeczytać:
*[[Troubleshooting problems|Rozwiązywanie problemów]], aby pomóc Ci z najczęstszymi problemami;
*[[Pl/FAQ|Często zadawane pytania]];
...oraz kanały komunikacji, które mogą być używane do uzyskania informacji lub poproszenia o pomoc:
*[[Pl/Podręcznik FlightGear|Podręcznik FlightGear]], ''obowiązkowa lektura'' dla początkujących;
*{{forum link|text=Forum FlightGear}} i jego podfora;
*[[Discord|Serwer Discord FlightGear]], najszybszy sposób na uzyskanie pomocy;
*[[FlightGear IRC channel|Kanał IRC FlightGear]];
*[[Mailing list|Lista mailingowa użytkowników FlightGeara]], największa szansa na kontakt z głównymi deweloperami;
*Dokumenty dołączone do pakietu wydaniowego.

=== Dostosowywanie FlightGear bez kompilacji ===
[https://www.flightgear.org/download/ Nasza strona internetowa] oferuje prekompilowane pliki binarne do pobrania i instalacji na Windows, macOS i Linux. Ponadto większość dystrybucji Linuksa udostępnia spakowaną wersję w swoich repozytoriach.

Chociaż instalacja jest binarna, większość systemów FlightGear jest otwarta na konfigurację poprzez pliki [[XML]] i [[NASAL scripting|skrypty NASAL]]. Masz swobodę ''i jesteś zachęcany'' do wprowadzania zmian w modelach lotu statków powietrznych, scenerii, teksturach, [[shader|shaderach]] OpenGL i każdej innej funkcji, którą chcesz zmienić dla własnej satysfakcji lub podzielić się z innymi użytkownikami FlightGeara. Jeśli to zamierzasz zrobić, spójrz na [[Pl/Portal:Developer|portal dewelopera]].

=== Jak możesz pomóc ===
{{Main article|Volunteer|Wolontariusz}}
FlightGear to projekt open source, oparty na wolontariacie. Oznacza to, że wszystko, co tu znajdziesz, pochodzi z pasji, wolnego czasu i niczego więcej. Obejmuje to symulator, scenerię, statki powietrzne, wiki, {{forum link|text=forum}} i wszystko inne. Wolontariusze, w istocie ''ludzie, którzy coś robią'', są fundamentalni dla tego projektu. Bez nich nie zrobiłby ani jednego kroku do przodu. Dlatego ważne jest, aby współtwórcy dobrze się bawili tym, co robią.

Jeśli planujesz wnieść wkład w ten projekt, powinieneś zapoznać się z kilkoma artykułami, które dadzą Ci pewne wskazówki:
*[[Howto:Understand the FlightGear development process|Jak zrozumieć proces rozwoju FlightGeara]]
*[[Implementing new features for FlightGear|Wdrażanie nowych funkcji dla FlightGeara]]
*[[How the FlightGear project works|Jak działa projekt FlightGear]]

Dziedzin, w których ich pomoc byłaby doceniona, jest wiele:
;Testowanie:
*[[Building FlightGear|Skompiluj]] najnowszy kod Git
*[https://gitlab.com/flightgear/flightgear/-/issues Zgłaszaj raporty o błędach]
*Uruchamianie FlightGeara za pomocą programu valgrind w celu wykrycia wycieków pamięci

;Wsparcie:
*Pomoc nowym użytkownikom w pobieraniu, kompilowaniu, instalowaniu i uruchamianiu FlightGeara ({{forum link|text=na forum}} lub na [[Discord|Discordzie]])
*Dostarczanie pomysłów i sugestii, zobacz: [[Feature Requests / Proposals / Ideas|Prośby o funkcje / Propozycje / Pomysły]]
*Pomoc w [[Portal:Wiki|oczyszczeniu tej wiki]]
*Pomoc w dostarczaniu nowych treści dla brakujących stron wiki

;Rozwój:
*Podstawowy kod źródłowy:
**Dostarczanie [[Howto:Start core development|wkładu w kod źródłowy, dane i dokumentację]]
**Dostarczanie [[Bugs|poprawek błędów]] lub nowych funkcji
*Rozwój statków powietrznych (modelowanie 3D, tekstury, modele lotu, skrypty)
*Rozwój scenerii (teren, modele, pogoda)
*Zaangażowanie w którykolwiek z innych projektów powiązanych z FlightGearem

[[Category:FlightGear]]

[[ca:Nou a FlightGear]]
[[de:Neu bei FlightGear]]
[[en:New to FlightGear]]
[[es:Nuevo en FlightGear]]
[[fi:Uusi_käyttäjä]]
[[fr:Nouveau sur flightgear]]
[[it:Nuovo per FlightGear]]
[[ja:FlightGear入門]]
[[nl:Nieuw bij FlightGear]]
[[pt:Novo no FlightGear]]
[[sr:Novi u FlightGear-u]]
[[th:New to FlightGear]]
[[zh:FlightGear新手]]

Pl/Nowy we FlightGear

2026-06-17T12:47:54Z

PlayeRom: /* Dostosowywanie FlightGear bez kompilacji */

'''Witaj we [[FlightGear]]!''' Postaramy się pomóc Ci wzbić się w wirtualne powietrze w najkrótszym możliwym czasie. Przedstawimy Ci również niektóre funkcje tego symulatora lotu oraz kilka informacji o jego społeczności.

== Instalacja i konfiguracja ==
=== Wymagania sprzętowe ===
Aby FlightGear działał płynnie, wymaga karty graficznej ze sterownikami OpenGL 4.0 lub nowszymi. Zwykle nie stanowi to problemu, ale zapoznaj się z [[Pl/Wymagania_sprzętowe|zaleceniami sprzętowymi]], aby lepiej to zrozumieć.

=== Pobieranie FlightGeara ===
Możesz pobrać najnowsze pliki ze strony [https://www.flightgear.org/download/ Pobieranie FlightGear]. Wybierz pliki źródłowe lub binarne odpowiednie dla Twojego systemu. Dostępne są również pliki binarne {{Wikipedia|AppImage|AppImage}} dla Linuksa dla wersji 2020.3 LTS i nowszych. Większość użytkowników Linuksa odkryje, że większość dystrybucji ma spakowaną wersję FlightGeara (nazwa pakietu może brzmieć <code>fgfs</code> lub <code>flightgear</code>).

W zależności od Twoich umiejętności technicznych możesz wybrać deweloperską wersję [[Git]] FlightGeara, która zazwyczaj ma więcej funkcji i może być wymagana przez niektóre najnowsze rozwijane statki powietrzne, ale może być niestabilna i jest bardziej skomplikowana do zdobycia dla użytkowników innych niż Windows. Ogólnie rzecz biorąc, wersja deweloperska nie jest zalecana dla przeciętnego użytkownika, ale jeśli chcesz przeprowadzić kilka testów, dostępna jest wersja nocna do [https://www.flightgear.org/download/nightly/ pobrania]. Jeśli używasz kopii FlightGeara kontrolowanej przez system Git, możesz zsynchronizować swoje statki powietrzne za pomocą kontrolowanego przez system repozytorium rozwojowego statków powietrznych [[Pl/FGAddon|FGAddon]].

=== Instalacja w systemie Windows ===
Po pobraniu instalatora uruchom go i postępuj zgodnie z jego instrukcjami, aby zainstalować FlightGear.

Defender SmartScreen w systemie Windows może zablokować instalację po prostu dlatego, że plik binarny nie jest podpisany kluczem, który Microsoft uznaje. Oczywiście klucz jest płatny. W takim przypadku musimy kliknąć niepozorny link "Więcej informacji". Dopiero wtedy pojawi się przycisk "Uruchom mimo to". Możesz bezpiecznie zaufać, że nie jest to niebezpieczna aplikacja, pod warunkiem, że pobrałeś ją z oficjalnych źródeł.

Jeśli z jakiegoś powodu używasz oprogramowania antywirusowego innej firmy, może ono blokować instalację FlightGeara. Nie jest to coś, na co mamy wpływ, więc to od Ciebie zależy, jak chcesz to rozwiązać.

Za pomocą instalatora Windows możesz wybrać miejsce instalacji FlightGeara. Katalog [[Pl/$FG_ROOT|$FG_ROOT]] będzie miał ścieżkę <code><wybrany katalog>/fgdata_2024_1</code>.

=== Instalacja w systemie macOS ===
Instalacja FlightGeara w systemie macOS jest bardzo prosta. Wystarczy przeciągnąć i upuścić ikonę FlightGeara do folderu <code>/Applications</code>. To wszystko.

Gdy uruchamiasz FlightGeara po raz pierwszy, jego ikona w Docku podskakuje przez kilka sekund podczas ładowania informacji o statkach powietrznych i lotniskach. Gdy pojawi się graficzny program uruchamiający, wybierz statek powietrzny i lotnisko, a następnie kliknij "Lećmy!", aby uruchomić symulator. Możesz skonfigurować więcej opcji za pomocą graficznego programu uruchamiającego. Zobacz [http://flightgear.sourceforge.net/manual/next/pl/getstart-plch4.html#start-jak-uruchomic-program oficjalną instrukcję] po więcej szczegółów.

Jeśli chcesz uruchomić FlightGeara z wiersza poleceń, uruchom aplikację Terminal i wpisz następujące polecenia.

cd /Applications/FlightGear.app/Contents/MacOS
./fgfs --options.....

Zmienne [[Pl/$FG_ROOT|$FG_ROOT]] i [[$FG_SCENERY]] nie są ustawione w systemie macOS. Jeśli chcesz samodzielnie określić te zmienne do użycia w wierszu poleceń, uruchom następujące polecenia w aplikacji Terminal:

FG_ROOT=/Applications/FlightGear.app/Contents/Resources/data
FG_SCENERY=[[Pl/$FG_ROOT|$FG_ROOT]]/Scenery

Po uruchomieniu graficznego programu uruchamiającego będziesz mieć alias do [[Pl/$FG_ROOT|$FG_ROOT]] w ścieżce <code>$HOME/Documents/FlightGear/<version></code>, dzięki czemu możesz przeglądać folder danych za pomocą Findera.

Uwaga: Po zainstalowaniu FlightGeara użytkownicy komputerów Mac mogą zlokalizować swój folder [[Pl/$FG_ROOT|$FG_ROOT]], otwierając folder Aplikacje w Finderze, klikając prawym przyciskiem myszy FlightGear i wybierając "Pokaż zawartość pakietu". To przeniesie Cię do wnętrza folderu FlightGear. Masz teraz dostęp do wszystkich plików, w tym Data/Aircraft, aby [[Pl/Instalowanie_samolotów#macOS|zainstalować nowe statki powietrzne]].

=== Instalacja ze źródeł ===
Główny artykuł: [[Building FlightGear|Kompilacja FlightGeara]]

=== Pobieranie scenerii ===
Z FlightGearem instalowany jest ograniczony zestaw [[scenery|scenerii]]. Dla FlightGear 2024.1 składa się on z:
* obszaru wokół wyróżnionego lotniska dla tej wersji, czyli [[Keflavik_Airport|Międzynarodowego Portu Lotniczego Keflavik]] (BIKF)
* lotniska używanego w samouczku dla [[Pl/Cessna 172P|Cessny 172P]], czyli [[Hilo_International_Airport|Międzynarodowego Portu Lotniczego Hilo]] (PHTO)

We FlightGear sceneria jest zazwyczaj przechowywana w katalogu [[Pl/$FG_ROOT|$FG_ROOT]] i dzieli się na trzy rodzaje danych:
* '''Airports''' zawiera dane o lotniskach, takie jak wykorzystanie pasów startowych i miejsca postojowe.
* '''Objects''' i '''Models''' to budynki, mosty, wieże radiowe itp., które reprezentują trójwymiarowe struktury.
* '''Terrain''' reprezentuje kontury, wzniesienia i rodzaj terenu, nad którym latasz/kołujesz.

Obecnym sposobem "instalowania" nowej scenerii jest włączenie [[TerraSync]], które automatycznie pobierze i zaktualizuje każde odwiedzane miejsce - nawet w locie! Jeśli masz wolne połączenie internetowe i/lub wolny komputer, możesz zamiast tego użyć menedżera scenerii, na przykład [[TerraMaster]]. Dodatkowo możesz ręcznie pobrać i zainstalować nowe części scenerii, oficjalną [[World Scenery|scenerię świata]] lub niestandardową scenerię.

Sceneria jest również dostępna na [https://www.flightgear.org/download/mirrors/ stronie mirrorów] witryny FlightGear i można ją zainstalować, postępując zgodnie z instrukcją [[Howto: Install scenery|Jak zainstalować scenerię]]. '''Jest to zalecane dla użytkowników ze słabym połączeniem internetowym lub słabymi komputerami!'''

Niestandardowa sceneria jest dostępna w wielu miejscach. Na przykład na {{forum link|f=5|text=forum FlightGear}} lub w repozytoriach. Wyszukiwanie w Internecie powinno pozwolić je znaleźć. Zobacz stronę [[Suggested_custom_scenery|sugerowanej niestandardowej scenerii]] po kilka najnowszych wydań.

FlightGear 2020.3.7 LTS i nowsze dodały eksperymentalną obsługę trójwymiarowych budynków, dróg i obiektów opartych na danych OpenStreetMap dla całego świata do automatycznie pobieranych danych TerraSync - zobacz notatki o [[OSM2City 1st Worldbuild|1. światowej kompilacji OSM2City]] (marzec 2021). Ręczne pobieranie struktur 3D dla regionów lub całych krajów jest dostępne na stronie wiki z [[Areas populated with osm2city scenery|pobraniami osm2City]].

=== Pobieranie statków powietrznych ===
Dodatkowe [[Pl/Samoloty|statki powietrzne]] można pobrać i zainstalować za pomocą [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz przejść na stronę internetową FlightGeara i przejść do strony [http://www.flightgear.org/download/ pobierania], a następnie wybrać link do pobrania statków powietrznych pasujący do Twojej wersji FlightGeara. Ponadto istnieje wiele [[hangars|hangarów]] innych firm. Informacje o instalacji znajdziesz w [[Pl/Instalowanie samolotów|Jak zainstalować statek powietrzny]].

== Uruchamianie FlightGeara ==
=== Uruchamianie FlightGeara ===
Najłatwiejszym sposobem uruchomienia FlightGeara jest użycie ikony na pulpicie. Uruchamia to interfejs graficzny [[FlightGear Qt launcher|Launchera]], w którym możesz wybrać statek powietrzny, pozycję startową itp.  Pamiętaj, że Launcher ma tylko podstawowe opcje, aby Ci pomóc. Wiele opcji dotyczących grafiki, scenerii, [[Weather|pogody]], [https://www.flightgear.org/tours/simulating-the-ever-changing-scenery/ środowiska], [[Input_device|urządzeń wejściowych]] itp. jest dostępnych z [[menu|menu]] wewnątrz symulatora.

Wielu użytkowników wybiera jednak uruchamianie FlightGeara bezpośrednio z wiersza poleceń. Nazwa pliku wykonywalnego to <code>fgfs</code> (lub plik AppImage, np. "flightgear-2024.1.6-linux-amd64.AppImage") i można go uruchomić bez opcji. Jeśli "nie został znaleziony", prawdopodobnie nie znajduje się w Twojej [https://en.wikipedia.org/wiki/PATH_(variable) ścieżce]. Lokalizacja zależy od Twojego konkretnego systemu i wyborów dokonanych podczas kompilacji i instalacji. Istnieje lista [[Pl/Opcje_wiersza_poleceń|parametrów wiersza poleceń]], których należy użyć do zmiany wielu opcji, takich jak wybrany statek powietrzny. Najważniejsze z nich:

fgfs --launcher # otwiera Launcher FlightGeara
fgfs --show-aircraft # wyświetla listę zainstalowanych statków powietrznych
fgfs --aircraft=c172p # uruchamia FG z statkiem powietrznym "c172p" (z listy)

Launcher umożliwia również użytkownikom dodawanie parametrów wiersza poleceń dla opcji, które są zwykle zmieniane z poziomu menu wewnątrz symulatora, a także dość zaawansowanych opcji dostępnych tylko z wiersza poleceń.

=== Konfiguracja renderowania i interfejsu użytkownika ===
[[File:Rendering options 2024.1.png|thumb|Okno dialogowe Widok > Opcje renderowania.]]
Jeśli jakość renderowania lub liczba klatek na sekundę jest zbyt niska, kliknij "Widok > Opcje renderowania", aby dostosować ustawienia graficzne. Dla nowszego sprzętu zaleca się ustawienie "jakości grafiki" na wysoką i zaznaczenie "użyj miejsca na dysku dla szybszego ładowania", "animowane rękawy" i "satelitarna fotosceneria".

Jeśli tekst menu wydaje się zbyt mały na ekranach o wysokiej rozdzielczości lub dużych ekranach, możesz ręcznie [[Menubar#How to Change the Default Menubar Font Size|zmienić rozmiar czcionki paska menu]], edytując plik danych, lub po prostu kliknąć "Debuguj > Zmień styl GUI".

=== Używanie klawiatury i/lub myszy ===
Użytkownicy z ograniczonym dostępem do [[joystick|joysticka]] lub innych kontrolerów czasami używają klawiatury lub myszy do sterowania swoim statkiem powietrznym. Używanie klawiatury do latania może być trudne, a mysz jest zalecana zamiast klawiatury do latania, jednak nawet tani joystick znacznie poprawiłby wrażenia.

Aby uzyskać pomoc dotyczącą poleceń klawiatury, gdy FlightGear jest uruchomiony, przejdź do menu ''Pomoc'', spójrz w ''Podstawowe klawisze'' (dla poleceń związanych z symulatorem), ''Wspólne klawisze statków powietrznych'' (dla poleceń uniwersalnych dla wszystkich statków powietrznych) i ''Pomoc dla statku powietrznego'' (dla poleceń specyficznych dla Twojego statku). Jeśli główne menu jest ukryte, naciśnij {{key press|F10}}. Jeśli przychodzisz z innych symulatorów, sprawdź [[key commands compared to other simulators|porównanie poleceń klawiatury z innymi symulatorami]], aby uzyskać przegląd różnic między poleceniami klawiatury tego symulatora a FlightGear.

Aby użyć myszy do latania statkiem powietrznym, naciśnij {{key press|Tab}} (kursor powinien zmienić się w krzyżyk) i przesuwaj myszą, aby kierować statkiem powietrznym. Naciśnij ponownie {{key press|Tab}}, aby rozglądać się (kursor powinien pokazywać dwustronną strzałkę), i naciśnij {{key press|Tab}} ponownie, aby wrócić do trybu normalnego, używanego do klikania elementów w kokpicie. Możesz kliknąć "Plik > Urządzenia wejściowe > Konfiguracja myszy", aby dostosować czułość myszy.

Dla większości użytkowników nieposiadających kontroli osi steru kierunku, trudno jest ręcznie koordynować ruchy [[aileron|lotki]] i [[rudder|steru kierunku]] podczas zakrętu. Aby włączyć autokoordynację i ułatwić latanie, możesz kliknąć "Ustawienia", następnie kliknąć przycisk "Pokaż więcej" po prawej stronie "Ogólne", a na końcu kliknąć "Włącz autokoordynację" w Launcherze.

=== Pierwszy raz w kokpicie ===
Orientacja w kokpicie może być wyzwaniem za pierwszym razem.

Możesz użyć {{key press|Ctrl|V}}, aby przełączyć się na widok kokpitu. Jeśli tekst na panelu jest zbyt mały, możesz użyć trybu widoku myszy (naciśnij Tab, aż uzyskasz kursor w kształcie podwójnej strzałki), aby przesuwać widok, i kółko myszy, aby przybliżać, lub przesuwać widok za pomocą czapki joysticka i przybliżać za pomocą {{key press|X}} i {{key press|Shift|X}}.

Jednym z pierwszych kroków, które wielu podejmuje po wejściu do nieznanego kokpitu, jest naciśnięcie {{key press|Ctrl|C}} w celu podświetlenia wszystkich "gorących punktów", czyli elementów sterujących przyrządami, przycisków, pokręteł itp. Wiele statków powietrznych oferuje również specjalne menu pomocy.

Niektóre funkcje, takie jak rozrusznik lub magneto, mogą być trudne w użyciu lub po prostu nie mieć klikalnych "gorących punktów", zwłaszcza w modelach statków powietrznych w fazie rozwoju. W większości przypadków możesz użyć klawiatury. Klawiatura zawsze działa zgodnie z przypisaniami wymienionymi w menu "Pomoc > Pomoc dla statku powietrznego" lub "Pomoc > Wspólne klawisze statków powietrznych", ale czasami niektóre klawisze są przypisywane ponownie przez statek powietrzny lub konfigurację. Ponownie, pamiętaj, aby sprawdzić wszystkie okna dialogowe pomocy.

=== Uruchamianie silnika ===
Chcesz już lecieć, ale silnik jest wyłączony. Cóż, włączanie silników nie zawsze jest łatwe. Większość statków powietrznych ma wpis ''autostart'' w swoim niestandardowym menu, ale oto ogólna procedura, która powinna działać w wielu przypadkach:

Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem tłokowym, potrzebujesz (po upewnieniu się, że gra nie jest wstrzymana {{key press|p}}):
# Paliwo: Niektóre statki powietrzne rozpoczynają symulację bez paliwa. Możesz je dodać w ''Wyposażenie'' > ''Paliwo i ładunek''.
# Prawidłowa mieszanka paliwowa: Zazwyczaj jest ''bogata'', więc wciśnij czerwony pokrętło do samego końca lub użyj klawisza {{key press|m}}, aby wzbogacić ({{key press|Shift|m}} zuboża).
# Magneto ustawione na ''obie'': Obróć kluczyk lub naciśnij {{key press|}}} ''trzy razy'', aby przejść przez ''R'', ''L'', ''Obie''.
# Przepustnica: Niektóre silniki lepiej uruchamiają się przy odrobinie gazu.
# Uruchom rozrusznik: Kliknij pozycję ''Start'' kluczyka na panelu lub naciśnij {{key press|s}}. Przytrzymaj rozrusznik przez wystarczający czas, nawet 10 sekund.

Uruchamianie wszystkich silników w statku powietrznym z wieloma silnikami jest podobne do uruchamiania pojedynczego silnika - z tą różnicą, że musisz powtórzyć tę samą sekwencję rozruchu dla każdego silnika. FlightGear oferuje wygodny sposób, aby zrobić to dla wszystkich silników jednocześnie: naciśnij {{key press|~}} i cała powyższa procedura zadziała dla wszystkich silników. Należy jednak pamiętać, że domyślny panel 2D jest podłączony do ''tylko jednego silnika'' i sztuczka z {{key press|~}} może nie zadziałać. Dodaj też trochę gazu, aby upewnić się, że wszystkie silniki są włączone.

Te instrukcje mogą nie działać dla odrzutowców, śmigłowców lub innych typów statków powietrznych o złożonych procedurach rozruchu. Sprawdź instrukcje w menu pomocy statku powietrznego (naciśnij {{key press|?}}) i/lub spójrz na [[Aircraft|artykuł o tym statku powietrznym na tej wiki]]. Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem odrzutowym, musisz:
# Ustawić odcięcie ''ON''
# Włączyć rozrusznik
# Gdy silniki osiągną około 5% N1, ustawić odcięcie ''OFF''
# Wyłączyć rozrusznik, gdy silnik osiągnie prędkość roboczą

== Nauka latania ==
=== Podręcznik FlightGear ===
FlightGear ma oficjalny [https://www.flightgear.org/support/manual/ podręcznik], który obejmuje podstawy latania. Jako początkujący, możesz chcieć zacząć od [https://flightgear.gitlab.io/getstart/release-{{current release|cr}}/pl/HTML/getstart-plch8.html Rozdziału 8: Podstawowy poradnik symulatora lotu].

=== Samouczki ===
Wiele statków powietrznych ma własne interaktywne [[tutorials|samouczki]]. Dzięki samouczkom możesz nauczyć się obsługiwać konkretny statek powietrzny, ale także nauczyć się latać. Możesz uzyskać dostęp do samouczków, przechodząc do ''Pomoc'' > ''Samouczek''. Świetnym miejscem na rozpoczęcie jest samouczek dla statku powietrznego [[Cessna 172P]], powszechnie używanego w rzeczywistości do nauki latania statkami powietrznymi o stałych skrzydłach.

Jeśli samouczek zaczyna się bez pasa startowego i w otoczeniu wody, Twoja instalacja FlightGeara nie ma scenerii dla lotniska, na którym samouczek miał się odbyć. Aby uzyskać scenerię, zobacz sekcję [[#Getting scenery|#Pobieranie scenerii]] powyżej.

== Twój pierwszy lot ==
=== Realizm ===
Jednym z najczęstszych pytań, jakie zadają początkujący piloci na temat każdego symulatora lotu, ale zwłaszcza FlightGeara, jest "Dlaczego mój statek powietrzny cały czas skręca w lewo?" Chociaż może to być spowodowane podmuchami wiatru przecinającymi pas startowy, bardziej prawdopodobne jest, że wynika to z [[Understanding Propeller Torque and P-Factor|momentu obrotowego śmigła i efektu P]].

W niektórych innych symulatorach lotu, pomimo haseł marketingowych głoszących co innego, niektóre ustawienia są obniżone, aby statek powietrzny był łatwiejszy w pilotażu. Zmniejsza to efekty takie jak powyższy. Realizm we FlightGear jest zawsze podkręcony do maksimum.

Oto niektóre punkty realizmu FlightGeara, które mogą dezorientować początkujących pilotów:
* "Syndrom skręcania w lewo" z wyżej wymienionych powodów.
* Błąd skrętu kompasu: Kompas, poddany siłom lotu, ma tendencję do skręcania w przeciwnym kierunku na krótki okres, zanim ustabilizuje się na prawidłowym kursie. Nie jest to usterka (zobacz także artykuł Wikipedii {{wikipedia|Aircraft compass turns}}).
* Wskaźnik prędkości pionowej (VSI) również jest obarczony błędem.
* [[Horizontal Situation Indicator|Wskaźnik sytuacji poziomej]] (HSI) jest napędzany przez żyroskop (dlatego czasami nazywa się go żyroskopem kierunkowym), który podlega ''dryfowi żyroskopowemu''. Wskaźnik będzie odchylać się od aktualnego kursu i musi być okresowo (co ~15 minut) kalibrowany, aby zgadzał się z kursem kompasu magnetycznego.
* Nie możesz po prostu przerwać skrętu lub wznoszenia poprzez wycentrowanie drążka lub pałki sterowniczej. Musisz skręcić lub popchnąć drążek w drugą stronę, aby wrócić do lotu poziomego. Ale nawet wtedy samolot nie utrzyma samodzielnie swojej wysokości ani kursu. Częstym błędem jest próba znalezienia pozycji drążka, przy której można puścić stery. Chociaż za pomocą trymowania można zostawić samolot na kilka sekund, trzeba użyć autopilota lub stale regulować drążek.

Na statek powietrzny w locie działa wiele sił, a także na [[avionics and instruments|awionikę i przyrządy]] używane do sterowania i nawigacji, co może być sprzeczne z intuicją. Piloci muszą nauczyć się rozpoznawać te zjawiska i kompensować ich skutki. ''FlightGear modeluje błędy przyrządów, które istnieją w rzeczywistym świecie''. Jeśli nie chcesz tego, naciśnij {{key press|h}}, aby włączyć HUD.

=== Lotniska i pomoce nawigacyjne ===
Gdy po raz pierwszy uruchamiasz FlightGear, czy to z wiersza poleceń, czy z interfejsu Launchera, możesz zastanawiać się, jak określić, jakie lotniska są dostępne. Program uruchamiający wyświetla listę lotnisk, ale nie zobaczysz szczegółów, takich jak częstotliwości wieży lub [[ILS|ILS]]. Nie znajdziesz mapy pokazującej [[VOR|VOR-y]] i ich częstotliwości. Co możesz zrobić? Zobacz [[Getting aeronautical charts|Pozyskiwanie map lotniczych]].

W symulatorze dostępna jest mapa, której możesz użyć w ''Menu główne'' > ''Wyposażenie'' > ''Mapa'', która pozwoli Ci zobaczyć dane nawigacyjne oraz pozycję lotnisk i pomocy. Aby uzyskać więcej pomocy dotyczącej nawigacji, zobacz [[Understanding navigation|Zrozumienie nawigacji]].

=== Latanie z autopilotem ===
Ogólny [[autopilot|autopilot]] jest dostępny w menu ''Autopilot > Ustawienia autopilota'', podczas gdy wiele statków powietrznych ma własny ''specyficzny'' autopilot, często będący modelem rzeczywistego.

W przypadku statków powietrznych, które mają własny autopilot, powinieneś używać elementów sterujących autopilotem dostępnych w wirtualnym kokpicie. Oznacza to klikanie na panelu przyrządów w wirtualnym kokpicie. Menu Autopilot może być wyszarzone i niedostępne, gdy statek powietrzny dostarcza własny autopilot w niektórych statkach powietrznych, w tym Airbuses i [[Cessna 172P|C172P]].

Cessna 172 jest wyposażona w [[Bendix/King KAP140 Autopilot|autopilot Bendix/King KAP140]] w swoim wirtualnym kokpicie. Możesz używać zarówno urządzenia autopilota w kokpicie, jak i [[Autopilot#Autopilot Settings|ustawień autopilota]] z menu.

== Zaawansowane ==
=== Latanie ===
{{Main article|Aircraft|Statki powietrzne}}

* Jeśli nadal latasz lekkimi cywilnymi statkami powietrznymi, [[Cessna 182S]], która jest bardziej złożona niż C172P, oraz [[Piper PA28 Warrior II|PA28]] to dobre wybory.
* Jeśli interesuje Cię latanie liniami lotniczymi, sugeruje się rodziny [[Airbus A320 family|Airbus A320]], Boeing [[Boeing 777|777]]/[[Boeing 787-8 Dreamliner|787]], [[MD-11]] i [[MD-80]].
* Jeśli fascynują Cię samoloty myśliwskie, wybierz wysoko oceniany wojskowy statek powietrzny (taki jak [[General Dynamics F-16 Fighting Falcon|F-16]]/[[F-15]]) z [[Aircraft#Modern military aircraft|tej listy]] i włącz obrażenia w trybie wieloosobowym lub zainstaluj [[Bombable]].
* Jeśli przechodzisz na śmigłowce, zaleca się latanie [[Eurocopter EC130 B4]].

Oprócz zwykłych statków powietrznych dostępne są również szczegółowe [[Space Shuttle|wahadłowce kosmiczne]].

=== Sceneria ===
Fascynujące jest odkrywanie [[scenery|scenerii]] (lub po prostu testowanie grafiki/szybkości klatek) za pomocą [[UFO|UFO]]. Po pierwsze, [[#Configuring rendering and UI|zwiększ swoją jakość grafiki]]. Jeśli początkowo nie widzisz budynków, pozostaw FG otwarte i odczekaj chwilę, aż [[TerraSync]] zakończy pobieranie i budynki się pojawią.
Istnieje wiele [[Suggested airports|dobrze rozwiniętych lotnisk]] i obszarów scenerii. Możesz również eksplorować obiekty scenerii na [https://scenery.flightgear.org/map mapie modeli].

=== Tryb wieloosobowy ===
FlightGear ma kilka serwerów wieloosobowych, które pozwolą Ci latać w bardziej ożywionych przestworzach; zobacz [[Howto: Multiplayer|Tryb wieloosobowy]]. Istnieją również [[OpenRadar]] i [[ATC-pie]], samodzielne programy, które pozwolą Ci być [[Air traffic control|kontrolerem ruchu lotniczego]].

Dostępna jest również [[MPMap|mapa wieloosobowa]], która pozwala zobaczyć, kto jest aktualnie online, a nawet jakie [[navaids|pomoce nawigacyjne]] są w pobliżu.

=== Elementy menu ===
Aby szybko zapoznać się z użyciem każdej pozycji menu w FlightGear, zobacz [[menu]].

=== Dodatki ===
FlightGear ma wiele [[Addon|dodatków]] innych firm zawierających ulepszenia. Dla początkujących, [[Logbook Add-on|Dziennik lotów]] i dodatek [[Which Runway Add-on|Który pas]] mogą być najbardziej przydatnymi dodatkami.

== Społeczność FlightGear ==
=== Uzyskiwanie pomocy ===
Ta strona została zaprojektowana, aby zapewnić użytkownikowi najważniejsze informacje, które musi wiedzieć o korzystaniu z FlightGeara po raz pierwszy. Oprócz [[Pl/Portal:Użytkownik|portalu użytkownika]] tej wiki, istnieją inne strony, które możesz chcieć przeczytać:
*[[Troubleshooting problems|Rozwiązywanie problemów]], aby pomóc Ci z najczęstszymi problemami;
*[[Pl/FAQ|Często zadawane pytania]];
...oraz kanały komunikacji, które mogą być używane do uzyskania informacji lub poproszenia o pomoc:
*[[Pl/Podręcznik FlightGear|Podręcznik FlightGear]], ''obowiązkowa lektura'' dla początkujących;
*{{forum link|text=Forum FlightGear}} i jego podfora;
*[[Discord|Serwer Discord FlightGear]], najszybszy sposób na uzyskanie pomocy;
*[[FlightGear IRC channel|Kanał IRC FlightGear]];
*[[Mailing list|Lista mailingowa użytkowników FlightGeara]], największa szansa na kontakt z głównymi deweloperami;
*Dokumenty dołączone do pakietu wydaniowego.

=== Dostosowywanie FlightGear bez kompilacji ===
[https://www.flightgear.org/download/ Nasza strona internetowa] oferuje prekompilowane pliki binarne do pobrania i instalacji na Windows, macOS i Linux. Ponadto większość dystrybucji Linuksa udostępnia spakowaną wersję w swoich repozytoriach.

Chociaż instalacja jest binarna, większość systemów FlightGear jest otwarta na konfigurację poprzez pliki [[XML]] i [[NASAL scripting|skrypty NASAL]]. Masz swobodę ''i jesteś zachęcany'' do wprowadzania zmian w modelach lotu statków powietrznych, scenerii, teksturach, [[shader|shaderach]] OpenGL i każdej innej funkcji, którą chcesz zmienić dla własnej satysfakcji lub podzielić się z innymi użytkownikami FlightGeara. Jeśli to zamierzasz zrobić, spójrz na [[Pl/Portal:Developer|portal dewelopera]].

=== Jak możesz pomóc ===
{{Main article|Volunteer|Wolontariusz}}
FlightGear to projekt open source, oparty na wolontariacie. Oznacza to, że wszystko, co tu znajdziesz, pochodzi z pasji, wolnego czasu i niczego więcej. Obejmuje to symulator, scenerię, statki powietrzne, wiki, {{forum link|text=forum}} i wszystko inne. Wolontariusze, w istocie ''ludzie, którzy coś robią'', są fundamentalni dla tego projektu. Bez nich nie zrobiłby ani jednego kroku do przodu. Dlatego ważne jest, aby współtwórcy dobrze się bawili tym, co robią.

Jeśli planujesz wnieść wkład w ten projekt, powinieneś zapoznać się z kilkoma artykułami, które dadzą Ci pewne wskazówki:
*[[Howto:Understand the FlightGear development process|Jak zrozumieć proces rozwoju FlightGeara]]
*[[Implementing new features for FlightGear|Wdrażanie nowych funkcji dla FlightGeara]]
*[[How the FlightGear project works|Jak działa projekt FlightGear]]

Dziedzin, w których ich pomoc byłaby doceniona, jest wiele:
;Testowanie:
*[[Building FlightGear|Skompiluj]] najnowszy kod Git
*[https://gitlab.com/flightgear/flightgear/-/issues Zgłaszaj raporty o błędach]
*Uruchamianie FlightGeara za pomocą programu valgrind w celu wykrycia wycieków pamięci

;Wsparcie:
*Pomoc nowym użytkownikom w pobieraniu, kompilowaniu, instalowaniu i uruchamianiu FlightGeara ({{forum link|text=na forum}} lub na [[Discord|Discordzie]])
*Dostarczanie pomysłów i sugestii, zobacz: [[Feature Requests / Proposals / Ideas|Prośby o funkcje / Propozycje / Pomysły]]
*Pomoc w [[Portal:Wiki|oczyszczeniu tej wiki]]
*Pomoc w dostarczaniu nowych treści dla brakujących stron wiki

;Rozwój:
*Podstawowy kod źródłowy:
**Dostarczanie [[Howto:Start core development|wkładu w kod źródłowy, dane i dokumentację]]
**Dostarczanie [[Bugs|poprawek błędów]] lub nowych funkcji
*Rozwój statków powietrznych (modelowanie 3D, tekstury, modele lotu, skrypty)
*Rozwój scenerii (teren, modele, pogoda)
*Zaangażowanie w którykolwiek z innych projektów powiązanych z FlightGearem

[[Category:FlightGear]]

[[ca:Nou a FlightGear]]
[[de:Neu bei FlightGear]]
[[en:New to FlightGear]]
[[es:Nuevo en FlightGear]]
[[fi:Uusi_käyttäjä]]
[[fr:Nouveau sur flightgear]]
[[it:Nuovo per FlightGear]]
[[ja:FlightGear入門]]
[[nl:Nieuw bij FlightGear]]
[[pt:Novo no FlightGear]]
[[sr:Novi u FlightGear-u]]
[[th:New to FlightGear]]
[[zh:FlightGear新手]]

User talk:Celesta

2026-06-17T12:01:34Z

PlayeRom: /* Tłumaczenie Pl/Nowy we FlightGear */ new section

{{Template:Welcome to the wiki|realName=|name=Celesta}}

-- [[User:New user message|New user message]] ([[User talk:New user message|talk]]) 21:42, 14 May 2026 (UTC)

== Tłumaczenie Pl/Nowy we FlightGear ==

Mam kilka uwag do Twojego tłumaczenia Pl/Nowy we FlightGear:

1. Odmiana nazw własnych: w języku polskim zagraniczne nazwy oprogramowania podlegają normalnej odmianie. Tak jak mówimy „uruchamianie Facebooka” czy "wyszukiwanie w Google'u", analogicznie poprawną formą jest np. „uruchamianie FlightGeara”.

2. Wymowa i przyimek: piszemy "We FlightGear", a nie "W FlightGear". Zastosowanie ma tu ta sama zasada fonetyczna co w przypadku słów "we Francji", "we Wrocławiu" czy "we flocie" (wokalizacja przyimka ułatwiająca wymowę).

3. Linki wewnętrzne: zauważyłem, że zmieniłeś/aś polskie linki na angielskie. Uważam za zasadę, że polskie Wiki jest linkowanie do polskich wersji artykułów, aby utrzymać czytelnika w tym samym środowisku językowym. Jeśli danej strony jeszcze nie ma po polsku, to wtedy używamy angielskiej.

4. Nazewnictwo Launchera: zamiast rozwlekłych opisów typu "program uruchomieniowy QT FlightGear", konsekwentnie stosuję po prostu "Launcher". Zdaję sobie sprawę, że to zapożyczenie, ale chciałem jednej prostej nazwy zamiast pisać rozwlekłe opisy utrudniające czytelność oraz stosuję ją wszędzie, np. w podręczniku i tutaj na wiki.

Poprawiłem już to, ale proszę o trzymanie się tych zasad na przyszłość, bo przysparzasz mi pracy :)

Pl/Nowy we FlightGear

2026-06-17T11:37:20Z

PlayeRom:

'''Witaj we [[FlightGear]]!''' Postaramy się pomóc Ci wzbić się w wirtualne powietrze w najkrótszym możliwym czasie. Przedstawimy Ci również niektóre funkcje tego symulatora lotu oraz kilka informacji o jego społeczności.

== Instalacja i konfiguracja ==
=== Wymagania sprzętowe ===
Aby FlightGear działał płynnie, wymaga karty graficznej ze sterownikami OpenGL 4.0 lub nowszymi. Zwykle nie stanowi to problemu, ale zapoznaj się z [[Pl/Wymagania_sprzętowe|zaleceniami sprzętowymi]], aby lepiej to zrozumieć.

=== Pobieranie FlightGeara ===
Możesz pobrać najnowsze pliki ze strony [https://www.flightgear.org/download/ Pobieranie FlightGear]. Wybierz pliki źródłowe lub binarne odpowiednie dla Twojego systemu. Dostępne są również pliki binarne {{Wikipedia|AppImage|AppImage}} dla Linuksa dla wersji 2020.3 LTS i nowszych. Większość użytkowników Linuksa odkryje, że większość dystrybucji ma spakowaną wersję FlightGeara (nazwa pakietu może brzmieć <code>fgfs</code> lub <code>flightgear</code>).

W zależności od Twoich umiejętności technicznych możesz wybrać deweloperską wersję [[Git]] FlightGeara, która zazwyczaj ma więcej funkcji i może być wymagana przez niektóre najnowsze rozwijane statki powietrzne, ale może być niestabilna i jest bardziej skomplikowana do zdobycia dla użytkowników innych niż Windows. Ogólnie rzecz biorąc, wersja deweloperska nie jest zalecana dla przeciętnego użytkownika, ale jeśli chcesz przeprowadzić kilka testów, dostępna jest wersja nocna do [https://www.flightgear.org/download/nightly/ pobrania]. Jeśli używasz kopii FlightGeara kontrolowanej przez system Git, możesz zsynchronizować swoje statki powietrzne za pomocą kontrolowanego przez system repozytorium rozwojowego statków powietrznych [[Pl/FGAddon|FGAddon]].

=== Instalacja w systemie Windows ===
Po pobraniu instalatora uruchom go i postępuj zgodnie z jego instrukcjami, aby zainstalować FlightGear.

Defender SmartScreen w systemie Windows może zablokować instalację po prostu dlatego, że plik binarny nie jest podpisany kluczem, który Microsoft uznaje. Oczywiście klucz jest płatny. W takim przypadku musimy kliknąć niepozorny link "Więcej informacji". Dopiero wtedy pojawi się przycisk "Uruchom mimo to". Możesz bezpiecznie zaufać, że nie jest to niebezpieczna aplikacja, pod warunkiem, że pobrałeś ją z oficjalnych źródeł.

Jeśli z jakiegoś powodu używasz oprogramowania antywirusowego innej firmy, może ono blokować instalację FlightGeara. Nie jest to coś, na co mamy wpływ, więc to od Ciebie zależy, jak chcesz to rozwiązać.

Za pomocą instalatora Windows możesz wybrać miejsce instalacji FlightGeara. Katalog [[Pl/$FG_ROOT|$FG_ROOT]] będzie miał ścieżkę <code><wybrany katalog>/fgdata_2024_1</code>.

=== Instalacja w systemie macOS ===
Instalacja FlightGeara w systemie macOS jest bardzo prosta. Wystarczy przeciągnąć i upuścić ikonę FlightGeara do folderu <code>/Applications</code>. To wszystko.

Gdy uruchamiasz FlightGeara po raz pierwszy, jego ikona w Docku podskakuje przez kilka sekund podczas ładowania informacji o statkach powietrznych i lotniskach. Gdy pojawi się graficzny program uruchamiający, wybierz statek powietrzny i lotnisko, a następnie kliknij "Lećmy!", aby uruchomić symulator. Możesz skonfigurować więcej opcji za pomocą graficznego programu uruchamiającego. Zobacz [http://flightgear.sourceforge.net/manual/next/pl/getstart-plch4.html#start-jak-uruchomic-program oficjalną instrukcję] po więcej szczegółów.

Jeśli chcesz uruchomić FlightGeara z wiersza poleceń, uruchom aplikację Terminal i wpisz następujące polecenia.

cd /Applications/FlightGear.app/Contents/MacOS
./fgfs --options.....

Zmienne [[Pl/$FG_ROOT|$FG_ROOT]] i [[$FG_SCENERY]] nie są ustawione w systemie macOS. Jeśli chcesz samodzielnie określić te zmienne do użycia w wierszu poleceń, uruchom następujące polecenia w aplikacji Terminal:

FG_ROOT=/Applications/FlightGear.app/Contents/Resources/data
FG_SCENERY=[[Pl/$FG_ROOT|$FG_ROOT]]/Scenery

Po uruchomieniu graficznego programu uruchamiającego będziesz mieć alias do [[Pl/$FG_ROOT|$FG_ROOT]] w ścieżce <code>$HOME/Documents/FlightGear/<version></code>, dzięki czemu możesz przeglądać folder danych za pomocą Findera.

Uwaga: Po zainstalowaniu FlightGeara użytkownicy komputerów Mac mogą zlokalizować swój folder [[Pl/$FG_ROOT|$FG_ROOT]], otwierając folder Aplikacje w Finderze, klikając prawym przyciskiem myszy FlightGear i wybierając "Pokaż zawartość pakietu". To przeniesie Cię do wnętrza folderu FlightGear. Masz teraz dostęp do wszystkich plików, w tym Data/Aircraft, aby [[Pl/Instalowanie_samolotów#macOS|zainstalować nowe statki powietrzne]].

=== Instalacja ze źródeł ===
Główny artykuł: [[Building FlightGear|Kompilacja FlightGeara]]

=== Pobieranie scenerii ===
Z FlightGearem instalowany jest ograniczony zestaw [[scenery|scenerii]]. Dla FlightGear 2024.1 składa się on z:
* obszaru wokół wyróżnionego lotniska dla tej wersji, czyli [[Keflavik_Airport|Międzynarodowego Portu Lotniczego Keflavik]] (BIKF)
* lotniska używanego w samouczku dla [[Pl/Cessna 172P|Cessny 172P]], czyli [[Hilo_International_Airport|Międzynarodowego Portu Lotniczego Hilo]] (PHTO)

We FlightGear sceneria jest zazwyczaj przechowywana w katalogu [[Pl/$FG_ROOT|$FG_ROOT]] i dzieli się na trzy rodzaje danych:
* '''Airports''' zawiera dane o lotniskach, takie jak wykorzystanie pasów startowych i miejsca postojowe.
* '''Objects''' i '''Models''' to budynki, mosty, wieże radiowe itp., które reprezentują trójwymiarowe struktury.
* '''Terrain''' reprezentuje kontury, wzniesienia i rodzaj terenu, nad którym latasz/kołujesz.

Obecnym sposobem "instalowania" nowej scenerii jest włączenie [[TerraSync]], które automatycznie pobierze i zaktualizuje każde odwiedzane miejsce - nawet w locie! Jeśli masz wolne połączenie internetowe i/lub wolny komputer, możesz zamiast tego użyć menedżera scenerii, na przykład [[TerraMaster]]. Dodatkowo możesz ręcznie pobrać i zainstalować nowe części scenerii, oficjalną [[World Scenery|scenerię świata]] lub niestandardową scenerię.

Sceneria jest również dostępna na [https://www.flightgear.org/download/mirrors/ stronie mirrorów] witryny FlightGear i można ją zainstalować, postępując zgodnie z instrukcją [[Howto: Install scenery|Jak zainstalować scenerię]]. '''Jest to zalecane dla użytkowników ze słabym połączeniem internetowym lub słabymi komputerami!'''

Niestandardowa sceneria jest dostępna w wielu miejscach. Na przykład na {{forum link|f=5|text=forum FlightGear}} lub w repozytoriach. Wyszukiwanie w Internecie powinno pozwolić je znaleźć. Zobacz stronę [[Suggested_custom_scenery|sugerowanej niestandardowej scenerii]] po kilka najnowszych wydań.

FlightGear 2020.3.7 LTS i nowsze dodały eksperymentalną obsługę trójwymiarowych budynków, dróg i obiektów opartych na danych OpenStreetMap dla całego świata do automatycznie pobieranych danych TerraSync - zobacz notatki o [[OSM2City 1st Worldbuild|1. światowej kompilacji OSM2City]] (marzec 2021). Ręczne pobieranie struktur 3D dla regionów lub całych krajów jest dostępne na stronie wiki z [[Areas populated with osm2city scenery|pobraniami osm2City]].

=== Pobieranie statków powietrznych ===
Dodatkowe [[Pl/Samoloty|statki powietrzne]] można pobrać i zainstalować za pomocą [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz przejść na stronę internetową FlightGeara i przejść do strony [http://www.flightgear.org/download/ pobierania], a następnie wybrać link do pobrania statków powietrznych pasujący do Twojej wersji FlightGeara. Ponadto istnieje wiele [[hangars|hangarów]] innych firm. Informacje o instalacji znajdziesz w [[Pl/Instalowanie samolotów|Jak zainstalować statek powietrzny]].

== Uruchamianie FlightGeara ==
=== Uruchamianie FlightGeara ===
Najłatwiejszym sposobem uruchomienia FlightGeara jest użycie ikony na pulpicie. Uruchamia to interfejs graficzny [[FlightGear Qt launcher|Launchera]], w którym możesz wybrać statek powietrzny, pozycję startową itp.  Pamiętaj, że Launcher ma tylko podstawowe opcje, aby Ci pomóc. Wiele opcji dotyczących grafiki, scenerii, [[Weather|pogody]], [https://www.flightgear.org/tours/simulating-the-ever-changing-scenery/ środowiska], [[Input_device|urządzeń wejściowych]] itp. jest dostępnych z [[menu|menu]] wewnątrz symulatora.

Wielu użytkowników wybiera jednak uruchamianie FlightGeara bezpośrednio z wiersza poleceń. Nazwa pliku wykonywalnego to <code>fgfs</code> (lub plik AppImage, np. "flightgear-2024.1.6-linux-amd64.AppImage") i można go uruchomić bez opcji. Jeśli "nie został znaleziony", prawdopodobnie nie znajduje się w Twojej [https://en.wikipedia.org/wiki/PATH_(variable) ścieżce]. Lokalizacja zależy od Twojego konkretnego systemu i wyborów dokonanych podczas kompilacji i instalacji. Istnieje lista [[Pl/Opcje_wiersza_poleceń|parametrów wiersza poleceń]], których należy użyć do zmiany wielu opcji, takich jak wybrany statek powietrzny. Najważniejsze z nich:

fgfs --launcher # otwiera Launcher FlightGeara
fgfs --show-aircraft # wyświetla listę zainstalowanych statków powietrznych
fgfs --aircraft=c172p # uruchamia FG z statkiem powietrznym "c172p" (z listy)

Launcher umożliwia również użytkownikom dodawanie parametrów wiersza poleceń dla opcji, które są zwykle zmieniane z poziomu menu wewnątrz symulatora, a także dość zaawansowanych opcji dostępnych tylko z wiersza poleceń.

=== Konfiguracja renderowania i interfejsu użytkownika ===
[[File:Rendering options 2024.1.png|thumb|Okno dialogowe Widok > Opcje renderowania.]]
Jeśli jakość renderowania lub liczba klatek na sekundę jest zbyt niska, kliknij "Widok > Opcje renderowania", aby dostosować ustawienia graficzne. Dla nowszego sprzętu zaleca się ustawienie "jakości grafiki" na wysoką i zaznaczenie "użyj miejsca na dysku dla szybszego ładowania", "animowane rękawy" i "satelitarna fotosceneria".

Jeśli tekst menu wydaje się zbyt mały na ekranach o wysokiej rozdzielczości lub dużych ekranach, możesz ręcznie [[Menubar#How to Change the Default Menubar Font Size|zmienić rozmiar czcionki paska menu]], edytując plik danych, lub po prostu kliknąć "Debuguj > Zmień styl GUI".

=== Używanie klawiatury i/lub myszy ===
Użytkownicy z ograniczonym dostępem do [[joystick|joysticka]] lub innych kontrolerów czasami używają klawiatury lub myszy do sterowania swoim statkiem powietrznym. Używanie klawiatury do latania może być trudne, a mysz jest zalecana zamiast klawiatury do latania, jednak nawet tani joystick znacznie poprawiłby wrażenia.

Aby uzyskać pomoc dotyczącą poleceń klawiatury, gdy FlightGear jest uruchomiony, przejdź do menu ''Pomoc'', spójrz w ''Podstawowe klawisze'' (dla poleceń związanych z symulatorem), ''Wspólne klawisze statków powietrznych'' (dla poleceń uniwersalnych dla wszystkich statków powietrznych) i ''Pomoc dla statku powietrznego'' (dla poleceń specyficznych dla Twojego statku). Jeśli główne menu jest ukryte, naciśnij {{key press|F10}}. Jeśli przychodzisz z innych symulatorów, sprawdź [[key commands compared to other simulators|porównanie poleceń klawiatury z innymi symulatorami]], aby uzyskać przegląd różnic między poleceniami klawiatury tego symulatora a FlightGear.

Aby użyć myszy do latania statkiem powietrznym, naciśnij {{key press|Tab}} (kursor powinien zmienić się w krzyżyk) i przesuwaj myszą, aby kierować statkiem powietrznym. Naciśnij ponownie {{key press|Tab}}, aby rozglądać się (kursor powinien pokazywać dwustronną strzałkę), i naciśnij {{key press|Tab}} ponownie, aby wrócić do trybu normalnego, używanego do klikania elementów w kokpicie. Możesz kliknąć "Plik > Urządzenia wejściowe > Konfiguracja myszy", aby dostosować czułość myszy.

Dla większości użytkowników nieposiadających kontroli osi steru kierunku, trudno jest ręcznie koordynować ruchy [[aileron|lotki]] i [[rudder|steru kierunku]] podczas zakrętu. Aby włączyć autokoordynację i ułatwić latanie, możesz kliknąć "Ustawienia", następnie kliknąć przycisk "Pokaż więcej" po prawej stronie "Ogólne", a na końcu kliknąć "Włącz autokoordynację" w Launcherze.

=== Pierwszy raz w kokpicie ===
Orientacja w kokpicie może być wyzwaniem za pierwszym razem.

Możesz użyć {{key press|Ctrl|V}}, aby przełączyć się na widok kokpitu. Jeśli tekst na panelu jest zbyt mały, możesz użyć trybu widoku myszy (naciśnij Tab, aż uzyskasz kursor w kształcie podwójnej strzałki), aby przesuwać widok, i kółko myszy, aby przybliżać, lub przesuwać widok za pomocą czapki joysticka i przybliżać za pomocą {{key press|X}} i {{key press|Shift|X}}.

Jednym z pierwszych kroków, które wielu podejmuje po wejściu do nieznanego kokpitu, jest naciśnięcie {{key press|Ctrl|C}} w celu podświetlenia wszystkich "gorących punktów", czyli elementów sterujących przyrządami, przycisków, pokręteł itp. Wiele statków powietrznych oferuje również specjalne menu pomocy.

Niektóre funkcje, takie jak rozrusznik lub magneto, mogą być trudne w użyciu lub po prostu nie mieć klikalnych "gorących punktów", zwłaszcza w modelach statków powietrznych w fazie rozwoju. W większości przypadków możesz użyć klawiatury. Klawiatura zawsze działa zgodnie z przypisaniami wymienionymi w menu "Pomoc > Pomoc dla statku powietrznego" lub "Pomoc > Wspólne klawisze statków powietrznych", ale czasami niektóre klawisze są przypisywane ponownie przez statek powietrzny lub konfigurację. Ponownie, pamiętaj, aby sprawdzić wszystkie okna dialogowe pomocy.

=== Uruchamianie silnika ===
Chcesz już lecieć, ale silnik jest wyłączony. Cóż, włączanie silników nie zawsze jest łatwe. Większość statków powietrznych ma wpis ''autostart'' w swoim niestandardowym menu, ale oto ogólna procedura, która powinna działać w wielu przypadkach:

Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem tłokowym, potrzebujesz (po upewnieniu się, że gra nie jest wstrzymana {{key press|p}}):
# Paliwo: Niektóre statki powietrzne rozpoczynają symulację bez paliwa. Możesz je dodać w ''Wyposażenie'' > ''Paliwo i ładunek''.
# Prawidłowa mieszanka paliwowa: Zazwyczaj jest ''bogata'', więc wciśnij czerwony pokrętło do samego końca lub użyj klawisza {{key press|m}}, aby wzbogacić ({{key press|Shift|m}} zuboża).
# Magneto ustawione na ''obie'': Obróć kluczyk lub naciśnij {{key press|}}} ''trzy razy'', aby przejść przez ''R'', ''L'', ''Obie''.
# Przepustnica: Niektóre silniki lepiej uruchamiają się przy odrobinie gazu.
# Uruchom rozrusznik: Kliknij pozycję ''Start'' kluczyka na panelu lub naciśnij {{key press|s}}. Przytrzymaj rozrusznik przez wystarczający czas, nawet 10 sekund.

Uruchamianie wszystkich silników w statku powietrznym z wieloma silnikami jest podobne do uruchamiania pojedynczego silnika - z tą różnicą, że musisz powtórzyć tę samą sekwencję rozruchu dla każdego silnika. FlightGear oferuje wygodny sposób, aby zrobić to dla wszystkich silników jednocześnie: naciśnij {{key press|~}} i cała powyższa procedura zadziała dla wszystkich silników. Należy jednak pamiętać, że domyślny panel 2D jest podłączony do ''tylko jednego silnika'' i sztuczka z {{key press|~}} może nie zadziałać. Dodaj też trochę gazu, aby upewnić się, że wszystkie silniki są włączone.

Te instrukcje mogą nie działać dla odrzutowców, śmigłowców lub innych typów statków powietrznych o złożonych procedurach rozruchu. Sprawdź instrukcje w menu pomocy statku powietrznego (naciśnij {{key press|?}}) i/lub spójrz na [[Aircraft|artykuł o tym statku powietrznym na tej wiki]]. Ogólnie, aby uruchomić silnik w statku powietrznym z silnikiem odrzutowym, musisz:
# Ustawić odcięcie ''ON''
# Włączyć rozrusznik
# Gdy silniki osiągną około 5% N1, ustawić odcięcie ''OFF''
# Wyłączyć rozrusznik, gdy silnik osiągnie prędkość roboczą

== Nauka latania ==
=== Podręcznik FlightGear ===
FlightGear ma oficjalny [https://www.flightgear.org/support/manual/ podręcznik], który obejmuje podstawy latania. Jako początkujący, możesz chcieć zacząć od [https://flightgear.gitlab.io/getstart/release-{{current release|cr}}/pl/HTML/getstart-plch8.html Rozdziału 8: Podstawowy poradnik symulatora lotu].

=== Samouczki ===
Wiele statków powietrznych ma własne interaktywne [[tutorials|samouczki]]. Dzięki samouczkom możesz nauczyć się obsługiwać konkretny statek powietrzny, ale także nauczyć się latać. Możesz uzyskać dostęp do samouczków, przechodząc do ''Pomoc'' > ''Samouczek''. Świetnym miejscem na rozpoczęcie jest samouczek dla statku powietrznego [[Cessna 172P]], powszechnie używanego w rzeczywistości do nauki latania statkami powietrznymi o stałych skrzydłach.

Jeśli samouczek zaczyna się bez pasa startowego i w otoczeniu wody, Twoja instalacja FlightGeara nie ma scenerii dla lotniska, na którym samouczek miał się odbyć. Aby uzyskać scenerię, zobacz sekcję [[#Getting scenery|#Pobieranie scenerii]] powyżej.

== Twój pierwszy lot ==
=== Realizm ===
Jednym z najczęstszych pytań, jakie zadają początkujący piloci na temat każdego symulatora lotu, ale zwłaszcza FlightGeara, jest "Dlaczego mój statek powietrzny cały czas skręca w lewo?" Chociaż może to być spowodowane podmuchami wiatru przecinającymi pas startowy, bardziej prawdopodobne jest, że wynika to z [[Understanding Propeller Torque and P-Factor|momentu obrotowego śmigła i efektu P]].

W niektórych innych symulatorach lotu, pomimo haseł marketingowych głoszących co innego, niektóre ustawienia są obniżone, aby statek powietrzny był łatwiejszy w pilotażu. Zmniejsza to efekty takie jak powyższy. Realizm we FlightGear jest zawsze podkręcony do maksimum.

Oto niektóre punkty realizmu FlightGeara, które mogą dezorientować początkujących pilotów:
* "Syndrom skręcania w lewo" z wyżej wymienionych powodów.
* Błąd skrętu kompasu: Kompas, poddany siłom lotu, ma tendencję do skręcania w przeciwnym kierunku na krótki okres, zanim ustabilizuje się na prawidłowym kursie. Nie jest to usterka (zobacz także artykuł Wikipedii {{wikipedia|Aircraft compass turns}}).
* Wskaźnik prędkości pionowej (VSI) również jest obarczony błędem.
* [[Horizontal Situation Indicator|Wskaźnik sytuacji poziomej]] (HSI) jest napędzany przez żyroskop (dlatego czasami nazywa się go żyroskopem kierunkowym), który podlega ''dryfowi żyroskopowemu''. Wskaźnik będzie odchylać się od aktualnego kursu i musi być okresowo (co ~15 minut) kalibrowany, aby zgadzał się z kursem kompasu magnetycznego.
* Nie możesz po prostu przerwać skrętu lub wznoszenia poprzez wycentrowanie drążka lub pałki sterowniczej. Musisz skręcić lub popchnąć drążek w drugą stronę, aby wrócić do lotu poziomego. Ale nawet wtedy samolot nie utrzyma samodzielnie swojej wysokości ani kursu. Częstym błędem jest próba znalezienia pozycji drążka, przy której można puścić stery. Chociaż za pomocą trymowania można zostawić samolot na kilka sekund, trzeba użyć autopilota lub stale regulować drążek.

Na statek powietrzny w locie działa wiele sił, a także na [[avionics and instruments|awionikę i przyrządy]] używane do sterowania i nawigacji, co może być sprzeczne z intuicją. Piloci muszą nauczyć się rozpoznawać te zjawiska i kompensować ich skutki. ''FlightGear modeluje błędy przyrządów, które istnieją w rzeczywistym świecie''. Jeśli nie chcesz tego, naciśnij {{key press|h}}, aby włączyć HUD.

=== Lotniska i pomoce nawigacyjne ===
Gdy po raz pierwszy uruchamiasz FlightGear, czy to z wiersza poleceń, czy z interfejsu Launchera, możesz zastanawiać się, jak określić, jakie lotniska są dostępne. Program uruchamiający wyświetla listę lotnisk, ale nie zobaczysz szczegółów, takich jak częstotliwości wieży lub [[ILS|ILS]]. Nie znajdziesz mapy pokazującej [[VOR|VOR-y]] i ich częstotliwości. Co możesz zrobić? Zobacz [[Getting aeronautical charts|Pozyskiwanie map lotniczych]].

W symulatorze dostępna jest mapa, której możesz użyć w ''Menu główne'' > ''Wyposażenie'' > ''Mapa'', która pozwoli Ci zobaczyć dane nawigacyjne oraz pozycję lotnisk i pomocy. Aby uzyskać więcej pomocy dotyczącej nawigacji, zobacz [[Understanding navigation|Zrozumienie nawigacji]].

=== Latanie z autopilotem ===
Ogólny [[autopilot|autopilot]] jest dostępny w menu ''Autopilot > Ustawienia autopilota'', podczas gdy wiele statków powietrznych ma własny ''specyficzny'' autopilot, często będący modelem rzeczywistego.

W przypadku statków powietrznych, które mają własny autopilot, powinieneś używać elementów sterujących autopilotem dostępnych w wirtualnym kokpicie. Oznacza to klikanie na panelu przyrządów w wirtualnym kokpicie. Menu Autopilot może być wyszarzone i niedostępne, gdy statek powietrzny dostarcza własny autopilot w niektórych statkach powietrznych, w tym Airbuses i [[Cessna 172P|C172P]].

Cessna 172 jest wyposażona w [[Bendix/King KAP140 Autopilot|autopilot Bendix/King KAP140]] w swoim wirtualnym kokpicie. Możesz używać zarówno urządzenia autopilota w kokpicie, jak i [[Autopilot#Autopilot Settings|ustawień autopilota]] z menu.

== Zaawansowane ==
=== Latanie ===
{{Main article|Aircraft|Statki powietrzne}}

* Jeśli nadal latasz lekkimi cywilnymi statkami powietrznymi, [[Cessna 182S]], która jest bardziej złożona niż C172P, oraz [[Piper PA28 Warrior II|PA28]] to dobre wybory.
* Jeśli interesuje Cię latanie liniami lotniczymi, sugeruje się rodziny [[Airbus A320 family|Airbus A320]], Boeing [[Boeing 777|777]]/[[Boeing 787-8 Dreamliner|787]], [[MD-11]] i [[MD-80]].
* Jeśli fascynują Cię samoloty myśliwskie, wybierz wysoko oceniany wojskowy statek powietrzny (taki jak [[General Dynamics F-16 Fighting Falcon|F-16]]/[[F-15]]) z [[Aircraft#Modern military aircraft|tej listy]] i włącz obrażenia w trybie wieloosobowym lub zainstaluj [[Bombable]].
* Jeśli przechodzisz na śmigłowce, zaleca się latanie [[Eurocopter EC130 B4]].

Oprócz zwykłych statków powietrznych dostępne są również szczegółowe [[Space Shuttle|wahadłowce kosmiczne]].

=== Sceneria ===
Fascynujące jest odkrywanie [[scenery|scenerii]] (lub po prostu testowanie grafiki/szybkości klatek) za pomocą [[UFO|UFO]]. Po pierwsze, [[#Configuring rendering and UI|zwiększ swoją jakość grafiki]]. Jeśli początkowo nie widzisz budynków, pozostaw FG otwarte i odczekaj chwilę, aż [[TerraSync]] zakończy pobieranie i budynki się pojawią.
Istnieje wiele [[Suggested airports|dobrze rozwiniętych lotnisk]] i obszarów scenerii. Możesz również eksplorować obiekty scenerii na [https://scenery.flightgear.org/map mapie modeli].

=== Tryb wieloosobowy ===
FlightGear ma kilka serwerów wieloosobowych, które pozwolą Ci latać w bardziej ożywionych przestworzach; zobacz [[Howto: Multiplayer|Tryb wieloosobowy]]. Istnieją również [[OpenRadar]] i [[ATC-pie]], samodzielne programy, które pozwolą Ci być [[Air traffic control|kontrolerem ruchu lotniczego]].

Dostępna jest również [[MPMap|mapa wieloosobowa]], która pozwala zobaczyć, kto jest aktualnie online, a nawet jakie [[navaids|pomoce nawigacyjne]] są w pobliżu.

=== Elementy menu ===
Aby szybko zapoznać się z użyciem każdej pozycji menu w FlightGear, zobacz [[menu]].

=== Dodatki ===
FlightGear ma wiele [[Addon|dodatków]] innych firm zawierających ulepszenia. Dla początkujących, [[Logbook Add-on|Dziennik lotów]] i dodatek [[Which Runway Add-on|Który pas]] mogą być najbardziej przydatnymi dodatkami.

== Społeczność FlightGear ==
=== Uzyskiwanie pomocy ===
Ta strona została zaprojektowana, aby zapewnić użytkownikowi najważniejsze informacje, które musi wiedzieć o korzystaniu z FlightGeara po raz pierwszy. Oprócz [[Pl/Portal:Użytkownik|portalu użytkownika]] tej wiki, istnieją inne strony, które możesz chcieć przeczytać:
*[[Troubleshooting problems|Rozwiązywanie problemów]], aby pomóc Ci z najczęstszymi problemami;
*[[Pl/FAQ|Często zadawane pytania]];
...oraz kanały komunikacji, które mogą być używane do uzyskania informacji lub poproszenia o pomoc:
*[[Pl/Podręcznik FlightGear|Podręcznik FlightGear]], ''obowiązkowa lektura'' dla początkujących;
*{{forum link|text=Forum FlightGear}} i jego podfora;
*[[Discord|Serwer Discord FlightGear]], najszybszy sposób na uzyskanie pomocy;
*[[FlightGear IRC channel|Kanał IRC FlightGear]];
*[[Mailing list|Lista mailingowa użytkowników FlightGeara]], największa szansa na kontakt z głównymi deweloperami;
*Dokumenty dołączone do pakietu wydaniowego.

=== Dostosowywanie FlightGear bez kompilacji ===
[https://www.flightgear.org/download/ Nasza strona internetowa] oferuje prekompilowane pliki binarne do pobrania i instalacji na Windows, macOS i Linux. Ponadto większość dystrybucji Linuksa udostępnia spakowaną wersję w swoich repozytoriach.

Chociaż instalacja jest binarna, większość systemów FlightGear jest otwarta na konfigurację poprzez pliki [[XML]] i [[NASAL scripting|skrypty NASAL]]. Masz swobodę ''i jesteś zachęcany'' do wprowadzania zmian w modelach lotu statków powietrznych, scenerii, teksturach, [[shader|shaderach]] OpenGL i każdej innej funkcji, którą chcesz zmienić dla własnej satysfakcji lub podzielić się z innymi użytkownikami FlightGeara. Jeśli to zamierzasz zrobić, spójrz na [[/Pl/Portal:Developer|portal dewelopera]].

=== Jak możesz pomóc ===
{{Main article|Volunteer|Wolontariusz}}
FlightGear to projekt open source, oparty na wolontariacie. Oznacza to, że wszystko, co tu znajdziesz, pochodzi z pasji, wolnego czasu i niczego więcej. Obejmuje to symulator, scenerię, statki powietrzne, wiki, {{forum link|text=forum}} i wszystko inne. Wolontariusze, w istocie ''ludzie, którzy coś robią'', są fundamentalni dla tego projektu. Bez nich nie zrobiłby ani jednego kroku do przodu. Dlatego ważne jest, aby współtwórcy dobrze się bawili tym, co robią.

Jeśli planujesz wnieść wkład w ten projekt, powinieneś zapoznać się z kilkoma artykułami, które dadzą Ci pewne wskazówki:
*[[Howto:Understand the FlightGear development process|Jak zrozumieć proces rozwoju FlightGeara]]
*[[Implementing new features for FlightGear|Wdrażanie nowych funkcji dla FlightGeara]]
*[[How the FlightGear project works|Jak działa projekt FlightGear]]

Dziedzin, w których ich pomoc byłaby doceniona, jest wiele:
;Testowanie:
*[[Building FlightGear|Skompiluj]] najnowszy kod Git
*[https://gitlab.com/flightgear/flightgear/-/issues Zgłaszaj raporty o błędach]
*Uruchamianie FlightGeara za pomocą programu valgrind w celu wykrycia wycieków pamięci

;Wsparcie:
*Pomoc nowym użytkownikom w pobieraniu, kompilowaniu, instalowaniu i uruchamianiu FlightGeara ({{forum link|text=na forum}} lub na [[Discord|Discordzie]])
*Dostarczanie pomysłów i sugestii, zobacz: [[Feature Requests / Proposals / Ideas|Prośby o funkcje / Propozycje / Pomysły]]
*Pomoc w [[Portal:Wiki|oczyszczeniu tej wiki]]
*Pomoc w dostarczaniu nowych treści dla brakujących stron wiki

;Rozwój:
*Podstawowy kod źródłowy:
**Dostarczanie [[Howto:Start core development|wkładu w kod źródłowy, dane i dokumentację]]
**Dostarczanie [[Bugs|poprawek błędów]] lub nowych funkcji
*Rozwój statków powietrznych (modelowanie 3D, tekstury, modele lotu, skrypty)
*Rozwój scenerii (teren, modele, pogoda)
*Zaangażowanie w którykolwiek z innych projektów powiązanych z FlightGearem

[[Category:FlightGear]]

[[ca:Nou a FlightGear]]
[[de:Neu bei FlightGear]]
[[en:New to FlightGear]]
[[es:Nuevo en FlightGear]]
[[fi:Uusi_käyttäjä]]
[[fr:Nouveau sur flightgear]]
[[it:Nuovo per FlightGear]]
[[ja:FlightGear入門]]
[[nl:Nieuw bij FlightGear]]
[[pt:Novo no FlightGear]]
[[sr:Novi u FlightGear-u]]
[[th:New to FlightGear]]
[[zh:FlightGear新手]]

Pl/Instalowanie samolotów

2026-06-17T10:30:29Z

PlayeRom:

{{installing}}

Preferowaną opcją instalacji najnowszego, oficjalnego [[aircraft|samolotu]] jest zakładka ''Statek powietrzny'' we wbudowanym [[FlightGear Qt launcher|launcherze]], co można zobaczyć na dołączonym filmie. Pozostała część tego artykułu opisuje proces ręczny, który należy wykonać tylko wtedy, gdy nie używamy statków powietrznych z oficjalnego hangaru FGAddon.

{{#ev:youtube|8eaUXFDEltg|480px||Poradnik na kanale SP-ROM, jak zainstalować samoloty z oficjalnego hangaru, z GitHuba, czy po prostu z innych miejsc w internecie.}}

== Ręczny proces instalacji ==

=== Linux ===
(Ubuntu 12.04)
# Pobierz paczkę ze statkiem powietrznym.
# Utwórz katalog do przechowywania statków powietrznych, jeśli jeszcze tego nie zrobiłeś. Upewnij się, że ten katalog znajduje się poza <tt>/usr/share/games/flightgear/</tt>. Na przykład użyj <tt>/home/{NazwaTwojegoUżytkownika}/FlightGear/CustomAircrafts</tt>.
# Rozpakuj pobrany plik ze statkiem powietrznym do powyższego folderu.
# Uruchom FlightGear z Launcherem. W Launcherze idź do zakładki ''Dodatki''. W sekcji ''Dodatkowe katalogi statków powietrznych'' kliknij przycisk ''Dodaj'' i wskaż główny folder dodatkowych statków powietrznych (w naszym przypadku <tt>/home/{NazwaTwojegoUżytkownika}/FlightGear/CustomAircrafts</tt>). Teraz Twój statek powietrzny powinien pojawić się na liście statków powietrznych, jeśli nie to zrestartuj FlightGeara.

Teraz, kolejny pobrany statek powietrzny wystarczy rozpakować w tym samym katalogu i powinien być już widoczny we FlightGear.

=== macOS ===
Po pierwsze, musimy upewnić się, że aplikacja FG znajduje się w folderze aplikacji, co można zrobić, po prostu przeciągając ją do folderu aplikacji z dowolnego miejsca, w którym się aktualnie znajduje.
Przejdźmy teraz do faktycznego dodawania statków powietrznych:

# Przejdź do aplikacji w folderze.
# Control+kliknij FlightGear.
# Kliknij drugą opcję, która brzmi "Show Package Contents".
# Następnie kliknij następujące foldery: "Contents >> Resources >> data >> Aircraft".
# Teraz wystarczy kliknąć i przeciągnąć dane statku powietrznego pobrane ze strony internetowej FG do folderu Aircraft.

Sprawdzono na macOS Sierra.

=== Windows ===
# Pobierz paczkę ze statkiem powietrznym i rozpakuj ją za pomocą archiwizatora plików, na przykład za pomocą programu [http://www.7-zip.org/ 7-Zip].
# Utwórz katalog do przechowywania statków powietrznych, jeśli jeszcze tego nie zrobiłeś. Upewnij się, że ten katalog znajduje się poza katalogiem <tt>[[$FG_ROOT]]</tt>. Na przykład użyj <tt>C:\Users\{NazwaTwojegoUżytkownika}\FlightGear\CustomAircrafts</tt>.
# Przenieś rozpakowany folder (zwykle z nazwą statku powietrznego) do uprzednio utworzonego katalogu.
# Uruchom FlightGear z Launcherem. W Launcherze idź do zakładki ''Dodatki''. W sekcji ''Dodatkowe katalogi statków powietrznych'' kliknij przycisk ''Dodaj'' i wskaż główny folder dodatkowych statków powietrznych (w naszym przypadku <tt>C:\Users\{NazwaTwojegoUżytkownika}\FlightGear\CustomAircrafts</tt>). Teraz Twój statek powietrzny powinien pojawić się na liście statków powietrznych, jeśli nie to zrestartuj FlightGeara.

Teraz, kolejny pobrany statek powietrzny wystarczy rozpakować w tym samym katalogu i powinien być już widoczny we FlightGear.

=== Z wiersza poleceń ===
Uruchamiając FlightGeara z wiersza poleceń, użyć opcji <code>--fg-aircraft=ścieżka</code>, czyli w naszym przypadku może to być: <code>
--fg-aircraft=/home/{NazwaUżytkownika}/FlightGear/CustomAircrafts</code>.

== Gdy instalacja statku powietrznego nie powiedzie się ==
=== Zmień nazwę folderu statku powietrznego ===
Jeśli FlightGear nie uruchomi się z nowo zainstalowanym statkiem powietrznym lub jeśli wystartuje, ale statek powietrzny jest niewidoczny, być może będziesz musiał zmienić nazwę folderu, w którym znajdują się pliki statku powietrznego.
Ten problem najczęściej występuje podczas pobierania pliku .zip z jakiegoś internetowego repozytorium git. W takich przypadkach najprawdopodobniej otrzymasz nazwę folderu w postaci MyZippedRepo-[gałąź]. W takim przypadku powinieneś zmienić nazwę folderu na '''MyZippedRepo'''.

Jeśli powyższe nie działa lub masz inny przypadek, poszukaj pliku readme, możliwe że tam będzie instrukcja instalacji.

W przeciwnym razie otwórz plik aircraft-set.xml i wyszukaj w nim ścieżki zawierającej '''Aircraft/NazwaKataloguSamolotu'''. Nazwa folderu powinna być zgodna z '''NazwaKataloguSamolotu'''.

Na przykład, jeśli w imaginary-set.xml znajdziesz taką instancję:
<syntaxhighlight lang="xml">
<splash-texture>Aircraft/MyCreation/splash1.png</splash-texture>
</syntaxhighlight>
oznacza to, że należy zmienić nazwę folderu, w którym znajduje się plik imaginary-set.xml na '''MyCreation'''.

=== Pliki XML z nieprawidłowym kodowaniem ===
Jeśli uruchamiasz FlightGeara z nowym statkiem powietrznym, który zainstalowałeś i nie ma kokpitu ani elementów zewnętrznych, może to być spowodowane nieprawidłowym kodowaniem plików XML.

Aby to naprawić w systemie Linux, wypróbuj to:
<syntaxhighlight lang="bash">
$ cd path/to/aircraft/directory/
$ find . -name "*.xml" -print | xargs sed -i 's/<?xml version="1.0" encoding="UTF-8"?>/<?xml version="1.0" encoding="ISO-8859-1"?>/g'
</syntaxhighlight>

Jeśli którakolwiek z powyższych metod nie działa, zapytaj na [[Howto:Multiplayer#Multiplayer chat|czacie multiplayer]], kanale [[FlightGear IRC channel|IRC]] lub na {{forum link|f=11|text=forum}}.

== Wybór statku powietrznego ==
Jeśli szukasz informacji, jaki statek powietrzny pobrać, spróbuj:
* [[Pl/Samoloty|Statki powietrzne]]
* [[Helicopter|Śmigłowce]]
* [[Vehicle|Pojazdy]]
* [[Table of models|Tabela modeli]]
Zewnętrzne linki do statków powietrznych stron trzecich można znaleźć w [[FlightGear hangars|Hangary FlightGear]]. Pamiętaj, że najnowsze statki powietrzne mogą nie wczytywać się z poprzednimi wersjami FlightGeara. Jeśli używasz starszej wersji FlightGeara, poszukaj starszych statków powietrznych w sekcji z linkami.

== Galeria (2017+) ==

<gallery mode="packed">
File:EC135_Heer.jpeg|[[Eurocopter_EC135|Eurocopter EC135]] z efektem podmuchów z wirnika na trawie (FG 2020).

File:DHC-6_in_Alaska.jpg|[[De_Havilland_Canada_DHC-6_Twin_Otter|de Havilland Canada DHC-6 Twin Otter]] nad Alaską. Warianty: pływaki, amfibia i płozy (FG 2017).

File:Amelia.jpg|[[Alouette-III]] zawiera symulację sztucznej inteligencji (celowo niedoskonałej) [[Alouette-III#Amelia|drugiego pilota]], która może pomóc osobą uczącym się latać helikopterami, aby wystartować i zawisnąć (FG 2018).

File:EC_130_on_the_slope_of_a_shield_volcano_in_Hawaii_-_Flightgear_2018.x.jpg|[[Eurocopter_EC130|Eurocopter EC130]] na zboczu wulkanu tarczowego na Hawajach. EC130 posiada najbardziej szczegółowe systemy śmigłowców, dostępne w FGAddon we Flightgear (FG 2018).

File:Asia.jpg|[[Space_Shuttle|Space Shuttle]]. Flightgear może wyświetlać widok z orbity za pomocą [[Earthview]] - widoczne tutaj tekstury w wysokiej rozdzielczości są dostępne jako osobne pliki do pobrania.

File:ALS_Compositor_pipeline.jpg|[[Piper J-3 Cub|Piper J-3 Cub]] nadaje się również do treningu. J-3 Cub ma wariant szklanego kokpitu [[FG1000|G1000]], a także warianty z pływakami, amfibię, płozy, trójkołowiec, warianty na busz w kilku rozmiarach silnika (FG 2020.x, Compositor).

File:SOTM-Jan19.jpg|[[Robinson_R44|Robinson R44]] jest popularnym helikopterem szkoleniowym, ponieważ jest niedrogi, ale trudno go kontrolować. W symulacjach wydatek nie ma znaczenia. Osoby próbujące po raz pierwszy helikoptera we Flightgear, powinny wypróbować jeden z pozostałych przed R44, chyba że mają ku temu konkretny powód (FG 2019).

</gallery>

== Powiązane treści ==
* [[Pl/Instalowanie_scenerii|Instalowanie scenerii]]

[[Category:Howto|Install aircraft]]

[[de:Howto:Flugzeuge Installieren]]
[[en:Howto:_Install_aircraft]]
[[es:Cómo:Instalar_aviones]]
[[fr:Howto Installer un avion]]

Volanta

2026-06-15T17:39:05Z

PlayeRom: /* Volanta can't recognize FlightGear and it doesn't prompt to install the plugin (Ubuntu specific) */

[https://volanta.app/ Volanta] is an easy-to-use smart flight tracker that integrates flight data across all major flight simulators including FlightGear.

== Getting started ==
=== Windows ===
# Download the Volanta installer from [https://api.volanta.app/api/v1/ClientUpdate/Latest here] and run the installer.
# Open Volanta with administrator permissions (If already open, close Volanta completely by right clicking the Volanta icon on the system tray and pressing exit).
# Once a Volanta account is created and logged in, Volanta will automatically search for available flight simulators and prompt to install the FlightGear plugin.
# Press install and follow the prompt shown in Volanta to add the <code>C:\Users\USERNAME\FlightGear\Downloads\fgdata_2024_1\Addons\volanta</code> folder to your add-on modules in the FlightGear Launcher.
# Fly!

=== Ubuntu ===

# Download the Volanta AppImage from [https://api.volanta.app/api/v1/ClientUpdate/Latest here].
# Make the file executable by right clicking on it and selecting "Executable as program". After that, run the file.
# Once a Volanta account is created and logged in, Volanta will automatically search for available flight simulators and prompt to install the FlightGear plugin.
# Press install and follow the prompt shown in Volanta to add a folder to your add-on modules in the FlightGear Launcher.
# Fly!

== Common issues ==

=== I press Install (plugin) in Volanta and it says installed but ''Settings'' > ''Simulators'' show uninstalled ===

==== Windows ====
You're probably storing your FlightGear data directory in a different location than the default. There are two ways to fix this: you can either manually copy the files to your FlightGear data folder or even better - use a simpler workaround.

===== Option A: The AppData Workaround (Simpler) =====
FlightGear doesn't actually require you to copy the add-on to the FlightGear data directory. Therefore, there's a simpler solution where you don't even need to know where the FlightGear data is located, and the Volanta add-on files are stored in one place:
# Go to the <code>%appdata%\Orbx\Volanta\plugins\</code> directory.
# Create the <code>FGData\Protocol</code> subdirectories there, i.e., <code>%appdata%\Orbx\Volanta\plugins\FGData\Protocol\</code>.
# Copy the <code>%appdata%\Orbx\Volanta\plugins\volanta.xml</code> file to the <code>%appdata%\Orbx\Volanta\plugins\FGData\Protocol\</code> directory.
# In the FlightGear Launcher go to "Add-ons" tab, click "Add" button by "Add-on Module folders" section and select the <code>%appdata%\Orbx\Volanta\plugins</code> folder or add the option <code>--addon=C:\Users\USERNAME\AppData\Roaming\Orbx\Volanta\plugins</code> in the additional settings/command line options. You must change "USERNAME" to the actual username of your system.

This solution means that the FlightGear simulator will mark the plugin as not installed in the Volanta settings, but that doesn't affect anything. You can also uncheck the plugin installation notifications option if you don't want Volanta to nag you about it, as the tracking will work fine for FlightGear anyway.

===== Option B: Manual copy to the FGData directory =====
If you want Volanta to explicitly show the plugin as "Installed" in its ''Settings'' > ''Simulators'' menu, you must manually copy the files to your FlightGear data directory. By default, FlightGear downloads its data to a specific folder (like <code>fgdata_2024_1</code>, default: <code>%UserProfile%\FlightGear\Downloads\fgdata_2024_1\</code>). You can manually copy the Volanta plugin files there:
# Open File Explorer and navigate to your FlightGear data directory. By default, it is located at: <code>%UserProfile%\FlightGear\Downloads\fgdata_2024_1</code>.
# Inside that folder, create a new folder named <code>Addons</code>, and then inside it, create a subfolder named <code>volanta</code> (resulting in the path: <code>...\fgdata_2024_1\Addons\volanta</code>).
# Open another File Explorer window and go to the Volanta plugins folder: <code>%appdata%\Orbx\Volanta\plugins\</code>.
# Copy all files starting with <code>addon-</code> (e.g., <code>addon-config.xml</code>, <code>addon-main.nas</code>, etc.) and paste them into the newly created <code>Addons\volanta</code> folder.
# Go back to the <code>%appdata%\Orbx\Volanta\plugins\</code> folder, copy the <code>volanta.xml</code> file, and paste it into the <code>Protocol</code> folder inside your FlightGear data directory. (Resulting in the path: <code>...\fgdata_2024_1\Protocol</code>).
# Finally, in the FlightGear Launcher go to "Add-ons" tab, click "Add" button by "Add-on Module folders" section and select the <code>C:\Users\USERNAME\FlightGear\Downloads\fgdata_2024_1\Addons\volanta</code> directory or add the option <code>--addon=C:\Users\USERNAME\FlightGear\Downloads\fgdata_2024_1\Addons\volanta</code> in the additional settings/command line options. Remember to replace "USERNAME" with your actual Windows username.

==== Ubuntu ====
If FlightGear was installed from a repository or from a package, FlightGear files are located in the system directory. Volanta doesn't have permission to change or write here so you have to install the plugin manually. However, FlightGear doesn't require you to copy the add-on to the FlightGear data directory, which Volanta doesn't seem to know about. Therefore, there's a simpler solution, see [[#Volanta_can't_recognize_FlightGear_and_it_doesn't_prompt_to_install_the_plugin_(Ubuntu_specific)]]

However, if you want Volanta to notify you that the plugin is installed, execute the following commands in the Linux console:

<syntaxhighlight lang="shell">
sudo mkdir -p /usr/share/games/flightgear/Addons/volanta
sudo cp ~/.config/Orbx/Volanta/plugins/addon-* /usr/share/games/flightgear/Addons/volanta/
sudo cp ~/.config/Orbx/Volanta/plugins/volanta.xml /usr/share/games/flightgear/Protocol/
</syntaxhighlight>

Now in the FlightGear launcher, specify the add-on location as <code>/usr/share/games/flightgear/Addons/volanta/</code> or add the <code>--addon=/usr/share/games/flightgear/Addons/volanta/</code> option in the additional settings.

=== Volanta plugin is "unable to be installed due to permissions" (Windows specific) ===
Exit Volanta completely (from taskbar) then reopen the program with administrator permissions.

=== Volanta can't recognize FlightGear and it doesn't prompt to install the plugin (Ubuntu specific) ===
This issue occurs when FlightGear is run from an AppImage file. Because the simulator doesn't use standard installation paths, Volanta cannot find it automatically and won't prompt you to install the plugin.

Fortunately, FlightGear's flexible add-on system allows us to completely bypass Volanta's default (and somewhat clunky) installation method. You don't actually need to copy any files into FlightGear's internal data directories. Instead, we can set up a minimal add-on structure directly inside Volanta's config folder and simply tell FlightGear to read it from there.

You can set this up using either the terminal or your file manager.

==== Option A: Using the Terminal (Faster) ====
Open your terminal and paste the following commands to create the directories and copy the file automatically:
<syntaxhighlight lang="shell">
cd ~/.config/Orbx/Volanta/plugins
mkdir -p FGData/Protocol
cp volanta.xml FGData/Protocol/
</syntaxhighlight>

==== Option B: Manual Setup ====
# Open your file manager and go to the <code>~/.config/Orbx/Volanta/plugins</code> directory.
# Inside it, create a new folder named <code>FGData</code>.
# Open the <code>FGData</code> folder and create a subfolder named <code>Protocol</code>.
# Copy the <code>volanta.xml</code> file (from the <code>plugins</code> folder) and paste it into the newly created <code>FGData/Protocol</code> directory.

==== Final Step: FlightGear Launcher Setup ====
Once the files are in place, you must tell FlightGear where the add-on is located.

In the FlightGear launcher, do one of the following (remember to change "USERNAME" to your actual Linux username):
* go to "Add-ons" tab, click "Add" button by "Add-on Module folders" section and select the <code>/home/USERNAME/.config/Orbx/Volanta/plugins</code> folder.
* OR add the following parameter in the additional settings/command line options: <code>--addon=/home/USERNAME/.config/Orbx/Volanta/plugins</code>

'''Note:''' The plugin is now fully installed. Even though it still might not appear in Volanta under ''Settings > Simulators'', the tracking will work correctly once you start your flight.

== Related content ==
* [[FlightGear Tracker]]

[[Category:Software]]

Volanta

2026-06-15T17:32:47Z

PlayeRom:

[https://volanta.app/ Volanta] is an easy-to-use smart flight tracker that integrates flight data across all major flight simulators including FlightGear.

== Getting started ==
=== Windows ===
# Download the Volanta installer from [https://api.volanta.app/api/v1/ClientUpdate/Latest here] and run the installer.
# Open Volanta with administrator permissions (If already open, close Volanta completely by right clicking the Volanta icon on the system tray and pressing exit).
# Once a Volanta account is created and logged in, Volanta will automatically search for available flight simulators and prompt to install the FlightGear plugin.
# Press install and follow the prompt shown in Volanta to add the <code>C:\Users\USERNAME\FlightGear\Downloads\fgdata_2024_1\Addons\volanta</code> folder to your add-on modules in the FlightGear Launcher.
# Fly!

=== Ubuntu ===

# Download the Volanta AppImage from [https://api.volanta.app/api/v1/ClientUpdate/Latest here].
# Make the file executable by right clicking on it and selecting "Executable as program". After that, run the file.
# Once a Volanta account is created and logged in, Volanta will automatically search for available flight simulators and prompt to install the FlightGear plugin.
# Press install and follow the prompt shown in Volanta to add a folder to your add-on modules in the FlightGear Launcher.
# Fly!

== Common issues ==

=== I press Install (plugin) in Volanta and it says installed but ''Settings'' > ''Simulators'' show uninstalled ===

==== Windows ====
You're probably storing your FlightGear data directory in a different location than the default. There are two ways to fix this: you can either manually copy the files to your FlightGear data folder or even better - use a simpler workaround.

===== Option A: The AppData Workaround (Simpler) =====
FlightGear doesn't actually require you to copy the add-on to the FlightGear data directory. Therefore, there's a simpler solution where you don't even need to know where the FlightGear data is located, and the Volanta add-on files are stored in one place:
# Go to the <code>%appdata%\Orbx\Volanta\plugins\</code> directory.
# Create the <code>FGData\Protocol</code> subdirectories there, i.e., <code>%appdata%\Orbx\Volanta\plugins\FGData\Protocol\</code>.
# Copy the <code>%appdata%\Orbx\Volanta\plugins\volanta.xml</code> file to the <code>%appdata%\Orbx\Volanta\plugins\FGData\Protocol\</code> directory.
# In the FlightGear Launcher go to "Add-ons" tab, click "Add" button by "Add-on Module folders" section and select the <code>%appdata%\Orbx\Volanta\plugins</code> folder or add the option <code>--addon=C:\Users\USERNAME\AppData\Roaming\Orbx\Volanta\plugins</code> in the additional settings/command line options. You must change "USERNAME" to the actual username of your system.

This solution means that the FlightGear simulator will mark the plugin as not installed in the Volanta settings, but that doesn't affect anything. You can also uncheck the plugin installation notifications option if you don't want Volanta to nag you about it, as the tracking will work fine for FlightGear anyway.

===== Option B: Manual copy to the FGData directory =====
If you want Volanta to explicitly show the plugin as "Installed" in its ''Settings'' > ''Simulators'' menu, you must manually copy the files to your FlightGear data directory. By default, FlightGear downloads its data to a specific folder (like <code>fgdata_2024_1</code>, default: <code>%UserProfile%\FlightGear\Downloads\fgdata_2024_1\</code>). You can manually copy the Volanta plugin files there:
# Open File Explorer and navigate to your FlightGear data directory. By default, it is located at: <code>%UserProfile%\FlightGear\Downloads\fgdata_2024_1</code>.
# Inside that folder, create a new folder named <code>Addons</code>, and then inside it, create a subfolder named <code>volanta</code> (resulting in the path: <code>...\fgdata_2024_1\Addons\volanta</code>).
# Open another File Explorer window and go to the Volanta plugins folder: <code>%appdata%\Orbx\Volanta\plugins\</code>.
# Copy all files starting with <code>addon-</code> (e.g., <code>addon-config.xml</code>, <code>addon-main.nas</code>, etc.) and paste them into the newly created <code>Addons\volanta</code> folder.
# Go back to the <code>%appdata%\Orbx\Volanta\plugins\</code> folder, copy the <code>volanta.xml</code> file, and paste it into the <code>Protocol</code> folder inside your FlightGear data directory. (Resulting in the path: <code>...\fgdata_2024_1\Protocol</code>).
# Finally, in the FlightGear Launcher go to "Add-ons" tab, click "Add" button by "Add-on Module folders" section and select the <code>C:\Users\USERNAME\FlightGear\Downloads\fgdata_2024_1\Addons\volanta</code> directory or add the option <code>--addon=C:\Users\USERNAME\FlightGear\Downloads\fgdata_2024_1\Addons\volanta</code> in the additional settings/command line options. Remember to replace "USERNAME" with your actual Windows username.

==== Ubuntu ====
If FlightGear was installed from a repository or from a package, FlightGear files are located in the system directory. Volanta doesn't have permission to change or write here so you have to install the plugin manually. However, FlightGear doesn't require you to copy the add-on to the FlightGear data directory, which Volanta doesn't seem to know about. Therefore, there's a simpler solution, see [[#Volanta_can't_recognize_FlightGear_and_it_doesn't_prompt_to_install_the_plugin_(Ubuntu_specific)]]

However, if you want Volanta to notify you that the plugin is installed, execute the following commands in the Linux console:

<syntaxhighlight lang="shell">
sudo mkdir -p /usr/share/games/flightgear/Addons/volanta
sudo cp ~/.config/Orbx/Volanta/plugins/addon-* /usr/share/games/flightgear/Addons/volanta/
sudo cp ~/.config/Orbx/Volanta/plugins/volanta.xml /usr/share/games/flightgear/Protocol/
</syntaxhighlight>

Now in the FlightGear launcher, specify the add-on location as <code>/usr/share/games/flightgear/Addons/volanta/</code> or add the <code>--addon=/usr/share/games/flightgear/Addons/volanta/</code> option in the additional settings.

=== Volanta plugin is "unable to be installed due to permissions" (Windows specific) ===
Exit Volanta completely (from taskbar) then reopen the program with administrator permissions.

=== Volanta can't recognize FlightGear and it doesn't prompt to install the plugin (Ubuntu specific) ===
This issue occurs when FlightGear is run from an AppImage file. Because the simulator doesn't use standard installation paths, Volanta cannot find it automatically and won't prompt you to install the plugin.

To fix this, you need to set up the plugin structure manually. You can do this using either the terminal or your file manager.

==== Option A: Using the Terminal (Faster) ====
Open your terminal and paste the following commands to create the directories and copy the file automatically:
<syntaxhighlight lang="shell">
cd ~/.config/Orbx/Volanta/plugins
mkdir -p FGData/Protocol
cp volanta.xml FGData/Protocol/
</syntaxhighlight>

==== Option B: Manual Setup ====
# Open your file manager and go to the <code>~/.config/Orbx/Volanta/plugins</code> directory.
# Inside it, create a new folder named <code>FGData</code>.
# Open the <code>FGData</code> folder and create a subfolder named <code>Protocol</code>.
# Copy the <code>volanta.xml</code> file (from the <code>plugins</code> folder) and paste it into the newly created <code>FGData/Protocol</code> directory.

==== Final Step: FlightGear Launcher Setup ====
Once the files are in place, you must tell FlightGear where the add-on is located.

In the FlightGear launcher, do one of the following (remember to change "USERNAME" to your actual Linux username):
* go to "Add-ons" tab, click "Add" button by "Add-on Module folders" section and select the <code>/home/USERNAME/.config/Orbx/Volanta/plugins</code> folder.
* OR add the following parameter in the additional settings/command line options: <code>--addon=/home/USERNAME/.config/Orbx/Volanta/plugins</code>

'''Note:''' The plugin is now fully installed. Even though it still might not appear in Volanta under ''Settings > Simulators'', the tracking will work correctly once you start your flight.

== Related content ==
* [[FlightGear Tracker]]

[[Category:Software]]

FlightGear Newsletter

2026-05-26T12:42:41Z

PlayeRom:

[[File:magagazine.png|right]]

The '''FlightGear Newsletter''' is intended to provide a collection of the latest developments from the worldwide [[FlightGear]] community. With so much development ongoing, it's almost impossible for anyone to keep up. The newsletter was started in July 2009, and is presented on a monthly basis. It is a collaborative effort that is created, edited and distributed via the [[FlightGear Wiki]], and all FlightGear users, contributors and developers are invited to contribute.

=== Archive ===
<div class="noresize">
{| class="prettytable"
! align="left" | 2026
! align="left" | 2025
! align="left" | 2024
! align="left" | 2023
! align="left" | 2022
! align="left" | 2021
! align="left" | 2020
! align="left" | 2019
! align="left" | 2018
! align="left" | 2017
! align="left" | 2016
! align="left" | 2015
! align="left" | 2014
! align="left" | 2013
! align="left" | 2012
! align="left" | 2011
! align="left" | 2010
! align="left" | 2009
|-
| valign="top" |
* [[FlightGear Newsletter January 2026|January]]
* [[FlightGear Newsletter February 2026|February]]
* [[FlightGear Newsletter March 2026|March]]
* [[FlightGear Newsletter April 2026|April]]
* [[FlightGear Newsletter May 2026|May]]
| valign="top" |
* [[FlightGear Newsletter January 2025|January]]
* [[FlightGear Newsletter February 2025|February]]
* [[FlightGear Newsletter March 2025|March]]
* [[FlightGear Newsletter April 2025|April]]
* [[FlightGear Newsletter May 2025|May]]
* [[FlightGear Newsletter June 2025|June]]
* [[FlightGear Newsletter July 2025|July]]
* [[FlightGear Newsletter August 2025|August]]
* [[FlightGear Newsletter September 2025|September]]
* [[FlightGear Newsletter October 2025|October]]
* [[FlightGear Newsletter November 2025|November]]
* [[FlightGear Newsletter December 2025|December]]
| valign="top" |
* [[FlightGear Newsletter January 2024|January]]
* [[FlightGear Newsletter February 2024|February]]
* [[FlightGear Newsletter March 2024|March]]
* [[FlightGear Newsletter April 2024|April]]
* [[FlightGear Newsletter May 2024|May]]
* [[FlightGear Newsletter June 2024|June]]
* [[FlightGear Newsletter July 2024|July]]
* [[FlightGear Newsletter August 2024|August]]
* [[FlightGear Newsletter September 2024|September]]
* [[FlightGear Newsletter October 2024|October]]
* [[FlightGear Newsletter November 2024|November]]
* [[FlightGear Newsletter December 2024|December]]
| valign="top" |
* [[FlightGear Newsletter January 2023|January]]
* [[FlightGear Newsletter February 2023|February]]
* [[FlightGear Newsletter March 2023|March]]
* [[FlightGear Newsletter April 2023|April]]
* [[FlightGear Newsletter May 2023|May]]
* [[FlightGear Newsletter June 2023|June]]
* [[FlightGear Newsletter July 2023|July]]
* [[FlightGear Newsletter August 2023|August]]
* [[FlightGear Newsletter September 2023|September]]
* [[FlightGear Newsletter October 2023|October]]
* [[FlightGear Newsletter November 2023|November]]
* [[FlightGear Newsletter December 2023|December]]
| valign="top" |
* [[FlightGear Newsletter January 2022|January]]
* [[FlightGear Newsletter February 2022|February]]
* [[FlightGear Newsletter March 2022|March]]
* [[FlightGear Newsletter April 2022|April]]
* [[FlightGear Newsletter May 2022|May]]
* June
* [[FlightGear Newsletter July 2022|July]]
* [[FlightGear Newsletter August 2022|August]]
* [[FlightGear Newsletter September 2022|September]]
* [[FlightGear Newsletter November 2022|November]]
* [[FlightGear Newsletter December 2022|December]]
| valign="top" |
* [[FlightGear Newsletter January 2021|January]]
* [[FlightGear Newsletter February 2021|February]]
* [[FlightGear Newsletter March 2021|March]]
* [[FlightGear Newsletter April 2021|April]]
* [[FlightGear Newsletter May 2021|May]]
* [[FlightGear Newsletter June 2021|June]]
* [[FlightGear Newsletter July 2021|July]]
* [[FlightGear Newsletter August 2021|August]]
* [[FlightGear Newsletter September 2021|September]]
* [[FlightGear Newsletter October 2021|October]]
* [[FlightGear Newsletter November 2021|November]]
* [[FlightGear Newsletter December 2021|December]]
| valign="top" |
* [[FlightGear Newsletter January 2020|January]]
* [[FlightGear Newsletter February 2020|February]]
* [[FlightGear Newsletter March 2020|March]]
* [[FlightGear Newsletter April 2020|April]]
* [[FlightGear Newsletter May 2020|May]]
* [[FlightGear Newsletter June 2020|June]]
* [[FlightGear Newsletter July 2020|July]]
* [[FlightGear Newsletter August 2020|August]]
* [[FlightGear Newsletter September 2020|September]]
* [[FlightGear Newsletter October 2020|October]]
* [[FlightGear Newsletter November 2020|November]]
* [[FlightGear Newsletter December 2020|December]]
| valign="top" |
* [[FlightGear Newsletter January 2019|January]]
* [[FlightGear Newsletter February 2019|February]]
* [[FlightGear Newsletter March 2019|March]]
* [[FlightGear Newsletter April 2019|April]]
* [[FlightGear Newsletter May 2019|May]]
* [[FlightGear Newsletter June 2019|June]]
* [[FlightGear Newsletter July 2019|July]]
* [[FlightGear Newsletter August 2019|August]]
* [[FlightGear Newsletter September 2019|September]]
* [[FlightGear Newsletter October 2019|October]]
* [[FlightGear Newsletter November 2019|November]]
| valign="top" |
* [[FlightGear Newsletter January 2018|January]]
* [[FlightGear Newsletter February 2018|February]]
* [[FlightGear Newsletter March 2018|March]]
* [[FlightGear Newsletter April 2018|April]]
* [[FlightGear Newsletter May 2018|May]]
* [[FlightGear Newsletter June 2018|June]]
* [[FlightGear Newsletter July 2018|July]]
* [[FlightGear Newsletter August 2018|August]]
* [[FlightGear Newsletter September 2018|September]]
* [[FlightGear Newsletter October 2018|October]]
* [[FlightGear Newsletter November 2018|November]]
* [[FlightGear Newsletter December 2018|December]]
| valign="top" |
* [[FlightGear Newsletter January 2017|January]]
* [[FlightGear Newsletter February 2017|February]]
* [[FlightGear Newsletter March 2017|March]]
* [[FlightGear Newsletter April 2017|April]]
* [[FlightGear Newsletter May 2017|May]]
* [[FlightGear Newsletter June 2017|June]]
* [[FlightGear Newsletter July 2017|July]]
* [[FlightGear Newsletter August 2017|August]]
* [[FlightGear Newsletter September 2017|September]]
* [[FlightGear Newsletter October 2017|October]]
* [[FlightGear Newsletter November 2017|November]]
* [[FlightGear Newsletter December 2017|December]]
| valign="top" |
* [[FlightGear Newsletter January 2016|January]]
* [[FlightGear Newsletter February 2016|February]]
* [[FlightGear Newsletter March 2016|March]]
* [[FlightGear Newsletter April 2016|April]]
* [[FlightGear Newsletter May 2016|May]]
* [[FlightGear Newsletter June 2016|June]]
* [[FlightGear Newsletter July 2016|July]]
* [[FlightGear Newsletter August 2016|August]]
* [[FlightGear Newsletter September 2016|September]]
* [[FlightGear Newsletter October 2016|October]]
* [[FlightGear Newsletter November 2016|November]]
* [[FlightGear Newsletter December 2016|December]]
| valign="top" |
* [[FlightGear Newsletter January 2015|January]]
* [[FlightGear Newsletter February 2015|February]]
* [[FlightGear Newsletter March 2015|March]]
* [[FlightGear Newsletter April 2015|April]]
* [[FlightGear Newsletter May 2015|May]]
* [[FlightGear Newsletter June 2015|June]]
* [[FlightGear Newsletter July 2015|July]]
* [[FlightGear Newsletter August 2015|August]]
* [[FlightGear Newsletter September 2015|September]]
* [[FlightGear Newsletter October 2015|October]]
* [[FlightGear Newsletter November 2015|November]]
* [[FlightGear Newsletter December 2015|December]]
| valign="top" |
* [[FlightGear Newsletter January 2014|January]]
* [[FlightGear Newsletter February 2014|February]]
* [[FlightGear Newsletter March 2014|March]]
* [[FlightGear Newsletter April 2014|April]]
* [[FlightGear Newsletter May 2014|May]]
* [[FlightGear Newsletter June 2014|June]]
* [[FlightGear Newsletter July 2014|July]]
* [[FlightGear Newsletter August 2014|August]]
* [[FlightGear Newsletter September 2014|September]]
* [[FlightGear Newsletter October 2014|October]]
* [[FlightGear Newsletter November 2014|November]]
* [[FlightGear Newsletter December 2014|December]]
| valign="top" |
* [[FlightGear Newsletter January 2013|January]]
* [[FlightGear Newsletter February 2013|February]]
* [[FlightGear Newsletter March 2013|March]]
* [[FlightGear Newsletter April 2013|April]]
* [[FlightGear Newsletter May 2013|May]]
* [[FlightGear Newsletter June 2013|June]]
* [[FlightGear Newsletter July 2013|July]]
* [[FlightGear Newsletter August 2013|August]]
* [[FlightGear Newsletter September 2013|September]]
* [[FlightGear Newsletter October 2013|October]]
* [[FlightGear Newsletter November 2013|November]]
* [[FlightGear Newsletter December 2013|December]]
| valign="top" |
* [[FlightGear Newsletter January 2012|January]]
* [[FlightGear Newsletter February 2012|February]]
* [[FlightGear Newsletter March 2012|March]]
* [[FlightGear Newsletter April 2012|April]]
* [[FlightGear Newsletter May 2012|May]]
* [[FlightGear Newsletter June 2012|June]]
* [[FlightGear Newsletter July 2012|July]]
* [[FlightGear Newsletter August 2012|August]]
* [[FlightGear Newsletter September 2012|September]]
* [[FlightGear Newsletter October 2012|October]]
* [[FlightGear Newsletter November 2012|November]]
* [[FlightGear Newsletter December 2012|December]]
| valign="top" |
* [[FlightGear Newsletter January 2011|January]]
* [[FlightGear Newsletter February 2011|February]]
* [[FlightGear Newsletter March 2011|March]]
* [[FlightGear Newsletter April 2011|April]]
* [[FlightGear Newsletter May 2011|May]]
* [[FlightGear Newsletter June 2011|June]]
* [[FlightGear Newsletter July 2011|July]]
* [[FlightGear Newsletter August 2011|August]]
* [[FlightGear Newsletter September 2011|September]]
* [[FlightGear Newsletter October 2011|October]]
* [[FlightGear Newsletter November 2011|November]]
* [[FlightGear Newsletter December 2011|December]]
| valign="top" |
* [[FlightGear Newsletter January 2010|January]]
* [[FlightGear Newsletter February 2010|February]]
* [[FlightGear Newsletter March 2010|March]]
* [[FlightGear Newsletter April 2010|April]]
* [[FlightGear Newsletter May 2010|May]]
* [[FlightGear Newsletter June 2010|June]]
* [[FlightGear Newsletter July 2010|July]]
* [[FlightGear Newsletter August 2010|August]]
* [[FlightGear Newsletter September 2010|September]]
* [[FlightGear Newsletter October 2010|October]]
* [[FlightGear Newsletter November 2010|November]]
* [[FlightGear Newsletter December 2010|December]]
| valign="top" |
* [[FlightGear Newsletter July 2009|July]]
* [[FlightGear Newsletter August 2009|August]]
* [[FlightGear Newsletter September 2009|September]]
* [[FlightGear Newsletter October 2009|October]]
* [[FlightGear Newsletter November 2009|November]]
* [[FlightGear Newsletter December 2009|December]]
|}
</div>

Some newsletter editions have been translated in other languages:
* [[File:De.gif|16px|link=:De:FlightGear Newsletter]] [[:De:FlightGear Newsletter|Deutsch]]
* [[File:Es.gif|16px|link=:Es:FlightGear Newsletter]] [[:Es:FlightGear Newsletter|Español]]
* [[File:Fr.gif|16px|link=:Fr:FlightGear Newsletter]] [[:Fr:FlightGear Newsletter|Français]]

=== You are invited to contribute! ===
We would like to emphasize that the monthly newsletter can not live without the contributions of FlightGear users and developers. The FlightGear Newsletter is a community-driven newsletter, which means that it is created and edited by people like ''you''. You don't need to be a long-time FlightGear user (or even a developer) to contribute to the newsletter.

In fact, helping write the monthly FlightGear newsletter is an excellent way for getting started contributing to the FlightGear community very quickly and very easily.

Even if you don't have to add anything yourself, just reviewing and improving additions by others is also highly appreciated, as are efforts to help translate newsletters or add screen shots (e.g. taken from the forum or mailing lists) to the newsletter. Screen shots can be uploaded at [[Special:Upload]].

Everyone with a wiki account (free to [[Special:UserLogin|register]]) can edit the newsletter and every contribution is welcome. So if you know about any FlightGear related projects such as for example updated scenery or aircraft, please do feel invited to add such news to the newsletter.

A simple template providing a basic structure for each upcoming newsletter can be taken from [[Talk:Next newsletter]]. This template can be copied/pasted into each new newsletter to help users getting started providing contents.

The draft for the upcoming newsletter can always be found at [[Next newsletter]].

If English is not your native language, please don't be concerned about contributing to the newsletter, you can always easily ask fellow FlightGear users to review or proof-read your changes. Also, one of the easiest ways to get started is simply copying/pasting text from forum or mailing list discussions, such as announcements (e.g., new aircraft, new scenery, etc.).

Another neat option to get started is adding links to FlightGear-related YouTube videos. For this, we have a dedicated section in each newsletter: "[[FlightGear Newsletter {{#time: F Y | last month }}#FlightGear on YouTube|FlightGear on YouTube]]."

If you want to embed a video, please see {{mediawiki|Extension:EmbedVideo#Usage}}

If you are looking for other ways to get involved, please see [[Volunteer]].

[[Category:FlightGear Newsletter| ]]
[[Category:Community|Newsletter]]
[[Category:Lists|Newsletter]]

[[de:FlightGear Newsletter]]
[[es:FlightGear Newsletter]]
[[fr:FlightGear Newsletter]]

Multi-key commands

2026-05-25T12:31:39Z

PlayeRom: /* Weather */

[[File:FlightGear vi-like commands on-screen help.png|thumb|The on-screen help for the multi-key commands.]]

FlightGear have a set of useful vi-like '''multi-key commands''' that can be used to change some settings quicker than if going through the menus.

== Basic keys ==
All multi-key sequence starts with {{Key press|:}}

{{Key press|:}}{{Key press|Tab}} toggles on-screen command help

{{Key press|Enter}} sends the command

{{Key press|Esc}} cancels the command

{{Key press|:}}{{Key press|?}} display help on standard output (console)

== List of commands ==
=== Dialogs ===
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|D}}{{Key press|a}} || Autopilot Settings
|-
| {{Key press|:}}{{Key press|D}}{{Key press|f}} || Fuel & Payload
|-
| {{Key press|:}}{{Key press|D}}{{Key press|g}} || GPS Settings
|-
| {{Key press|:}}{{Key press|D}}{{Key press|h}} || Chat History
|-
| {{Key press|:}}{{Key press|D}}{{Key press|i}} || Instrument Settings
|-
| {{Key press|:}}{{Key press|D}}{{Key press|m}} || Multiplayer Pilot List
|-
| {{Key press|:}}{{Key press|D}}{{Key press|p}}{{Key press|a}} || Position aircraft in air
|-
| {{Key press|:}}{{Key press|D}}{{Key press|p}}{{Key press|g}} || Position aircraft on ground
|-
| {{Key press|:}}{{Key press|D}}{{Key press|r}} || Radio Settings
|-
| {{Key press|:}}{{Key press|D}}{{Key press|s}} || Sound Configuration
|-
| {{Key press|:}}{{Key press|D}}{{Key press|t}} || Time Settings
|-
| {{Key press|:}}{{Key press|D}}{{Key press|v}} || View Options
|-
| {{Key press|:}}{{Key press|D}}{{Key press|w}} || Weather Conditions
|-
| {{Key press|:}}{{Key press|D}}{{Key press|Y}} || Nasal Console
|}

=== Environament ===
==== Weather ====

{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|b}} || Enable Basic Weather
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|d}} || Enable Detailed Weather
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|r}}{{Key press|Enter}} || Weather scenario = Live Data
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|i}}{{Key press|Enter}} || Weather scenario = International Standard Atmosphere
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|H}}{{Key press|Enter}} || Weather scenario = Core high pressure region
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|h}}{{Key press|Enter}} || Weather scenario = High pressure region
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|B}}{{Key press|Enter}} || Weather scenario = Border of a high pressure region
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|b}}{{Key press|Enter}} || Weather scenario = Border of a low pressure region
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|l}}{{Key press|Enter}} || Weather scenario = Low pressure region
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|L}}{{Key press|Enter}} || Weather scenario = Core low pressure region
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|w}}{{Key press|Enter}} || Weather scenario = Warm sector
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|f}}{{Key press|Enter}} || Weather scenario = Fair weather
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|t}}{{Key press|Enter}} || Weather scenario = Thunderstorm
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|s}}{{Key press|Enter}} || Weather scenario = Stormy Monday
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|m}}{{Key press|Enter}} || Weather scenario = Marginal VFR
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|e}}{{Key press|Enter}} || Weather scenario = Early morning fog
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|1}}{{Key press|Enter}} || Weather scenario = CAT I minimum
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|2}}{{Key press|Enter}} || Weather scenario = CAT II minimum
|-
| {{Key press|:}}{{Key press|E}}{{Key press|w}}{{Key press|s}}{{Key press|3}}{{Key press|Enter}} || Weather scenario = CAT IIIb minimum
|}

==== Time ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|E}}{{Key press|t}}{{Key press|c}} || Time of day = Clock time
|-
| {{Key press|:}}{{Key press|E}}{{Key press|t}}{{Key press|1}} || Time of day = Dawn
|-
| {{Key press|:}}{{Key press|E}}{{Key press|t}}{{Key press|2}} || Time of day = Morning
|-
| {{Key press|:}}{{Key press|E}}{{Key press|t}}{{Key press|3}} || Time of day = Noon
|-
| {{Key press|:}}{{Key press|E}}{{Key press|t}}{{Key press|4}} || Time of day = Afternoon
|-
| {{Key press|:}}{{Key press|E}}{{Key press|t}}{{Key press|5}} || Time of day = Dusk
|-
| {{Key press|:}}{{Key press|E}}{{Key press|t}}{{Key press|6}} || Time of day = Evening
|-
| {{Key press|:}}{{Key press|E}}{{Key press|t}}{{Key press|7}} || Time of day = Midnight
|}

=== Position ===
==== on Ground ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|P}}{{Key press|g}}''<ICAO>''{{Key press|space}}''<RWY>''{{Key press|Enter}} || Position aircraft at airport + optional runway number, e.g. {{Key press|:}}{{Key press|P}}{{Key press|g}}{{Key press|b}}{{Key press|i}}{{Key press|k}}{{Key press|f}}{{Key press|space}}{{Key press|1}}{{Key press|1}}{{Key press|Enter}} means go to <code>BIKF</code> airport, runway <code>11</code>.
|}

=== Development functions ===
==== Fog ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|f}}{{Key press|/}} || Disable fog
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|f}}{{Key press|f}} || Fog fastest
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|f}}{{Key press|n}} || Fog nicest
|}

==== On screen statistics ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|s}}{{Key press|0}} || OSG statistic level = off
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|s}}{{Key press|1}} || OSG statistic level = show FPS
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|s}}{{Key press|2}} || OSG statistic level = 1 + Viewer Graph
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|s}}{{Key press|3}} || OSG statistic level = 2 + Camera
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|s}}{{Key press|4}} || OSG statistic level = 3 + Viewer Scene
|}

==== Others dev ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|c}} || Reload tile cache
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|d}} || Toggle FDM data logging
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|l}} || Force lighting update
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|m}} || Dump link to Google Maps of your location on standard output
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|p}} || Reload 2D panel
|-
| {{Key press|:}}{{Key press|Y}}{{Key press|w}} || Toggle wireframe
|-
| {{Key press|:}}''<number>'' || Execute Nasal console tab given by number from 1 to 10
|}

=== Autopilot ===
==== LNAV ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|a}}{{Key press|h}}{{Key press|/}}{{Key press|Enter}} || Disable heading control
|-
| {{Key press|:}}{{Key press|a}}{{Key press|h}}{{Key press|b}}''<degrees>''{{Key press|Enter}} || Set heading bug, e.g. {{Key press|:}}{{Key press|a}}{{Key press|h}}{{Key press|b}}{{Key press|1}}{{Key press|8}}{{Key press|0}}{{Key press|Enter}}
|-
| {{Key press|:}}{{Key press|a}}{{Key press|h}}{{Key press|n}}{{Key press|Enter}} || NAV1 hold
|-
| {{Key press|:}}{{Key press|a}}{{Key press|h}}{{Key press|t}}''<degrees>''{{Key press|Enter}} || Set true heading, e.g. {{Key press|:}}{{Key press|a}}{{Key press|h}}{{Key press|t}}{{Key press|1}}{{Key press|8}}{{Key press|0}}{{Key press|Enter}}
|-
| {{Key press|:}}{{Key press|a}}{{Key press|h}}{{Key press|w}}{{Key press|Enter}} || Wing level hold
|}

==== VNAV ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|/}}{{Key press|Enter}} || Disable pitch/altitude control
|-
| {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|a}}''<feets>''{{Key press|Enter}} || Altitude hold MSL, e.g. {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|a}}{{Key press|5}}{{Key press|0}}{{Key press|0}}{{Key press|0}}{{Key press|Enter}}
|-
| {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|f}}''<degrees>''{{Key press|Enter}} || FPA hold (available in next release)
|-
| {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|g}}''<feets>''{{Key press|Enter}} || Altitude hold AGL, e.g. {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|g}}{{Key press|1}}{{Key press|0}}{{Key press|0}}{{Key press|0}}{{Key press|Enter}}
|-
| {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|n}}{{Key press|Enter}} || Enable glideslop (NAV1)
|-
| {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|o}}''<degrees>''{{Key press|Enter}} || AoA hold (available until version 2020.3)
|-
| {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|p}}''<degrees>''{{Key press|Enter}} || Pitch hold
|-
| {{Key press|:}}{{Key press|a}}{{Key press|p}}{{Key press|v}}''<fpm>''{{Key press|Enter}} || Vertical speed hold
|}

==== Velocity ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|a}}{{Key press|v}}{{Key press|/}}{{Key press|Enter}} || Disable velocity control
|-
| {{Key press|:}}{{Key press|a}}{{Key press|v}}{{Key press|p}}''<kts>''{{Key press|Enter}} || Hold given speed by pitch
|-
| {{Key press|:}}{{Key press|a}}{{Key press|v}}{{Key press|t}}''<kts>''{{Key press|Enter}} || Hold given speed by throttle
|}

==== Route Manager ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|a}}{{Key press|r}}{{Key press|a}}''<ID[@alt]>''{{Key press|Enter}} || Append given waypoint (optional with altitude), e.g. {{Key press|:}}{{Key press|a}}{{Key press|r}}{{Key press|a}}{{Key press|t}}{{Key press|r}}{{Key press|z}}{{Key press|@}}{{Key press|6}}{{Key press|0}}{{Key press|0}}{{Key press|0}}{{Key press|Enter}} which add VOR TRZ at 6000 ft
|-
| {{Key press|:}}{{Key press|a}}{{Key press|r}}{{Key press|c}}{{Key press|Enter}} || Clear waypoints
|-
| {{Key press|:}}{{Key press|a}}{{Key press|r}}{{Key press|d}}''<index>''{{Key press|Enter}} || Delete selected waypoint, counting from 1
|-
| {{Key press|:}}{{Key press|a}}{{Key press|r}}{{Key press|i}}''<index><ID[@alt]>''{{Key press|Enter}} || Insert given waypoint (optional with altitude), e.g. {{Key press|:}}{{Key press|a}}{{Key press|r}}{{Key press|i}}{{Key press|2}}{{Key press|t}}{{Key press|r}}{{Key press|z}}{{Key press|@}}{{Key press|6}}{{Key press|0}}{{Key press|0}}{{Key press|0}}{{Key press|Enter}} which insert VOR TRZ at 6000 ft in second position
|-
| {{Key press|:}}{{Key press|a}}{{Key press|r}}{{Key press|p}}{{Key press|Enter}} || Remove first waypoint
|}

=== Engines ===
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|e}}{{Key press|m}}{{Key press|^}} || Mixture rich gradually
|-
| {{Key press|:}}{{Key press|e}}{{Key press|m}}{{Key press|_}} || Mixture lean gradually
|-
| {{Key press|:}}{{Key press|e}}{{Key press|m}}''<value>''{{Key press|Enter}} || Set mixture by value from 0.0 to 1.0
|-
| {{Key press|:}}{{Key press|e}}{{Key press|p}}{{Key press|^}} || Propeller pitch up gradually
|-
| {{Key press|:}}{{Key press|e}}{{Key press|p}}{{Key press|_}} || Propeller pitch down gradually
|-
| {{Key press|:}}{{Key press|e}}{{Key press|p}}''<value>''{{Key press|Enter}} || Set propeller pitch by value from 0.0 to 1.0
|-
| {{Key press|:}}{{Key press|e}}{{Key press|t}}{{Key press|^}} || Throttle up gradually
|-
| {{Key press|:}}{{Key press|e}}{{Key press|t}}{{Key press|_}} || Throttle down gradually
|-
| {{Key press|:}}{{Key press|e}}{{Key press|t}}''<value>''{{Key press|Enter}} || Set throttle by value from 0.0 to 1.0
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|m}}{{Key press|^}} || Mixture rich gradually for selected engine
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|m}}{{Key press|_}} || Mixture lean gradually for selected engine
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|m}}''<value>''{{Key press|Enter}} || Set mixture by value from 0.0 to 1.0 for selected engine
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|p}}{{Key press|^}} || Propeller pitch up gradually for selected engine
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|p}}{{Key press|_}} || Propeller pitch down gradually for selected engine
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|p}}''<value>''{{Key press|Enter}} || Set propeller pitch by value from 0.0 to 1.0 for selected engine
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|t}}{{Key press|^}} || Throttle up gradually for selected engine
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|t}}{{Key press|_}} || Throttle down gradually for selected engine
|-
| {{Key press|:}}{{Key press|e}}''<engine>''{{Key press|t}}''<value>''{{Key press|Enter}} || Set throttle by value from 0.0 to 1.0 for selected engine
|}

=== Flight controls ===
==== Ailerons ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|f}}{{Key press|a}}{{Key press|t}}{{Key press|<}} || Ailerons trim adjustment left
|-
| {{Key press|:}}{{Key press|f}}{{Key press|a}}{{Key press|t}}{{Key press|>}} || Ailerons trim adjustment right
|-
| {{Key press|:}}{{Key press|f}}{{Key press|a}}{{Key press|t}}''<value>''{{Key press|Enter}} || Ailerons trim adjustment by value from -1.0 to 1.0
|-
| {{Key press|:}}{{Key press|f}}{{Key press|a}}''<value>''{{Key press|Enter}} || Ailerons adjustment by value from -1.0 to 1.0
|}

==== Elevator ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|f}}{{Key press|e}}{{Key press|t}}{{Key press|^}} || Elevator trim adjustment up
|-
| {{Key press|:}}{{Key press|f}}{{Key press|e}}{{Key press|t}}{{Key press|_}} || Elevator trim adjustment down
|-
| {{Key press|:}}{{Key press|f}}{{Key press|e}}{{Key press|t}}''<value>''{{Key press|Enter}} || Elevator trim adjustment by value from -1.0 to 1.0
|-
| {{Key press|:}}{{Key press|f}}{{Key press|e}}''<value>''{{Key press|Enter}} || Elevator adjustment by value from -1.0 to 1.0
|}

==== Rudder ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|f}}{{Key press|r}}{{Key press|t}}{{Key press|<}} || Rudder trim adjustment left
|-
| {{Key press|:}}{{Key press|f}}{{Key press|r}}{{Key press|t}}{{Key press|>}} || Rudder trim adjustment right
|-
| {{Key press|:}}{{Key press|f}}{{Key press|r}}{{Key press|t}}''<value>''{{Key press|Enter}} || Rudder trim adjustment by value from -1.0 to 1.0
|-
| {{Key press|:}}{{Key press|f}}{{Key press|r}}''<value>''{{Key press|Enter}} || Rudder adjustment by value from -1.0 to 1.0
|}

==== Initialize ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|f}}{{Key press|i}}{{Key press|a}}{{Key press|Enter}} || Initialize all trims
|}

==== Wings ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|f}}{{Key press|w}}{{Key press|f}}{{Key press|Enter}} || Toggle wings fold
|-
| {{Key press|:}}{{Key press|f}}{{Key press|w}}{{Key press|s}}''<value>''{{Key press|Enter}} || Wings sweep by value from 0.0 to 1.0
|}

=== Radio ===
==== ADF ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|r}}{{Key press|a}}{{Key press|f}}''<kHz>''{{Key press|Enter}} || Set active frequency for ADF
|}

==== COMM ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|r}}{{Key press|c}}''<which>''{{Key press|f}}''<MHz>''{{Key press|Enter}} || Set active frequency for selected COMM, e.g. {{Key press|:}}{{Key press|r}}{{Key press|c}}{{Key press|1}}{{Key press|f}}{{Key press|1}}{{Key press|2}}{{Key press|3}}{{Key press|.}}{{Key press|4}}{{Key press|5}}{{Key press|Enter}} will set active frequency for COMM1 on 123.45 MHz.
|-
| {{Key press|:}}{{Key press|r}}{{Key press|c}}''<which>''{{Key press|s}}''<MHz>''{{Key press|Enter}} || Set standby frequency for selected COMM, e.g. {{Key press|:}}{{Key press|r}}{{Key press|c}}{{Key press|1}}{{Key press|s}}{{Key press|1}}{{Key press|2}}{{Key press|3}}{{Key press|.}}{{Key press|4}}{{Key press|5}}{{Key press|Enter}} will set standby frequency for COMM1 on 123.45 MHz.
|-
| {{Key press|:}}{{Key press|r}}{{Key press|c}}''<which>''{{Key press|t}}{{Key press|Enter}} || Toggle active/standby frequency for selected COMM
|}

==== NAV ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|r}}{{Key press|n}}''<which>''{{Key press|f}}''<MHz>''{{Key press|Enter}} || Set active frequency for selected NAV, e.g. {{Key press|:}}{{Key press|r}}{{Key press|n}}{{Key press|1}}{{Key press|f}}{{Key press|1}}{{Key press|1}}{{Key press|6}}{{Key press|.}}{{Key press|8}}{{Key press|Enter}} will set active frequency for NAV1 on 116.80 MHz.
|-
| {{Key press|:}}{{Key press|r}}{{Key press|n}}''<which>''{{Key press|s}}''<MHz>''{{Key press|Enter}} || Set standby frequency for selected NAV, e.g. {{Key press|:}}{{Key press|r}}{{Key press|n}}{{Key press|1}}{{Key press|s}}{{Key press|1}}{{Key press|1}}{{Key press|6}}{{Key press|.}}{{Key press|8}}{{Key press|Enter}} will set standby frequency for NAV1 on 116.80 MHz.
|-
| {{Key press|:}}{{Key press|r}}{{Key press|n}}''<which>''{{Key press|t}}{{Key press|Enter}} || Toggle active/standby frequency for selected NAV
|}

==== TACAN ====
{| class="wikitable sortable" border="0" cellspacing="0"
! Sequence !! Use
|-
| {{Key press|:}}{{Key press|r}}{{Key press|t}}''<channel>''{{Key press|x}}{{Key press|Enter}} || Set TACAN with given channel X, e.g. {{Key press|:}}{{Key press|r}}{{Key press|t}}{{Key press|1}}{{Key press|2}}{{Key press|3}}{{Key press|x}}{{Key press|Enter}} will set TACAN on 123X.
|-
| {{Key press|:}}{{Key press|r}}{{Key press|t}}''<channel>''{{Key press|y}}{{Key press|Enter}} || Set TACAN with given channel Y, e.g. {{Key press|:}}{{Key press|r}}{{Key press|t}}{{Key press|1}}{{Key press|2}}{{Key press|3}}{{Key press|y}}{{Key press|Enter}} will set TACAN on 123Y.
|}

== Related content ==
=== Wiki articles ===
* [[Howto:Add multi-key commands to an aircraft]]

=== Source code ===
* {{fgdata source|path=Input/Keyboard/multikey.xml|pre=$FG_ROOT}}
* {{fgdata source|path=Nasal/multikey.nas|pre=$FG_ROOT}}

[[Category:FlightGear]]
[[Category:FlightGear keyboard]]

[[fr:Multi-key_commands]]

Canvas

2026-05-24T15:17:27Z

PlayeRom:

{{infobox subsystem
|image = Anniversary4.png
|name = Canvas Subsystem
|started = 05/2012 (Available since [[Changelog 2.8.0|FlightGear 2.8]])
|description = Dynamic 2D drawing at runtime using the property tree and scripting (for instruments, HUDs, GUIs)
|status = Under active development as of 02/2013
|maintainers = {{usr|TheTom}}
|developers = TheTom (since 02/2012)
|folders =
* {{flightgear file|src/Canvas}}
* {{simgear file|simgear/canvas}}
* {{fgdata file|Nasal/Canvas}}

|subforum = http://forum.flightgear.org/viewforum.php?f=71
}}

{{Canvas Navigation}}

In FlightGear, a '''Canvas''' is a dynamically created image (OpenGL texture) that can be created and modified (drawn to) at runtime by using the [[Property Tree]], i.e. via the built-in scripting language [[Nasal]] and setting a few properties via {{func link|setprop()}} or its object-oriented wrapper props.nas.

Canvas is all about rendering to a texture and updating it dynamically at run-time by modifying a sub-tree in the property tree that represents the texture (RTT) - its primary rendering primitives are:
* text (via osgText)
* vector graphics (via shivaVG/OpenVG, subject to change as of 03/2022, see [[Shiva Alternatives]])
* static raster images (or dynamic images via osg::Image represented as another Canvas)
* groups/maps - for grouping/nesting elements to arbitrary depths, and selectively controlling/transforming/clipping each sub-tree
Canvas itself maintains a FBO (frame buffer object ) for each texture, which is also the mechanism in use by [[Rembrandt]].
In other words, Canvas is an abstraction mechanism for RTT/FBO management via conventional FlightGear properties. A Canvas texture can optionally also respond to common GUI events to support keyboard/mouse interactions (e.g. drag&drop, hot-keys).<ref>{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=221229#p221229
|title=<nowiki>Re: Orbital Makes the Sky Black</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Sun Oct 19</nowiki>
}}
</ref>

It is a good idea to learn more about OOP (object oriented programming) and how to use that in Nasal.

Next, you will probably want to look at some of the existing Canvas sources - i.e. $FG_ROOT/Nasal/canvas/* (especially api.nas)

And then, you need to understand that Canvas works in form of primitives that form the primitives/ "building blocks" for all instruments.

Namely: text handling, raster images, OpenVG Paths

Everything else is built on top of these primitives (well, except for Maps, but that's a different topic).
For learning purposes, you could play with the examples that can be found in the [[Canvas Snippets]] article on the wiki.
Note that you need to understand OOP, and especially method chaining, to understand how those examples work behind the scenes.<ref>{{cite web
| url = http://forum.flightgear.org/viewtopic.php?p=281522#p281522
| title = <nowiki>Re: Best way to learn Canvas?</nowiki>
| author = <nowiki>Hooray</nowiki>
| date = Apr 4th, 2016
| added = Apr 4th, 2016
| script_version = 0.25
}}
</ref>

Canvas textures can be used for a number of different purposes, such as creating fully-scripted avionics (airliner/bizjet -style/MFD glass cockpits) but also custom HUDs and custom GUI textures, even fully interactive GUI widgets (scheduled for FG 4.2+) and interactive scenery elements (e.g. VDGS).

You can use any arbitrary shape to place a canvas onto. For a HUD you just need to create an arbitrarily shaped polygon with your favorite 3d modeling software and place a canvas onto it. As everything drawn onto the canvas goes to an offscreen texture first, only the parts placed onto the 3d model are shown.

You can also draw transparent paths. With the correct blending mode you can just replace all existing contents. It's not named mask, but you can use every canvas element as a mask:

<syntaxhighlight lang="nasal">
# replace everything already drawn with the pixels of the path
path.set("blend-source", "one")
.set("blend-destination", "zero");
</syntaxhighlight>

Currently only rectangular clipping regions are possible (and will be for the next time). You can still get rounded corners if you just draw them in black (or any other background color) on top of the clipped region.

The canvas subsystem is entirely implemented on top of the FlightGear [[Property Tree]], it makes use of property listeners to watch a sub tree of the property tree for canvas-related events (e.g. drawing commands or events to load an image from disk), so that textures can be dynamically instantiated and modified by setting properties in the property tree. This method is not specific to [[Nasal]] scripting, the same system can be used by other subsystems (such as the [[Telnet_usage|Telnet]] or HTTP daemons) to create and modify textures without directly using Nasal. The Canvas makes use of [http://www.khronos.org/openvg/ OpenVG] for 2D rendering.

As of 08/2012, the Canvas system is still under active development and nothing is set in stone yet. See [[Canvas Properties]] for further information.

The first prototype of the canvas system became available in FlightGear 2.8, this lacked some features currently under development (notably the Nasal API, support for raster and vector images)- it is expected that a more feature-rich version will be available in the following release, i.e. FlightGear 3.0+ - possibly replacing the entire existing PUI GUI with a fully Canvas-driven implementation in scripting space (one of the primary long-term goals is to modernize the FlightGear GUI).

Future FlightGear versions will contain reimplementations of currently hard-coded instruments such as the wxradar, tcas or navdisplay using the canvas system, so that these can be easily maintained as part of the base package, and so that the same backend code can be also used for creating sophisticated dialogs using the Canvas system, such as ATC displays like [[ATC-FS]], sharing a single backend - without having to re-implement logic for otherwise identical purposes (currently, we have code that implements a navigational display, while another piece of code renders a conceptually identical [[Map]] dialog).

Among other advantages, this will also provide for an opportunity to run Canvas-based instruments and GUI elements in another process, or even on another computer, analogous to [[FGPanel]] (see [[FGCanvas]]).

The canvas system allows you to use SVG images drawn with Inkscape, and easily use raster images and even commpletely custom drawing commands using OpenVG paths.

However, please do note that the canvas cannot currently be run in a standalone/FGPanel-fashion - there's been some talk about that, but that will at least take another 1-2 releases probably. That being said, you could certainly come up with a canvas instrument panel, and then simply use in a dedicated fgfs instance, which is slaved to a corresonding master instance.

Also, there's currently work ongoing to port the old 2D panel and HUD systems to the new Canvas system, using custom Nasal wrappers reimplementing the old behavior and turning the textures into canvas properties.

<references/>
== Requirements and Limitations ==
Beginning with 2.8, up to 2.99+, all FlightGear versions require FBO support for the canvas system to work properly [http://forum.flightgear.org/viewtopic.php?f=68&t=20887]. In particular, this means that very old GPUs such as Intel 910/915 cards are currently not supported (FBO support is obviously also required for [[Rembrandt]] to work), people without FBO support are likely to just get "white" Canvas textures[http://forum.flightgear.org/viewtopic.php?f=71&t=24562].

Unless render-to-texture (RTT) support can be provided through some form of fallback mode for hardware without FBO support, we we might need to consider officially un-supporting such old hardware from 3.0 (since we can already detect the vendor as Intel).

It seems 940-class chips are okay, and the 2000/3000/4000HD versions seem to work, but the earlier 9xx and before are going to be problematic for the time being [http://forum.flightgear.org/viewtopic.php?f=68&t=20887&p=192091#p192088]. At the moment, it isn't clear if telling the od_gauge/OSG backend code to use pbuffer rendering instead of FBOs would already help solve the problem [http://forum.flightgear.org/viewtopic.php?f=68&t=20887&p=192091#p192091].

== Performance ==
{{FGCquote
|1= <div class="content">Canvas is just a piece of technology - there are some early adopters/attempts who began using Canvas at a time when things were very much still in flux, which is why we have code snippets/instruments (and aircraft) where Canvas related functionality is significantly contributing to lag - I think this did apply to the m2000 and the extra500.
I haven't looked at any of those aircraft in months, so I cannot say if those problems have been addressed/fixed meanwhile - but there are a handful of examples for efficient Nasal/Canvas-based features, without them causing/contributing to significant lag. We have provided a bunch of "best practices" in various threads, and also offered 1:1 help to the efforts/people affected by this.
Some have refused to accept such advice, others simply disappeared over time. So I cannot say much about any particular aircraft. But Nasal and Canvas are just tools that can be misused - and they're "interpreted" tools, both of which are basically using the concept of a "virtual machine" internally, so there's a certain overhead due to all the indirection taking place - which is to say that you don't need to be an experienced C/C++ or OpenGL/OSG programmer to use Nasal and Canvas to create sophisticated avionics - which isn't unlike the YASim/JSBSim FDM engines (or the autopilot system), which also, can be mis-used to create inefficient constructs that end up slowing down the simulator significantly.
Then again, sometimes, there simply are very real bugs - like those in the property tree/effects code that TorstenD fixed a while ago, or the memory leak that Jabberwocky brought up on the forum, and that sanhoay identified - as long as people can provide actionable bug reports and reproducible test scenarios, there's a fairly good chance for bugs (and performance issues) to get fixed within 1-2 release cycles. But just coming here and saying that feature XYZ is broken or slows down the simulator isn't helping anybody, unless you can provide all the information that is needed that people who understanding the underlying subsystems can nail down the problem and see if there's an actual problem or not.
This also involves stating exactly what hardware you are on, and what your other startup/runtime settings are - as of now, Canvas doesn't provide native support for shaders, so it will be using OSG/shivaVG for all hardware accelerated graphics, which should usually be sufficiently fast - but there are known constructs/usage patterns that are infamous for triggering unnecessary updates/re-drawing, which should be avoided.
The other obvious issue is that Canvas does require FBO support.
People writing Nasal/Canvas code should ideally understand that Canvas is not just a VM but also a state machine to some extent, so even redundant/unnecessary state changes (all of which are going through the property tree usually) will trigger updates/re-drawing under certain circumstances, which is to say that this should be avoided - and which is why I, and a handful of others, have been trying to enforce a framework-centric development philosophy when it comes to Canvas development, so that people don't use Canvas directly, but instead come up with frameworks for functionality that they need, to encapsulate any Canvas specific functionality - that we- can help review/improve over time, without having to touch tons of code files, instruments, aircraft etc
The underlying idea can be seen in the ND and MapStructure efforts, neither of which needs to be touched by aircraft/GUI developers to add/create an ND or chart/map.
In summary, Canvas certainly isn't being maintained as actively as it once used to be, but -like Nasal- Canvas is just a technology enabler, and people should introduce abstraction layers to use the system, so that possibly problematic usage patterns can be more easily encapsulated, but also reviewed/edited and optimized over time.
But please don't expect any of the people involved in Canvas related efforts to answer such broad questions with a single "yes" or "no", without also providing a proper context.

|2= {{cite web
| url = http://forum.flightgear.org/viewtopic.php?p=250205#p250205
| title = <nowiki>Re: Developing a Canvas Cockpit for the CRJ700</nowiki>
| author = <nowiki>Hooray</nowiki>
| date = Jul 7th, 2015
| added = Jul 7th, 2015
| script_version = 0.25
}}
}}

== Latest Canvas Efforts ==

{{Canvas Frameworks|mode=by-year|year=2013}}

= Canvas and Nasal =
{{FGCquote
|Canvas is not all about Nasal - it's probably safe to say that 95-99% of all Nasal code using Canvas ends up being "just" property I/O i.e. properties being read/written, or updated via timers/listeners. Usually, the idea is to initialize a Canvas texture by setting up all important state early on, and then "update" and "animate" things using timers/listeners - or even property rules later on. That will usually help minimize most Nasal-induced overhead.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237678#p237678
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Fri Apr 03</nowiki>
}}
}}

{{FGCquote
| Canvas can definitely also be used without using Nasal - to see for yourself, just use the property tree browser to create/display canvas textures, or even the telnet/httpd protocols.
For the time being Nasal merely happens to provide the most abstract interface/mechanism to deal with Canvas - but you could just as well use the Canvas system from C++ by doing the corresponding property I/O using the C++ property interface directly - which would eliminate all Nasal overhead, even timers/listeners could then implemented in C++ space for animation/update logic.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237678#p237678
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Fri Apr 03</nowiki>
}}
}}

{{FGCquote
|That being said, this isn't necessarily the smartest/best thing to do - primarily, Canvas is all about exposing hardware-accelerated 2D rendering to fgdata space, so that non-core developers can easily address their 2D rendering needs, without having to rebuild FG from source and without having to be intimately familiar with C++ and OSG/OpenGL. Which is where the performance overhead is coming from, i.e. Canvas APIs being modeled on top of the property tree and wrapped using Nasal bindings - which adds two fairly massive layers of abstraction in terms of property I/O and Nasal<->C++ marshalling.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237678#p237678
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Fri Apr 03</nowiki>
}}
}}

= Using the Canvas in non-FG projects =
The canvas system has been refactored such that it can be more easily re-used in other programs, this included moving the Canvas component from FlightGear to SimGear and releasing the canvas code under SimGear's license (LGPL).

It is now possible to use the Canvas in projects unrelated to FlightGear, but you will obviously benefit from using certain FlightGear-related technologies, such as an * property tree
* SGSubsystem/Mgr-based main loop
* an osgviewer-based main window
* Nasal scripting

Icecode's FGRadar project is such a completely separate code base from FG, which uses SG/FG components to simplify code reuse, without re-inventing the wheel.

For this very purpose, FGRadar uses a custom "SGApplication" framework - so that existing FlightGear subsystems can be more easily reused in different projects. All that's needed is deriving your own class from "SGApplication" and implementing its interface.
The whole idea behind "SGApplication" is to provide a scriptable framework for OpenGL applications, fully based on 1) OSG, 2) SGSubsystems, 3) Nasal scripting and 4) the Canvas.

{{FGCquote
|the whole purpose of SGApplication is to provide a SGSubsystem-based "architecture" so that Nasal + Canvas and the property tree code can be easily reused.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237591#p237591
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Thu Apr 02</nowiki>
}}
}}

{{FGCquote
|the SGApplication stuff isn't really needed, we just came up with it to simplify working with the SG code. But at least it demonstrates how the whole SGSubsystemMgr stuff works.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237591#p237591
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Thu Apr 02</nowiki>
}}
}}

{{FGCquote
|you can also use SGSubsystem/SGSubsystemMgr directly - no need for "SGApplication" at all, it's just a convenicence helper.
"porting" isn't strictly necessary - you would primarily need int main() with a top-level SGSubsystemMgr, where you can then add the property tree, Nasal, Canvas, events etc (a handful of subsystems). To use Canvas outside FG, you would also need to look at the FGCanvasSystemAdapter in $FG_SRC/Canvas and provide your own wrapper for your own app (trivial).
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237591#p237591
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Thu Apr 02</nowiki>
}}
}}

{{FGCquote
|"fgpanel" is a code base that is using the "copy & paste" approach - so could serve as another example (beyond fgradar).
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237613#p237613
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Thu Apr 02</nowiki>
}}
}}

For additional info, see: http://forum.flightgear.org/viewtopic.php?f=71&t=18415

== Gallery ==

[[File:Boeing 747-400 PFD and ND approach EHAM 18R.png|450px]]

A short video demonstrating a possible usecase (C-130J AMU):

{{#ev:youtube|A7j-B0LgV-A}}

By using alphablending it can also be used to render the contents of a HUD:

{{#ev:youtube|_oRX53JyXmM}}

In my branch there is now also support for using the canvas in a gui widget:

[[File:Canvas GUI Demo.png|thumb|none|400px|Using the Canvas as a GUI widget]]

With the new ''map'' element it is also very easy to draw maps:

[[File:Demonstration of using the Canvas inside a GUI dialog..png|thumb|none|400px|Simple Map of KSFO]]

Using the new [[Howto:Use_SVG_inside_a_Canvas|''canvas.parsesvg'']] function to use an SVG file to simulate an EICAS display:

{{#ev:youtube|43P7xKNJnV4}}

Demonstrating how the new Canvas GUI wrapper can be used to create entirely custom, scripted GUI widgets using XML, SVG and Nasal:

{{#ev:youtube|1a6wtPVPWc4}}

Experimenting with selecting text and positioning a cursor inside the text. The visualization is all done using Nasal.

{{#ev:youtube|CIS8UyuJLgM}}

Since 07/2012, the canvas system also provides support for full window-drawing:

{{#ev:youtube|Qv-uEX42QZY}}

Omega95 has reimplemented the CDU of the ATR72 using the Canvas system:

{{#ev:youtube|sAaVEKuiF5w}}

Another video demonstrating window stacking and nested canvases:

{{#ev:youtube|llVaasTEf44}}

Using Canvas mouse events to create [http://forum.flightgear.org/viewtopic.php?p=183653#p183653 animation of slider, wheel and knob]

{{#ev:youtube|HELiLjEGno8}}

[[Category:Rewrite]]

Canvas

2026-05-24T15:14:36Z

PlayeRom:

{{infobox subsystem
|image = Anniversary4.png
|name = Canvas Subsystem
|started = 05/2012 (Available since [[Changelog 2.8.0|FlightGear 2.8]])
|description = Dynamic 2D drawing at runtime using the property tree and scripting (for instruments, HUDs, GUIs)
|status = Under active development as of 02/2013
|maintainers = {{usr|TheTom}}
|developers = TheTom (since 02/2012)
|folders =
* {{flightgear file|src/Canvas}}
* {{simgear file|simgear/canvas}}
* {{fgdata file|Nasal/Canvas}}

|subforum = http://forum.flightgear.org/viewforum.php?f=71
}}

{{Canvas Navigation}}

In FlightGear, a '''Canvas''' is a dynamically created image (OpenGL texture) that can be created and modified (drawn to) at runtime by using the [[Property Tree]], i.e. via the built-in scripting language [[Nasal]] and setting a few properties via {{func link|setprop()}} or its object-oriented wrapper props.nas.

Canvas is all about rendering to a texture and updating it dynamically at run-time by modifying a sub-tree in the property tree that represents the texture (RTT) - its primary rendering primitives are:
* text (via osgText)
* vector graphics (via shivaVG/OpenVG, subject to change as of 03/2022, see [[Shiva Alternatives]])
* static raster images (or dynamic images via osg::Image represented as another Canvas)
* groups/maps - for grouping/nesting elements to arbitrary depths, and selectively controlling/transforming/clipping each sub-tree
Canvas itself maintains a FBO (frame buffer object ) for each texture, which is also the mechanism in use by [[Rembrandt]].
In other words, Canvas is an abstraction mechanism for RTT/FBO management via conventional FlightGear properties. A Canvas texture can optionally also respond to common GUI events to support keyboard/mouse interactions (e.g. drag&drop, hot-keys).<ref>{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=221229#p221229
|title=<nowiki>Re: Orbital Makes the Sky Black</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Sun Oct 19</nowiki>
}}
</ref>

It is a good idea to learn more about OOP (object oriented programming) and how to use that in Nasal.

Next, you will probably want to look at some of the existing Canvas sources - i.e. $FG_ROOT/Nasal/canvas/* (especially api.nas)

And then, you need to understand that Canvas works in form of primitives that form the primitives/ "building blocks" for all instruments.

Namely: text handling, raster images, OpenVG Paths

Everything else is built on top of these primitives (well, except for Maps, but that's a different topic).
For learning purposes, you could play with the examples that can be found in the [[Canvas Snippets]] article on the wiki.
Note that you need to understand OOP, and especially method chaining, to understand how those examples work behind the scenes.<ref>{{cite web
| url = http://forum.flightgear.org/viewtopic.php?p=281522#p281522
| title = <nowiki>Re: Best way to learn Canvas?</nowiki>
| author = <nowiki>Hooray</nowiki>
| date = Apr 4th, 2016
| added = Apr 4th, 2016
| script_version = 0.25
}}
</ref>

Canvas textures can be used for a number of different purposes, such as creating fully-scripted avionics (airliner/bizjet -style/MFD glass cockpits) but also custom HUDs and custom GUI textures, even fully interactive GUI widgets (scheduled for FG 4.2+) and interactive scenery elements (e.g. VDGS).

You can use any arbitrary shape to place a canvas onto. For a HUD you just need to create an arbitrarily shaped polygon with your favorite 3d modeling software and place a canvas onto it. As everything drawn onto the canvas goes to an offscreen texture first, only the parts placed onto the 3d model are shown.

You can also draw transparent paths. With the correct blending mode you can just replace all existing contents. It's not named mask, but you can use every canvas element as a mask:

<syntaxhighlight lang="nasal">
# replace everything already drawn with the pixels of the path
path.set("blend-source", "one")
.set("blend-destination", "zero");
</syntaxhighlight>

Currently only rectangular clipping regions are possible (and will be for the next time). You can still get rounded corners if you just draw them in black (or any other background color) on top of the clipped region.

The canvas subsystem is entirely implemented on top of the FlightGear [[Property Tree]], it makes use of property listeners to watch a sub tree of the property tree for canvas-related events (e.g. drawing commands or events to load an image from disk), so that textures can be dynamically instantiated and modified by setting properties in the property tree. This method is not specific to [[Nasal]] scripting, the same system can be used by other subsystems (such as the [[Telnet]] or HTTP daemons) to create and modify textures without directly using Nasal. The Canvas makes use of [http://www.khronos.org/openvg/ OpenVG] for 2D rendering.

As of 08/2012, the Canvas system is still under active development and nothing is set in stone yet. See [[Canvas Properties]] for further information.

The first prototype of the canvas system became available in FlightGear 2.8, this lacked some features currently under development (notably the Nasal API, support for raster and vector images)- it is expected that a more feature-rich version will be available in the following release, i.e. FlightGear 3.0+ - possibly replacing the entire existing PUI GUI with a fully Canvas-driven implementation in scripting space (one of the primary long-term goals is to modernize the FlightGear GUI).

Future FlightGear versions will contain reimplementations of currently hard-coded instruments such as the wxradar, tcas or navdisplay using the canvas system, so that these can be easily maintained as part of the base package, and so that the same backend code can be also used for creating sophisticated dialogs using the Canvas system, such as ATC displays like [[ATC-FS]], sharing a single backend - without having to re-implement logic for otherwise identical purposes (currently, we have code that implements a navigational display, while another piece of code renders a conceptually identical [[Map]] dialog).

Among other advantages, this will also provide for an opportunity to run Canvas-based instruments and GUI elements in another process, or even on another computer, analogous to [[FGPanel]] (see [[FGCanvas]]).

The canvas system allows you to use SVG images drawn with Inkscape, and easily use raster images and even commpletely custom drawing commands using OpenVG paths.

However, please do note that the canvas cannot currently be run in a standalone/FGPanel-fashion - there's been some talk about that, but that will at least take another 1-2 releases probably. That being said, you could certainly come up with a canvas instrument panel, and then simply use in a dedicated fgfs instance, which is slaved to a corresonding master instance.

Also, there's currently work ongoing to port the old 2D panel and HUD systems to the new Canvas system, using custom Nasal wrappers reimplementing the old behavior and turning the textures into canvas properties.

<references/>
== Requirements and Limitations ==
Beginning with 2.8, up to 2.99+, all FlightGear versions require FBO support for the canvas system to work properly [http://forum.flightgear.org/viewtopic.php?f=68&t=20887]. In particular, this means that very old GPUs such as Intel 910/915 cards are currently not supported (FBO support is obviously also required for [[Rembrandt]] to work), people without FBO support are likely to just get "white" Canvas textures[http://forum.flightgear.org/viewtopic.php?f=71&t=24562].

Unless render-to-texture (RTT) support can be provided through some form of fallback mode for hardware without FBO support, we we might need to consider officially un-supporting such old hardware from 3.0 (since we can already detect the vendor as Intel).

It seems 940-class chips are okay, and the 2000/3000/4000HD versions seem to work, but the earlier 9xx and before are going to be problematic for the time being [http://forum.flightgear.org/viewtopic.php?f=68&t=20887&p=192091#p192088]. At the moment, it isn't clear if telling the od_gauge/OSG backend code to use pbuffer rendering instead of FBOs would already help solve the problem [http://forum.flightgear.org/viewtopic.php?f=68&t=20887&p=192091#p192091].

== Performance ==
{{FGCquote
|1= <div class="content">Canvas is just a piece of technology - there are some early adopters/attempts who began using Canvas at a time when things were very much still in flux, which is why we have code snippets/instruments (and aircraft) where Canvas related functionality is significantly contributing to lag - I think this did apply to the m2000 and the extra500.
I haven't looked at any of those aircraft in months, so I cannot say if those problems have been addressed/fixed meanwhile - but there are a handful of examples for efficient Nasal/Canvas-based features, without them causing/contributing to significant lag. We have provided a bunch of "best practices" in various threads, and also offered 1:1 help to the efforts/people affected by this.
Some have refused to accept such advice, others simply disappeared over time. So I cannot say much about any particular aircraft. But Nasal and Canvas are just tools that can be misused - and they're "interpreted" tools, both of which are basically using the concept of a "virtual machine" internally, so there's a certain overhead due to all the indirection taking place - which is to say that you don't need to be an experienced C/C++ or OpenGL/OSG programmer to use Nasal and Canvas to create sophisticated avionics - which isn't unlike the YASim/JSBSim FDM engines (or the autopilot system), which also, can be mis-used to create inefficient constructs that end up slowing down the simulator significantly.
Then again, sometimes, there simply are very real bugs - like those in the property tree/effects code that TorstenD fixed a while ago, or the memory leak that Jabberwocky brought up on the forum, and that sanhoay identified - as long as people can provide actionable bug reports and reproducible test scenarios, there's a fairly good chance for bugs (and performance issues) to get fixed within 1-2 release cycles. But just coming here and saying that feature XYZ is broken or slows down the simulator isn't helping anybody, unless you can provide all the information that is needed that people who understanding the underlying subsystems can nail down the problem and see if there's an actual problem or not.
This also involves stating exactly what hardware you are on, and what your other startup/runtime settings are - as of now, Canvas doesn't provide native support for shaders, so it will be using OSG/shivaVG for all hardware accelerated graphics, which should usually be sufficiently fast - but there are known constructs/usage patterns that are infamous for triggering unnecessary updates/re-drawing, which should be avoided.
The other obvious issue is that Canvas does require FBO support.
People writing Nasal/Canvas code should ideally understand that Canvas is not just a VM but also a state machine to some extent, so even redundant/unnecessary state changes (all of which are going through the property tree usually) will trigger updates/re-drawing under certain circumstances, which is to say that this should be avoided - and which is why I, and a handful of others, have been trying to enforce a framework-centric development philosophy when it comes to Canvas development, so that people don't use Canvas directly, but instead come up with frameworks for functionality that they need, to encapsulate any Canvas specific functionality - that we- can help review/improve over time, without having to touch tons of code files, instruments, aircraft etc
The underlying idea can be seen in the ND and MapStructure efforts, neither of which needs to be touched by aircraft/GUI developers to add/create an ND or chart/map.
In summary, Canvas certainly isn't being maintained as actively as it once used to be, but -like Nasal- Canvas is just a technology enabler, and people should introduce abstraction layers to use the system, so that possibly problematic usage patterns can be more easily encapsulated, but also reviewed/edited and optimized over time.
But please don't expect any of the people involved in Canvas related efforts to answer such broad questions with a single "yes" or "no", without also providing a proper context.

|2= {{cite web
| url = http://forum.flightgear.org/viewtopic.php?p=250205#p250205
| title = <nowiki>Re: Developing a Canvas Cockpit for the CRJ700</nowiki>
| author = <nowiki>Hooray</nowiki>
| date = Jul 7th, 2015
| added = Jul 7th, 2015
| script_version = 0.25
}}
}}

== Latest Canvas Efforts ==

{{Canvas Frameworks|mode=by-year|year=2013}}

= Canvas and Nasal =
{{FGCquote
|Canvas is not all about Nasal - it's probably safe to say that 95-99% of all Nasal code using Canvas ends up being "just" property I/O i.e. properties being read/written, or updated via timers/listeners. Usually, the idea is to initialize a Canvas texture by setting up all important state early on, and then "update" and "animate" things using timers/listeners - or even property rules later on. That will usually help minimize most Nasal-induced overhead.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237678#p237678
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Fri Apr 03</nowiki>
}}
}}

{{FGCquote
| Canvas can definitely also be used without using Nasal - to see for yourself, just use the property tree browser to create/display canvas textures, or even the telnet/httpd protocols.
For the time being Nasal merely happens to provide the most abstract interface/mechanism to deal with Canvas - but you could just as well use the Canvas system from C++ by doing the corresponding property I/O using the C++ property interface directly - which would eliminate all Nasal overhead, even timers/listeners could then implemented in C++ space for animation/update logic.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237678#p237678
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Fri Apr 03</nowiki>
}}
}}

{{FGCquote
|That being said, this isn't necessarily the smartest/best thing to do - primarily, Canvas is all about exposing hardware-accelerated 2D rendering to fgdata space, so that non-core developers can easily address their 2D rendering needs, without having to rebuild FG from source and without having to be intimately familiar with C++ and OSG/OpenGL. Which is where the performance overhead is coming from, i.e. Canvas APIs being modeled on top of the property tree and wrapped using Nasal bindings - which adds two fairly massive layers of abstraction in terms of property I/O and Nasal<->C++ marshalling.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237678#p237678
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Fri Apr 03</nowiki>
}}
}}

= Using the Canvas in non-FG projects =
The canvas system has been refactored such that it can be more easily re-used in other programs, this included moving the Canvas component from FlightGear to SimGear and releasing the canvas code under SimGear's license (LGPL).

It is now possible to use the Canvas in projects unrelated to FlightGear, but you will obviously benefit from using certain FlightGear-related technologies, such as an * property tree
* SGSubsystem/Mgr-based main loop
* an osgviewer-based main window
* Nasal scripting

Icecode's FGRadar project is such a completely separate code base from FG, which uses SG/FG components to simplify code reuse, without re-inventing the wheel.

For this very purpose, FGRadar uses a custom "SGApplication" framework - so that existing FlightGear subsystems can be more easily reused in different projects. All that's needed is deriving your own class from "SGApplication" and implementing its interface.
The whole idea behind "SGApplication" is to provide a scriptable framework for OpenGL applications, fully based on 1) OSG, 2) SGSubsystems, 3) Nasal scripting and 4) the Canvas.

{{FGCquote
|the whole purpose of SGApplication is to provide a SGSubsystem-based "architecture" so that Nasal + Canvas and the property tree code can be easily reused.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237591#p237591
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Thu Apr 02</nowiki>
}}
}}

{{FGCquote
|the SGApplication stuff isn't really needed, we just came up with it to simplify working with the SG code. But at least it demonstrates how the whole SGSubsystemMgr stuff works.
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237591#p237591
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Thu Apr 02</nowiki>
}}
}}

{{FGCquote
|you can also use SGSubsystem/SGSubsystemMgr directly - no need for "SGApplication" at all, it's just a convenicence helper.
"porting" isn't strictly necessary - you would primarily need int main() with a top-level SGSubsystemMgr, where you can then add the property tree, Nasal, Canvas, events etc (a handful of subsystems). To use Canvas outside FG, you would also need to look at the FGCanvasSystemAdapter in $FG_SRC/Canvas and provide your own wrapper for your own app (trivial).
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237591#p237591
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Thu Apr 02</nowiki>
}}
}}

{{FGCquote
|"fgpanel" is a code base that is using the "copy & paste" approach - so could serve as another example (beyond fgradar).
|{{cite web |url=http://forum.flightgear.org/viewtopic.php?p=237613#p237613
|title=<nowiki>Re: Simgear-based subsystem with Canvas support?</nowiki>
|author=<nowiki>Hooray</nowiki>
|date=<nowiki>Thu Apr 02</nowiki>
}}
}}

For additional info, see: http://forum.flightgear.org/viewtopic.php?f=71&t=18415

== Gallery ==

[[File:Boeing 747-400 PFD and ND approach EHAM 18R.png|450px]]

A short video demonstrating a possible usecase (C-130J AMU):

{{#ev:youtube|A7j-B0LgV-A}}

By using alphablending it can also be used to render the contents of a HUD:

{{#ev:youtube|_oRX53JyXmM}}

In my branch there is now also support for using the canvas in a gui widget:

[[File:Canvas GUI Demo.png|thumb|none|400px|Using the Canvas as a GUI widget]]

With the new ''map'' element it is also very easy to draw maps:

[[File:Demonstration of using the Canvas inside a GUI dialog..png|thumb|none|400px|Simple Map of KSFO]]

Using the new [[Howto:Use_SVG_inside_a_Canvas|''canvas.parsesvg'']] function to use an SVG file to simulate an EICAS display:

{{#ev:youtube|43P7xKNJnV4}}

Demonstrating how the new Canvas GUI wrapper can be used to create entirely custom, scripted GUI widgets using XML, SVG and Nasal:

{{#ev:youtube|1a6wtPVPWc4}}

Experimenting with selecting text and positioning a cursor inside the text. The visualization is all done using Nasal.

{{#ev:youtube|CIS8UyuJLgM}}

Since 07/2012, the canvas system also provides support for full window-drawing:

{{#ev:youtube|Qv-uEX42QZY}}

Omega95 has reimplemented the CDU of the ATR72 using the Canvas system:

{{#ev:youtube|sAaVEKuiF5w}}

Another video demonstrating window stacking and nested canvases:

{{#ev:youtube|llVaasTEf44}}

Using Canvas mouse events to create [http://forum.flightgear.org/viewtopic.php?p=183653#p183653 animation of slider, wheel and knob]

{{#ev:youtube|HELiLjEGno8}}

[[Category:Rewrite]]

Pl/Nowy we FlightGear

2026-05-10T11:40:22Z

PlayeRom: /* Wymagania sprzętowe */

'''Witaj we [[FlightGear]]!''' Tutaj postaramy się, abyś wzbił się w wirtualne powietrze w jak najkrótszym czasie. Zapoznamy Cię również z niektórymi funkcjami tego symulatora lotu, a także z kilkoma informacjami na temat jego społeczności.

==Instalacja i konfigurowanie==
===Wymagania sprzętowe===
Aby FlightGear działał płynnie, wymagana jest karta graficzna ze sterownikami OpenGL w wersji 4.0 lub wyższej. Zazwyczaj nie stanowi to problemu, ale spójrz na [[Pl/Wymagania sprzętowe|zalecenia sprzętowe]], aby mieć lepsze rozeznanie.

Wiele laptopów może mieć problemy z FlightGear, ponieważ ich karty graficzne są zazwyczaj z niższej półki. Zobacz [[Notebooks known to run FlightGear|notebooki na których można uruchomić FlightGear]], aby zapoznać się z recenzjami kilku laptopów.

===Pobieranie FlightGear===
Możesz pobrać najnowsze pliki ze [https://www.flightgear.org/download/ strony pobierania FlightGeara]. Wybierz pliki źródłowe lub binarne odpowiednie dla Twojego konkretnego systemu. Od wersji 2020.3 LTS, dostępne są również pliki binarne {{Wikipedia|AppImage|AppImage}} dla Linuxa. Większość użytkowników Linuxa znajdzie też FlightGeara w zasobach swojej dystrybucji (pakiet może nazywać się <code>fgfs</code> lub <code>flightgear</code>).

W zależności od Twojej wiedzy technicznej, możesz wybrać wersję rozwojową [[Git]] FlightGeara, która zazwyczaj ma więcej funkcji i może być wymagana przez niektóre z najnowszych samolotów rozwojowych, ale może być niestabilna. Ogólnie rzecz biorąc, wersja rozwojowa nie jest zalecana dla przeciętnego użytkownika, ale jeśli jesteś chętny, aby zrobić kilka testów, istnieje wersja [https://www.flightgear.org/download/nightly/ nightly] dostępna do pobrania. Jeśli używasz wersji Git FlightGeara, możesz zsynchronizować swoje samoloty za pomocą [[FGAddon|repozytorium samolotów FGAddon]].

===Instalacja na Windows===
Po pobraniu instalatora, uruchom go i postępuj zgodnie z jego instrukcjami, aby zainstalować FlightGeara.

FlightGear jest uważany przez niektóre programy antywirusowe za wirusa. Jeśli tak się stanie, możesz tymczasowo wyłączyć antywirusa podczas instalacji.

W instalatorze Windows, możesz wybrać gdzie chcesz zainstalować FlightGeara. Katalogiem [[Pl/$FG_ROOT|$FG_ROOT]] będzie <code><wybrany przez Ciebie katalog>/data</code>.

===Instalacja na macOS===
Instalacja FlightGeara na macOS jest bardzo prosta. Wystarczy przeciągnąć i upuścić ikonę FlightGear do folderu <code>/Applications</code>. To wszystko.

Przy pierwszym uruchomieniu FlightGeara, ikona w Docku będzie podskakiwać przez kilka sekund podczas ładowania informacji o samolotach i lotniskach. Kiedy pojawi się GUI launchera, wybierz samolot i lotnisko, następnie kliknij "Lećmy!" aby uruchomić symulator. Możesz skonfigurować więcej opcji używając launchera GUI. Więcej szczegółów znajdziesz w [http://flightgear.sourceforge.net/manual/next/pl/getstart-plch4.html#start-jak-uruchomic-program Podręczniku Użytkownika].

Jeśli chcesz uruchomić FlightGear za pomocą wiersza poleceń, uruchom /Applications/Utilities/Terminal.app i wpisz następujące polecenie:

cd /Applications/FlightGear.app/Contents/MacOS
./fgfs --options.....

Zmienne [[Pl/$FG_ROOT|$FG_ROOT]] i [[$FG_SCENERY]] nie są ustawiane na macOS. Jeśli chcesz samemu określić te zmienne do użytku w wierszu poleceń, wykonaj poniższe polecenia w Terminal.app:

FG_ROOT=/Applications/FlightGear.app/Contents/Resources/data
FG_SCENERY=[[Pl/$FG_ROOT|$FG_ROOT]]/Scenery

Po uruchomieniu launchera GUI, będziesz miał alias do [[Pl/$FG_ROOT|$FG_ROOT]] w <code>$HOME/Documents/Flightgear/<wersja></code>, więc możesz przeglądać folder danych za pomocą Findera.

Uwaga: Po zainstalowaniu FlightGeara, użytkownicy Mac mogą zlokalizować folder [[Pl/$FG_ROOT|$FG_ROOT]] otwierając folder aplikacji w Finderze, klikając prawym przyciskiem myszy na FlightGear i klikając "Pokaż zawartość pakietu". To przeniesie Cię do folderu FlightGear. Teraz możesz uzyskać dostęp do wszystkich plików, w tym Data/Aircraft, aby [[Pl/Instalowanie_samolotów#macOS|zainstalować nowy samolot]].

===Konfiguracja OpenGL===
FlightGear działa najlepiej z aktualnymi sterownikami wideo [[OpenGL]]. Jeśli masz problemy z uruchomieniem FlightGeara, zobacz [[Graphics drivers configuration|Konfiguracja sterowników graficznych]], aby uzyskać więcej informacji.

===Pobieranie scenerii===
Wraz z FlightGearem instalowany jest ograniczony zestaw [[Scenery|scenerii]]. W przypadku FlightGear 2020.3 LTS jest to:
*obszar wokół lotniska, które jest głównym lotniskiem dla tego wydania, czyli [[Keflavik Airport|Keflavik International Airport]] (BIKF),
*lotnisko szkoleniowe dla [[Pl/Cessna 172P|Cessny 172P]], którym jest [[Hilo International Airport]] (PHTO).

We FlightGear sceneria jest przechowywana w katalogu [[Pl/$FG_ROOT|$FG_ROOT]] i jest podzielona na trzy rodzaje danych:
*'''Airports''' przechowuje dane o lotnisku, takie jak wykorzystanie pasów startowych i miejsc parkingowych.
*'''Objects''' i '''Models''' to budynki, mosty, wieże radiowe itp. reprezentujące trójwymiarowe struktury.
*'''Terrain''' reprezentuje kontury, wysokość i rodzaj terenu, nad którym latasz/kołujesz.

Aktualnym sposobem "instalowania" nowych scenerii jest włączenie funkcji [[TerraSync]], która automatycznie pobierze i zaktualizuje każde miejsce, które odwiedzisz - nawet w locie! Jeśli masz wolne łącze internetowe i/lub powolny komputer, możesz zamiast tego użyć menedżera scenerii, na przykład [[TerraMaster]]. Dodatkowo możesz także ręcznie pobrać i zainstalować nowe części scenerii, zarówno oficjalne [[World Scenery|Scenerie Świata]], jak i niestandardowe scenerie.

Oficjalna sceneria, choć przestarzała, jest dostępna w [http://www.flightgear.org/download/scenery/ sekcji pobierania scenerii] na stronie FlightGeara, i może być zainstalowana zgodnie z [[Howto: Install scenery|instrukcją instalowania scenerii]]. Możesz uzyskać dodatkowe i bardziej aktualne obiekty scenerii, gdy staną się dostępne w [http://scenemodels.flightgear.org/ Bazie Danych Scenerii FlightGear]. '''Jest to zalecane dla użytkowników ze słabym połączeniem internetowym lub słabym komputerem!'''

Niestandardowe scenerie są dostępne w wielu miejscach. Na przykład na {{Forum link|text=forum FlightGeara}} lub w repozytoriach. Poszukiwania w internecie aby je znaleźć. Zobacz [[Suggested custom scenery|sugerowaną listę niestandardowych scenerii]] dla kilku ostatnich wydań.

Wersje FlightGeara 2020.3.7 LTS i późniejsze dodały eksperymentalne wdrożenie trójwymiarowych budynków, dróg i obiektów opartych na danych OpenStreetMap dla całego świata do automatycznie pobieranych danych TerraSync - zobacz [[OSM2City 1st Worldbuild|pierwsze wydanie całego świata w OSM2City]] (marzec 2021). Można też samodzielnie [[Areas populated with osm2city scenery|pobrać niektóre obszary scenerii pokryte OSM2City]].

===Pobieranie samolotów===
Dodatkowe [[Pl/Samoloty|samoloty]] można pobrać i zainstalować za pomocą [[FlightGear Qt launcher|launchera]]. Alternatywnie możesz przejść do [http://www.flightgear.org/download/ strony pobierania], a następnie wybrać link do pobrania samolotu, który pasuje do Twojej wersji FlightGeara. Dodatkowo istnieje wiele [[Hangars|hangarów]] osób trzecich. Po szczegóły jak zainstalować samolot, zobacz [[Pl/Instalowanie samolotów|Instalowanie samolotów]].

==Uruchamianie FlightGeara==
===Uruchamianie FlightGeara===
Najprostszym sposobem na uruchomienie FlightGeara jest użycie ikony na pulpicie. To uruchamia graficzny interfejs [[FlightGear Qt launcher]], gdzie można wybrać samolot, pozycję startową itp. Pamiętaj, że Qt launcher ma tylko podstawowe opcje wygodnego uruchomienia. Wiele opcji dla grafiki, scenerii, [[Weather|pogody]], [https://www.flightgear.org/tours/simulating-the-ever-changing-scenery/ środowiska], [[Input device|urządzeń wejściowych]] itp. jest dostępnych z menu wewnątrz symulatora.

Wielu użytkowników decyduje się jednak na uruchomienie FlightGeara bezpośrednio z linii poleceń. Nazwa pliku wykonywalnego to fgfs i może on być uruchamiany bez opcji. Jeśli nie zostanie znaleziony, to prawdopodobnie nie masz ustawionej ścieżki w [https://en.wikipedia.org/wiki/PATH_(variable) zmiennej środowiskowej PATH]. Lokalizacja zależy od Twojego systemu i wyborów dokonanych podczas kompilacji i instalacji. Istnieje lista [[Pl/Opcje_wiersza_poleceń|opcji wiersza poleceń]], które mogą być użyte do zmiany konfiguracji, takich jak samolot, którym chcesz lecieć. Najważniejsze z nich:
fgfs --launcher # otwiera FlightGear Qt launcher
fgfs --show-aircraft # wyświetla listę zainstalowanych samolotów
fgfs --aircraft=c172p # uruchamia FG z samolotem "c172p" (z listy)

Qt launcher pozwala również na wpisywanie opcji wiersza poleceń, które są normalnie zmieniane z menu wewnątrz symulatora, jak również dość zaawansowanych opcji, które są dostępne tylko z wiersza poleceń (od sierpnia 2020).

===Używanie klawiatury i/lub myszki===
Użytkownicy z ograniczonym dostępem do [[Joystick|joysticka]] lub innych kontrolerów, czasami używają klawiatury lub myszy do sterowania samolotem. Używanie klawiatury do latania może być trudne i zaleca się używanie myszy zamiast klawiatury, ale nawet tani joystick znacznie poprawiłby wrażenia.

Aby podejrzeć skróty klawiaturowe, przy uruchomionym FlightGear, przejdź do menu ''Pomoc'' i kliknij na ''Podstawowe klawisze symulatora'' (dla klawiszy związanych z symulatorem) lub ''Klawisze sterowania'' (dla uniwersalnych klawiszy dla wszystkich samolotów) lub ''Dla tego samolotu'' (dla klawiszy specyficznych dla Twojego samolotu). Jeśli menu główne jest ukryte, wciśnij {{Key press|F10}}.

Przyszedłeś z innego symulatora? Sprawdź [[Key commands compared to other simulators|skróty klawiaturowe w porównaniu z innymi symulatorami]], aby dowiedzieć się, jakie są różnice między klawiszami danego symulatora a FlightGearem. Aby użyć myszy do pilotowania samolotu, naciśnij {{Key press|Tab}} (kursor powinien zmienić się na krzyżyk) i poruszaj myszą, aby sterować samolotem. Naciśnij {{Key press|Tab}} ponownie, aby rozejrzeć się dookoła (kursor powinien pokazać dwustronną strzałkę), i naciśnij {{Key press|Tab}} jeszcze raz, aby powrócić do normalnego trybu, używanego do klikania elementów w kokpicie. W niektórych samolotach, takich jak [[A320neo]] i [[Airbus A330|A330]] to niestety nie zadziała, więc będziesz musiał użyć prawego przycisku myszy, aby się rozejrzeć, a tryb myszy jest wyłączony. Na szczęście te samoloty to samoloty pasażerskie, które są naprawdę stabilne i łatwe do pilotowania za pomocą klawiatury.
[[Category:Menubar|FlightGear dialogs and menu bar]]

===Pierwszy raz w kokpicie===
Odnalezienie się w kokpicie może być trudne za pierwszym razem.

Gdzie jest "wirtualny kokpit"? Nie wszystkie samoloty we FlightGear posiadają wnętrze, niektóre projekty badawcze mogą nawet nie posiadać modelu zewnętrznego. Panel 2D może być wyświetlany nad kokpitem 3D, jeśli taki istnieje. Możesz to wyłączyć poprzez ''Menu główne'' > ''Widok'' > ''Opcje widoku'' i odznaczenie opcji ''Show 2D Panel'' w sekcji ''Display Options'' lub naciskając {{Key press|Shift|P}}. W przeciwnym razie, powinieneś znajdować się w wirtualnym kokpicie, pod warunkiem, że jest wybrany Widok Kokpitu (jeśli nie, wciśnięcie {{Key press|Ctrl|V}} powinno przenieść Cię do widoku pilota).

Możesz mieć trudności z odczytaniem niektórych wskaźników, tarcz i mierników na tablicy przyrządów. Możesz użyć trybu widoku myszy (naciskaj klawisz {{Key press|Tab}}, aż pojawi się kursor w kształcie podwójnej strzałki) do rozglądania się oraz kółka myszy do przybliżania/oddalania widoku. Ewentualnie możesz rozglądać się za pomocą joysticka i przybliżać/oddalać widok za pomocą {{Key press|X}} i {{Key press|Shift|X}}.

Jednym z pierwszych kroków, które wiele osób wykonuje po wejściu do nieznanego kokpitu, jest wciśnięcie {{Key press|Ctrl|C}} aby podświetlić wszystkie klikalne elementy, czyli kontrolki przyrządów, przyciski, pokrętła itp. Wiele samolotów oferuje również specjalne menu pomocy.

Niektóre funkcje, takie jak rozrusznik czy magneto, mogą być trudne w użyciu lub po prostu nie są klikalne, szczególnie w modelach samolotów, które są w fazie rozwoju. W większości przypadków możesz skorzystać z odpowiedników na panelu 2D lub skorzystać z klawiatury. Klawiatura zawsze działa zgodnie z przypisaniami wymienionymi w menu pomocy, ale czasami są one zmieniane przez samolot lub konfigurację. Ponownie, pamiętaj, aby sprawdzić wszystkie okna dialogowe pomocy.

===Uruchamianie silnika===
Masz ochotę latać, ale silnik jest wyłączony. Cóż, włączanie silników nie zawsze jest łatwe. Niektóre samoloty mają opcję autostartu w swoim menu, ale poniżej podajemy ogólną procedurę, która powinna zadziałać w wielu przypadkach:

Ogólnie rzecz biorąc, aby uruchomić silnik w samolocie z silnikiem tłokowym, potrzebujesz:
#Paliwo: niektóre samoloty rozpoczynają symulację bez paliwa. Możesz je dodać w ''Wyposażenie'' > ''Paliwo i ładunek''.
#Właściwa mieszanka paliwowa: z reguły jest ona ''bogata'', więc wciśnij czerwoną manetkę do końca lub użyj klawisza {{Key press|m}} do wzbogacenia, ({{Key press|Shift|m}} do zubożenia).
#Magneto ustawione na ''Both'': obróć kluczyk lub naciśnij {{Key press|}}} ''trzy razy'', aby przejść przez ''R'', ''L'' do ''Both''.
#Przepustnica: niektóre silniki uruchamiają się lepiej z niewielką ilością ciągu.
#Uruchomić rozrusznik: kliknij i przytrzymaj pozycję ''Start'' rozrusznika (na panelu z kluczykiem) lub przytrzymaj klawisz {{Key press|s}}. Przytrzymaj rozrusznik przez odpowiedni czas, nawet 10 sekund.

Uruchamianie wszystkich silników w samolocie wielosilnikowym jest podobne do uruchamiania pojedynczego silnika - z tą różnicą, że dla każdego silnika należy zachować taką samą sekwencję uruchamiania. FlightGear oferuje wygodny sposób, aby zrobić to dla wszystkich silników jednocześnie: Naciśnij {{Key press|~}} i cała powyższa procedura będzie działać dla wszystkich silników. Zauważ jednak, że domyślny panel 2D jest podłączony tylko do jednego silnika i sztuczka z {{Key press|~}} może nie zadziałać. Dodaj też trochę ciągu, aby upewnić się, że wszystkie silniki są włączone.

Te instrukcje mogą nie działać dla samolotów odrzutowych, helikopterów lub innych typów samolotów ze skomplikowanymi procedurami startowymi. Sprawdź instrukcje w menu pomocy samolotu (wciśnij {{Key press|?}}) i/lub zajrzyj do [[Pl/Samoloty|artykułu o samolotach]]. Ogólnie rzecz biorąc, aby uruchomić silnik w samolocie z silnikiem odrzutowym, musisz:
#Ustawić ''cutoff'' na ON.
#Włączyć rozrusznik.
#Gdy silnik osiągnie około 5% N1, ustawić ''cutoff'' na OFF.
#Wyłączyć rozrusznik, gdy silnik osiągnie prędkość operacyjną.

===Latanie w trybie online dla wielu graczy===
FlightGear ma kilka serwerów multiplayer, które pozwolą Ci latać w bardziej ożywionych przestworzach, zobacz [[Howto: Multiplayer]]. Istnieją także [[OpenRadar]] i [[ATC-pie]], samodzielne programy, które pozwolą Ci być [[Air traffic control|kontrolerem ruchu lotniczego]].

Jest też [[MPMap|mapa multiplayer]], która pozwala zobaczyć kto jest online, a nawet jakie [[Navaids|pomoce nawigacyjne]] są w pobliżu.

==Nauka latania==
===Samouczki===
Wiele samolotów ma swoje własne samouczki. Dzięki samouczkom możesz nauczyć się obsługiwać dany samolot, ale także nauczyć się latać. Możesz uzyskać dostęp do samouczka poprzez wybranie w menu głównym ''Pomoc'' > ''Samouczki''. Doskonałym miejscem do rozpoczęcia nauki jest samouczek dla samolotu Cessna 172P, powszechnie używanego w prawdziwym życiu do nauki latania samolotami stałopłatowymi.

Jeśli po uruchomieniu samouczka, zamiast na ziemi, rozpoczynasz w wodzie, oznacza to, że w Twojej konfiguracji FlightGeara brakuje scenerii lotniska, na którym miał się rozpocząć samouczek. Aby zdobyć scenerię zobacz sekcję [[#Pobieranie scenerii]] powyżej.

==Pierwszy lot==
===Realizm===
Jednym z najczęstszych pytań początkujących pilotów dotyczących każdego symulatora lotu, ale bardziej dotyczących FlightGeara, jest "Dlaczego mój samolot skręca cały czas w lewo?". Chociaż może to być spowodowane podmuchami wiatru przecinającymi pas startowy, bardziej prawdopodobną przyczyną jest [[Understanding Propeller Torque and P-Factor|moment obrotowy śmigła i współczynnik P]].

W niektórych innych symulatorach lotu, pomimo marketingowych sloganów mówiących coś przeciwnego, niektóre ustawienia są obniżone, aby ułatwić latanie samolotem. Zmniejsza to efekty takie jak powyżej. We FlightGear realizm jest zawsze podkręcony.

Oto niektóre z punktów realizmu we FlightGear, które mogą być mylące dla początkujących pilotów:
*"Syndrom skrętu w lewo" z wcześniej wymienionych powodów.
*Błąd skrętu kompasu: Kompas, gdy jest poddany siłom lotu, ma tendencję do obracania się w przeciwnym kierunku przez krótki czas, zanim ustali się na prawidłowym kursie. Nie jest to usterka (patrz również artykuł na Wikipedii {{Wikipedia|Aircraft compass turns}}).
*Wskaźnik prędkości pionowej (VSI) jest również podatny na błędy.
*Wskaźnik sytuacji poziomej (HSI) jest napędzany przez żyroskop (dlatego nazywany jest również żyroskopowym wskaźnikiem kursu), który podlega dryfowi żyroskopowemu. Wskaźnik będzie dryfował w stosunku do aktualnego kursu i musi być okresowo (co ~15 minut) kalibrowany, aby zgadzał się z kursem kompasu magnetycznego.
*Nie możesz po prostu zaniechać zakrętu lub wznoszenia przez wycentrowanie wolantu. Musisz obrócić lub pchnąć wolant w drugą stronę, aby przejść do lotu równego i poziomego. Ale nawet wtedy samolot sam nie utrzyma wysokości ani kursu. Często popełnianym błędem jest próba znalezienia neutralnej pozycji drążka. O ile trymując można opuścić samolot na kilka sekund, o tyle trzeba korzystać z autopilota lub stale regulować pozycję wolantem.

Wiele sił działa na samolot w locie, jak również na [[Avionics and instruments|awionikę i instrumenty]] używane do sterowania i nawigacji, i mogą być sprzeczne z intuicją. Piloci muszą nauczyć się rozpoznawać te zjawiska i kompensować ich skutki. ''FlightGear modeluje błędy instrumentów, które istnieją w świecie rzeczywistym.''

===Lotniska i pomoce nawigacyjne===
Kiedy po raz pierwszy uruchamiasz FlightGear, czy to z wiersza poleceń, czy z graficznego interfejsu launchera, możesz się zastanawiać, jak określić, jakie lotniska są dostępne. Launcher wyświetla listę lotnisk, ale nie zobaczysz szczegółów, takich jak częstotliwości wieży lub [[ILS]]. Nie znajdziesz też mapy pokazującej [[VOR|VOR-y]] i ich częstotliwości. Co możesz zrobić? Patrz [[Getting aeronautical charts|Uzyskiwanie map lotniczych.]]

W symulacji dostępna jest mapa, której możesz użyć w ''Menu główne'' > ''Wyposażenie'' > ''Mapa'', która pozwoli ci zobaczyć dane nawigacyjne oraz pozycje lotnisk i pomocy. Aby uzyskać więcej pomocy na temat nawigacji zobacz [[Understanding navigation|Zrozumieć nawigację]].

===Latanie z użyciem autopilota===
Niektóre samoloty wymagają użycia [[Autopilot|autopilota]] dostępnego z menu ''Autopilot'', który jest domyślnym autopilotem we FlightGear. Jest to autopilot ''ogólny'' i w związku z tym wiele samolotów posiada ''własnego'' autopilota, często będącego modelem prawdziwego autopilota.

W przypadku samolotów, które posiadają własnego autopilota, powinieneś używać kontrolek autopilota dostępnych w wirtualnym kokpicie. Oznacza to kliknięcie na tablicę przyrządów w wirtualnym kokpicie. Menu Autopilot będzie wyszarzone i niedostępne, gdy samolot posiada własnego autopilota, jak np. w Airbusach i w [[Pl/Cessna 172P|C172P]].

Cessna 172P jest wyposażona w [[Bendix/King KAP140 Autopilot|autopilota Bendix/King KAP140]] w wirtualnym kokpicie. Nie możesz użyć okna dialogowego ''Autopilot'' z menu w tym samolocie. Musisz użyć urządzenia autopilota na panelu.

==Społeczność FlightGear==
===Uzyskiwanie pomocy===
Ta strona jest stworzona, żeby dać użytkownikowi podstawowe rzeczy, które musi wiedzieć o używaniu FlightGeara po raz pierwszy. Poza [[Portal:User|portalem użytkownika]] w tym wiki, są inne strony, które możesz chcieć przeczytać:
*[[Troubleshooting problems|Rozwiązywanie problemów]], aby pomóc Ci z najczęstszymi problemami;
*[[Pl/FAQ|Często zadawane pytania]];
...i kanały komunikacyjne, które mogą być używane do uzyskania informacji lub pomocy:
*[[Pl/Podręcznik FlightGear|Podręcznik FlightGear]], ''lektura obowiązkowa'' dla początkujących;
*{{Forum link|text=Forum FlightGear}} i jego podfora;
*[[Discord|Serwer Discord]], najszybsza droga, żeby uzyskać pomoc;
*[[FlightGear IRC channel|Kanał IRC FlightGear]];
*[[Mailing list|Lista mailingowa]], największa szansa aby skontaktować się z deweloperami;
*Dokumenty dołączone do pakietu wydania.

===Dostosowywanie FlightGear bez kompilacji kodu źródłowego===
[https://www.flightgear.org/download/ Nasza strona internetowa] oferuje skompilowane pliki binarne do pobrania i zainstalowania dla systemów Windows, macOS i Linux. Ponadto większość dystrybucji linuksowych dostarcza gotowe pakiety w swoich repozytoriach.

Chociaż instalacja jest binarna, większość systemów FlightGeara jest otwarta na konfigurację poprzez pliki [[XML]] i [[NASAL scripting|skrypty NASAL]]. Masz swobodę ''i zachęcamy'' do wprowadzania zmian w modelach lotu samolotów, scenerii, teksturach, [[Shader|shaderach]] OpenGL i wszelkich innych funkcjach, które chcesz zmienić dla własnej satysfakcji lub podzielenia się nimi z innymi użytkownikami FlightGeara. Jeśli to jest to, co zamierzasz zrobić, spójrz na [[Portal:Developer|portal dla deweloperów]].

===Jak możesz pomóc===
{{Main article|Volunteer}}
FlightGear jest projektem open source, opartym na wolontariacie. Oznacza to, że cokolwiek tu znajdziesz, jest wynikiem pasji, wolnego czasu i niczego innego. Dotyczy to symulatora, scenerii, samolotów, wiki, {{Forum link|text=forum}} i wszystkiego innego. Wolontariusze, czyli ludzie robiący przeróżne rzeczy, są podstawą tego projektu. Bez nich ten projekt nie zrobiłby ani jednego kroku naprzód. Jest więc niezwykle ważne, aby współtwórcy mieli radość z tego co robią.

Jeśli planujesz wnieść swój wkład w ten projekt, powinieneś rzucić okiem na parę artykułów, które dadzą Ci kilka wskazówek:
*[[Howto:Understand the FlightGear development process|Howto:Zrozumieć proces rozwoju FlightGeara]]
*[[Implementing new features for FlightGear|Wdrażanie nowych funkcji dla FlightGeara]]
*[[How the FlightGear project works|Jak działa projekt FlightGear]]

Nigdy nie jest dość ludzi, którzy wnoszą swój wkład, a dziedzin, w których ich pomoc byłaby doceniana jest wiele:
;Testowanie:
*[[Building FlightGear|Zbuduj]] najnowszy kod Git lub pobierz migawki z [[FlightGear Build Server|Serwera Budowania FlightGeara]].
*[https://gitlab.com/flightgear/flightgear/-/issues Zgłaszaj błędy].
*Uruchamiaj FlightGear przez valgrind, aby wyśledzić wycieki pamięci.

;Wsparcie
*Pomagaj nowym użytkownikom w ściąganiu, kompilowaniu, instalowaniu i uruchamianiu FlightGeara (na {{Forum link|text=forum}} lub na [[Discord|Discordzie]], IRC).
*Dostarczaj pomysły i sugestie, zobacz: [[Feature Requests / Proposals / Ideas|Prośby o funkcje, propozycje, pomysły]].
*Pomóż uporządkować wiki.
*Pomóż dostarczyć nową zawartość dla brakujących stron wiki.

;Rozwój
*Programowanie w C/C++:
**Czyszczenie kodu źródłowego (w zasadzie pomoc w procesie migracji zarządzania pamięcią, opartym głównie na inteligentnych wskaźnikach przy użyciu SGSharedPtr).
**Poprawianie [[Bugs|błędów]] lub dodawanie nowych funkcji.
**Zaangażuj się w któryś z innych projektów związanych z FlightGearem.
*Rozwój samolotów (modelowanie 3D, tekstury, model lotu, skrypty).
*Rozwój scenerii (teren, model, pogoda).

[[Category:FlightGear]]

[[ca:Nou a FlightGear]]
[[de:Neu bei FlightGear]]
[[en:New to FlightGear]]
[[es:Nuevo en FlightGear]]
[[fi:Uusi_käyttäjä]]
[[fr:Nouveau sur flightgear]]
[[it:Nuovo per FlightGear]]
[[ja:FlightGear入門]]
[[nl:Nieuw bij FlightGear]]
[[pt:Novo no FlightGear]]
[[sr:Novi u FlightGear-u]]
[[th:New to FlightGear]]
[[zh:FlightGear新手]]

Pl/FAQ

2026-04-30T17:19:29Z

PlayeRom: /* Ochrona treści */

Dziękujemy za zainteresowanie [[FlightGear]]! Ten ''FAQ'' zawiera listę najczęściej zadawanych pytań. Jeśli nie możesz znaleźć odpowiedzi na swój problem, proszę utworzyć temat na {{forum link|text=naszym forum}}.

== Dystrybucja ==

=== Skąd wziąć FlightGear? ===
Oficjalną stroną pobierania jest: {{project infrastructure|website|link=no|urn=download/}}. Znajdziesz tam wersje binarne dla Windows, macOS oraz Linux (AppImage). W większości dystrybucji Linuxa, FlightGear można pobrać bezpośrednio z repozytoriów danej dystrybucji. Szukaj w "Centrum/Menedżer oprogramowania" Twojej dystrybucji.

=== Jak zainstalować FlightGeara na Linuksie? ===
Wiele dystrybucji zawiera FlightGear w swoich repozytoriach. Ponadto w {{project infrastructure|website|urn=download/|text=Centrum Pobierania}} znajdziesz też wersję skompilowaną do AppImage, którą uruchomisz na niemal każdej współczesnej dystrybucji. Jeśli nie możesz znaleźć wersji pakietowej dla siebie, rozważ pobranie i [[Building FlightGear - Linux|kompilację z kodów źródłowych]].

=== Gdzie mogę znaleźć najnowszy kod źródłowy? ===
Najnowszy kod źródłowy jest dostępny dla każdego za pośrednictwem naszego [[FlightGear Git|repozytorium Git]].

=== Gdzie mogę latać i skąd wziąć scenerie? ===
Latać można wszędzie, po całym świecie. Scenerie można pobrać na wiele sposobów. Obecnie najlepszą opcją jest automatyczne pobieranie scenerii w zależności od tego gdzie się znajdujesz. Służy do tego program TerraSync. Aby go włączyć wystarczy w Launcherze wejść do "Ustawienia" -> "Pobieranie" i tam zaznaczyć opcję "Automatycznie pobieraj scenerię".

Można także pobrać większe rejony świata ręcznie, ze strony {{project infrastructure|website|urn=download/scenery|text=Pobieranie Scenerii}}

=== Gdzie mogę zdobyć dodatkowe samoloty? ===
Najnowsze, oficjalne samoloty można pobrać i zainstalować jednym kliknięciem w zakładce samolotów w Launcherze (patrz [[FlightGear Qt launcher|FlightGear Qt Launcher]]).

Możesz także zajrzeć na oficjalną stronę {{project infrastructure|website|urn=download/download-aircraft/|text=Pobierania Samolotów}}.

Inne samoloty w fazie rozwoju możesz znaleźć w oficjalnym repozytorium samolotów [[FGAddon]], a inne w hangarach FlightGear osób trzecich (patrz także [[Pl/Instalowanie_samolotów|Jak zainstalować samoloty]]).

=== Dlaczego samoloty na FlightGear.org są nieaktualne? ===
Samoloty z oficjalnej {{project infrastructure|website|urn=download/|text=strony pobierania}} są aktualizowane tylko w momencie wydania nowej wersji FlightGeara. Dzieje się tak, ponieważ samoloty, które są obecnie w fazie rozwoju, są zwykle opracowywane dla rozwojowych/nieopublikowanych wersji FlightGeara. Te wersje rozwojowe mają wiele funkcji, które nie są obsługiwane przez starszą, stabilną wersję. Gdybyśmy częściej aktualizowali pobierane samoloty, większość samolotów nie działałaby w stabilnej wersji FlightGeara.

=== Jak aktualne są dane we FlightGear w porównaniu z rzeczywistością? ===
Korzystamy z tych samych danych nawigacyjnych i baz lotnisk co X-Plane. Aktualne bazy danych można znaleźć w folderach [[$FG ROOT]]/Navaids/ and [[$FG ROOT]]/Airports/.

=== Dlaczego nie pobieracie za to pieniędzy? ===
FlightGear można pobrać bezpłatnie z wielu miejsc, w tym ze strony internetowej FlightGear, ale można go również kupić na płycie CD/DVD. Chociaż oferujemy tę usługę (zobacz oficjalną stronę internetową), zachęcamy inne grupy do redystrybucji dla swoich użytkowników, zwłaszcza w ramach dystrybucji systemu operacyjnego, która sprawia, że instalacja jest jeszcze szybsza i łatwiejsza dla nowych użytkowników.

Czasami możesz znaleźć ofertę kupna FlightGeara na portalach aukcyjnych lub komercyjnych stronach internetowych pod inną nazwą. Można to zrobić całkiem legalnie, o ile warunki licencji są przestrzegane i może być warte kosztów, jeśli uwzględnione zostaną niektóre funkcje o wartości dodanej, takie jak dodatkowa sceneria, samolot lub wsparcie posprzedażowe. Niestety, większość przypadków obserwowanych do tej pory wydaje się być po prostu próbą zarobienia pieniędzy na sprzedaży czegoś, co jest bezpłatne i nie zapewnia prawdziwej wartości dodanej.

=== Jak mogę zacząć korzystać z FlightGear? ===
FlightGear można pobrać z {{project infrastructure|website|urn=download/|text=Download Central}}. Po uruchomieniu Launchera, możesz doinstalować tam samoloty z oficjalnego hangaru. Włączając automatyczne pobieranie scenerii, FlightGear sam zadba o scenerię. Uważaj na wymagania systemowe! Sprawdź też [[Pl/Nowy we FlightGear|Nowy we FlightGear]].

== Kompilacja ==
=== Jak skompilować FlightGear z kodów źródłowych? ===
Zobacz [[Building Flightgear|Budowanie FlightGear]]. Istnieją wyjaśnienia dla kompilacji pod Window, Linuks, a nawet skrypty do automatycznego pobrania i kompilowania całości.

=== Dlaczego FlightGear się nie kompiluje? ===

To zależy. Po pierwsze upewnij się że używasz odpowiednich wersji FlightGear, [[SimGear]], plib, zlib. Jeśli którykolwiek z pakietów nie pasuje (wersją) do innych, kompilacja może się nie udać.

Upewnij się też czy masz implementację OpenGL ze wsparciem glut'a z odpowiednimi plikami nagłówkowymi. Użytkownicy Linuksa posiadający karty nVidia powinni się sprawdzić, czy mają najnowsze sterowniki. Inni posiadacze Linuks powinni mieć bibliotekę Mesa3d (http://mesa3d.org/). Sprawdź też czy masz dobrze zainstalowany i skonfigurowany serwer X-ów.

Jeśli dalej masz problemy, zapytaj na {{forum link|text=FlightGear forum}}, na [[IRC]] lub zapisz się na naszą [[mailing list|listę mailingową]] FlightGear-Users i daj nam znać, jaki masz problem.

=== Czym jest SimGear i dlaczego go potrzebuję? ===
[[SimGear]] jest biblioteką kodu pomocniczego. SimGear jest potrzebny tylko wtedy, gdy planujesz skompilować FlightGear - nie jest potrzebny do uruchamiania prekompilowanych binariów. Więcej informacji znajdziesz na stronie http://www.simgear.org/. Uwaga: Podczas kompilacji FlightGeara bardzo ważne jest posiadanie pasującej wersji SimGeara.

== Konfiguracja i uruchomienie ==

=== Jak uruchomić FlightGear? ===
Najprostszym sposobem jest użycie [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz go uruchomić z terminala używając [[Pl/Opcje_wiersza_poleceń|opcji wiersza poleceń]].

=== Jak zainstalować nowe scenerie? ===

Jeśli naprawdę nie chcesz/nie możesz używać [[Terrasync]], pliki archiwum scenerii (np. w100n30.tar.gz) powinny zostać rozpakowane do katalogu Scenery/Terrain w Twoim [[$FG_ROOT]]. Więcej na [[Pl/Instalowanie_scenerii|Instalowanie scenerii]].

=== Jak skonfigurować mój joystick? ===

FlightGear obsługuje wiele joysticków/wolantów od razu po podłączeniu. Jeśli jednak masz problemy, zobacz [[Input device|Urządzenie wejściowe]].

=== W jakim formacie powinien być mój osobisty plik .fgfsrc? ===

Twój plik .fgfsrc powinien po prostu być listą [[Pl/Opcje_wiersza_poleceń|opcji wiersza poleceń]], z każdą opcją w osobnej linii. Plik ten nie jest plikiem XML.

Jeśli wolałbyś korzystać z plików konfiguracyjnych XML mógłbyś dodać coś takiego do pliku .fgfsrc lub do wiersza poleceń:

--config=/ścieżka/do/pliku.xml

Prawie każda opcja odpowiada właściwości, więc możesz wybrać metodę która Ci najlepiej odpowiada.

=== Jak dostać się do opcji, pomocy itp.? ===
Prawdopodobnie nie widzisz głównego menu. Aby je wyświetlić naciśnij {{Key press|F10}}.

== Latanie ==

=== Jak uruchomić silnik/i? ===
Samoloty różnią się w swoich procedurach startowych. Niektóre mogą mieć sekwencję automatycznego startu lub instrukcje w menu pomocy samolotu (naciśnij klawisz {{key press|?}}) i/lub na stronie Wiki o [[Aircraft|statkach powietrznych]]. Zapoznaj się z [[Pl/Podręcznik_FlightGear|Podręcznikiem FlightGear]] lub zobacz [[Pl/Nowy_w_FlightGear#Uruchamianie_silnika|szybki przewodnik]].

=== Gdzie jest przesuwana mapa? ===
W symulatorze można wejść w menu "Wyposażenie > [[Map|Mapa]]", ale nie jest to mapa lotnicza. Popularna ruchoma mapa jest dostępne w ramach osobnego projektu o nazwie Atlas. Jest również [[MPmap]] - mapa online dla multiplayer.

Jeśli lubisz alternatywę dla Atlasa z uaktualnioną grafiką i mapami dostarczanymi przez projekt OpenStreetMap, to sprawdź [[Phi#Map|Phi]] lub [[JMapView]].

=== Gdzie mogę się nauczyć latania według wskazań przyrządów i nawigacji? ===
Jest dobry artykuł [[Understanding navigation]] oraz jest to bardzo dobrze wyjaśnione w [[Pl/Podręcznik_FlightGear|Podręczniku FlightGear]]. Inne zasoby to:
* [http://www.av8n.com/how/ See How It Flies] - bardzo dobra książka autorstwa Johna S. Denkera, dostępna online.

=== Jaka jest różnica między lotką a sterem kierunku? ===
W tej samej książce jest trochę informacji o lotkach i sterze kierunku.

=== Czy FlightGear wspiera multiplayer? ===
Oczywiście. Zobacz [[Howto: Multiplayer]]. Zarówno wersje Windowsowe jak i Unixowe obsługują tryb wieloosobowy na serwerach FlightGear. Również komunikacja głosowa jest obsługiwana dzięki [[FGCom]].

Mapa pokazująca samoloty graczy online w czasie rzeczywistym jest dostępna jako [[MPmap]].

=== Gdzie są najlepsze miejsca do latania w FlightGear? ===
Sceneria FlightGear obejmuje cały świat, ale dzięki społeczności użytkowników FlightGear, niektóre lotniska i obszary są bardziej szczegółowe niż inne:
* W okolicach Paryża we Francji jest wiele wysokiej jakości modeli scenerii.
* EHAM Amsterdam Schiphol, EGK Londyn Gatwick i LFPG Paryż Charles de Gaulle są jednymi z najwyższej jakości lotnisk.
* LOWI Innsbruck jest zarówno rozwinięty w scenerii jak i na lotnisku.
* TNCM St. Maarten jest popularnym celem podróży, a okoliczne wyspy (Anguilla, St. Eustatius, Saba, St. Barthélemy, St. Kitts i Nevis) są dobrze wymodelowane.

Ponadto zobacz [[Suggested Flights|sugerowane loty]], [[Suggested Airports|sugerowane lotniska]] i [[Suggested custom scenery|sugerowane scenerie niestandardowe]].

=== Gdzie mogę znaleźć informacje o lotniskach i mapy lotnicze online? ===
Lotniska:
* [http://www.airnav.com/airports/ AirNav.com]

Mapy:
* [http://skyvector.com/ SkyVector.com]

Zobacz także [[Getting aeronautical charts|pozyskanie map lotniczych]].

=== Czy we FlightGear jest możliwość prowadzenia działań militarnych np. prowadzenia walk powietrznych lub zrzucania bomb? ===
Tak. Sprawdź dodatek [[Bombable]] i {{forum link|t=5742|title=Bombable}}. Istnieją również scenariusze bombardowania dla [[A-10]] i innych samolotów z uzbrojeniem, jak [[North American OV-10A Bronco]], [[General Dynamics F-16]] i [[F-117 Nighthawk]].

=== Problemy z lataniem ===

==== Dlaczego moje powierzchnie sterowe wracają do określonej pozycji? ====
Jest kilka możliwości, które mogą do tego doprowadzać:
* Jeśli [[autopilot]] twojego samolotu jest włączony, przejmie on (część) twoich elementów sterujących. Wyłącz autopilota, aby odzyskać kontrolę.
* Niektóre laptopy mają wbudowany czujnik grawitacji, który może zostać wykryty jako [[joystick]]. Zobacz jak to rozwiązać na [[Troubleshooting input devices#Controls returning to a particular position|Rozwiązywanie problemów z urządzeniami wejściowymi]].

==== Dlaczego mój kokpit znika, gdy się rozglądam? ====
Prawdopodobnie używasz wersji samolotu z panelem 2D. Upewnij się, że wybrałeś ten z kokpitem 3D. Większość samolotów ma go teraz!

==== Wokół lata mnóstwo innych samolotów ====
FlightGear posiada tak zwany system sztucznego ruchu lotniczego (AI Traffic). System ten generuje sterowane przez komputer samoloty na podstawie prawdziwych planów lotu, aby świat we FlightGear wyglądał bardziej żywo. Aby wyłączyć sztuczny ruch idź do menu "SI" > "Ruch lotniczy oraz scenariusze" i odznacz opcję "Enable AI traffic".

Jeśli natomiast nie widzisz żadnych samolotów poza swoim, rozważ [[AI Traffic|przyczynienie się do dodania ruchu]] w swoim ulubionym miejscu!

==== Samolot ciągle skręca w lewo, nie mogę lecieć prosto! ====
Tak, FlightGear jest prawdziwym symulatorem lotu i modeluje te efekty. Dokładnie tak zachowują się prawdziwe samoloty śmigłowe. Zobacz [[Understanding Propeller Torque and P-Factor|zrozumienie momentu obrotowego śmigła i współczynnika P]].

Sprawdź też rozkład obciążenia samolotu. Spróbuj dodać drugiego pilota o wadze 180 funtów i zobacz, czy efekt zostanie zniwelowany.

== Wkład własny ==

=== W jakim języku napisany jest FlightGear? ===
Głównie C++ z pewną ilością wspierającego kodu C, który jest głównie zawarty w SimGear. Więcej szczegółów na temat użytych języków:
* [https://www.openhub.net/p/flightgear/analyses/latest/languages_summary Moduł FlightGear]
* [https://www.openhub.net/p/simgear/analyses/latest/languages_summary Moduł SimGear]
* [https://www.openhub.net/p/flightgeardata/analyses/latest/languages_summary Dane FlightGeara] (samoloty, dźwięki itp.)

Ponieważ wydajesz się być zainteresowany rozwojem rdzenia, powinieneś naprawdę sprawdzić [[Howto:Start core development]].

=== Jak zaprojektować model dynamiki lotu do nowego samolotu? ===

FlightGear obsługuje różne [[flight dynamics model|modele dynamiki lotu]] (FDM), ale tylko dwa z nich są powszechnie używane:
* [[JSBSim]]: patrz http://jsbsim.sf.net/.
* [[YASim]]: jeśli chcesz pracować z prostszym FDM, spróbuj swoich sił w YASim. Przewodnik dotyczący tworzenia samolotów YASim znajduje się w podstawowym pakiecie FlightGear w pliku <tt>[[$FG_ROOT]]/Docs/README.yasim</tt>.

Zobacz [[Portal:Developer/Aircraft|Portal rozwoju samolotów]].

=== Jak zaprojektować albo zmienić panel? ===
Zobacz plik <tt>[[$FG_ROOT]]/Docs/README.xmlpanel</tt>.

=== Skąd mogę się nauczyć programowania 3D i zaangażować się? ===
Jeśli chciałbyś stworzyć trójwymiarowy kokpit samolotu do FlightGear lub stworzyć budynki, zewnętrzne modele samolotów itp., Twoja pomoc jest bardzo potrzebna. Postaraj się nie przesadzać ze złożonością siatki. Najczęściej używanymi narzędziami są tutaj [[Blender]], [[AC3D]], [[Gimp]].

Jeśli natomiast naprawdę chcesz wejść w programowanie w C++, będziesz musiał kupić sobie dobrą książkę o [[OpenGL]]. Jednak, FlightGear korzysta z biblioteki wysokiego poziomu [[OSG]], wydajnego zestawu narzędzi do grafiki 3D. Aby rozpocząć pracę z kodowaniem 3D w C++, możesz przejrzeć dokumentację OSG i nauczyć się tylko tyle OpenGL, ile będziesz potrzebować.

=== Jak mogę dodać lotnisko? ===

Proces ten obejmuje stworzenie układu lotniska w [[WorldEditor]], przetestowanie go (możesz chcieć wygenerować część scenerii, ale nie jest to obowiązkowe), a następnie, jeśli twoje źródła danych są zgodne z GPL, użycie [[WorldEditor]] do przesłania go do bramki. Lotnisko będzie dostępne w następnej pełnej przebudowie scenerii, chyba że chcesz wygenerować własną scenerię. Więcej na [[Howto:Make an airport]].

=== Czy mogę stworzyć własną scenerię? ===

Tak, choć może to być trudne zadanie. Generowaniem scenerii dla FlightGeara zajmuje się siostrzany projekt [[TerraGear]]. Dobrą wiadomością jest to, że gdy już wszystko ustawisz, jest to dość łatwe (choć może być czasochłonne), a przede wszystkim, że możesz to łatwo udostępnić.

== Problemy ==

=== Błędy sieciowe lub DNS podczas pobierania terenu ===
Jeśli wystąpią błędy sieciowe/DNS, wpisz <code>--prop:/sim/terrasync/http-server=twój-serwer</code> w dodatkowych ustawieniach programu uruchamiającego (np. <code>--prop:/sim/terrasync/http-server=http://flightgear.sourceforge.net/scenery</code>) lub kliknij przycisk „Pokaż więcej” po prawej stronie i wybierz serwer DNS.

Patrz post na forum: [https://forum.flightgear.org/viewtopic.php?p=438783 Network errors occurred]

=== X-y nie działają / są uszkodzone / złe / nie uruchamiają się ===
FlightGear jest bardzo skomplikowanym programem. Jeśli potrzebujesz pomocy w ogólnym użytkowaniu symulatora, znajdziesz ją na [[Portal:User|portalu Użytkownika]] oraz na {{forum link|text=forum FlightGeara}}.

Jeśli Twoim problemem jest zawieszanie się oprogramowania, otrzymujesz błędy itp., rozważ zastosowanie się do wskazówek zawartych na stronie [[Troubleshooting problems|rozwiązywania problemów]].

Niektóre z najczęściej występujących problemów są jednak wymienione poniżej. Jeśli nie możesz rozwiązać problemu samodzielnie i potrzebujesz pomocy kogoś, proszę pamiętaj, że jesteśmy ''wszyscy'' tutaj dla zabawy, deweloperzy również, i że każda pomoc ''jest'' aktem hojności. Więc postaraj się być miły, nawet jeśli problem cię frustruje.

=== Co się stało z panelem, klawiaturą itp.? ===
Problemem jest prawie na pewno to, że Twój pakiet bazowy (FGData) nie jest zsynchronizowany z FlightGearem. Wiele konfigurowalnych części FlightGeara jest zdefiniowanych w plikach [[XML]] zawartych w pakiecie podstawowym.

=== Dlaczego FlightGear działa tak wolno? ===
Jeśli wydaje Ci się, że FlightGear działa zbyt wolno, sprawdź w [[Howto: Improve Framerates]], czy możesz pokombinować z ustawieniami grafiki.

Jeśli wszystko działa skrajnie wolno (np. ~1 klatka na sekundę), być może sprzętowa akceleracja 3D nie jest aktywna. Upewnij się, że masz zainstalowane biblioteki OpenGL i [[Graphics drivers configuration|poprawnie skonfigurowane]] oraz upewnij się, że masz najnowsze sterowniki do swojej karty graficznej. Bądź również świadomy, że niektóre karty graficzne [[Problematic Video Cards|nie są zbyt dobrze wspierane]].

=== Jak sprawdzić liczbę klatek na sekundę? ===

W symulatorze idź do menu "Widok" > "Opcje widoku" i zaznacz tam opcję "Show frame rate".

=== Jak zmienić ustawienia kokpitu 2D? ===

Aby pokazać/ukryć panel 2D użyj kombinacji klawiszy {{Key press|Shift|P}}. Aby wyświetlić/ukryć HUD, naciskaj klawisz {{Key press|Shift|H}}. Możesz też włączyć alternatywny HUD przez naciśnięcie {{Key press|Shift|I}} (naciśnij {{Key press|I}} aby wrócić do domyślnego). Klawiszem {{Key press|Shift|H}} dostosujesz jasność HUD-a.

=== Utknąłem do góry nogami po rozbiciu się? ===

Szybką odpowiedzią jest zresetowanie symulatora, poprzez menu "Plik" > "Zresetuj". To ustawi twój samolot z powrotem w pozycji startowej.

Alternatywnie naciśnij {{Key press|Ctrl|U}} (w domyślnej konfiguracji), aby podnieść samolot o 1000 stóp.

Dla upartych: sztuczka do nauki. Aby wrócić do normalnej (nie odwróconej) pozycji, wznieś się o 500 stóp i obróć się przy użyciu lotek o 180*. Pamiętaj, sterowanie działa odwrotnie gdy jesteś do góry nogami i utrzymuj prędkość!

=== Dlaczego najnowsze wersje niektórych samolotów nie działają w mojej (starszej) wersji FlightGeara? ===
Często rozwój nowych samolotów nadąża za rozwojem kodu FlightGeara. Nowe lub nowo zmodyfikowane samoloty mogą korzystać z plików (takich jak nowe pliki instrumentów) lub funkcji dostępnych tylko w nowszych wersjach FlightGeara. Jeśli utknąłeś w starszej wersji FlightGeara, możesz spróbować pobrać wcześniejszą wersję samolotu z odpowiedniego [[FlightGear_hangars#Official_hangars|oficjalnego hangaru]] FlightGear.

=== Kiedy uruchamiam FlightGear widzę błąd wspominający o "SQLite". Co mam zrobić? ===

Od wersji FlightGear v2.10 (wydanej w lutym 2013) wprowadzono [[navdata cache|pamięć podręczną navdata]], aby poprawić czas uruchamiania FlightGeara. Ta pamięć podręczna to baza danych SQLite, która czasami jest trochę niestabilna. Jeśli baza danych jest uszkodzona, FlightGear nie będzie mógł się uruchomić.

Aby to naprawić musisz po prostu usunąć plik <code>[[$FG_HOME]]/navdata.cache</code>. Przy pierwszym uruchomieniu FlightGeara, po usunięciu pliku, pamięć podręczna navdata zostanie odbudowana. Ponieważ proces ten jest czasochłonny, uruchomienie FlightGeara zajmie więcej czasu.

Niektórzy uciekają się do usunięcia całego katalogu <code>$FG_HOME</code> lub nawet ponownej instalacji FlightGeara. Jednak żadne z nich nie jest potrzebne i może spowodować utratę wszelkich skonfigurowanych niestandardowych preferencji.

Kolejnym wskaźnikiem problemu związanego z SQLite jest komunikat o błędzie:

<tt>
Sqlite error:attempt to write a readonly database (8) while running:
INSERT OR REPLACE INTO stat_cache (path, stamp) VALUES (?,?)
</tt>

W takim przypadku, wcześniej uruchomiona instancja FlightGeara może nadal działać i blokować plik navdata.cache. Sprawdź, czy działa inny proces fgfs i zakończ go.

=== Mój samolot ma szare okna? ===
Problem nieprzejrzystych szarych okien, prze które nie można nic zobaczyć, jest najczęściej spowodowany niezgodnością wersji programu FlightGear i samolotu. Lub może to być spowodowane efektem okna, który nie jest zgodny z systemami renderowania [[Project Rembrandt|Rembrandt]] lub [[ALS]]. Przyczyną techniczną jest niezgodność renderera i zadeklarowanego efektu dla okna. Niektóre rozwiązania obejmują:

* Jeśli używasz stabilnej wersji FlightGeara, pobierz samolot z [[FlightGear_hangars#Official_hangars|oficjalnego hangaru]] pasującego do Twojej wersji FlightGeara.
* Jeśli używasz najnowszej wersji z [[FlightGear Build Server|builda nocnego]] lub [[Building FlightGear|samodzielnie skompilowanej wersji FlightGeara]] lub chcesz używać najnowocześniejszego samolotu, zobacz [[FGAddon#Obtaining aircraft|FGAddon - pozyskiwanie samolotu]].
* Jeśli korzystasz z samolotu z jednego z [[FlightGear_hangars#Unofficial_sites|nieoficjalnych hangarów]], najlepiej skontaktuj się z oryginalnym autorem samolotu lub osobą odpowiedzialną za ten hangar.
* Jeśli używasz [[Project Rembrandt|Rembrandta]], spróbuj wyłączyć ten system renderowania. Samoloty, które używają <code>model-default.eff</code> dla okien (prostym kosztem nierobienia niczego) zamiast <code>model-transparent.eff</code>, <code>model-combined-transparent .eff</code> lub <code>glass.eff</code> (które instruują Rembrandta, aby nie używał odroczonego renderowania dla szyb) będą miały szare okna podczas używania Rembrandta.

=== Mój ekran staje się całkowicie czerwony zaraz po uruchomieniu FlightGear ===
Czerwony ekran to wizualizacja efektu "redout" (napływ krwi do głowy pilota z powodu zbyt dużych przeciążeń). Jeśli pojawia się zaraz po uruchomieniu FlightGeara, może to być spowodowane problemem z ładowaniem scenerii. FlightGear ładuje scenerię w locie, a jeśli scenerii nie można załadować, np. ze względu na problemy z siecią, może nie być podłoża, na którym można zlokalizować statek powietrzny. W rezultacie samolot spada przez nieistniejący grunt, zaczynając się przewracać doprowadzając do nadmiernych przeciążeń. To z kolei powoduje efekt czerwonej planszy. Aby zweryfikować problem, należy rozpocząć lot w KSFO, którego sceneria jest już zawarta w pakiecie podstawowym.

== FAQ ==

=== Z kim się kontaktować w sprawie tego FAQ? ===
Dodaj komentarz na temat FAQ [[Talk:Frequently asked questions|na tej stronie]].

=== Jak stary jest ten dokument? ===
Sprawdź jego <span class="plainlinks">[{{fullurl:{{PAGENAME}}|action=history}} historię]</span>.

=== Jaką inną dokumentację powinienem przeczytać? ===
* [[Pl/Podręcznik_FlightGear|Podręcznik FlightGear]]
* [[Pl/Nowy_w_FlightGear|Nowy we FlightGear]]
* Zobacz także katalog FlightGear/docs-mini/ w dystrybucji źródłowej, aby znaleźć różne inne przydatne dokumenty.

== Wkład własny ==

=== Ochrona treści ===
{{See also|FlightGear Plugins}} DRM
{{Cleanup}}

Co jakiś czas pojawia się pytanie, czy dostarczanie do do FlightGeara zamkniętego kodu źródłowego wtyczki (dokładniej wtyczki czytnika plików OSG) jest legalne. Jedyną potrzebą trzymania kodu w pobliżu jest zapobieganie inżynierii wstecznej.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/27996073/
|title = <nowiki> [Flightgear-devel] Content protection for modders? </nowiki>
|author = <nowiki> Paul Guhl </nowiki>
|date = Aug 25th, 2011
|added = Aug 25th, 2011
|script_version = 0.37
}}</ref><ref>Soitanen (Aug 28th, 2014). {{forum link|title=Re: Encrypted aircraft dynamics|p=217378}}</ref><ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34559749/
|title = <nowiki> [Flightgear-devel] External FDM to protect propriety data in a GPL
eviirenment </nowiki>
|author = <nowiki> Alan Teeder </nowiki>
|date = Oct 21st, 2015
|added = Oct 21st, 2015
|script_version = 0.37
}}</ref>

FlightGear w obecnej postaci jest efektem pracy wielu ludzi, którzy dobrowolnie pracują nad wspólnym wysiłkiem stworzenia otwartej i rozszerzalnej platformy symulatora lotu. Sam Twój pomysł wprowadzenia DRM jest wbrew wszelkim zasadom open source.

Możesz swobodnie stworzyć samolot dla FlightGeara na licencji własnościowej - to są dane z perspektywy symulatora i nie powoduję aktywacji licencji. Możesz to sprzedawać, nie pozwalając na ponowną dystrybucję kodu źródłowego. Musisz trzymać się z dala od kilku rzeczy (nie możesz używać ogólnych instrumentów, bibliotek Nasal,...) ale to powinno być do zrobienia. Możesz pobierać opłaty licencyjne za taki samolot i nikt nie może go redystrybuować.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

dane są analizowane z XML-a do dynamicznych tabel wyszukiwania (IE. STL). Jedynymi zasobami używanymi poza tym, co jest potrzebne do stworzenia funkcji FDM, jest narzut związany z wyciąganiem danych z pliku XML do pamięci. To musiałoby się zdarzyć bez względu na to, w jakiej formie były dane.
Chociaż mogą istnieć lepsze sposoby przechowywania danych niż XML-e, jeśli nie przejmujesz się interakcją człowieka z danymi. Myślę, że uczynienie danych czytelnymi/edytowalnymi dla człowieka jest głównym celem używania XML-i. Może być zbyt gadatliwy, ale działa i istnieją standardowe biblioteki do odczytu/parsowania plików XML, dzięki czemu używanie ich do wprowadzania danych jest dość proste. Jest to korzystne zarówno dla FlightGeara, jak i JSBSim pod względem ograniczenia złożoności obsługi danych konfiguracyjnych. Ponadto istnieje ograniczona liczba standardowych formatów dla tego typu rzeczy, takich jak JSON, a wszystkie te, które są czytelne/edytowalne przez człowieka, mają wiele takich samych problemów jak XML.
W pełni funkcjonalne FDM są złożone, a zrozumienie XML-a używanego do konfiguracji złożonego FDM jest bardzo drobnym problemem, a każdy, kto faktycznie rozumie w pełni funkcjonalny FDM, będzie miał bardzo niewiele problemów z częścią XML.<ref>hvengel (Aug 28th, 2014). {{forum link|title=Re: Encrypted aircraft dynamics|p=217408}}</ref>

FlightGear sam w sobie jest OpenSource, więc niezależnie od tego, w jakim systemie DRM chcemy zakodować dane, każdy może go usunąć (i jest to całkiem legalne). Nie trzeba się zastanawiać, aby wygenerować wersję FlightGear bez ochrony praw autorskich i rozpowszechnić ją, na której Twoja treść działa bez klucza (lub czegokolwiek innego). Biorąc pod uwagę, że ludziom zwykle udaje się złamać schematy DRM przy braku otwartego kodu źródłowego, próba zrobienia tego z kodem źródłowym otwartym dla każdego wydaje się po prostu stratą czasu. Po drugie, jakikolwiek format pliku odczyta OSG, zanim dotrze do renderera, musi być tablicą wierzchołków. Renderer tego potrzebuje, na etapie GLSL nie ma deszyfrowania. Więc są szanse, że skoro działamy na *Open*GL, to znowu każdy, kto naprawdę chce, może wypisać niezaszyfrowany format.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Ponieważ FlightGear jest open source, niezwykle łatwo jest dodać kod, aby uzyskać dostęp do grafu sceny 3D i wyodrębnić pełny model samolotu (z wyłączeniem skryptów, chociaż można je odtworzyć). Informacje po prostu tam siedzą, w pełni widoczne i gotowe do pobrania z gałęzi OSG jak duża soczysta brzoskwinia. Prawdopodobnie mógłbym napisać ten kod w pół dnia, ale konwersja do formatu AC3D, tekstur PNG itp. w celu odtworzenia nowej kopii samolotu zajęłaby trochę więcej czasu. Gdyby FlightGear miał zamknięty kod źródłowy, napisanie kodu ekstraktora OSG byłoby znacznie trudniejsze, ale mimo to nadal wykonalne.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076297/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Edward d'Auvergne </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Właśnie z tego powodu mamy wsparcie dla katalogów i zewnętrznych hangarów. Oczywiście chcemy zachęcać do tworzenia samolotów na licencji GPL, ale nie każdy twórca samolotów chce lub może udostępniać swoje prace na licencji GPL. FlightGear szanuje i wspiera tę opcję.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076199/
|title = <nowiki> Re: [Flightgear-devel] botom line: if i don't my aircraft to be
subject to GPL FGAddon clauses </nowiki>
|author = <nowiki> Stuart Buchanan </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Z pewnością można uruchomić model FDM z zewnątrz i użyć jednej z wielu opcji sieciowych I/O we FlightGear, aby przesyłać dane tam i z powrotem. W przeszłości zrobiono to w kilku projektach badawczych, aby wykorzystać FlightGear jako narzędzie do wizualizacji. Co za tym idzie, możesz zrobić to samo w przypadku skryptów - uruchomić skrypty na zewnątrz i wchodzić w interakcje z FlightGearem za pośrednictwem jednego z tych protokołów.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076187/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Stuart Buchanan </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Jeśli faktycznie spróbujesz pobierać opłatę 100$ za samolot dla FlighGear, nie znajdziesz zbyt wielu klientów, ponieważ FG jest popularny głównie w społeczności OpenSource. Jeśli sprawisz, że będzie to zbyt kłopotliwe za pomocą DRM-ów, być może ktoś spróbuje to obejść dla zasady (ludzie robią to dla sportu) - nie jest łatwo sprawić by wieloplatformowy DRM nie był irytujący dla użytkowników.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Należy pamiętać, że bez względu na format źródłowy (dll, zaszyfrowany + podpisany, binarny itp.), ostatecznie siatka modelu, tekstury i struktura logiczna są wczytywane do wewnętrznych struktur klas OSG. Po zakończeniu tego procesu, aby model mógł zostać wyrenderowany na ekranie, osoba może wywołać odpowiednią funkcję write*File() w celu zapisania poddrzewa modelu w dowolnym obsługiwanym formacie. Jedyne, co jest potrzebne, to dostęp do kodu źródłowego FlightGeara, aby wstawić wywołanie funkcji w strategicznym miejscu. W ostatecznym rozrachunku nie możesz całkowicie chronić swojej treści, jeśli nie masz pełnej kontroli nad sytuacją na poziomie kodu źródłowego aplikacji. I jest to klasyczna strategia hakowania ochrony przed kopiowaniem, wstawiaj magię do kodu po uwierzytelnieniu/załadowaniu/dekodowaniu formatu dystrybucji, a następnie zapisz go w "odszyfrowanym" formacie. Ludzie robią to cały czas, nawet z zastrzeżonym kodem. Wartość celu zwykle określa, jak ciężko są skłonni pracować, aby go ukraść.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074534/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.38
}}</ref>

Dodanie wsparcia dla DRM do FlightGear nie nastąpi - skrypty Nasal są domyślnie dostarczane w formacie zwykłego tekstu (podobnie jak JavaScript), natomiast zaciemnianie jest oczywiście możliwe, jednak nie ma to żadnego sensu w kontekście FlightGear jako projektu otwarto źródłowego.

Ponadto skrypty mogą być łatwo udostępniane i uruchamiane przez użytkowników, po prostu je wymieniając lub kopiując.

Nawet gdybyś zrzucił pośredni kod bajtowy Nasal do pliku obiektowego i wykonał to za pomocą maszyny wirtualnej Nasal, nie byłoby możliwości wyegzekwowania DRM.

Oczywiście, ponieważ FlightGear jest open source, możesz po prostu dodać obsługę DSO/wtyczek do rozwidlenia FlightGear i oprzeć całą swoją pracę na tym rozwidleniu - z drugiej strony, twoje modyfikacje nadal będą musiały być udostępniane.

Istnieje sposób na tworzenie legalnych dodatków z zamkniętym kodem źródłowym: możesz napisać cały "tajny" kod C++ jako zewnętrzną aplikację i pozwolić jej komunikować się z FlightGearem za pośrednictwem gniazd sieciowych. To powinno działać w miarę dobrze. Ale nie oczekuję, że zdobędziesz wielu klientów. Przede wszystkim, przynajmniej w Linuksie, nikt nie chce uruchamiać binarnych blobów, które mogłyby z łatwością wymazać katalog domowy podczas zabawy we FlightGear. A potem dzieje się tyle darmowych samolotów, z dużym rozmachem, że prawdopodobnie zawsze będziesz w tyle. A ci programiści mają bliskie powiązania z (lub są) programistami FlightGeara, więc mają tę zaletę, że mogą w dowolnym momencie zmienić kod FlightGeara według własnych upodobań. Mogą zmieniać interfejs do woli, a ty musisz nadrobić zaległości i zająć się reklamacjami klientów, którzy nagle siadają na zepsutym binarnym blobie, który nie działa z ostatnią wersją FlightGeara. I wreszcie, to podejście do gniazd działa tylko za pośrednictwem systemu właściwości i jest otwarte do wglądu dla każdego (oprócz niedawno dodanej półtajnej właściwości wektora śmieci).

FlightGear nie ma możliwości ładowania samolotów z bibliotek współdzielonych. Możesz rozpowszechniać swój samolot na licencji zastrzeżonej, tak jak robi to Vitos, ale nie jako biblioteka współdzielona. Zmiana we FlightGear, aby mógł ładować samoloty z bibliotek współdzielonych, wymagałaby dużo pracy. Kto miałby to robić i dlaczego ktokolwiek miałby to robić, skoro mógłby poświęcić swój czas na ulepszanie wolnego oprogramowania? I dlaczego główni twórcy FlightGear mieliby akceptować taki wkład?<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073736/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Ludovic Brenta </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Realistycznie patrząc, jeśli chcesz sprzedać komercyjny samolot, twoją bazą klientów będzie Flight Sim X, X-Plane, Prepar3D. Po prostu nie uzyskasz żadnej przyczepności w ekosystemie FlightGear. Nie jest on do tego stworzony.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074166/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> geneb </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Poza tym obsługa języka skryptowego OSG (lua) nie może uzyskać dostępu do wszystkich wewnętrznych funkcji Nasal, po prostu dlatego, że we FlightGear nie zaimplementowano kodu łączącego. Więc nie ma żadnych właściwości dla ciebie i żadnego dostępu do wewnętrznego wywołania funkcji, które zapewnia Nasal.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074133/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Erik Hofman </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Posiadasz prawa autorskie do swojej pracy, nawet jeśli wydasz ją na licencji GPL i możesz dalej rozwijać swoją pracę i wydać bardziej kompletną wersję na licencji komercyjnej, jeśli tylko chcesz (jest to wariant podwójnej licencji). Jedynym sposobem, aby nie zachować praw autorskich do tego, co robisz, jest przeniesienie ich na kogoś innego lub zrzeczenie się ich poprzez udostępnienie swojej pracy jako domeny publicznej. Jeśli stworzysz model 3D dla samolotu FG i nadasz mu licencję GPL, nikt nie zabroni Ci adaptacji i sprzedaży go dla X-Plane. W rzeczywistości możesz go sprzedawać również dla FG (ale inni mogą go redystrybuować, jak im się podoba, gdy go kupią, ponieważ jest to GPL, więc może to nie być zbyt opłacalny model biznesowy).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073832/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Czy inne symulatory oferują szyfrowanie lub ochronę zawartości? Na przykład udało mi się zlokalizować i przetestować wtyczkę blendera, która może otworzyć wiele modeli samolotów MSFS. A jak z X-Plane? Minął *długi*, *długi* czas, odkąd majstrowałem przy ich pakiecie, ale w tamtym czasie zwracałem uwagę, że wszystkie ich formaty 3D były otwarte i dobrze zdefiniowane. Często komercyjne symulatory przechowują rzeczy we własnych formatach binarnych, ale w większości przypadków nie są one zaszyfrowane, a użytkownicy końcowi dość szybko je odszyfrowują -- więc mogą edytować lub tworzyć nową zawartość w tym samym formacie. Nie uważałbym formatu binarnego za schemat ochrony treści, zwłaszcza w projekcie typu open source, w którym źródło do ładowania i przechowywania formatu binarnego jest łatwo dostępne. Rozumiem pragnienie twórców treści, aby nie dać się „oszukać”. Ale zrozum też, że jednym z głównych powodów, dla których FlightGear może odnieść sukces, jest to, że cały kod źródłowy i zawartość są otwarte. Gdybyśmy nie otworzyli wszystkiego, nie otrzymalibyśmy prawie takiej samej liczby datków wolontariuszy, a wysokiej jakości wolontariat jest kluczowym powodem, dla którego FlightGear odniósł taki sukces. Gdybyśmy byli zamkniętą organizacją komercyjną, kto chciałby się włączyć i pomóc komuś innemu zarabiać pieniądze? Ale gdy wszystko jest otwarte, wiesz, że wszyscy inni mogą cieszyć się takim samym wkładem, tak samo jak Ty cieszysz się wkładem wszystkich innych. Istnieje kilka oszustów, którzy próbują zarobić na pracy innych ludzi i chętnie kłamią i wprowadzają w błąd, aby wyłudzić jak najwięcej pieniędzy od niczego niepodejrzewających użytkowników końcowych. Prawda jest taka, że ci ludzie zawsze istnieli i zawsze będą istnieć. Są niezwykle skrupulatni i uporczywi w kopiowaniu rzeczy, posuwają się nawet do łamania schematów ochrony przed kopiowaniem, przeprowadzania inżynierii wstecznej projektów sprzętu, kopiowania dokładnego wyglądu produktów (nawet łącznie z logo). To nie jest problem, który jest unikalny dla projektu FlightGear -- i jest to coś, z czym wciąż byśmy się borykali, bez względu na to, jak ciężko pracowaliśmy nad stworzeniem schematów ochrony przed kopiowaniem. Jeśli zaprojektowałeś format zawartości binarnej, ktoś dokona inżynierii wstecznej. Jeśli zaprojektujesz schemat szyfrowania, ktoś po prostu zmodyfikuje kod symulatora, aby zrzucić odszyfrowaną wersję po załadowaniu jej do pamięci przez zastrzeżoną wtyczkę deszyfrującą (o ile nie złamie schematu szyfrowania lub nie ukradnie kluczy szyfrowania). We wszystkich tych przypadkach zawartość nadal można łatwo kopiować, replikować, sprzedawać itp. Najlepszy schemat, jaki widziałem, to taki, który ma klucz blokady węzła, który będzie działał tylko na jednym komputerze (klucz przypisany do adresu mac lub identyfikatora procesora). Oznacza to jednak bardziej skomplikowaną dwuetapową instalację, w której użytkownik musi wrócić do Ciebie po zainstalowaniu produktu, zgłosić swój unikalny identyfikator, uzyskać klucz, a następnie zainstalować ten klucz, zanim będzie mógł działać. Problem z tym wszystkim polega na tym, że w projekcie open source ktoś może po prostu skompilować nową wersję symulatora, która pomija sprawdzanie klucza lub akceptuje trywialny klucz lub dowolny klucz. Zastanawiam się tutaj nad różnymi możliwościami, ale mam nadzieję, że widzisz, że to, co na pierwszy rzut oka wydaje się prostą prośbą, w rzeczywistości jest dość złożone i w dalszym ciągu powoduje różnego rodzaju problemy (zarówno pod względem technicznym, jak i ze wsparciem użytkowników). Ostatecznie złoczyńcy i tak zazwyczaj znajdują obejścia i nie są zbytnio spowalniani. Kiedy rolnicy uprawiają rośliny, muszą znosić chwasty. Możemy spróbować rozsądnych rzeczy, aby zminimalizować chwasty, ale jeśli jesteś zbyt agresywny w zabijaniu chwastów i nie tolerujesz ani jednego, najprawdopodobniej zabijesz również większość swoich upraw. Dlatego uważam, że jest to coś, z czym musimy się po prostu pogodzić. Możemy spróbować podjąć rozsądne kroki, aby zminimalizować problem, ale nie możemy wyeliminować wszystkich złych osób bez szkody dla wszystkich dobrych rzeczy w naszym projekcie.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/27998023/
|title = <nowiki> Re: [Flightgear-devel] Content protection for modders? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Aug 25th, 2011
|added = Aug 25th, 2011
|script_version = 0.37
}}</ref>

Kiedy już rozpowszechniłeś kod źródłowy na licencji GPL, wyraźnie zadeklarowałeś, że każdy ma prawo do redystrybucji i modyfikacji - o ile nie rozpowszechnia go na innej licencji. Ale ty, jako właściciel praw autorskich, możesz zmienić licencję dla nowej wersji kodu, której jeszcze nie rozpowszechniałeś na licencji GPL - o ile modyfikacje te nie zostały dokonane przez innych, tj. Ty, jako jedyny posiadacz praw autorskich, możesz również rozpowszechniać go na kilku licencjach jednocześnie, np. GPL i niektórych licencjach własnościowych (czyniąc go wartym pieniędzy, które ludzie mogą za niego zapłacić, dzięki szybszym poprawkom błędów, dystrybuowanym tylko do płacących klientów itp.).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073990/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Jens Thoms Toerring </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Inną rzeczą do rozważenia jest to, że dystrybucja Twojego statku powietrznego jako .dll lub .so nie ukryła by ani nie zaciemniła by Twojego kodu i tekstur po załadowaniu ich do struktur symulatora w celu renderowania. Reszta FlightGeara jest open source, więc wstawienie wywołania funkcji OSG, aby zapisać samolot (modele i tekstury) w innym popularnym formacie 3D, nie wymagałoby wiele wysiłku. Spowodowałoby to pewne straty w zakresie organizacji plików źródłowych, ale mimo to dałoby miejsce startu komuś, kto zamierza skopiować lub zmodyfikować pracę. Cała konfiguracja XML także powinna być dostępna za darmo w drzewie właściwości. Licencjonowanie Nasal (jak sądzę) jest napisane w sposób, który utrudnia dystrybucję zastrzeżonego kodu Nasal. Zatem stworzenie samolotu dla FlightGear zabezpieczonego przed modyfikacjami, nie mówiąc już o kopiowaniu, wiązałoby się z pewnymi naprawdę poważnymi wyzwaniami.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073896/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Kluczem do projektu open source nie jest to, czy możesz wygrać spór prawny, czy nie. Chodzi raczej o to, aby przede wszystkim unikać wszelkich sporów prawnych i to za wszelką cenę. To znaczy trzymać się z dala od sądu. Aby bezpiecznie użyć czegoś takiego w projekcie open source, sugerowałbym coś w następujący sposób:
* Upublicznienie swojego produktu pochodnego w całości (ale bez licencji, mówiąc, że jest to materiał chroniony prawem autorskim),
* Zwrócenie się do właścicieli oryginalnego produktu i przekazanie im linku do produktu pochodnego,
* Poproszenie ich o publiczne oświadczenie, że produkt pochodny może być licencjonowany przy użyciu licencji „GPLv2 lub nowszej wersji”,
* Pamiętaj, aby poprosić ich o zidentyfikowanie publicznego produktu pochodnego jako łącza i zidentyfikowanie wszystkich jego części (aby uniknąć późniejszego stwierdzenia, że umieściłeś fragmenty chronionego materiału).

Kopię zapasową każdego oświadczenia złożonego w sieci można znaleźć w archiwum internetowym (http://web.archive.org/). Aby uprościć ten proces, możesz sporządzić część oświadczenia opisującą w całości produkt pochodny, ze wszystkimi szczegółami. Dzięki temu nie będzie już żadnych odcieni szarości! Jeśli chętnie to zrobią, to z prawnego punktu widzenia nie będzie problemu z ich użyciem (tj. szara sytuacja zmieniła się w białą). Jeśli nie są zadowoleni z Twojej propozycji, pewnego dnia mogą odwrócić się i pozwać (tj. szara sytuacja zmieniła się w czystą czerń).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34561220/
|title = <nowiki> Re: [Flightgear-devel] External FDM to protect propriety data in a
GPL eviirenment </nowiki>
|author = <nowiki> Edward d'Auvergne </nowiki>
|date = Oct 22nd, 2015
|added = Oct 22nd, 2015
|script_version = 0.37
}}</ref>

Świat open source zależy od warunków licencji i praw autorskich oraz współpracy i zaufania w celu ochrony naszej pracy. Znosimy niewielki podzbiór ludzi, którzy chcą nadużywać tych warunków i mamy nadzieję, że presja większej grupy utrzyma złych aktorów w ryzach. Czasami istnieje środek prawny, czasami trudno jest coś z tym zrobić, gdy problemy wykraczają poza granice kraju (lub gdy ktoś po prostu chce złamać zasady dla własnych korzyści). Mam jednak wrażenie, że na dłuższą metę większość ludzi jest uczciwa i chce postępować właściwie, a mała grupa, która naprawdę istnieje, aby powodować problemy lub po prostu służyć sobie kosztem innych, nigdy nie przetrwa tak długo, jak większa grupa ludzi o dobrych intencjach. Ostatecznie musisz samodzielnie określić, ile wysiłku włożyłeś w model, ile pieniędzy możesz zarobić na jego sprzedaży, w porównaniu z ryzykiem, że ktoś go sam skopiuje i rozpowszechni, w porównaniu z kosztami prawnymi, aby spróbować ich powstrzymać.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074534/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.38
}}</ref>

=== Obejścia DRM ===

W jednym z moich poprzednich projektów miałem do czynienia z autorskim modelem dynamiki lotu. Początkowo korzystałem z interfejsu Ethernet, aby mógł działać jako zewnętrzna samodzielna aplikacja. Potem przełączyłem się na dwukierunkowy układ potoków uniksowych, więc mogłem mieć ściślejszą synchronizację z kolejnością wykonania, ale nadal zewnętrzny program był całkowicie niezależny i samodzielny. Chciałbym, aby wszystko było darmowe i otwarte, ale w tym przypadku nie miałem wyboru i było to coś zakupionego od firmy zewnętrznej na surowych warunkach. Czułem, że dwa niezależne, samowystarczalne programy (które mogą ze sobą rozmawiać i wymieniać informacje) stworzyły wystarczającą separację licencji, aby honorować warunki licencji GPL FlightGeara.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34559783/
|title = <nowiki> Re: [Flightgear-devel] External FDM to protect propriety data in a
GPL eviirenment </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Oct 21st, 2015
|added = Oct 21st, 2015
|script_version = 0.37
}}</ref>

Na ile to jest warte, FDM „ExternalPipe” został skonfigurowany tak, aby obejmował większość obszarów, których dotknąłeś. Prawdopodobnie nie jest to dokładnie to, czego chcesz, ale oto trochę mojej logiki w tym, jak/dlaczego skonfigurowałem to tak, jak to zrobiłem:
* Korzystanie z interfejsu sieciowego dodaje trochę indeterminizmu. Czasami pakiety sieciowe są opóźniane lub układają się w stos w zależności od tego, co dzieje się z maszyną, więc nie ma gwarantowanej relacji między symulatorem a dynamiką lotu.
* Zwykle interfejs sieciowy jest dobry, ale zaobserwowałem czasy, kiedy pakiety docierały tam, gdzie powinny, z dodatkowymi opóźnieniami.
* Alternatywnie ustawiam parę „nazwanych potoków”. Potoki są konstrukcją uniksową, dla programu wyglądają jak plik, ale to, co do nich zapisujesz, jest gromadzone i przechowywane do odczytania przez inną aplikację. Niestety nie są one obsługiwane w systemie Windows. Potoki są jednokierunkowe, stąd potrzeba dwóch do komunikacji dwukierunkowej. Potok jest naprawdę prosty: otwierasz go jak każdy inny plik, a jeden proces zapisuje w nim; odczytuje z niego inny proces. W międzyczasie system operacyjny może buforować pewną ilość informacji, dopóki proces odczytujący ich nie złapie. Możesz użyć blokowania odczytów (ostrożnie z tym), aby mieć pewność, że FlightGear i zewnętrzny FDM działają dokładnie tak samo.
* Potoki oznaczają, że oba procesy będą działać na tej samej maszynie, interfejs sieciowy pozwoliłby procesom działać na oddzielnych maszynach.
* Interfejs ExternalPipe obsługuje elastyczny interfejs właściwości, więc zewnętrzny proces FDM może wysyłać dowolne pary nazwa/wartość, które chce wysłać, a interfejs sumiennie skopiuje je do drzewa właściwości FlightGeara. Strona FDM może również wysłać listę nazw właściwości, które chciałaby otrzymać w odpowiedzi, a interfejs będzie sumiennie przesyłał je potokiem wychodzącym w każdej klatce. To był miły dodatek, a nazwane potoki mają dużą przepustowość, aby zrobić to czystym tekstem, nawet z wieloma dodatkowymi wartościami właściwości.

Historia: Użyłem tego jako części projektu, który zrobiłem z symulatorem lotu ATC. Mieli własne, zastrzeżone aplikacje do dynamiki lotu, które modelowały konkretny statek powietrzny w samym kodzie. Modele te posiadały całą niezbędną dokumentację źródłową i dane z testów w locie, aby spełnić wymagania testowe certyfikacyjne FAA dotyczące ostatecznego symulatora. Ponadto ten zewnętrzny kod modelował wiele systemów samolotu dla jednej z ich wysokiej klasy symulacji. Wymagało to elastyczności w zakresie wysyłanych tam i z powrotem wartości i umożliwiło mi sterowanie niektórymi wskaźnikami przyrządów bezpośrednio z kodu zewnętrznego.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/31900851/
|title = <nowiki> Re: [Flightgear-devel] Feeding FlightGear data through the Protocol
Pipe </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Jan 29th, 2014
|added = Jan 29th, 2014
|script_version = 0.37
}}</ref>

[[Category:FlightGear]]

[[de:FAQ]]
[[en:Frequently asked questions]]
[[es:Preguntas frecuentes]]
[[fr:Foire aux questions]]
[[it:Domande frequenti]]
[[ja:FAQ]]
[[nl:veel gestelde vragen]]
[[pt:FAQ]]
[[pt-br:Perguntas_frequentes]]
[[sr:FAQ]]

Pl/FAQ

2026-04-30T17:14:09Z

PlayeRom: /* Błędy sieciowe lub DNS podczas pobierania terenu */

Dziękujemy za zainteresowanie [[FlightGear]]! Ten ''FAQ'' zawiera listę najczęściej zadawanych pytań. Jeśli nie możesz znaleźć odpowiedzi na swój problem, proszę utworzyć temat na {{forum link|text=naszym forum}}.

== Dystrybucja ==

=== Skąd wziąć FlightGear? ===
Oficjalną stroną pobierania jest: {{project infrastructure|website|link=no|urn=download/}}. Znajdziesz tam wersje binarne dla Windows, macOS oraz Linux (AppImage). W większości dystrybucji Linuxa, FlightGear można pobrać bezpośrednio z repozytoriów danej dystrybucji. Szukaj w "Centrum/Menedżer oprogramowania" Twojej dystrybucji.

=== Jak zainstalować FlightGeara na Linuksie? ===
Wiele dystrybucji zawiera FlightGear w swoich repozytoriach. Ponadto w {{project infrastructure|website|urn=download/|text=Centrum Pobierania}} znajdziesz też wersję skompilowaną do AppImage, którą uruchomisz na niemal każdej współczesnej dystrybucji. Jeśli nie możesz znaleźć wersji pakietowej dla siebie, rozważ pobranie i [[Building FlightGear - Linux|kompilację z kodów źródłowych]].

=== Gdzie mogę znaleźć najnowszy kod źródłowy? ===
Najnowszy kod źródłowy jest dostępny dla każdego za pośrednictwem naszego [[FlightGear Git|repozytorium Git]].

=== Gdzie mogę latać i skąd wziąć scenerie? ===
Latać można wszędzie, po całym świecie. Scenerie można pobrać na wiele sposobów. Obecnie najlepszą opcją jest automatyczne pobieranie scenerii w zależności od tego gdzie się znajdujesz. Służy do tego program TerraSync. Aby go włączyć wystarczy w Launcherze wejść do "Ustawienia" -> "Pobieranie" i tam zaznaczyć opcję "Automatycznie pobieraj scenerię".

Można także pobrać większe rejony świata ręcznie, ze strony {{project infrastructure|website|urn=download/scenery|text=Pobieranie Scenerii}}

=== Gdzie mogę zdobyć dodatkowe samoloty? ===
Najnowsze, oficjalne samoloty można pobrać i zainstalować jednym kliknięciem w zakładce samolotów w Launcherze (patrz [[FlightGear Qt launcher|FlightGear Qt Launcher]]).

Możesz także zajrzeć na oficjalną stronę {{project infrastructure|website|urn=download/download-aircraft/|text=Pobierania Samolotów}}.

Inne samoloty w fazie rozwoju możesz znaleźć w oficjalnym repozytorium samolotów [[FGAddon]], a inne w hangarach FlightGear osób trzecich (patrz także [[Pl/Instalowanie_samolotów|Jak zainstalować samoloty]]).

=== Dlaczego samoloty na FlightGear.org są nieaktualne? ===
Samoloty z oficjalnej {{project infrastructure|website|urn=download/|text=strony pobierania}} są aktualizowane tylko w momencie wydania nowej wersji FlightGeara. Dzieje się tak, ponieważ samoloty, które są obecnie w fazie rozwoju, są zwykle opracowywane dla rozwojowych/nieopublikowanych wersji FlightGeara. Te wersje rozwojowe mają wiele funkcji, które nie są obsługiwane przez starszą, stabilną wersję. Gdybyśmy częściej aktualizowali pobierane samoloty, większość samolotów nie działałaby w stabilnej wersji FlightGeara.

=== Jak aktualne są dane we FlightGear w porównaniu z rzeczywistością? ===
Korzystamy z tych samych danych nawigacyjnych i baz lotnisk co X-Plane. Aktualne bazy danych można znaleźć w folderach [[$FG ROOT]]/Navaids/ and [[$FG ROOT]]/Airports/.

=== Dlaczego nie pobieracie za to pieniędzy? ===
FlightGear można pobrać bezpłatnie z wielu miejsc, w tym ze strony internetowej FlightGear, ale można go również kupić na płycie CD/DVD. Chociaż oferujemy tę usługę (zobacz oficjalną stronę internetową), zachęcamy inne grupy do redystrybucji dla swoich użytkowników, zwłaszcza w ramach dystrybucji systemu operacyjnego, która sprawia, że instalacja jest jeszcze szybsza i łatwiejsza dla nowych użytkowników.

Czasami możesz znaleźć ofertę kupna FlightGeara na portalach aukcyjnych lub komercyjnych stronach internetowych pod inną nazwą. Można to zrobić całkiem legalnie, o ile warunki licencji są przestrzegane i może być warte kosztów, jeśli uwzględnione zostaną niektóre funkcje o wartości dodanej, takie jak dodatkowa sceneria, samolot lub wsparcie posprzedażowe. Niestety, większość przypadków obserwowanych do tej pory wydaje się być po prostu próbą zarobienia pieniędzy na sprzedaży czegoś, co jest bezpłatne i nie zapewnia prawdziwej wartości dodanej.

=== Jak mogę zacząć korzystać z FlightGear? ===
FlightGear można pobrać z {{project infrastructure|website|urn=download/|text=Download Central}}. Po uruchomieniu Launchera, możesz doinstalować tam samoloty z oficjalnego hangaru. Włączając automatyczne pobieranie scenerii, FlightGear sam zadba o scenerię. Uważaj na wymagania systemowe! Sprawdź też [[Pl/Nowy we FlightGear|Nowy we FlightGear]].

== Kompilacja ==
=== Jak skompilować FlightGear z kodów źródłowych? ===
Zobacz [[Building Flightgear|Budowanie FlightGear]]. Istnieją wyjaśnienia dla kompilacji pod Window, Linuks, a nawet skrypty do automatycznego pobrania i kompilowania całości.

=== Dlaczego FlightGear się nie kompiluje? ===

To zależy. Po pierwsze upewnij się że używasz odpowiednich wersji FlightGear, [[SimGear]], plib, zlib. Jeśli którykolwiek z pakietów nie pasuje (wersją) do innych, kompilacja może się nie udać.

Upewnij się też czy masz implementację OpenGL ze wsparciem glut'a z odpowiednimi plikami nagłówkowymi. Użytkownicy Linuksa posiadający karty nVidia powinni się sprawdzić, czy mają najnowsze sterowniki. Inni posiadacze Linuks powinni mieć bibliotekę Mesa3d (http://mesa3d.org/). Sprawdź też czy masz dobrze zainstalowany i skonfigurowany serwer X-ów.

Jeśli dalej masz problemy, zapytaj na {{forum link|text=FlightGear forum}}, na [[IRC]] lub zapisz się na naszą [[mailing list|listę mailingową]] FlightGear-Users i daj nam znać, jaki masz problem.

=== Czym jest SimGear i dlaczego go potrzebuję? ===
[[SimGear]] jest biblioteką kodu pomocniczego. SimGear jest potrzebny tylko wtedy, gdy planujesz skompilować FlightGear - nie jest potrzebny do uruchamiania prekompilowanych binariów. Więcej informacji znajdziesz na stronie http://www.simgear.org/. Uwaga: Podczas kompilacji FlightGeara bardzo ważne jest posiadanie pasującej wersji SimGeara.

== Konfiguracja i uruchomienie ==

=== Jak uruchomić FlightGear? ===
Najprostszym sposobem jest użycie [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz go uruchomić z terminala używając [[Pl/Opcje_wiersza_poleceń|opcji wiersza poleceń]].

=== Jak zainstalować nowe scenerie? ===

Jeśli naprawdę nie chcesz/nie możesz używać [[Terrasync]], pliki archiwum scenerii (np. w100n30.tar.gz) powinny zostać rozpakowane do katalogu Scenery/Terrain w Twoim [[$FG_ROOT]]. Więcej na [[Pl/Instalowanie_scenerii|Instalowanie scenerii]].

=== Jak skonfigurować mój joystick? ===

FlightGear obsługuje wiele joysticków/wolantów od razu po podłączeniu. Jeśli jednak masz problemy, zobacz [[Input device|Urządzenie wejściowe]].

=== W jakim formacie powinien być mój osobisty plik .fgfsrc? ===

Twój plik .fgfsrc powinien po prostu być listą [[Pl/Opcje_wiersza_poleceń|opcji wiersza poleceń]], z każdą opcją w osobnej linii. Plik ten nie jest plikiem XML.

Jeśli wolałbyś korzystać z plików konfiguracyjnych XML mógłbyś dodać coś takiego do pliku .fgfsrc lub do wiersza poleceń:

--config=/ścieżka/do/pliku.xml

Prawie każda opcja odpowiada właściwości, więc możesz wybrać metodę która Ci najlepiej odpowiada.

=== Jak dostać się do opcji, pomocy itp.? ===
Prawdopodobnie nie widzisz głównego menu. Aby je wyświetlić naciśnij {{Key press|F10}}.

== Latanie ==

=== Jak uruchomić silnik/i? ===
Samoloty różnią się w swoich procedurach startowych. Niektóre mogą mieć sekwencję automatycznego startu lub instrukcje w menu pomocy samolotu (naciśnij klawisz {{key press|?}}) i/lub na stronie Wiki o [[Aircraft|statkach powietrznych]]. Zapoznaj się z [[Pl/Podręcznik_FlightGear|Podręcznikiem FlightGear]] lub zobacz [[Pl/Nowy_w_FlightGear#Uruchamianie_silnika|szybki przewodnik]].

=== Gdzie jest przesuwana mapa? ===
W symulatorze można wejść w menu "Wyposażenie > [[Map|Mapa]]", ale nie jest to mapa lotnicza. Popularna ruchoma mapa jest dostępne w ramach osobnego projektu o nazwie Atlas. Jest również [[MPmap]] - mapa online dla multiplayer.

Jeśli lubisz alternatywę dla Atlasa z uaktualnioną grafiką i mapami dostarczanymi przez projekt OpenStreetMap, to sprawdź [[Phi#Map|Phi]] lub [[JMapView]].

=== Gdzie mogę się nauczyć latania według wskazań przyrządów i nawigacji? ===
Jest dobry artykuł [[Understanding navigation]] oraz jest to bardzo dobrze wyjaśnione w [[Pl/Podręcznik_FlightGear|Podręczniku FlightGear]]. Inne zasoby to:
* [http://www.av8n.com/how/ See How It Flies] - bardzo dobra książka autorstwa Johna S. Denkera, dostępna online.

=== Jaka jest różnica między lotką a sterem kierunku? ===
W tej samej książce jest trochę informacji o lotkach i sterze kierunku.

=== Czy FlightGear wspiera multiplayer? ===
Oczywiście. Zobacz [[Howto: Multiplayer]]. Zarówno wersje Windowsowe jak i Unixowe obsługują tryb wieloosobowy na serwerach FlightGear. Również komunikacja głosowa jest obsługiwana dzięki [[FGCom]].

Mapa pokazująca samoloty graczy online w czasie rzeczywistym jest dostępna jako [[MPmap]].

=== Gdzie są najlepsze miejsca do latania w FlightGear? ===
Sceneria FlightGear obejmuje cały świat, ale dzięki społeczności użytkowników FlightGear, niektóre lotniska i obszary są bardziej szczegółowe niż inne:
* W okolicach Paryża we Francji jest wiele wysokiej jakości modeli scenerii.
* EHAM Amsterdam Schiphol, EGK Londyn Gatwick i LFPG Paryż Charles de Gaulle są jednymi z najwyższej jakości lotnisk.
* LOWI Innsbruck jest zarówno rozwinięty w scenerii jak i na lotnisku.
* TNCM St. Maarten jest popularnym celem podróży, a okoliczne wyspy (Anguilla, St. Eustatius, Saba, St. Barthélemy, St. Kitts i Nevis) są dobrze wymodelowane.

Ponadto zobacz [[Suggested Flights|sugerowane loty]], [[Suggested Airports|sugerowane lotniska]] i [[Suggested custom scenery|sugerowane scenerie niestandardowe]].

=== Gdzie mogę znaleźć informacje o lotniskach i mapy lotnicze online? ===
Lotniska:
* [http://www.airnav.com/airports/ AirNav.com]

Mapy:
* [http://skyvector.com/ SkyVector.com]

Zobacz także [[Getting aeronautical charts|pozyskanie map lotniczych]].

=== Czy we FlightGear jest możliwość prowadzenia działań militarnych np. prowadzenia walk powietrznych lub zrzucania bomb? ===
Tak. Sprawdź dodatek [[Bombable]] i {{forum link|t=5742|title=Bombable}}. Istnieją również scenariusze bombardowania dla [[A-10]] i innych samolotów z uzbrojeniem, jak [[North American OV-10A Bronco]], [[General Dynamics F-16]] i [[F-117 Nighthawk]].

=== Problemy z lataniem ===

==== Dlaczego moje powierzchnie sterowe wracają do określonej pozycji? ====
Jest kilka możliwości, które mogą do tego doprowadzać:
* Jeśli [[autopilot]] twojego samolotu jest włączony, przejmie on (część) twoich elementów sterujących. Wyłącz autopilota, aby odzyskać kontrolę.
* Niektóre laptopy mają wbudowany czujnik grawitacji, który może zostać wykryty jako [[joystick]]. Zobacz jak to rozwiązać na [[Troubleshooting input devices#Controls returning to a particular position|Rozwiązywanie problemów z urządzeniami wejściowymi]].

==== Dlaczego mój kokpit znika, gdy się rozglądam? ====
Prawdopodobnie używasz wersji samolotu z panelem 2D. Upewnij się, że wybrałeś ten z kokpitem 3D. Większość samolotów ma go teraz!

==== Wokół lata mnóstwo innych samolotów ====
FlightGear posiada tak zwany system sztucznego ruchu lotniczego (AI Traffic). System ten generuje sterowane przez komputer samoloty na podstawie prawdziwych planów lotu, aby świat we FlightGear wyglądał bardziej żywo. Aby wyłączyć sztuczny ruch idź do menu "SI" > "Ruch lotniczy oraz scenariusze" i odznacz opcję "Enable AI traffic".

Jeśli natomiast nie widzisz żadnych samolotów poza swoim, rozważ [[AI Traffic|przyczynienie się do dodania ruchu]] w swoim ulubionym miejscu!

==== Samolot ciągle skręca w lewo, nie mogę lecieć prosto! ====
Tak, FlightGear jest prawdziwym symulatorem lotu i modeluje te efekty. Dokładnie tak zachowują się prawdziwe samoloty śmigłowe. Zobacz [[Understanding Propeller Torque and P-Factor|zrozumienie momentu obrotowego śmigła i współczynnika P]].

Sprawdź też rozkład obciążenia samolotu. Spróbuj dodać drugiego pilota o wadze 180 funtów i zobacz, czy efekt zostanie zniwelowany.

== Wkład własny ==

=== W jakim języku napisany jest FlightGear? ===
Głównie C++ z pewną ilością wspierającego kodu C, który jest głównie zawarty w SimGear. Więcej szczegółów na temat użytych języków:
* [https://www.openhub.net/p/flightgear/analyses/latest/languages_summary Moduł FlightGear]
* [https://www.openhub.net/p/simgear/analyses/latest/languages_summary Moduł SimGear]
* [https://www.openhub.net/p/flightgeardata/analyses/latest/languages_summary Dane FlightGeara] (samoloty, dźwięki itp.)

Ponieważ wydajesz się być zainteresowany rozwojem rdzenia, powinieneś naprawdę sprawdzić [[Howto:Start core development]].

=== Jak zaprojektować model dynamiki lotu do nowego samolotu? ===

FlightGear obsługuje różne [[flight dynamics model|modele dynamiki lotu]] (FDM), ale tylko dwa z nich są powszechnie używane:
* [[JSBSim]]: patrz http://jsbsim.sf.net/.
* [[YASim]]: jeśli chcesz pracować z prostszym FDM, spróbuj swoich sił w YASim. Przewodnik dotyczący tworzenia samolotów YASim znajduje się w podstawowym pakiecie FlightGear w pliku <tt>[[$FG_ROOT]]/Docs/README.yasim</tt>.

Zobacz [[Portal:Developer/Aircraft|Portal rozwoju samolotów]].

=== Jak zaprojektować albo zmienić panel? ===
Zobacz plik <tt>[[$FG_ROOT]]/Docs/README.xmlpanel</tt>.

=== Skąd mogę się nauczyć programowania 3D i zaangażować się? ===
Jeśli chciałbyś stworzyć trójwymiarowy kokpit samolotu do FlightGear lub stworzyć budynki, zewnętrzne modele samolotów itp., Twoja pomoc jest bardzo potrzebna. Postaraj się nie przesadzać ze złożonością siatki. Najczęściej używanymi narzędziami są tutaj [[Blender]], [[AC3D]], [[Gimp]].

Jeśli natomiast naprawdę chcesz wejść w programowanie w C++, będziesz musiał kupić sobie dobrą książkę o [[OpenGL]]. Jednak, FlightGear korzysta z biblioteki wysokiego poziomu [[OSG]], wydajnego zestawu narzędzi do grafiki 3D. Aby rozpocząć pracę z kodowaniem 3D w C++, możesz przejrzeć dokumentację OSG i nauczyć się tylko tyle OpenGL, ile będziesz potrzebować.

=== Jak mogę dodać lotnisko? ===

Proces ten obejmuje stworzenie układu lotniska w [[WorldEditor]], przetestowanie go (możesz chcieć wygenerować część scenerii, ale nie jest to obowiązkowe), a następnie, jeśli twoje źródła danych są zgodne z GPL, użycie [[WorldEditor]] do przesłania go do bramki. Lotnisko będzie dostępne w następnej pełnej przebudowie scenerii, chyba że chcesz wygenerować własną scenerię. Więcej na [[Howto:Make an airport]].

=== Czy mogę stworzyć własną scenerię? ===

Tak, choć może to być trudne zadanie. Generowaniem scenerii dla FlightGeara zajmuje się siostrzany projekt [[TerraGear]]. Dobrą wiadomością jest to, że gdy już wszystko ustawisz, jest to dość łatwe (choć może być czasochłonne), a przede wszystkim, że możesz to łatwo udostępnić.

== Problemy ==

=== Błędy sieciowe lub DNS podczas pobierania terenu ===
Jeśli wystąpią błędy sieciowe/DNS, wpisz <code>--prop:/sim/terrasync/http-server=twój-serwer</code> w dodatkowych ustawieniach programu uruchamiającego (np. <code>--prop:/sim/terrasync/http-server=http://flightgear.sourceforge.net/scenery</code>) lub kliknij przycisk „Pokaż więcej” po prawej stronie i wybierz serwer DNS.

Patrz post na forum: [https://forum.flightgear.org/viewtopic.php?p=438783 Network errors occurred]

=== X-y nie działają / są uszkodzone / złe / nie uruchamiają się ===
FlightGear jest bardzo skomplikowanym programem. Jeśli potrzebujesz pomocy w ogólnym użytkowaniu symulatora, znajdziesz ją na [[Portal:User|portalu Użytkownika]] oraz na {{forum link|text=forum FlightGeara}}.

Jeśli Twoim problemem jest zawieszanie się oprogramowania, otrzymujesz błędy itp., rozważ zastosowanie się do wskazówek zawartych na stronie [[Troubleshooting problems|rozwiązywania problemów]].

Niektóre z najczęściej występujących problemów są jednak wymienione poniżej. Jeśli nie możesz rozwiązać problemu samodzielnie i potrzebujesz pomocy kogoś, proszę pamiętaj, że jesteśmy ''wszyscy'' tutaj dla zabawy, deweloperzy również, i że każda pomoc ''jest'' aktem hojności. Więc postaraj się być miły, nawet jeśli problem cię frustruje.

=== Co się stało z panelem, klawiaturą itp.? ===
Problemem jest prawie na pewno to, że Twój pakiet bazowy (FGData) nie jest zsynchronizowany z FlightGearem. Wiele konfigurowalnych części FlightGeara jest zdefiniowanych w plikach [[XML]] zawartych w pakiecie podstawowym.

=== Dlaczego FlightGear działa tak wolno? ===
Jeśli wydaje Ci się, że FlightGear działa zbyt wolno, sprawdź w [[Howto: Improve Framerates]], czy możesz pokombinować z ustawieniami grafiki.

Jeśli wszystko działa skrajnie wolno (np. ~1 klatka na sekundę), być może sprzętowa akceleracja 3D nie jest aktywna. Upewnij się, że masz zainstalowane biblioteki OpenGL i [[Graphics drivers configuration|poprawnie skonfigurowane]] oraz upewnij się, że masz najnowsze sterowniki do swojej karty graficznej. Bądź również świadomy, że niektóre karty graficzne [[Problematic Video Cards|nie są zbyt dobrze wspierane]].

=== Jak sprawdzić liczbę klatek na sekundę? ===

W symulatorze idź do menu "Widok" > "Opcje widoku" i zaznacz tam opcję "Show frame rate".

=== Jak zmienić ustawienia kokpitu 2D? ===

Aby pokazać/ukryć panel 2D użyj kombinacji klawiszy {{Key press|Shift|P}}. Aby wyświetlić/ukryć HUD, naciskaj klawisz {{Key press|Shift|H}}. Możesz też włączyć alternatywny HUD przez naciśnięcie {{Key press|Shift|I}} (naciśnij {{Key press|I}} aby wrócić do domyślnego). Klawiszem {{Key press|Shift|H}} dostosujesz jasność HUD-a.

=== Utknąłem do góry nogami po rozbiciu się? ===

Szybką odpowiedzią jest zresetowanie symulatora, poprzez menu "Plik" > "Zresetuj". To ustawi twój samolot z powrotem w pozycji startowej.

Alternatywnie naciśnij {{Key press|Ctrl|U}} (w domyślnej konfiguracji), aby podnieść samolot o 1000 stóp.

Dla upartych: sztuczka do nauki. Aby wrócić do normalnej (nie odwróconej) pozycji, wznieś się o 500 stóp i obróć się przy użyciu lotek o 180*. Pamiętaj, sterowanie działa odwrotnie gdy jesteś do góry nogami i utrzymuj prędkość!

=== Dlaczego najnowsze wersje niektórych samolotów nie działają w mojej (starszej) wersji FlightGeara? ===
Często rozwój nowych samolotów nadąża za rozwojem kodu FlightGeara. Nowe lub nowo zmodyfikowane samoloty mogą korzystać z plików (takich jak nowe pliki instrumentów) lub funkcji dostępnych tylko w nowszych wersjach FlightGeara. Jeśli utknąłeś w starszej wersji FlightGeara, możesz spróbować pobrać wcześniejszą wersję samolotu z odpowiedniego [[FlightGear_hangars#Official_hangars|oficjalnego hangaru]] FlightGear.

=== Kiedy uruchamiam FlightGear widzę błąd wspominający o "SQLite". Co mam zrobić? ===

Od wersji FlightGear v2.10 (wydanej w lutym 2013) wprowadzono [[navdata cache|pamięć podręczną navdata]], aby poprawić czas uruchamiania FlightGeara. Ta pamięć podręczna to baza danych SQLite, która czasami jest trochę niestabilna. Jeśli baza danych jest uszkodzona, FlightGear nie będzie mógł się uruchomić.

Aby to naprawić musisz po prostu usunąć plik <code>[[$FG_HOME]]/navdata.cache</code>. Przy pierwszym uruchomieniu FlightGeara, po usunięciu pliku, pamięć podręczna navdata zostanie odbudowana. Ponieważ proces ten jest czasochłonny, uruchomienie FlightGeara zajmie więcej czasu.

Niektórzy uciekają się do usunięcia całego katalogu <code>$FG_HOME</code> lub nawet ponownej instalacji FlightGeara. Jednak żadne z nich nie jest potrzebne i może spowodować utratę wszelkich skonfigurowanych niestandardowych preferencji.

Kolejnym wskaźnikiem problemu związanego z SQLite jest komunikat o błędzie:

<tt>
Sqlite error:attempt to write a readonly database (8) while running:
INSERT OR REPLACE INTO stat_cache (path, stamp) VALUES (?,?)
</tt>

W takim przypadku, wcześniej uruchomiona instancja FlightGeara może nadal działać i blokować plik navdata.cache. Sprawdź, czy działa inny proces fgfs i zakończ go.

=== Mój samolot ma szare okna? ===
Problem nieprzejrzystych szarych okien, prze które nie można nic zobaczyć, jest najczęściej spowodowany niezgodnością wersji programu FlightGear i samolotu. Lub może to być spowodowane efektem okna, który nie jest zgodny z systemami renderowania [[Project Rembrandt|Rembrandt]] lub [[ALS]]. Przyczyną techniczną jest niezgodność renderera i zadeklarowanego efektu dla okna. Niektóre rozwiązania obejmują:

* Jeśli używasz stabilnej wersji FlightGeara, pobierz samolot z [[FlightGear_hangars#Official_hangars|oficjalnego hangaru]] pasującego do Twojej wersji FlightGeara.
* Jeśli używasz najnowszej wersji z [[FlightGear Build Server|builda nocnego]] lub [[Building FlightGear|samodzielnie skompilowanej wersji FlightGeara]] lub chcesz używać najnowocześniejszego samolotu, zobacz [[FGAddon#Obtaining aircraft|FGAddon - pozyskiwanie samolotu]].
* Jeśli korzystasz z samolotu z jednego z [[FlightGear_hangars#Unofficial_sites|nieoficjalnych hangarów]], najlepiej skontaktuj się z oryginalnym autorem samolotu lub osobą odpowiedzialną za ten hangar.
* Jeśli używasz [[Project Rembrandt|Rembrandta]], spróbuj wyłączyć ten system renderowania. Samoloty, które używają <code>model-default.eff</code> dla okien (prostym kosztem nierobienia niczego) zamiast <code>model-transparent.eff</code>, <code>model-combined-transparent .eff</code> lub <code>glass.eff</code> (które instruują Rembrandta, aby nie używał odroczonego renderowania dla szyb) będą miały szare okna podczas używania Rembrandta.

=== Mój ekran staje się całkowicie czerwony zaraz po uruchomieniu FlightGear ===
Czerwony ekran to wizualizacja efektu "redout" (napływ krwi do głowy pilota z powodu zbyt dużych przeciążeń). Jeśli pojawia się zaraz po uruchomieniu FlightGeara, może to być spowodowane problemem z ładowaniem scenerii. FlightGear ładuje scenerię w locie, a jeśli scenerii nie można załadować, np. ze względu na problemy z siecią, może nie być podłoża, na którym można zlokalizować statek powietrzny. W rezultacie samolot spada przez nieistniejący grunt, zaczynając się przewracać doprowadzając do nadmiernych przeciążeń. To z kolei powoduje efekt czerwonej planszy. Aby zweryfikować problem, należy rozpocząć lot w KSFO, którego sceneria jest już zawarta w pakiecie podstawowym.

== FAQ ==

=== Z kim się kontaktować w sprawie tego FAQ? ===
Dodaj komentarz na temat FAQ [[Talk:Frequently asked questions|na tej stronie]].

=== Jak stary jest ten dokument? ===
Sprawdź jego <span class="plainlinks">[{{fullurl:{{PAGENAME}}|action=history}} historię]</span>.

=== Jaką inną dokumentację powinienem przeczytać? ===
* [[Pl/Podręcznik_FlightGear|Podręcznik FlightGear]]
* [[Pl/Nowy_w_FlightGear|Nowy we FlightGear]]
* Zobacz także katalog FlightGear/docs-mini/ w dystrybucji źródłowej, aby znaleźć różne inne przydatne dokumenty.

== Wkład własny ==

=== Ochrona treści ===
{{See also|FlightGear Plugins}} DRM
{{Cleanup}}

Co jakiś czas pojawia się pytanie, czy dostarczanie do do FlightGeara zamkniętego kodu źródłowego wtyczki (dokładniej wtyczki czytnika plików OSG) jest legalne. Jedyną potrzebą trzymania kodu w pobliżu jest zapobieganie inżynierii wstecznej.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/27996073/
|title = <nowiki> [Flightgear-devel] Content protection for modders? </nowiki>
|author = <nowiki> Paul Guhl </nowiki>
|date = Aug 25th, 2011
|added = Aug 25th, 2011
|script_version = 0.37
}}</ref><ref>Soitanen (Aug 28th, 2014). {{forum link|title=Re: Encrypted aircraft dynamics|p=217378}}</ref><ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34559749/
|title = <nowiki> [Flightgear-devel] External FDM to protect propriety data in a GPL
eviirenment </nowiki>
|author = <nowiki> Alan Teeder </nowiki>
|date = Oct 21st, 2015
|added = Oct 21st, 2015
|script_version = 0.37
}}</ref>

FlightGear w obecnej postaci jest efektem pracy wielu ludzi, którzy dobrowolnie pracują nad wspólnym wysiłkiem stworzenia otwartej i rozszerzalnej platformy symulatora lotu. Sam Twój pomysł wprowadzenia DRM jest wbrew wszelkim zasadom open source.

Możesz swobodnie stworzyć samolot dla FlightGeara na licencji własnościowej - to są dane z perspektywy symulatora i nie uruchamiają licencji. Możesz to sprzedawać, nie pozwalając na ponowną dystrybucję kodu źródłowego. Musisz trzymać się z dala od kilku rzeczy (nie możesz używać ogólnych instrumentów, bibliotek Nasal,...) ale to powinno być do zrobienia. Możesz pobierać opłaty licencyjne za taki samolot i nikt nie może go redystrybuować.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

dane są analizowane z XML-a do dynamicznych tabel wyszukiwania (IE. STL). Jedynymi zasobami używanymi poza tym, co jest potrzebne do stworzenia funkcji FDM, jest narzut związany z wyciąganiem danych z pliku XML do pamięci. To musiałoby się zdarzyć bez względu na to, w jakiej formie były dane.
Chociaż mogą istnieć lepsze sposoby przechowywania danych niż XML-e, jeśli nie przejmujesz się interakcją człowieka z danymi. Myślę, że uczynienie danych czytelnymi/edytowalnymi dla człowieka jest głównym celem używania XML-i. Może być zbyt gadatliwy, ale działa i istnieją standardowe biblioteki do odczytu/parsowania plików XML, dzięki czemu używanie ich do wprowadzania danych jest dość proste. Jest to korzystne zarówno dla FlightGeara, jak i JSBSim pod względem ograniczenia złożoności obsługi danych konfiguracyjnych. Ponadto istnieje ograniczona liczba standardowych formatów dla tego typu rzeczy, takich jak JSON, a wszystkie te, które są czytelne/edytowalne przez człowieka, mają wiele takich samych problemów jak XML.
W pełni funkcjonalne FDM są złożone, a zrozumienie XML-a używanego do konfiguracji złożonego FDM jest bardzo drobnym problemem, a każdy, kto faktycznie rozumie w pełni funkcjonalny FDM, będzie miał bardzo niewiele problemów z częścią XML.<ref>hvengel (Aug 28th, 2014). {{forum link|title=Re: Encrypted aircraft dynamics|p=217408}}</ref>

FlightGear sam w sobie jest OpenSource, więc niezależnie od tego, w jakim systemie DRM chcemy zakodować dane, każdy może go usunąć (i jest to całkiem legalne). Nie trzeba się zastanawiać, aby wygenerować wersję FlightGear bez ochrony praw autorskich i rozpowszechnić ją, na której Twoja treść działa bez klucza (lub czegokolwiek innego). Biorąc pod uwagę, że ludziom zwykle udaje się złamać schematy DRM przy braku otwartego kodu źródłowego, próba zrobienia tego z kodem źródłowym otwartym dla każdego wydaje się po prostu stratą czasu. Po drugie, jakikolwiek format pliku odczyta OSG, zanim dotrze do renderera, musi być tablicą wierzchołków. Renderer tego potrzebuje, na etapie GLSL nie ma deszyfrowania. Więc są szanse, że skoro działamy na *Open*GL, to znowu każdy, kto naprawdę chce, może wypisać niezaszyfrowany format.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Ponieważ FlightGear jest open source, niezwykle łatwo jest dodać kod, aby uzyskać dostęp do grafu sceny 3D i wyodrębnić pełny model samolotu (z wyłączeniem skryptów, chociaż można je odtworzyć). Informacje po prostu tam siedzą, w pełni widoczne i gotowe do pobrania z gałęzi OSG jak duża soczysta brzoskwinia. Prawdopodobnie mógłbym napisać ten kod w pół dnia, ale konwersja do formatu AC3D, tekstur PNG itp. w celu odtworzenia nowej kopii samolotu zajęłaby trochę więcej czasu. Gdyby FlightGear miał zamknięty kod źródłowy, napisanie kodu ekstraktora OSG byłoby znacznie trudniejsze, ale mimo to nadal wykonalne.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076297/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Edward d'Auvergne </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Właśnie z tego powodu mamy wsparcie dla katalogów i zewnętrznych hangarów. Oczywiście chcemy zachęcać do tworzenia samolotów na licencji GPL, ale nie każdy twórca samolotów chce lub może udostępniać swoje prace na licencji GPL. FlightGear szanuje i wspiera tę opcję.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076199/
|title = <nowiki> Re: [Flightgear-devel] botom line: if i don't my aircraft to be
subject to GPL FGAddon clauses </nowiki>
|author = <nowiki> Stuart Buchanan </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Z pewnością można uruchomić model FDM z zewnątrz i użyć jednej z wielu opcji sieciowych I/O we FlightGear, aby przesyłać dane tam i z powrotem. W przeszłości zrobiono to w kilku projektach badawczych, aby wykorzystać FlightGear jako narzędzie do wizualizacji. Co za tym idzie, możesz zrobić to samo w przypadku skryptów - uruchomić skrypty na zewnątrz i wchodzić w interakcje z FlightGearem za pośrednictwem jednego z tych protokołów.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076187/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Stuart Buchanan </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Jeśli faktycznie spróbujesz pobierać opłatę 100$ za samolot dla FlighGear, nie znajdziesz zbyt wielu klientów, ponieważ FG jest popularny głównie w społeczności OpenSource. Jeśli sprawisz, że będzie to zbyt kłopotliwe za pomocą DRM-ów, być może ktoś spróbuje to obejść dla zasady (ludzie robią to dla sportu) - nie jest łatwo sprawić by wieloplatformowy DRM nie był irytujący dla użytkowników.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Należy pamiętać, że bez względu na format źródłowy (dll, zaszyfrowany + podpisany, binarny itp.), ostatecznie siatka modelu, tekstury i struktura logiczna są wczytywane do wewnętrznych struktur klas OSG. Po zakończeniu tego procesu, aby model mógł zostać wyrenderowany na ekranie, osoba może wywołać odpowiednią funkcję write*File() w celu zapisania poddrzewa modelu w dowolnym obsługiwanym formacie. Jedyne, co jest potrzebne, to dostęp do kodu źródłowego FlightGeara, aby wstawić wywołanie funkcji w strategicznym miejscu. W ostatecznym rozrachunku nie możesz całkowicie chronić swojej treści, jeśli nie masz pełnej kontroli nad sytuacją na poziomie kodu źródłowego aplikacji. I jest to klasyczna strategia hakowania ochrony przed kopiowaniem, wstawiaj magię do kodu po uwierzytelnieniu/załadowaniu/dekodowaniu formatu dystrybucji, a następnie zapisz go w "odszyfrowanym" formacie. Ludzie robią to cały czas, nawet z zastrzeżonym kodem. Wartość celu zwykle określa, jak ciężko są skłonni pracować, aby go ukraść.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074534/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.38
}}</ref>

Dodanie wsparcia dla DRM do FlightGear nie nastąpi - skrypty Nasal są domyślnie dostarczane w formacie zwykłego tekstu (podobnie jak JavaScript), natomiast zaciemnianie jest oczywiście możliwe, jednak nie ma to żadnego sensu w kontekście FlightGear jako projektu otwarto źródłowego.

Ponadto skrypty mogą być łatwo udostępniane i uruchamiane przez użytkowników, po prostu je wymieniając lub kopiując.

Nawet gdybyś zrzucił pośredni kod bajtowy Nasal do pliku obiektowego i wykonał to za pomocą maszyny wirtualnej Nasal, nie byłoby możliwości wyegzekwowania DRM.

Oczywiście, ponieważ FlightGear jest open source, możesz po prostu dodać obsługę DSO/wtyczek do rozwidlenia FlightGear i oprzeć całą swoją pracę na tym rozwidleniu - z drugiej strony, twoje modyfikacje nadal będą musiały być udostępniane.

Istnieje sposób na tworzenie legalnych dodatków z zamkniętym kodem źródłowym: możesz napisać cały "tajny" kod C++ jako zewnętrzną aplikację i pozwolić jej komunikować się z FlightGearem za pośrednictwem gniazd sieciowych. To powinno działać w miarę dobrze. Ale nie oczekuję, że zdobędziesz wielu klientów. Przede wszystkim, przynajmniej w Linuksie, nikt nie chce uruchamiać binarnych blobów, które mogłyby z łatwością wymazać katalog domowy podczas zabawy we FlightGear. A potem dzieje się tyle darmowych samolotów, z dużym rozmachem, że prawdopodobnie zawsze będziesz w tyle. A ci programiści mają bliskie powiązania z (lub są) programistami FlightGeara, więc mają tę zaletę, że mogą w dowolnym momencie zmienić kod FlightGeara według własnych upodobań. Mogą zmieniać interfejs do woli, a ty musisz nadrobić zaległości i zająć się reklamacjami klientów, którzy nagle siadają na zepsutym binarnym blobie, który nie działa z ostatnią wersją FlightGeara. I wreszcie, to podejście do gniazd działa tylko za pośrednictwem systemu właściwości i jest otwarte do wglądu dla każdego (oprócz niedawno dodanej półtajnej właściwości wektora śmieci).

FlightGear nie ma możliwości ładowania samolotów z bibliotek współdzielonych. Możesz rozpowszechniać swój samolot na licencji zastrzeżonej, tak jak robi to Vitos, ale nie jako biblioteka współdzielona. Zmiana we FlightGear, aby mógł ładować samoloty z bibliotek współdzielonych, wymagałaby dużo pracy. Kto miałby to robić i dlaczego ktokolwiek miałby to robić, skoro mógłby poświęcić swój czas na ulepszanie wolnego oprogramowania? I dlaczego główni twórcy FlightGear mieliby akceptować taki wkład?<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073736/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Ludovic Brenta </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Realistycznie patrząc, jeśli chcesz sprzedać komercyjny samolot, twoją bazą klientów będzie Flight Sim X, X-Plane, Prepar3D. Po prostu nie uzyskasz żadnej przyczepności w ekosystemie FlightGear. Nie jest on do tego stworzony.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074166/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> geneb </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Poza tym obsługa języka skryptowego OSG (lua) nie może uzyskać dostępu do wszystkich wewnętrznych funkcji Nasal, po prostu dlatego, że we FlightGear nie zaimplementowano kodu łączącego. Więc nie ma żadnych właściwości dla ciebie i żadnego dostępu do wewnętrznego wywołania funkcji, które zapewnia Nasal.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074133/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Erik Hofman </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Posiadasz prawa autorskie do swojej pracy, nawet jeśli wydasz ją na licencji GPL i możesz dalej rozwijać swoją pracę i wydać bardziej kompletną wersję na licencji komercyjnej, jeśli tylko chcesz (jest to wariant podwójnej licencji). Jedynym sposobem, aby nie zachować praw autorskich do tego, co robisz, jest przeniesienie ich na kogoś innego lub zrzeczenie się ich poprzez udostępnienie swojej pracy jako domeny publicznej. Jeśli stworzysz model 3D dla samolotu FG i nadasz mu licencję GPL, nikt nie zabroni Ci adaptacji i sprzedaży go dla X-Plane. W rzeczywistości możesz go sprzedawać również dla FG (ale inni mogą go redystrybuować, jak im się podoba, gdy go kupią, ponieważ jest to GPL, więc może to nie być zbyt opłacalny model biznesowy).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073832/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Czy inne symulatory oferują szyfrowanie lub ochronę zawartości? Na przykład udało mi się zlokalizować i przetestować wtyczkę blendera, która może otworzyć wiele modeli samolotów MSFS. A jak z X-Plane? Minął *długi*, *długi* czas, odkąd majstrowałem przy ich pakiecie, ale w tamtym czasie zwracałem uwagę, że wszystkie ich formaty 3D były otwarte i dobrze zdefiniowane. Często komercyjne symulatory przechowują rzeczy we własnych formatach binarnych, ale w większości przypadków nie są one zaszyfrowane, a użytkownicy końcowi dość szybko je odszyfrowują -- więc mogą edytować lub tworzyć nową zawartość w tym samym formacie. Nie uważałbym formatu binarnego za schemat ochrony treści, zwłaszcza w projekcie typu open source, w którym źródło do ładowania i przechowywania formatu binarnego jest łatwo dostępne. Rozumiem pragnienie twórców treści, aby nie dać się „oszukać”. Ale zrozum też, że jednym z głównych powodów, dla których FlightGear może odnieść sukces, jest to, że cały kod źródłowy i zawartość są otwarte. Gdybyśmy nie otworzyli wszystkiego, nie otrzymalibyśmy prawie takiej samej liczby datków wolontariuszy, a wysokiej jakości wolontariat jest kluczowym powodem, dla którego FlightGear odniósł taki sukces. Gdybyśmy byli zamkniętą organizacją komercyjną, kto chciałby się włączyć i pomóc komuś innemu zarabiać pieniądze? Ale gdy wszystko jest otwarte, wiesz, że wszyscy inni mogą cieszyć się takim samym wkładem, tak samo jak Ty cieszysz się wkładem wszystkich innych. Istnieje kilka oszustów, którzy próbują zarobić na pracy innych ludzi i chętnie kłamią i wprowadzają w błąd, aby wyłudzić jak najwięcej pieniędzy od niczego niepodejrzewających użytkowników końcowych. Prawda jest taka, że ci ludzie zawsze istnieli i zawsze będą istnieć. Są niezwykle skrupulatni i uporczywi w kopiowaniu rzeczy, posuwają się nawet do łamania schematów ochrony przed kopiowaniem, przeprowadzania inżynierii wstecznej projektów sprzętu, kopiowania dokładnego wyglądu produktów (nawet łącznie z logo). To nie jest problem, który jest unikalny dla projektu FlightGear -- i jest to coś, z czym wciąż byśmy się borykali, bez względu na to, jak ciężko pracowaliśmy nad stworzeniem schematów ochrony przed kopiowaniem. Jeśli zaprojektowałeś format zawartości binarnej, ktoś dokona inżynierii wstecznej. Jeśli zaprojektujesz schemat szyfrowania, ktoś po prostu zmodyfikuje kod symulatora, aby zrzucić odszyfrowaną wersję po załadowaniu jej do pamięci przez zastrzeżoną wtyczkę deszyfrującą (o ile nie złamie schematu szyfrowania lub nie ukradnie kluczy szyfrowania). We wszystkich tych przypadkach zawartość nadal można łatwo kopiować, replikować, sprzedawać itp. Najlepszy schemat, jaki widziałem, to taki, który ma klucz blokady węzła, który będzie działał tylko na jednym komputerze (klucz przypisany do adresu mac lub identyfikatora procesora). Oznacza to jednak bardziej skomplikowaną dwuetapową instalację, w której użytkownik musi wrócić do Ciebie po zainstalowaniu produktu, zgłosić swój unikalny identyfikator, uzyskać klucz, a następnie zainstalować ten klucz, zanim będzie mógł działać. Problem z tym wszystkim polega na tym, że w projekcie open source ktoś może po prostu skompilować nową wersję symulatora, która pomija sprawdzanie klucza lub akceptuje trywialny klucz lub dowolny klucz. Zastanawiam się tutaj nad różnymi możliwościami, ale mam nadzieję, że widzisz, że to, co na pierwszy rzut oka wydaje się prostą prośbą, w rzeczywistości jest dość złożone i w dalszym ciągu powoduje różnego rodzaju problemy (zarówno pod względem technicznym, jak i ze wsparciem użytkowników). Ostatecznie złoczyńcy i tak zazwyczaj znajdują obejścia i nie są zbytnio spowalniani. Kiedy rolnicy uprawiają rośliny, muszą znosić chwasty. Możemy spróbować rozsądnych rzeczy, aby zminimalizować chwasty, ale jeśli jesteś zbyt agresywny w zabijaniu chwastów i nie tolerujesz ani jednego, najprawdopodobniej zabijesz również większość swoich upraw. Dlatego uważam, że jest to coś, z czym musimy się po prostu pogodzić. Możemy spróbować podjąć rozsądne kroki, aby zminimalizować problem, ale nie możemy wyeliminować wszystkich złych osób bez szkody dla wszystkich dobrych rzeczy w naszym projekcie.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/27998023/
|title = <nowiki> Re: [Flightgear-devel] Content protection for modders? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Aug 25th, 2011
|added = Aug 25th, 2011
|script_version = 0.37
}}</ref>

Kiedy już rozpowszechniłeś kod źródłowy na licencji GPL, wyraźnie zadeklarowałeś, że każdy ma prawo do redystrybucji i modyfikacji - o ile nie rozpowszechnia go na innej licencji. Ale ty, jako właściciel praw autorskich, możesz zmienić licencję dla nowej wersji kodu, której jeszcze nie rozpowszechniałeś na licencji GPL - o ile modyfikacje te nie zostały dokonane przez innych, tj. Ty, jako jedyny posiadacz praw autorskich, możesz również rozpowszechniać go na kilku licencjach jednocześnie, np. GPL i niektórych licencjach własnościowych (czyniąc go wartym pieniędzy, które ludzie mogą za niego zapłacić, dzięki szybszym poprawkom błędów, dystrybuowanym tylko do płacących klientów itp.).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073990/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Jens Thoms Toerring </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Inną rzeczą do rozważenia jest to, że dystrybucja Twojego statku powietrznego jako .dll lub .so nie ukryła by ani nie zaciemniła by Twojego kodu i tekstur po załadowaniu ich do struktur symulatora w celu renderowania. Reszta FlightGeara jest open source, więc wstawienie wywołania funkcji OSG, aby zapisać samolot (modele i tekstury) w innym popularnym formacie 3D, nie wymagałoby wiele wysiłku. Spowodowałoby to pewne straty w zakresie organizacji plików źródłowych, ale mimo to dałoby miejsce startu komuś, kto zamierza skopiować lub zmodyfikować pracę. Cała konfiguracja XML także powinna być dostępna za darmo w drzewie właściwości. Licencjonowanie Nasal (jak sądzę) jest napisane w sposób, który utrudnia dystrybucję zastrzeżonego kodu Nasal. Zatem stworzenie samolotu dla FlightGear zabezpieczonego przed modyfikacjami, nie mówiąc już o kopiowaniu, wiązałoby się z pewnymi naprawdę poważnymi wyzwaniami.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073896/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Kluczem do projektu open source nie jest to, czy możesz wygrać spór prawny, czy nie. Chodzi raczej o to, aby przede wszystkim unikać wszelkich sporów prawnych i to za wszelką cenę. To znaczy trzymać się z dala od sądu. Aby bezpiecznie użyć czegoś takiego w projekcie open source, sugerowałbym coś w następujący sposób:
* Upublicznienie swojego produktu pochodnego w całości (ale bez licencji, mówiąc, że jest to materiał chroniony prawem autorskim),
* Zwrócenie się do właścicieli oryginalnego produktu i przekazanie im linku do produktu pochodnego,
* Poproszenie ich o publiczne oświadczenie, że produkt pochodny może być licencjonowany przy użyciu licencji „GPLv2 lub nowszej wersji”,
* Pamiętaj, aby poprosić ich o zidentyfikowanie publicznego produktu pochodnego jako łącza i zidentyfikowanie wszystkich jego części (aby uniknąć późniejszego stwierdzenia, że umieściłeś fragmenty chronionego materiału).

Kopię zapasową każdego oświadczenia złożonego w sieci można znaleźć w archiwum internetowym (http://web.archive.org/). Aby uprościć ten proces, możesz sporządzić część oświadczenia opisującą w całości produkt pochodny, ze wszystkimi szczegółami. Dzięki temu nie będzie już żadnych odcieni szarości! Jeśli chętnie to zrobią, to z prawnego punktu widzenia nie będzie problemu z ich użyciem (tj. szara sytuacja zmieniła się w białą). Jeśli nie są zadowoleni z Twojej propozycji, pewnego dnia mogą odwrócić się i pozwać (tj. szara sytuacja zmieniła się w czystą czerń).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34561220/
|title = <nowiki> Re: [Flightgear-devel] External FDM to protect propriety data in a
GPL eviirenment </nowiki>
|author = <nowiki> Edward d'Auvergne </nowiki>
|date = Oct 22nd, 2015
|added = Oct 22nd, 2015
|script_version = 0.37
}}</ref>

Świat open source zależy od warunków licencji i praw autorskich oraz współpracy i zaufania w celu ochrony naszej pracy. Znosimy niewielki podzbiór ludzi, którzy chcą nadużywać tych warunków i mamy nadzieję, że presja większej grupy utrzyma złych aktorów w ryzach. Czasami istnieje środek prawny, czasami trudno jest coś z tym zrobić, gdy problemy wykraczają poza granice kraju (lub gdy ktoś po prostu chce złamać zasady dla własnych korzyści). Mam jednak wrażenie, że na dłuższą metę większość ludzi jest uczciwa i chce postępować właściwie, a mała grupa, która naprawdę istnieje, aby powodować problemy lub po prostu służyć sobie kosztem innych, nigdy nie przetrwa tak długo, jak większa grupa ludzi o dobrych intencjach. Ostatecznie musisz samodzielnie określić, ile wysiłku włożyłeś w model, ile pieniędzy możesz zarobić na jego sprzedaży, w porównaniu z ryzykiem, że ktoś go sam skopiuje i rozpowszechni, w porównaniu z kosztami prawnymi, aby spróbować ich powstrzymać.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074534/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.38
}}</ref>

=== Obejścia DRM ===

W jednym z moich poprzednich projektów miałem do czynienia z autorskim modelem dynamiki lotu. Początkowo korzystałem z interfejsu Ethernet, aby mógł działać jako zewnętrzna samodzielna aplikacja. Potem przełączyłem się na dwukierunkowy układ potoków uniksowych, więc mogłem mieć ściślejszą synchronizację z kolejnością wykonania, ale nadal zewnętrzny program był całkowicie niezależny i samodzielny. Chciałbym, aby wszystko było darmowe i otwarte, ale w tym przypadku nie miałem wyboru i było to coś zakupionego od firmy zewnętrznej na surowych warunkach. Czułem, że dwa niezależne, samowystarczalne programy (które mogą ze sobą rozmawiać i wymieniać informacje) stworzyły wystarczającą separację licencji, aby honorować warunki licencji GPL FlightGeara.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34559783/
|title = <nowiki> Re: [Flightgear-devel] External FDM to protect propriety data in a
GPL eviirenment </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Oct 21st, 2015
|added = Oct 21st, 2015
|script_version = 0.37
}}</ref>

Na ile to jest warte, FDM „ExternalPipe” został skonfigurowany tak, aby obejmował większość obszarów, których dotknąłeś. Prawdopodobnie nie jest to dokładnie to, czego chcesz, ale oto trochę mojej logiki w tym, jak/dlaczego skonfigurowałem to tak, jak to zrobiłem:
* Korzystanie z interfejsu sieciowego dodaje trochę indeterminizmu. Czasami pakiety sieciowe są opóźniane lub układają się w stos w zależności od tego, co dzieje się z maszyną, więc nie ma gwarantowanej relacji między symulatorem a dynamiką lotu.
* Zwykle interfejs sieciowy jest dobry, ale zaobserwowałem czasy, kiedy pakiety docierały tam, gdzie powinny, z dodatkowymi opóźnieniami.
* Alternatywnie ustawiam parę „nazwanych potoków”. Potoki są konstrukcją uniksową, dla programu wyglądają jak plik, ale to, co do nich zapisujesz, jest gromadzone i przechowywane do odczytania przez inną aplikację. Niestety nie są one obsługiwane w systemie Windows. Potoki są jednokierunkowe, stąd potrzeba dwóch do komunikacji dwukierunkowej. Potok jest naprawdę prosty: otwierasz go jak każdy inny plik, a jeden proces zapisuje w nim; odczytuje z niego inny proces. W międzyczasie system operacyjny może buforować pewną ilość informacji, dopóki proces odczytujący ich nie złapie. Możesz użyć blokowania odczytów (ostrożnie z tym), aby mieć pewność, że FlightGear i zewnętrzny FDM działają dokładnie tak samo.
* Potoki oznaczają, że oba procesy będą działać na tej samej maszynie, interfejs sieciowy pozwoliłby procesom działać na oddzielnych maszynach.
* Interfejs ExternalPipe obsługuje elastyczny interfejs właściwości, więc zewnętrzny proces FDM może wysyłać dowolne pary nazwa/wartość, które chce wysłać, a interfejs sumiennie skopiuje je do drzewa właściwości FlightGeara. Strona FDM może również wysłać listę nazw właściwości, które chciałaby otrzymać w odpowiedzi, a interfejs będzie sumiennie przesyłał je potokiem wychodzącym w każdej klatce. To był miły dodatek, a nazwane potoki mają dużą przepustowość, aby zrobić to czystym tekstem, nawet z wieloma dodatkowymi wartościami właściwości.

Historia: Użyłem tego jako części projektu, który zrobiłem z symulatorem lotu ATC. Mieli własne, zastrzeżone aplikacje do dynamiki lotu, które modelowały konkretny statek powietrzny w samym kodzie. Modele te posiadały całą niezbędną dokumentację źródłową i dane z testów w locie, aby spełnić wymagania testowe certyfikacyjne FAA dotyczące ostatecznego symulatora. Ponadto ten zewnętrzny kod modelował wiele systemów samolotu dla jednej z ich wysokiej klasy symulacji. Wymagało to elastyczności w zakresie wysyłanych tam i z powrotem wartości i umożliwiło mi sterowanie niektórymi wskaźnikami przyrządów bezpośrednio z kodu zewnętrznego.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/31900851/
|title = <nowiki> Re: [Flightgear-devel] Feeding FlightGear data through the Protocol
Pipe </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Jan 29th, 2014
|added = Jan 29th, 2014
|script_version = 0.37
}}</ref>

[[Category:FlightGear]]

[[de:FAQ]]
[[en:Frequently asked questions]]
[[es:Preguntas frecuentes]]
[[fr:Foire aux questions]]
[[it:Domande frequenti]]
[[ja:FAQ]]
[[nl:veel gestelde vragen]]
[[pt:FAQ]]
[[pt-br:Perguntas_frequentes]]
[[sr:FAQ]]

Pl/FAQ

2026-04-30T17:12:53Z

PlayeRom:

Dziękujemy za zainteresowanie [[FlightGear]]! Ten ''FAQ'' zawiera listę najczęściej zadawanych pytań. Jeśli nie możesz znaleźć odpowiedzi na swój problem, proszę utworzyć temat na {{forum link|text=naszym forum}}.

== Dystrybucja ==

=== Skąd wziąć FlightGear? ===
Oficjalną stroną pobierania jest: {{project infrastructure|website|link=no|urn=download/}}. Znajdziesz tam wersje binarne dla Windows, macOS oraz Linux (AppImage). W większości dystrybucji Linuxa, FlightGear można pobrać bezpośrednio z repozytoriów danej dystrybucji. Szukaj w "Centrum/Menedżer oprogramowania" Twojej dystrybucji.

=== Jak zainstalować FlightGeara na Linuksie? ===
Wiele dystrybucji zawiera FlightGear w swoich repozytoriach. Ponadto w {{project infrastructure|website|urn=download/|text=Centrum Pobierania}} znajdziesz też wersję skompilowaną do AppImage, którą uruchomisz na niemal każdej współczesnej dystrybucji. Jeśli nie możesz znaleźć wersji pakietowej dla siebie, rozważ pobranie i [[Building FlightGear - Linux|kompilację z kodów źródłowych]].

=== Gdzie mogę znaleźć najnowszy kod źródłowy? ===
Najnowszy kod źródłowy jest dostępny dla każdego za pośrednictwem naszego [[FlightGear Git|repozytorium Git]].

=== Gdzie mogę latać i skąd wziąć scenerie? ===
Latać można wszędzie, po całym świecie. Scenerie można pobrać na wiele sposobów. Obecnie najlepszą opcją jest automatyczne pobieranie scenerii w zależności od tego gdzie się znajdujesz. Służy do tego program TerraSync. Aby go włączyć wystarczy w Launcherze wejść do "Ustawienia" -> "Pobieranie" i tam zaznaczyć opcję "Automatycznie pobieraj scenerię".

Można także pobrać większe rejony świata ręcznie, ze strony {{project infrastructure|website|urn=download/scenery|text=Pobieranie Scenerii}}

=== Gdzie mogę zdobyć dodatkowe samoloty? ===
Najnowsze, oficjalne samoloty można pobrać i zainstalować jednym kliknięciem w zakładce samolotów w Launcherze (patrz [[FlightGear Qt launcher|FlightGear Qt Launcher]]).

Możesz także zajrzeć na oficjalną stronę {{project infrastructure|website|urn=download/download-aircraft/|text=Pobierania Samolotów}}.

Inne samoloty w fazie rozwoju możesz znaleźć w oficjalnym repozytorium samolotów [[FGAddon]], a inne w hangarach FlightGear osób trzecich (patrz także [[Pl/Instalowanie_samolotów|Jak zainstalować samoloty]]).

=== Dlaczego samoloty na FlightGear.org są nieaktualne? ===
Samoloty z oficjalnej {{project infrastructure|website|urn=download/|text=strony pobierania}} są aktualizowane tylko w momencie wydania nowej wersji FlightGeara. Dzieje się tak, ponieważ samoloty, które są obecnie w fazie rozwoju, są zwykle opracowywane dla rozwojowych/nieopublikowanych wersji FlightGeara. Te wersje rozwojowe mają wiele funkcji, które nie są obsługiwane przez starszą, stabilną wersję. Gdybyśmy częściej aktualizowali pobierane samoloty, większość samolotów nie działałaby w stabilnej wersji FlightGeara.

=== Jak aktualne są dane we FlightGear w porównaniu z rzeczywistością? ===
Korzystamy z tych samych danych nawigacyjnych i baz lotnisk co X-Plane. Aktualne bazy danych można znaleźć w folderach [[$FG ROOT]]/Navaids/ and [[$FG ROOT]]/Airports/.

=== Dlaczego nie pobieracie za to pieniędzy? ===
FlightGear można pobrać bezpłatnie z wielu miejsc, w tym ze strony internetowej FlightGear, ale można go również kupić na płycie CD/DVD. Chociaż oferujemy tę usługę (zobacz oficjalną stronę internetową), zachęcamy inne grupy do redystrybucji dla swoich użytkowników, zwłaszcza w ramach dystrybucji systemu operacyjnego, która sprawia, że instalacja jest jeszcze szybsza i łatwiejsza dla nowych użytkowników.

Czasami możesz znaleźć ofertę kupna FlightGeara na portalach aukcyjnych lub komercyjnych stronach internetowych pod inną nazwą. Można to zrobić całkiem legalnie, o ile warunki licencji są przestrzegane i może być warte kosztów, jeśli uwzględnione zostaną niektóre funkcje o wartości dodanej, takie jak dodatkowa sceneria, samolot lub wsparcie posprzedażowe. Niestety, większość przypadków obserwowanych do tej pory wydaje się być po prostu próbą zarobienia pieniędzy na sprzedaży czegoś, co jest bezpłatne i nie zapewnia prawdziwej wartości dodanej.

=== Jak mogę zacząć korzystać z FlightGear? ===
FlightGear można pobrać z {{project infrastructure|website|urn=download/|text=Download Central}}. Po uruchomieniu Launchera, możesz doinstalować tam samoloty z oficjalnego hangaru. Włączając automatyczne pobieranie scenerii, FlightGear sam zadba o scenerię. Uważaj na wymagania systemowe! Sprawdź też [[Pl/Nowy we FlightGear|Nowy we FlightGear]].

== Kompilacja ==
=== Jak skompilować FlightGear z kodów źródłowych? ===
Zobacz [[Building Flightgear|Budowanie FlightGear]]. Istnieją wyjaśnienia dla kompilacji pod Window, Linuks, a nawet skrypty do automatycznego pobrania i kompilowania całości.

=== Dlaczego FlightGear się nie kompiluje? ===

To zależy. Po pierwsze upewnij się że używasz odpowiednich wersji FlightGear, [[SimGear]], plib, zlib. Jeśli którykolwiek z pakietów nie pasuje (wersją) do innych, kompilacja może się nie udać.

Upewnij się też czy masz implementację OpenGL ze wsparciem glut'a z odpowiednimi plikami nagłówkowymi. Użytkownicy Linuksa posiadający karty nVidia powinni się sprawdzić, czy mają najnowsze sterowniki. Inni posiadacze Linuks powinni mieć bibliotekę Mesa3d (http://mesa3d.org/). Sprawdź też czy masz dobrze zainstalowany i skonfigurowany serwer X-ów.

Jeśli dalej masz problemy, zapytaj na {{forum link|text=FlightGear forum}}, na [[IRC]] lub zapisz się na naszą [[mailing list|listę mailingową]] FlightGear-Users i daj nam znać, jaki masz problem.

=== Czym jest SimGear i dlaczego go potrzebuję? ===
[[SimGear]] jest biblioteką kodu pomocniczego. SimGear jest potrzebny tylko wtedy, gdy planujesz skompilować FlightGear - nie jest potrzebny do uruchamiania prekompilowanych binariów. Więcej informacji znajdziesz na stronie http://www.simgear.org/. Uwaga: Podczas kompilacji FlightGeara bardzo ważne jest posiadanie pasującej wersji SimGeara.

== Konfiguracja i uruchomienie ==

=== Jak uruchomić FlightGear? ===
Najprostszym sposobem jest użycie [[FlightGear Qt launcher|Launchera]]. Alternatywnie możesz go uruchomić z terminala używając [[Pl/Opcje_wiersza_poleceń|opcji wiersza poleceń]].

=== Jak zainstalować nowe scenerie? ===

Jeśli naprawdę nie chcesz/nie możesz używać [[Terrasync]], pliki archiwum scenerii (np. w100n30.tar.gz) powinny zostać rozpakowane do katalogu Scenery/Terrain w Twoim [[$FG_ROOT]]. Więcej na [[Pl/Instalowanie_scenerii|Instalowanie scenerii]].

=== Jak skonfigurować mój joystick? ===

FlightGear obsługuje wiele joysticków/wolantów od razu po podłączeniu. Jeśli jednak masz problemy, zobacz [[Input device|Urządzenie wejściowe]].

=== W jakim formacie powinien być mój osobisty plik .fgfsrc? ===

Twój plik .fgfsrc powinien po prostu być listą [[Pl/Opcje_wiersza_poleceń|opcji wiersza poleceń]], z każdą opcją w osobnej linii. Plik ten nie jest plikiem XML.

Jeśli wolałbyś korzystać z plików konfiguracyjnych XML mógłbyś dodać coś takiego do pliku .fgfsrc lub do wiersza poleceń:

--config=/ścieżka/do/pliku.xml

Prawie każda opcja odpowiada właściwości, więc możesz wybrać metodę która Ci najlepiej odpowiada.

=== Jak dostać się do opcji, pomocy itp.? ===
Prawdopodobnie nie widzisz głównego menu. Aby je wyświetlić naciśnij {{Key press|F10}}.

== Latanie ==

=== Jak uruchomić silnik/i? ===
Samoloty różnią się w swoich procedurach startowych. Niektóre mogą mieć sekwencję automatycznego startu lub instrukcje w menu pomocy samolotu (naciśnij klawisz {{key press|?}}) i/lub na stronie Wiki o [[Aircraft|statkach powietrznych]]. Zapoznaj się z [[Pl/Podręcznik_FlightGear|Podręcznikiem FlightGear]] lub zobacz [[Pl/Nowy_w_FlightGear#Uruchamianie_silnika|szybki przewodnik]].

=== Gdzie jest przesuwana mapa? ===
W symulatorze można wejść w menu "Wyposażenie > [[Map|Mapa]]", ale nie jest to mapa lotnicza. Popularna ruchoma mapa jest dostępne w ramach osobnego projektu o nazwie Atlas. Jest również [[MPmap]] - mapa online dla multiplayer.

Jeśli lubisz alternatywę dla Atlasa z uaktualnioną grafiką i mapami dostarczanymi przez projekt OpenStreetMap, to sprawdź [[Phi#Map|Phi]] lub [[JMapView]].

=== Gdzie mogę się nauczyć latania według wskazań przyrządów i nawigacji? ===
Jest dobry artykuł [[Understanding navigation]] oraz jest to bardzo dobrze wyjaśnione w [[Pl/Podręcznik_FlightGear|Podręczniku FlightGear]]. Inne zasoby to:
* [http://www.av8n.com/how/ See How It Flies] - bardzo dobra książka autorstwa Johna S. Denkera, dostępna online.

=== Jaka jest różnica między lotką a sterem kierunku? ===
W tej samej książce jest trochę informacji o lotkach i sterze kierunku.

=== Czy FlightGear wspiera multiplayer? ===
Oczywiście. Zobacz [[Howto: Multiplayer]]. Zarówno wersje Windowsowe jak i Unixowe obsługują tryb wieloosobowy na serwerach FlightGear. Również komunikacja głosowa jest obsługiwana dzięki [[FGCom]].

Mapa pokazująca samoloty graczy online w czasie rzeczywistym jest dostępna jako [[MPmap]].

=== Gdzie są najlepsze miejsca do latania w FlightGear? ===
Sceneria FlightGear obejmuje cały świat, ale dzięki społeczności użytkowników FlightGear, niektóre lotniska i obszary są bardziej szczegółowe niż inne:
* W okolicach Paryża we Francji jest wiele wysokiej jakości modeli scenerii.
* EHAM Amsterdam Schiphol, EGK Londyn Gatwick i LFPG Paryż Charles de Gaulle są jednymi z najwyższej jakości lotnisk.
* LOWI Innsbruck jest zarówno rozwinięty w scenerii jak i na lotnisku.
* TNCM St. Maarten jest popularnym celem podróży, a okoliczne wyspy (Anguilla, St. Eustatius, Saba, St. Barthélemy, St. Kitts i Nevis) są dobrze wymodelowane.

Ponadto zobacz [[Suggested Flights|sugerowane loty]], [[Suggested Airports|sugerowane lotniska]] i [[Suggested custom scenery|sugerowane scenerie niestandardowe]].

=== Gdzie mogę znaleźć informacje o lotniskach i mapy lotnicze online? ===
Lotniska:
* [http://www.airnav.com/airports/ AirNav.com]

Mapy:
* [http://skyvector.com/ SkyVector.com]

Zobacz także [[Getting aeronautical charts|pozyskanie map lotniczych]].

=== Czy we FlightGear jest możliwość prowadzenia działań militarnych np. prowadzenia walk powietrznych lub zrzucania bomb? ===
Tak. Sprawdź dodatek [[Bombable]] i {{forum link|t=5742|title=Bombable}}. Istnieją również scenariusze bombardowania dla [[A-10]] i innych samolotów z uzbrojeniem, jak [[North American OV-10A Bronco]], [[General Dynamics F-16]] i [[F-117 Nighthawk]].

=== Problemy z lataniem ===

==== Dlaczego moje powierzchnie sterowe wracają do określonej pozycji? ====
Jest kilka możliwości, które mogą do tego doprowadzać:
* Jeśli [[autopilot]] twojego samolotu jest włączony, przejmie on (część) twoich elementów sterujących. Wyłącz autopilota, aby odzyskać kontrolę.
* Niektóre laptopy mają wbudowany czujnik grawitacji, który może zostać wykryty jako [[joystick]]. Zobacz jak to rozwiązać na [[Troubleshooting input devices#Controls returning to a particular position|Rozwiązywanie problemów z urządzeniami wejściowymi]].

==== Dlaczego mój kokpit znika, gdy się rozglądam? ====
Prawdopodobnie używasz wersji samolotu z panelem 2D. Upewnij się, że wybrałeś ten z kokpitem 3D. Większość samolotów ma go teraz!

==== Wokół lata mnóstwo innych samolotów ====
FlightGear posiada tak zwany system sztucznego ruchu lotniczego (AI Traffic). System ten generuje sterowane przez komputer samoloty na podstawie prawdziwych planów lotu, aby świat we FlightGear wyglądał bardziej żywo. Aby wyłączyć sztuczny ruch idź do menu "SI" > "Ruch lotniczy oraz scenariusze" i odznacz opcję "Enable AI traffic".

Jeśli natomiast nie widzisz żadnych samolotów poza swoim, rozważ [[AI Traffic|przyczynienie się do dodania ruchu]] w swoim ulubionym miejscu!

==== Samolot ciągle skręca w lewo, nie mogę lecieć prosto! ====
Tak, FlightGear jest prawdziwym symulatorem lotu i modeluje te efekty. Dokładnie tak zachowują się prawdziwe samoloty śmigłowe. Zobacz [[Understanding Propeller Torque and P-Factor|zrozumienie momentu obrotowego śmigła i współczynnika P]].

Sprawdź też rozkład obciążenia samolotu. Spróbuj dodać drugiego pilota o wadze 180 funtów i zobacz, czy efekt zostanie zniwelowany.

== Wkład własny ==

=== W jakim języku napisany jest FlightGear? ===
Głównie C++ z pewną ilością wspierającego kodu C, który jest głównie zawarty w SimGear. Więcej szczegółów na temat użytych języków:
* [https://www.openhub.net/p/flightgear/analyses/latest/languages_summary Moduł FlightGear]
* [https://www.openhub.net/p/simgear/analyses/latest/languages_summary Moduł SimGear]
* [https://www.openhub.net/p/flightgeardata/analyses/latest/languages_summary Dane FlightGeara] (samoloty, dźwięki itp.)

Ponieważ wydajesz się być zainteresowany rozwojem rdzenia, powinieneś naprawdę sprawdzić [[Howto:Start core development]].

=== Jak zaprojektować model dynamiki lotu do nowego samolotu? ===

FlightGear obsługuje różne [[flight dynamics model|modele dynamiki lotu]] (FDM), ale tylko dwa z nich są powszechnie używane:
* [[JSBSim]]: patrz http://jsbsim.sf.net/.
* [[YASim]]: jeśli chcesz pracować z prostszym FDM, spróbuj swoich sił w YASim. Przewodnik dotyczący tworzenia samolotów YASim znajduje się w podstawowym pakiecie FlightGear w pliku <tt>[[$FG_ROOT]]/Docs/README.yasim</tt>.

Zobacz [[Portal:Developer/Aircraft|Portal rozwoju samolotów]].

=== Jak zaprojektować albo zmienić panel? ===
Zobacz plik <tt>[[$FG_ROOT]]/Docs/README.xmlpanel</tt>.

=== Skąd mogę się nauczyć programowania 3D i zaangażować się? ===
Jeśli chciałbyś stworzyć trójwymiarowy kokpit samolotu do FlightGear lub stworzyć budynki, zewnętrzne modele samolotów itp., Twoja pomoc jest bardzo potrzebna. Postaraj się nie przesadzać ze złożonością siatki. Najczęściej używanymi narzędziami są tutaj [[Blender]], [[AC3D]], [[Gimp]].

Jeśli natomiast naprawdę chcesz wejść w programowanie w C++, będziesz musiał kupić sobie dobrą książkę o [[OpenGL]]. Jednak, FlightGear korzysta z biblioteki wysokiego poziomu [[OSG]], wydajnego zestawu narzędzi do grafiki 3D. Aby rozpocząć pracę z kodowaniem 3D w C++, możesz przejrzeć dokumentację OSG i nauczyć się tylko tyle OpenGL, ile będziesz potrzebować.

=== Jak mogę dodać lotnisko? ===

Proces ten obejmuje stworzenie układu lotniska w [[WorldEditor]], przetestowanie go (możesz chcieć wygenerować część scenerii, ale nie jest to obowiązkowe), a następnie, jeśli twoje źródła danych są zgodne z GPL, użycie [[WorldEditor]] do przesłania go do bramki. Lotnisko będzie dostępne w następnej pełnej przebudowie scenerii, chyba że chcesz wygenerować własną scenerię. Więcej na [[Howto:Make an airport]].

=== Czy mogę stworzyć własną scenerię? ===

Tak, choć może to być trudne zadanie. Generowaniem scenerii dla FlightGeara zajmuje się siostrzany projekt [[TerraGear]]. Dobrą wiadomością jest to, że gdy już wszystko ustawisz, jest to dość łatwe (choć może być czasochłonne), a przede wszystkim, że możesz to łatwo udostępnić.

== Problemy ==

=== Błędy sieciowe lub DNS podczas pobierania terenu ===
Jeśli wystąpią błędy sieciowe/DNS, wpisz <code>--prop:/sim/terrasync/http-server= twój serwer</code> w dodatkowych ustawieniach programu uruchamiającego (np. <code>--prop:/sim/terrasync/http-server=http://flightgear.sourceforge.net/scenery</code>) lub kliknij przycisk „Pokaż więcej” po prawej stronie i wybierz serwer DNS.

Patrz post na forum: [https://forum.flightgear.org/viewtopic.php?p=438783 Network errors occurred]

=== X-y nie działają / są uszkodzone / złe / nie uruchamiają się ===
FlightGear jest bardzo skomplikowanym programem. Jeśli potrzebujesz pomocy w ogólnym użytkowaniu symulatora, znajdziesz ją na [[Portal:User|portalu Użytkownika]] oraz na {{forum link|text=forum FlightGeara}}.

Jeśli Twoim problemem jest zawieszanie się oprogramowania, otrzymujesz błędy itp., rozważ zastosowanie się do wskazówek zawartych na stronie [[Troubleshooting problems|rozwiązywania problemów]].

Niektóre z najczęściej występujących problemów są jednak wymienione poniżej. Jeśli nie możesz rozwiązać problemu samodzielnie i potrzebujesz pomocy kogoś, proszę pamiętaj, że jesteśmy ''wszyscy'' tutaj dla zabawy, deweloperzy również, i że każda pomoc ''jest'' aktem hojności. Więc postaraj się być miły, nawet jeśli problem cię frustruje.

=== Co się stało z panelem, klawiaturą itp.? ===
Problemem jest prawie na pewno to, że Twój pakiet bazowy (FGData) nie jest zsynchronizowany z FlightGearem. Wiele konfigurowalnych części FlightGeara jest zdefiniowanych w plikach [[XML]] zawartych w pakiecie podstawowym.

=== Dlaczego FlightGear działa tak wolno? ===
Jeśli wydaje Ci się, że FlightGear działa zbyt wolno, sprawdź w [[Howto: Improve Framerates]], czy możesz pokombinować z ustawieniami grafiki.

Jeśli wszystko działa skrajnie wolno (np. ~1 klatka na sekundę), być może sprzętowa akceleracja 3D nie jest aktywna. Upewnij się, że masz zainstalowane biblioteki OpenGL i [[Graphics drivers configuration|poprawnie skonfigurowane]] oraz upewnij się, że masz najnowsze sterowniki do swojej karty graficznej. Bądź również świadomy, że niektóre karty graficzne [[Problematic Video Cards|nie są zbyt dobrze wspierane]].

=== Jak sprawdzić liczbę klatek na sekundę? ===

W symulatorze idź do menu "Widok" > "Opcje widoku" i zaznacz tam opcję "Show frame rate".

=== Jak zmienić ustawienia kokpitu 2D? ===

Aby pokazać/ukryć panel 2D użyj kombinacji klawiszy {{Key press|Shift|P}}. Aby wyświetlić/ukryć HUD, naciskaj klawisz {{Key press|Shift|H}}. Możesz też włączyć alternatywny HUD przez naciśnięcie {{Key press|Shift|I}} (naciśnij {{Key press|I}} aby wrócić do domyślnego). Klawiszem {{Key press|Shift|H}} dostosujesz jasność HUD-a.

=== Utknąłem do góry nogami po rozbiciu się? ===

Szybką odpowiedzią jest zresetowanie symulatora, poprzez menu "Plik" > "Zresetuj". To ustawi twój samolot z powrotem w pozycji startowej.

Alternatywnie naciśnij {{Key press|Ctrl|U}} (w domyślnej konfiguracji), aby podnieść samolot o 1000 stóp.

Dla upartych: sztuczka do nauki. Aby wrócić do normalnej (nie odwróconej) pozycji, wznieś się o 500 stóp i obróć się przy użyciu lotek o 180*. Pamiętaj, sterowanie działa odwrotnie gdy jesteś do góry nogami i utrzymuj prędkość!

=== Dlaczego najnowsze wersje niektórych samolotów nie działają w mojej (starszej) wersji FlightGeara? ===
Często rozwój nowych samolotów nadąża za rozwojem kodu FlightGeara. Nowe lub nowo zmodyfikowane samoloty mogą korzystać z plików (takich jak nowe pliki instrumentów) lub funkcji dostępnych tylko w nowszych wersjach FlightGeara. Jeśli utknąłeś w starszej wersji FlightGeara, możesz spróbować pobrać wcześniejszą wersję samolotu z odpowiedniego [[FlightGear_hangars#Official_hangars|oficjalnego hangaru]] FlightGear.

=== Kiedy uruchamiam FlightGear widzę błąd wspominający o "SQLite". Co mam zrobić? ===

Od wersji FlightGear v2.10 (wydanej w lutym 2013) wprowadzono [[navdata cache|pamięć podręczną navdata]], aby poprawić czas uruchamiania FlightGeara. Ta pamięć podręczna to baza danych SQLite, która czasami jest trochę niestabilna. Jeśli baza danych jest uszkodzona, FlightGear nie będzie mógł się uruchomić.

Aby to naprawić musisz po prostu usunąć plik <code>[[$FG_HOME]]/navdata.cache</code>. Przy pierwszym uruchomieniu FlightGeara, po usunięciu pliku, pamięć podręczna navdata zostanie odbudowana. Ponieważ proces ten jest czasochłonny, uruchomienie FlightGeara zajmie więcej czasu.

Niektórzy uciekają się do usunięcia całego katalogu <code>$FG_HOME</code> lub nawet ponownej instalacji FlightGeara. Jednak żadne z nich nie jest potrzebne i może spowodować utratę wszelkich skonfigurowanych niestandardowych preferencji.

Kolejnym wskaźnikiem problemu związanego z SQLite jest komunikat o błędzie:

<tt>
Sqlite error:attempt to write a readonly database (8) while running:
INSERT OR REPLACE INTO stat_cache (path, stamp) VALUES (?,?)
</tt>

W takim przypadku, wcześniej uruchomiona instancja FlightGeara może nadal działać i blokować plik navdata.cache. Sprawdź, czy działa inny proces fgfs i zakończ go.

=== Mój samolot ma szare okna? ===
Problem nieprzejrzystych szarych okien, prze które nie można nic zobaczyć, jest najczęściej spowodowany niezgodnością wersji programu FlightGear i samolotu. Lub może to być spowodowane efektem okna, który nie jest zgodny z systemami renderowania [[Project Rembrandt|Rembrandt]] lub [[ALS]]. Przyczyną techniczną jest niezgodność renderera i zadeklarowanego efektu dla okna. Niektóre rozwiązania obejmują:

* Jeśli używasz stabilnej wersji FlightGeara, pobierz samolot z [[FlightGear_hangars#Official_hangars|oficjalnego hangaru]] pasującego do Twojej wersji FlightGeara.
* Jeśli używasz najnowszej wersji z [[FlightGear Build Server|builda nocnego]] lub [[Building FlightGear|samodzielnie skompilowanej wersji FlightGeara]] lub chcesz używać najnowocześniejszego samolotu, zobacz [[FGAddon#Obtaining aircraft|FGAddon - pozyskiwanie samolotu]].
* Jeśli korzystasz z samolotu z jednego z [[FlightGear_hangars#Unofficial_sites|nieoficjalnych hangarów]], najlepiej skontaktuj się z oryginalnym autorem samolotu lub osobą odpowiedzialną za ten hangar.
* Jeśli używasz [[Project Rembrandt|Rembrandta]], spróbuj wyłączyć ten system renderowania. Samoloty, które używają <code>model-default.eff</code> dla okien (prostym kosztem nierobienia niczego) zamiast <code>model-transparent.eff</code>, <code>model-combined-transparent .eff</code> lub <code>glass.eff</code> (które instruują Rembrandta, aby nie używał odroczonego renderowania dla szyb) będą miały szare okna podczas używania Rembrandta.

=== Mój ekran staje się całkowicie czerwony zaraz po uruchomieniu FlightGear ===
Czerwony ekran to wizualizacja efektu "redout" (napływ krwi do głowy pilota z powodu zbyt dużych przeciążeń). Jeśli pojawia się zaraz po uruchomieniu FlightGeara, może to być spowodowane problemem z ładowaniem scenerii. FlightGear ładuje scenerię w locie, a jeśli scenerii nie można załadować, np. ze względu na problemy z siecią, może nie być podłoża, na którym można zlokalizować statek powietrzny. W rezultacie samolot spada przez nieistniejący grunt, zaczynając się przewracać doprowadzając do nadmiernych przeciążeń. To z kolei powoduje efekt czerwonej planszy. Aby zweryfikować problem, należy rozpocząć lot w KSFO, którego sceneria jest już zawarta w pakiecie podstawowym.

== FAQ ==

=== Z kim się kontaktować w sprawie tego FAQ? ===
Dodaj komentarz na temat FAQ [[Talk:Frequently asked questions|na tej stronie]].

=== Jak stary jest ten dokument? ===
Sprawdź jego <span class="plainlinks">[{{fullurl:{{PAGENAME}}|action=history}} historię]</span>.

=== Jaką inną dokumentację powinienem przeczytać? ===
* [[Pl/Podręcznik_FlightGear|Podręcznik FlightGear]]
* [[Pl/Nowy_w_FlightGear|Nowy we FlightGear]]
* Zobacz także katalog FlightGear/docs-mini/ w dystrybucji źródłowej, aby znaleźć różne inne przydatne dokumenty.

== Wkład własny ==

=== Ochrona treści ===
{{See also|FlightGear Plugins}} DRM
{{Cleanup}}

Co jakiś czas pojawia się pytanie, czy dostarczanie do do FlightGeara zamkniętego kodu źródłowego wtyczki (dokładniej wtyczki czytnika plików OSG) jest legalne. Jedyną potrzebą trzymania kodu w pobliżu jest zapobieganie inżynierii wstecznej.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/27996073/
|title = <nowiki> [Flightgear-devel] Content protection for modders? </nowiki>
|author = <nowiki> Paul Guhl </nowiki>
|date = Aug 25th, 2011
|added = Aug 25th, 2011
|script_version = 0.37
}}</ref><ref>Soitanen (Aug 28th, 2014). {{forum link|title=Re: Encrypted aircraft dynamics|p=217378}}</ref><ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34559749/
|title = <nowiki> [Flightgear-devel] External FDM to protect propriety data in a GPL
eviirenment </nowiki>
|author = <nowiki> Alan Teeder </nowiki>
|date = Oct 21st, 2015
|added = Oct 21st, 2015
|script_version = 0.37
}}</ref>

FlightGear w obecnej postaci jest efektem pracy wielu ludzi, którzy dobrowolnie pracują nad wspólnym wysiłkiem stworzenia otwartej i rozszerzalnej platformy symulatora lotu. Sam Twój pomysł wprowadzenia DRM jest wbrew wszelkim zasadom open source.

Możesz swobodnie stworzyć samolot dla FlightGeara na licencji własnościowej - to są dane z perspektywy symulatora i nie uruchamiają licencji. Możesz to sprzedawać, nie pozwalając na ponowną dystrybucję kodu źródłowego. Musisz trzymać się z dala od kilku rzeczy (nie możesz używać ogólnych instrumentów, bibliotek Nasal,...) ale to powinno być do zrobienia. Możesz pobierać opłaty licencyjne za taki samolot i nikt nie może go redystrybuować.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

dane są analizowane z XML-a do dynamicznych tabel wyszukiwania (IE. STL). Jedynymi zasobami używanymi poza tym, co jest potrzebne do stworzenia funkcji FDM, jest narzut związany z wyciąganiem danych z pliku XML do pamięci. To musiałoby się zdarzyć bez względu na to, w jakiej formie były dane.
Chociaż mogą istnieć lepsze sposoby przechowywania danych niż XML-e, jeśli nie przejmujesz się interakcją człowieka z danymi. Myślę, że uczynienie danych czytelnymi/edytowalnymi dla człowieka jest głównym celem używania XML-i. Może być zbyt gadatliwy, ale działa i istnieją standardowe biblioteki do odczytu/parsowania plików XML, dzięki czemu używanie ich do wprowadzania danych jest dość proste. Jest to korzystne zarówno dla FlightGeara, jak i JSBSim pod względem ograniczenia złożoności obsługi danych konfiguracyjnych. Ponadto istnieje ograniczona liczba standardowych formatów dla tego typu rzeczy, takich jak JSON, a wszystkie te, które są czytelne/edytowalne przez człowieka, mają wiele takich samych problemów jak XML.
W pełni funkcjonalne FDM są złożone, a zrozumienie XML-a używanego do konfiguracji złożonego FDM jest bardzo drobnym problemem, a każdy, kto faktycznie rozumie w pełni funkcjonalny FDM, będzie miał bardzo niewiele problemów z częścią XML.<ref>hvengel (Aug 28th, 2014). {{forum link|title=Re: Encrypted aircraft dynamics|p=217408}}</ref>

FlightGear sam w sobie jest OpenSource, więc niezależnie od tego, w jakim systemie DRM chcemy zakodować dane, każdy może go usunąć (i jest to całkiem legalne). Nie trzeba się zastanawiać, aby wygenerować wersję FlightGear bez ochrony praw autorskich i rozpowszechnić ją, na której Twoja treść działa bez klucza (lub czegokolwiek innego). Biorąc pod uwagę, że ludziom zwykle udaje się złamać schematy DRM przy braku otwartego kodu źródłowego, próba zrobienia tego z kodem źródłowym otwartym dla każdego wydaje się po prostu stratą czasu. Po drugie, jakikolwiek format pliku odczyta OSG, zanim dotrze do renderera, musi być tablicą wierzchołków. Renderer tego potrzebuje, na etapie GLSL nie ma deszyfrowania. Więc są szanse, że skoro działamy na *Open*GL, to znowu każdy, kto naprawdę chce, może wypisać niezaszyfrowany format.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Ponieważ FlightGear jest open source, niezwykle łatwo jest dodać kod, aby uzyskać dostęp do grafu sceny 3D i wyodrębnić pełny model samolotu (z wyłączeniem skryptów, chociaż można je odtworzyć). Informacje po prostu tam siedzą, w pełni widoczne i gotowe do pobrania z gałęzi OSG jak duża soczysta brzoskwinia. Prawdopodobnie mógłbym napisać ten kod w pół dnia, ale konwersja do formatu AC3D, tekstur PNG itp. w celu odtworzenia nowej kopii samolotu zajęłaby trochę więcej czasu. Gdyby FlightGear miał zamknięty kod źródłowy, napisanie kodu ekstraktora OSG byłoby znacznie trudniejsze, ale mimo to nadal wykonalne.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076297/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Edward d'Auvergne </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Właśnie z tego powodu mamy wsparcie dla katalogów i zewnętrznych hangarów. Oczywiście chcemy zachęcać do tworzenia samolotów na licencji GPL, ale nie każdy twórca samolotów chce lub może udostępniać swoje prace na licencji GPL. FlightGear szanuje i wspiera tę opcję.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076199/
|title = <nowiki> Re: [Flightgear-devel] botom line: if i don't my aircraft to be
subject to GPL FGAddon clauses </nowiki>
|author = <nowiki> Stuart Buchanan </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Z pewnością można uruchomić model FDM z zewnątrz i użyć jednej z wielu opcji sieciowych I/O we FlightGear, aby przesyłać dane tam i z powrotem. W przeszłości zrobiono to w kilku projektach badawczych, aby wykorzystać FlightGear jako narzędzie do wizualizacji. Co za tym idzie, możesz zrobić to samo w przypadku skryptów - uruchomić skrypty na zewnątrz i wchodzić w interakcje z FlightGearem za pośrednictwem jednego z tych protokołów.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35076187/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Stuart Buchanan </nowiki>
|date = May 10th, 2016
|added = May 10th, 2016
|script_version = 0.39
}}</ref>

Jeśli faktycznie spróbujesz pobierać opłatę 100$ za samolot dla FlighGear, nie znajdziesz zbyt wielu klientów, ponieważ FG jest popularny głównie w społeczności OpenSource. Jeśli sprawisz, że będzie to zbyt kłopotliwe za pomocą DRM-ów, być może ktoś spróbuje to obejść dla zasady (ludzie robią to dla sportu) - nie jest łatwo sprawić by wieloplatformowy DRM nie był irytujący dla użytkowników.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074186/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Należy pamiętać, że bez względu na format źródłowy (dll, zaszyfrowany + podpisany, binarny itp.), ostatecznie siatka modelu, tekstury i struktura logiczna są wczytywane do wewnętrznych struktur klas OSG. Po zakończeniu tego procesu, aby model mógł zostać wyrenderowany na ekranie, osoba może wywołać odpowiednią funkcję write*File() w celu zapisania poddrzewa modelu w dowolnym obsługiwanym formacie. Jedyne, co jest potrzebne, to dostęp do kodu źródłowego FlightGeara, aby wstawić wywołanie funkcji w strategicznym miejscu. W ostatecznym rozrachunku nie możesz całkowicie chronić swojej treści, jeśli nie masz pełnej kontroli nad sytuacją na poziomie kodu źródłowego aplikacji. I jest to klasyczna strategia hakowania ochrony przed kopiowaniem, wstawiaj magię do kodu po uwierzytelnieniu/załadowaniu/dekodowaniu formatu dystrybucji, a następnie zapisz go w "odszyfrowanym" formacie. Ludzie robią to cały czas, nawet z zastrzeżonym kodem. Wartość celu zwykle określa, jak ciężko są skłonni pracować, aby go ukraść.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074534/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.38
}}</ref>

Dodanie wsparcia dla DRM do FlightGear nie nastąpi - skrypty Nasal są domyślnie dostarczane w formacie zwykłego tekstu (podobnie jak JavaScript), natomiast zaciemnianie jest oczywiście możliwe, jednak nie ma to żadnego sensu w kontekście FlightGear jako projektu otwarto źródłowego.

Ponadto skrypty mogą być łatwo udostępniane i uruchamiane przez użytkowników, po prostu je wymieniając lub kopiując.

Nawet gdybyś zrzucił pośredni kod bajtowy Nasal do pliku obiektowego i wykonał to za pomocą maszyny wirtualnej Nasal, nie byłoby możliwości wyegzekwowania DRM.

Oczywiście, ponieważ FlightGear jest open source, możesz po prostu dodać obsługę DSO/wtyczek do rozwidlenia FlightGear i oprzeć całą swoją pracę na tym rozwidleniu - z drugiej strony, twoje modyfikacje nadal będą musiały być udostępniane.

Istnieje sposób na tworzenie legalnych dodatków z zamkniętym kodem źródłowym: możesz napisać cały "tajny" kod C++ jako zewnętrzną aplikację i pozwolić jej komunikować się z FlightGearem za pośrednictwem gniazd sieciowych. To powinno działać w miarę dobrze. Ale nie oczekuję, że zdobędziesz wielu klientów. Przede wszystkim, przynajmniej w Linuksie, nikt nie chce uruchamiać binarnych blobów, które mogłyby z łatwością wymazać katalog domowy podczas zabawy we FlightGear. A potem dzieje się tyle darmowych samolotów, z dużym rozmachem, że prawdopodobnie zawsze będziesz w tyle. A ci programiści mają bliskie powiązania z (lub są) programistami FlightGeara, więc mają tę zaletę, że mogą w dowolnym momencie zmienić kod FlightGeara według własnych upodobań. Mogą zmieniać interfejs do woli, a ty musisz nadrobić zaległości i zająć się reklamacjami klientów, którzy nagle siadają na zepsutym binarnym blobie, który nie działa z ostatnią wersją FlightGeara. I wreszcie, to podejście do gniazd działa tylko za pośrednictwem systemu właściwości i jest otwarte do wglądu dla każdego (oprócz niedawno dodanej półtajnej właściwości wektora śmieci).

FlightGear nie ma możliwości ładowania samolotów z bibliotek współdzielonych. Możesz rozpowszechniać swój samolot na licencji zastrzeżonej, tak jak robi to Vitos, ale nie jako biblioteka współdzielona. Zmiana we FlightGear, aby mógł ładować samoloty z bibliotek współdzielonych, wymagałaby dużo pracy. Kto miałby to robić i dlaczego ktokolwiek miałby to robić, skoro mógłby poświęcić swój czas na ulepszanie wolnego oprogramowania? I dlaczego główni twórcy FlightGear mieliby akceptować taki wkład?<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073736/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Ludovic Brenta </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Realistycznie patrząc, jeśli chcesz sprzedać komercyjny samolot, twoją bazą klientów będzie Flight Sim X, X-Plane, Prepar3D. Po prostu nie uzyskasz żadnej przyczepności w ekosystemie FlightGear. Nie jest on do tego stworzony.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074166/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> geneb </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Poza tym obsługa języka skryptowego OSG (lua) nie może uzyskać dostępu do wszystkich wewnętrznych funkcji Nasal, po prostu dlatego, że we FlightGear nie zaimplementowano kodu łączącego. Więc nie ma żadnych właściwości dla ciebie i żadnego dostępu do wewnętrznego wywołania funkcji, które zapewnia Nasal.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074133/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Erik Hofman </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Posiadasz prawa autorskie do swojej pracy, nawet jeśli wydasz ją na licencji GPL i możesz dalej rozwijać swoją pracę i wydać bardziej kompletną wersję na licencji komercyjnej, jeśli tylko chcesz (jest to wariant podwójnej licencji). Jedynym sposobem, aby nie zachować praw autorskich do tego, co robisz, jest przeniesienie ich na kogoś innego lub zrzeczenie się ich poprzez udostępnienie swojej pracy jako domeny publicznej. Jeśli stworzysz model 3D dla samolotu FG i nadasz mu licencję GPL, nikt nie zabroni Ci adaptacji i sprzedaży go dla X-Plane. W rzeczywistości możesz go sprzedawać również dla FG (ale inni mogą go redystrybuować, jak im się podoba, gdy go kupią, ponieważ jest to GPL, więc może to nie być zbyt opłacalny model biznesowy).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073832/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Thorsten Renk </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Czy inne symulatory oferują szyfrowanie lub ochronę zawartości? Na przykład udało mi się zlokalizować i przetestować wtyczkę blendera, która może otworzyć wiele modeli samolotów MSFS. A jak z X-Plane? Minął *długi*, *długi* czas, odkąd majstrowałem przy ich pakiecie, ale w tamtym czasie zwracałem uwagę, że wszystkie ich formaty 3D były otwarte i dobrze zdefiniowane. Często komercyjne symulatory przechowują rzeczy we własnych formatach binarnych, ale w większości przypadków nie są one zaszyfrowane, a użytkownicy końcowi dość szybko je odszyfrowują -- więc mogą edytować lub tworzyć nową zawartość w tym samym formacie. Nie uważałbym formatu binarnego za schemat ochrony treści, zwłaszcza w projekcie typu open source, w którym źródło do ładowania i przechowywania formatu binarnego jest łatwo dostępne. Rozumiem pragnienie twórców treści, aby nie dać się „oszukać”. Ale zrozum też, że jednym z głównych powodów, dla których FlightGear może odnieść sukces, jest to, że cały kod źródłowy i zawartość są otwarte. Gdybyśmy nie otworzyli wszystkiego, nie otrzymalibyśmy prawie takiej samej liczby datków wolontariuszy, a wysokiej jakości wolontariat jest kluczowym powodem, dla którego FlightGear odniósł taki sukces. Gdybyśmy byli zamkniętą organizacją komercyjną, kto chciałby się włączyć i pomóc komuś innemu zarabiać pieniądze? Ale gdy wszystko jest otwarte, wiesz, że wszyscy inni mogą cieszyć się takim samym wkładem, tak samo jak Ty cieszysz się wkładem wszystkich innych. Istnieje kilka oszustów, którzy próbują zarobić na pracy innych ludzi i chętnie kłamią i wprowadzają w błąd, aby wyłudzić jak najwięcej pieniędzy od niczego niepodejrzewających użytkowników końcowych. Prawda jest taka, że ci ludzie zawsze istnieli i zawsze będą istnieć. Są niezwykle skrupulatni i uporczywi w kopiowaniu rzeczy, posuwają się nawet do łamania schematów ochrony przed kopiowaniem, przeprowadzania inżynierii wstecznej projektów sprzętu, kopiowania dokładnego wyglądu produktów (nawet łącznie z logo). To nie jest problem, który jest unikalny dla projektu FlightGear -- i jest to coś, z czym wciąż byśmy się borykali, bez względu na to, jak ciężko pracowaliśmy nad stworzeniem schematów ochrony przed kopiowaniem. Jeśli zaprojektowałeś format zawartości binarnej, ktoś dokona inżynierii wstecznej. Jeśli zaprojektujesz schemat szyfrowania, ktoś po prostu zmodyfikuje kod symulatora, aby zrzucić odszyfrowaną wersję po załadowaniu jej do pamięci przez zastrzeżoną wtyczkę deszyfrującą (o ile nie złamie schematu szyfrowania lub nie ukradnie kluczy szyfrowania). We wszystkich tych przypadkach zawartość nadal można łatwo kopiować, replikować, sprzedawać itp. Najlepszy schemat, jaki widziałem, to taki, który ma klucz blokady węzła, który będzie działał tylko na jednym komputerze (klucz przypisany do adresu mac lub identyfikatora procesora). Oznacza to jednak bardziej skomplikowaną dwuetapową instalację, w której użytkownik musi wrócić do Ciebie po zainstalowaniu produktu, zgłosić swój unikalny identyfikator, uzyskać klucz, a następnie zainstalować ten klucz, zanim będzie mógł działać. Problem z tym wszystkim polega na tym, że w projekcie open source ktoś może po prostu skompilować nową wersję symulatora, która pomija sprawdzanie klucza lub akceptuje trywialny klucz lub dowolny klucz. Zastanawiam się tutaj nad różnymi możliwościami, ale mam nadzieję, że widzisz, że to, co na pierwszy rzut oka wydaje się prostą prośbą, w rzeczywistości jest dość złożone i w dalszym ciągu powoduje różnego rodzaju problemy (zarówno pod względem technicznym, jak i ze wsparciem użytkowników). Ostatecznie złoczyńcy i tak zazwyczaj znajdują obejścia i nie są zbytnio spowalniani. Kiedy rolnicy uprawiają rośliny, muszą znosić chwasty. Możemy spróbować rozsądnych rzeczy, aby zminimalizować chwasty, ale jeśli jesteś zbyt agresywny w zabijaniu chwastów i nie tolerujesz ani jednego, najprawdopodobniej zabijesz również większość swoich upraw. Dlatego uważam, że jest to coś, z czym musimy się po prostu pogodzić. Możemy spróbować podjąć rozsądne kroki, aby zminimalizować problem, ale nie możemy wyeliminować wszystkich złych osób bez szkody dla wszystkich dobrych rzeczy w naszym projekcie.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/27998023/
|title = <nowiki> Re: [Flightgear-devel] Content protection for modders? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Aug 25th, 2011
|added = Aug 25th, 2011
|script_version = 0.37
}}</ref>

Kiedy już rozpowszechniłeś kod źródłowy na licencji GPL, wyraźnie zadeklarowałeś, że każdy ma prawo do redystrybucji i modyfikacji - o ile nie rozpowszechnia go na innej licencji. Ale ty, jako właściciel praw autorskich, możesz zmienić licencję dla nowej wersji kodu, której jeszcze nie rozpowszechniałeś na licencji GPL - o ile modyfikacje te nie zostały dokonane przez innych, tj. Ty, jako jedyny posiadacz praw autorskich, możesz również rozpowszechniać go na kilku licencjach jednocześnie, np. GPL i niektórych licencjach własnościowych (czyniąc go wartym pieniędzy, które ludzie mogą za niego zapłacić, dzięki szybszym poprawkom błędów, dystrybuowanym tylko do płacących klientów itp.).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073990/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Jens Thoms Toerring </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Inną rzeczą do rozważenia jest to, że dystrybucja Twojego statku powietrznego jako .dll lub .so nie ukryła by ani nie zaciemniła by Twojego kodu i tekstur po załadowaniu ich do struktur symulatora w celu renderowania. Reszta FlightGeara jest open source, więc wstawienie wywołania funkcji OSG, aby zapisać samolot (modele i tekstury) w innym popularnym formacie 3D, nie wymagałoby wiele wysiłku. Spowodowałoby to pewne straty w zakresie organizacji plików źródłowych, ale mimo to dałoby miejsce startu komuś, kto zamierza skopiować lub zmodyfikować pracę. Cała konfiguracja XML także powinna być dostępna za darmo w drzewie właściwości. Licencjonowanie Nasal (jak sądzę) jest napisane w sposób, który utrudnia dystrybucję zastrzeżonego kodu Nasal. Zatem stworzenie samolotu dla FlightGear zabezpieczonego przed modyfikacjami, nie mówiąc już o kopiowaniu, wiązałoby się z pewnymi naprawdę poważnymi wyzwaniami.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35073896/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.37
}}</ref>

Kluczem do projektu open source nie jest to, czy możesz wygrać spór prawny, czy nie. Chodzi raczej o to, aby przede wszystkim unikać wszelkich sporów prawnych i to za wszelką cenę. To znaczy trzymać się z dala od sądu. Aby bezpiecznie użyć czegoś takiego w projekcie open source, sugerowałbym coś w następujący sposób:
* Upublicznienie swojego produktu pochodnego w całości (ale bez licencji, mówiąc, że jest to materiał chroniony prawem autorskim),
* Zwrócenie się do właścicieli oryginalnego produktu i przekazanie im linku do produktu pochodnego,
* Poproszenie ich o publiczne oświadczenie, że produkt pochodny może być licencjonowany przy użyciu licencji „GPLv2 lub nowszej wersji”,
* Pamiętaj, aby poprosić ich o zidentyfikowanie publicznego produktu pochodnego jako łącza i zidentyfikowanie wszystkich jego części (aby uniknąć późniejszego stwierdzenia, że umieściłeś fragmenty chronionego materiału).

Kopię zapasową każdego oświadczenia złożonego w sieci można znaleźć w archiwum internetowym (http://web.archive.org/). Aby uprościć ten proces, możesz sporządzić część oświadczenia opisującą w całości produkt pochodny, ze wszystkimi szczegółami. Dzięki temu nie będzie już żadnych odcieni szarości! Jeśli chętnie to zrobią, to z prawnego punktu widzenia nie będzie problemu z ich użyciem (tj. szara sytuacja zmieniła się w białą). Jeśli nie są zadowoleni z Twojej propozycji, pewnego dnia mogą odwrócić się i pozwać (tj. szara sytuacja zmieniła się w czystą czerń).<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34561220/
|title = <nowiki> Re: [Flightgear-devel] External FDM to protect propriety data in a
GPL eviirenment </nowiki>
|author = <nowiki> Edward d'Auvergne </nowiki>
|date = Oct 22nd, 2015
|added = Oct 22nd, 2015
|script_version = 0.37
}}</ref>

Świat open source zależy od warunków licencji i praw autorskich oraz współpracy i zaufania w celu ochrony naszej pracy. Znosimy niewielki podzbiór ludzi, którzy chcą nadużywać tych warunków i mamy nadzieję, że presja większej grupy utrzyma złych aktorów w ryzach. Czasami istnieje środek prawny, czasami trudno jest coś z tym zrobić, gdy problemy wykraczają poza granice kraju (lub gdy ktoś po prostu chce złamać zasady dla własnych korzyści). Mam jednak wrażenie, że na dłuższą metę większość ludzi jest uczciwa i chce postępować właściwie, a mała grupa, która naprawdę istnieje, aby powodować problemy lub po prostu służyć sobie kosztem innych, nigdy nie przetrwa tak długo, jak większa grupa ludzi o dobrych intencjach. Ostatecznie musisz samodzielnie określić, ile wysiłku włożyłeś w model, ile pieniędzy możesz zarobić na jego sprzedaży, w porównaniu z ryzykiem, że ktoś go sam skopiuje i rozpowszechni, w porównaniu z kosztami prawnymi, aby spróbować ich powstrzymać.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/35074534/
|title = <nowiki> Re: [Flightgear-devel] can i distribute my airplane as a shared
library, and what legislation issues would that ensue? </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = May 9th, 2016
|added = May 9th, 2016
|script_version = 0.38
}}</ref>

=== Obejścia DRM ===

W jednym z moich poprzednich projektów miałem do czynienia z autorskim modelem dynamiki lotu. Początkowo korzystałem z interfejsu Ethernet, aby mógł działać jako zewnętrzna samodzielna aplikacja. Potem przełączyłem się na dwukierunkowy układ potoków uniksowych, więc mogłem mieć ściślejszą synchronizację z kolejnością wykonania, ale nadal zewnętrzny program był całkowicie niezależny i samodzielny. Chciałbym, aby wszystko było darmowe i otwarte, ale w tym przypadku nie miałem wyboru i było to coś zakupionego od firmy zewnętrznej na surowych warunkach. Czułem, że dwa niezależne, samowystarczalne programy (które mogą ze sobą rozmawiać i wymieniać informacje) stworzyły wystarczającą separację licencji, aby honorować warunki licencji GPL FlightGeara.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/34559783/
|title = <nowiki> Re: [Flightgear-devel] External FDM to protect propriety data in a
GPL eviirenment </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Oct 21st, 2015
|added = Oct 21st, 2015
|script_version = 0.37
}}</ref>

Na ile to jest warte, FDM „ExternalPipe” został skonfigurowany tak, aby obejmował większość obszarów, których dotknąłeś. Prawdopodobnie nie jest to dokładnie to, czego chcesz, ale oto trochę mojej logiki w tym, jak/dlaczego skonfigurowałem to tak, jak to zrobiłem:
* Korzystanie z interfejsu sieciowego dodaje trochę indeterminizmu. Czasami pakiety sieciowe są opóźniane lub układają się w stos w zależności od tego, co dzieje się z maszyną, więc nie ma gwarantowanej relacji między symulatorem a dynamiką lotu.
* Zwykle interfejs sieciowy jest dobry, ale zaobserwowałem czasy, kiedy pakiety docierały tam, gdzie powinny, z dodatkowymi opóźnieniami.
* Alternatywnie ustawiam parę „nazwanych potoków”. Potoki są konstrukcją uniksową, dla programu wyglądają jak plik, ale to, co do nich zapisujesz, jest gromadzone i przechowywane do odczytania przez inną aplikację. Niestety nie są one obsługiwane w systemie Windows. Potoki są jednokierunkowe, stąd potrzeba dwóch do komunikacji dwukierunkowej. Potok jest naprawdę prosty: otwierasz go jak każdy inny plik, a jeden proces zapisuje w nim; odczytuje z niego inny proces. W międzyczasie system operacyjny może buforować pewną ilość informacji, dopóki proces odczytujący ich nie złapie. Możesz użyć blokowania odczytów (ostrożnie z tym), aby mieć pewność, że FlightGear i zewnętrzny FDM działają dokładnie tak samo.
* Potoki oznaczają, że oba procesy będą działać na tej samej maszynie, interfejs sieciowy pozwoliłby procesom działać na oddzielnych maszynach.
* Interfejs ExternalPipe obsługuje elastyczny interfejs właściwości, więc zewnętrzny proces FDM może wysyłać dowolne pary nazwa/wartość, które chce wysłać, a interfejs sumiennie skopiuje je do drzewa właściwości FlightGeara. Strona FDM może również wysłać listę nazw właściwości, które chciałaby otrzymać w odpowiedzi, a interfejs będzie sumiennie przesyłał je potokiem wychodzącym w każdej klatce. To był miły dodatek, a nazwane potoki mają dużą przepustowość, aby zrobić to czystym tekstem, nawet z wieloma dodatkowymi wartościami właściwości.

Historia: Użyłem tego jako części projektu, który zrobiłem z symulatorem lotu ATC. Mieli własne, zastrzeżone aplikacje do dynamiki lotu, które modelowały konkretny statek powietrzny w samym kodzie. Modele te posiadały całą niezbędną dokumentację źródłową i dane z testów w locie, aby spełnić wymagania testowe certyfikacyjne FAA dotyczące ostatecznego symulatora. Ponadto ten zewnętrzny kod modelował wiele systemów samolotu dla jednej z ich wysokiej klasy symulacji. Wymagało to elastyczności w zakresie wysyłanych tam i z powrotem wartości i umożliwiło mi sterowanie niektórymi wskaźnikami przyrządów bezpośrednio z kodu zewnętrznego.<ref>{{cite web
|url = https://sourceforge.net/p/flightgear/mailman/message/31900851/
|title = <nowiki> Re: [Flightgear-devel] Feeding FlightGear data through the Protocol
Pipe </nowiki>
|author = <nowiki> Curtis Olson </nowiki>
|date = Jan 29th, 2014
|added = Jan 29th, 2014
|script_version = 0.37
}}</ref>

[[Category:FlightGear]]

[[de:FAQ]]
[[en:Frequently asked questions]]
[[es:Preguntas frecuentes]]
[[fr:Foire aux questions]]
[[it:Domande frequenti]]
[[ja:FAQ]]
[[nl:veel gestelde vragen]]
[[pt:FAQ]]
[[pt-br:Perguntas_frequentes]]
[[sr:FAQ]]

Pl/Opcje wiersza poleceń

2026-04-27T09:29:40Z

PlayeRom: /* Opcje IO */

{{note|Ten artykuł przedstawia aktualne opcje wiersza poleceń, włączając wersję deweloperską. Aby sprawdzić opcje dla wersji '''FlightGeara 2020.3.x''', zobacz artykuł [[Command line options 2020.3]].}}

'''Opcje wiersza poleceń''' to powszechny sposób informowania aplikacji, co i jak ma robić podczas uruchamiania. We [[FlightGear]] są one używane do wielu rzeczy, od prostych, takich jak wybór samolotu, po złożone, takie jak ruch sieciowy i parametry pogodowe.

Najłatwiejszym sposobem obsługi tych opcji we FlightGear jest użycie narzędzia z graficznym interfejsem użytkownika, takim jak [[FlightGear Qt launcher]]. W ten sposób nie trzeba się nimi w ogóle przejmować.

Są jednak użytkownicy, którzy nie chcą lub nie mogą uruchamiać GUI i dlatego są tym zainteresowani. Ci, którzy ich potrzebują lub po prostu chcą dowiedzieć się więcej o FlightGear, ale nie mają pojęcia, o czym mówimy, mogą przeczytać stronę wiki o ogólnym użyciu [[command line|wiersza poleceń]].

Dobrym miejscem do przechowywania osobistych opcji jest plik o nazwie [[fgfsrc]]. Ten plik jest odczytywany przez FlightGear przy każdym uruchamianiu.

Poniższe listy przedstawiają opcje FlightGear, w tym krótki opis i są posortowane wg kategorii. Pamiętaj, że utrzymywanie aktualności tych list na wiki nie jest łatwym zadaniem. Istnieją również różne wersje FlightGear, które nie mają dokładnie tych samych opcji. Dlatego lepiej sprawdź również swoje wersje za pomocą polecenia <code>fgfs --help --verbose</code>. Jeśli to polecenie nie powiedzie się, możesz dodać również opcję <code>--fg-root=[ścieżka]</code>. Co to oznacza, patrz poniżej.

To smutne, ale prawdziwe, że nawet powyższe polecenie nie jest, przynajmniej w Gitcie, cały czas aktualne. W chwili pisania tego tekstu przynajmniej jedna obsługiwana opcja nie jest wyświetlana za pomocą <code>fgfs --help --verbose</code>. Więc jeśli masz poważne problemy z jakąś opcją, to kod źródłowy, jak zawsze, jest najlepszym źródłem informacji. W pliku ''src/Main/options.cxx'' wszystkie opcje są wymienione na stałe wraz z ich ustawieniem ''domyślnym'' i typem.

Plik [[$FG_ROOT]]/options.xml służy do generowania danych wyjściowych dla <code>fgfs --help [--verbose]</code>. To jest powód, dla którego <code>--fg-root=[ścieżka]</code> musi zostać do tego dodana, jeśli nie jest ustawiona jako zmienna środowiskowa lub jako opcja w fgfsrc.

Sposób użycia z linii komend: <code>fgfs [OPTION [OPTION ...]]</code>

Sposób użycia z [[FlightGear Qt launcher]]: idź do zakładki "Ustawienia" i w sekcji "Dodatkowe ustawienia" wpisz poniższe opcje, każda w nowej linii. Wpisane tam opcje mają pierwszeństwo przed tymi zdefiniowanymi przez Qt Launcher. Aby z poziomu Qt Launchera zobaczyć całą listę użytych opcji wiersza poleceń, użyj skrótu klawiszowego {{Key press|Ctrl|L}} lub z menu wybierz "Zobacz listę parametrów".

= Legenda sposobu zapisu poniższych opcji =

# <code>--option1</code> (<code>--option2</code>) - w tym przypadku <code>--option2</code> jest aliastem dla <code>--option1</code>, czyli robi dokładnie to samo co <code>--option1</code>.
# <code>--option1</code><br/><code>--option2</code> - dwie różne opcje, wykluczające się. Nie można ich użyć jednocześnie, ale są połączone ze względu na wspólny opis.
# <code>--option1</code>, <code>--option2</code> - dwie różne opcje, które można podać jednocześnie, są połączone ze względu na wspólny opis.

= Wartości dla opcji =

Pewne opcje nie przyjmują wartości, jak np. <code>--help</code>, ale są też opcji, dla których powinieneś podać wartość, jak np. dla <code>--fg-root</code> oraz są też opcje, dla których możesz podać wartość opcjonalnie, np. dla <code>--launcher</code>. Możesz oddzielić wartość od opcji znakiem <code>=</code> lub spacją, np.:

--fg-root=/path/to/fgdata
--fg-root /path/to/fgdata

Opcje, które działają jak przełącznik włącz/wyłącz, mogą przyjąć wartości <code>true</code>, <code>1</code>, <code>yes</code> (włącz) lub <code>false</code>, <code>0</code>, <code>no</code> (wyłącz). Jeśli dla takiej opcji nie podasz żadnej wartości, to z domysłu zadziała ona tak jakbyś przekazała tam <code>true</code>, <code>1</code> lub <code>yes</code>, czyli ją włączył, np.:

--launcher

uruchomi Launcher, co jest równoznaczne z:

--launcher=yes

Z drugiej strony możesz także przekazać wartość, która wyłączy daną opcję, np.:

--launcher=no

co spowoduje, że Launcher nie będzie uruchamiany. Poza tym, większość takich opcji zawiera dodatkowo dwa warianty z przedrostkami <code>enable-</code> i <code>disable-</code>, np.:

--enable-launcher

co także włączy Launcher.

= Opcje ogólne =

<code>--help</code> (<code>-h</code>)
::Pokaż najbardziej istotne opcje wiersza poleceń.

<code>--verbose</code> (<code>-v</code>)
::Pokaż wszystkie opcje wiersza poleceń w połączeniu z <code>--help</code> lub <code>-h</code>.

<code>--version[={true|false|1|0|yes|no}]</code>
::Włącz/wyłącz wypisanie informacje o wersji FlighGear i niektórych bibliotek używanych przez program (SimGear, OpenSceneGraph, PLIB).

<code>--fg-root=ścieżka</code>
::Określ główną ścieżkę do danych (tam gdzie FlightGear jest zainstalowany).

<code>--fg-scenery=ścieżka[:ścieżka...]</code>
::Określ podstawową ścieżkę scenerii. Domyślnie [[$FG_ROOT]]/Scenery.

<code>--fg-aircraft=ścieżka</code>
::Określ dodatkowe ścieżki katalogów z samolotami (alternatywnie możesz użyć <code>--aircraft-dir</code>, aby wskazać konkretny samolot w podanym katalogu).

<code>--addon=ścieżka</code>
::Określ ścieżkę do dodatku. Można użyć tej opcji wielokrotnie.

<code>--download-dir=ścieżka</code>
::Określ główny katalog jako miejsce przechowywania pobranych samolotów i scenerii. Domyślnie dla Windows %userprofile%\FlightGear\Downloads\, dla Linux ~/.fgfs/. Katalog scenerii TerraSync może być dodatkowo określony przez opcję <code>--terrasync-dir</code>.

<code>--data=ścieżka</code>
::Określa dodatkowy katalog danych podstawowych (FGData), przed katalogiem [[$FG_ROOT]].

<code>--terrasync[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-terrasync</code><br/>
<code>--disable-terrasync</code>
::Włącz/wyłącz automatyczne pobieranie scenerii przez TerraSync.

<code>--terrasync-dir=ścieżka</code>
::Określ katalog gdzie TerraSync będzie przechowywał pobieraną scenerię (domyślnie jest to katalog "TerraSync" w lokalizacji określonej przez <code>--download-dir</code>).

<code>--language=kod</code>
::Ustaw język używany przez symulator podany jako kod. Dostępne kody: <tt>ca</tt>, <tt>de</tt>, <tt>en</tt>, <tt>es</tt>, <tt>fr</tt>, <tt>it</tt>, <tt>nl</tt>, <tt>pl</tt>, <tt>pt</tt>, <tt>ru</tt>, <tt>tr</tt>, <tt>sk</tt>, <tt>zh</tt>.

<code>--launcher[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-launcher</code><br/>
<code>--disable-launcher</code>
:::Włącz/wyłącz uruchamianie [[FlightGear Qt launcher|Qt Launchera]]. Bez tej opcji lub gdy wyłączysz, uruchomi się od razu symulator w domyślnej konfiguracji lub w konfiguracji odczytanej z pliku [[Fgfsrc|fgfsrc]] - o ile istnieje.

<code>--splash-screen[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-splash-screen</code><br/>
<code>--disable-splash-screen</code>
::Włącz/wyłącz ekran powitalny.

<code>--mouse-pointer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-mouse-pointer</code><br/>
<code>--disable-mouse-pointer</code>
::Włącz/wyłącz dodatkowy wskaźnik myszy (dla pełnego ekranu dla kart Voodoo).

<code>--browser-app=ścieżka</code>
::Określ ścieżkę do swojej przeglądarki internetowej aby otworzyć dokumentację statku powietrznego.

<code>--prop:[typ:]właściwość=wartość</code>
::Ustaw podaną właściwość na zadaną wartość. "Typ" jest opcjonalny i może być: <tt>string</tt>, <tt>double</tt>, <tt>float</tt>, <tt>long</tt>, <tt>int</tt> lub <tt>bool</tt>.

<code>--prop:browser=właściwość</code>
::Po uruchomieniu symulatora otwórz okno z drzewem właściwości od razu na podanej właściwości (property). Jeśli potrzebujesz więcej okien, to wystarczy dodać kolejne indeksy przy browser, jak <tt>browser[1]</tt>, <tt>browser[2]</tt> itd., np.:
--prop:browser=/sim/presets
--prop:browser[1]=/devices/status/keyboard/event
co spowoduje otworzenie dwóch okien z podanymi właściwościami.

<code>--config=/ścieżka/plik.xml</code>
::Załaduj dodatkowe właściwości z podanego pliku xml.

<code>--no-default-config[={true|false|1|0|yes|no}]</code>
::Włączy/wyłącz nie wczytywanie żadnych domyślnych plików konfiguracyjnych (jak [[Fgfsrc|fgfsrc]]), chyba że wyraźnie określono je za pomocą <code>--config</code>.

<code>--units-feet</code><br/>
<code>--units-meters</code>
::Używaj stóp (domyślnie) lub metrów do określania odległości.

<code>--allow-nasal-read=ścieżka[:ścieżka...]</code>
::Zezwalaj skryptom Nasal samolotu na odczytywanie plików z wymienionych katalogów (oddziel ścieżki dwukropkami lub średnikami w Microsoft Windows). Jako środek bezpieczeństwa, domyślnie skrypty Nasal mogą odczytywać dane tylko z [[$FG_ROOT]] i [[$FG_HOME]].

<code>--read-only[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-read-only</code><br/>
<code>--disable-read-only</code>
::Włącz/wyłącz folder [[$FG_HOME]] (lokalizację, w której przechowywane są dane FlightGear użytkownika) tylko do odczytu.

<code>--ignore-autosave[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-ignore-autosave</code><br/>
<code>--disable-ignore-autosave</code>
::Włącz/wyłącz ignorowanie pliku autosave, tzn. ustawienia zapisane w tym pliku nie będą wczytywane podczas uruchamiania, ani nie będą zapisywane do tego pliku podczas zamykania symulatora.

<code>--save-on-exit[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-save-on-exit</code><br/>
<code>--disable-save-on-exit</code>
::Włącz/wyłącz zapisywanie preferencji użytkownika podczas wychodzenia z symulatora.

<code>--restore-defaults[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-restore-defaults</code><br/>
<code>--disable-restore-defaults</code>
::Włącz/wyłącz resetowanie wszystkich ustawień użytkownika do wartości domyślnych.

<code>--gui[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-gui</code><br/>
<code>--disable-gui</code>
::Włącz/wyłącz GUI. Wyłączenie GUI oznacza włączenie trybu headless.

<code>--jsbsim-output-directive-file=plik</code>
::Rejestrowanie właściwości JSBSim. Podany plik musi zawierać w sobie znacznik <code><output></code> z odpowiednimi opcjami i właściwościami do logowania - patrz [[JSBSim Logging]].

= Funkcje =

<code>--composite-viewer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-composite-viewer</code><br/>
<code>--disable-composite-viewer</code>
::Włącz/wyłącz CompositeViewer (widoki w osobnych oknach). Opcje te zostały usunięte z wersji dev, gdzie CompositeViewer jest zawsze włączony.

<code>--panel[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-panel</code><br/>
<code>--disable-panel</code>
::Włącz/wyłącz tablicę przyrządów 2D.

<code>--freeze[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-freeze</code><br/>
<code>--disable-freeze</code>
::Uruchom w stanie zapauzowanym/odpauzowanym.

<code>--fuel-freeze[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fuel-freeze</code><br/>
<code>--disable-fuel-freeze</code>
::Włącz/wyłącz nieużywanie paliwa.

<code>--clock-freeze[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-clock-freeze</code><br/>
<code>--disable-clock-freeze</code>
::Włącz/wyłącz zamrożenie upływu czasu. Włączenie jest jednoznaczne z włączeniem pauzy.

<code>--ai-scenario=scenariusz</code>
::Dodaj i włącz nowy scenariusz SI. Dozwolonych jest wiele opcji. Scenariusze znajdują się w [[$FG_ROOT]]/AI/.

<code>--ai-models[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-ai-models</code><br/>
<code>--disable-ai-models</code>
::Włącz/wyłącz podsystem SI (wyłącza to również wyświetlanie modeli innych samolotów w trybie wieloosobowym).

<code>--ai-traffic[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-ai-traffic</code><br/>
<code>--disable-ai-traffic</code>
::Włącz/wyłącz podsystem ruchu generowanego automatycznie.

<code>--vr[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-vr</code><br/>
<code>--disable-vr</code>
::Włącz/wyłącz obsługę zestawu wirtualnej rzeczywistości.

<code>--restart-launcher[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-restart-launcher</code><br/>
<code>--disable-restart-launcher</code>
::Uruchom Launcher po zamknięciu symulatora.

<code>--load-tape={plik|url}</code>
::Wczytaj nagranie wcześniejszej sesji lotu. W przypadku pliku, jeśli plik kończy się na „.fgtape”, jest traktowana jako lokalna ścieżka pliku nagrania. W przeciwnym razie tworzymy ścieżkę lokalną, poprzedzając plik katalogiem taśmy i dopisując „.fgtape”. W przypadku URL-a (zaczynającego się od http:// lub https://) pobieramy zdalne nagranie (które musi być nagrywaniem ciągłym) w tle do nazwy pliku zależnej od adresu URL podczas odtwarzania. Jeśli nazwa pliku zależna od adresu URL już istnieje, zakłada się, że jest to skrócone pobieranie i pobieramy tylko pozostałe dane.

<code>--load-tape-create-video[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-load-tape-create-video</code><br/>
<code>--disable-load-tape-create-video</code>
::Włącz/wyłącz tworzenie plik wideo podczas odtwarzania taśmy określonej przez <code>--load-tape</code>.

<code>--load-tape-fixed-dt=value</code>
::Ustawia tryb fixed delta time podczas odtwarzania taśmy określonej przez <code>--load-tape</code>.

= Samolot =

<code>--aircraft=nazwa</code> (<code>--vehicle=nazwa</code>)
::Wybierz samolot zgodnie z definicją w pliku -set.xml. Plik jest wyszukiwany w [[$FG_ROOT]]/Aircraft, w katalogu wskazywanym przez zmienną środowiskową $FG_AIRCRAFT oraz w katalogach przekazanych do fgfs przy użyciu <code>--fg-aircraft</code>.

<code>--aircraft-dir=ścieżka</code>
::Określ dokładny katalog, który ma być używany dla samolotu (zwykle nie jest to wymagane, ale może być przydatne). Ścieżka jest względna w stosunku do bieżącego katalogu. Powoduje ominięcie opcji <code><path-cache></code> z pliku autosave_X_Y.xml, a także opcji <code>--fg-aircraft</code> i zmiennej środowiskowej $FG_AIRCRAFT.

<code>--show-aircraft</code>
::Wyświetl listę aktualnie dostępnych typów samolotów.

<code>--min-status={alpha|beta|early-production|production}</code>
::Umożliwia zdefiniowanie minimalnego poziomu statusu dla wszystkich listowanych samolotów, które są w trakcie rozwoju. Zobacz [[Aircraft rating system|System oceny statków powietrznych]], aby uzyskać szerszy opis.

<code>--auto-coordination[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-auto-coordination</code><br/>
<code>--disable-auto-coordination</code>
::Włącz/wyłącz automatyczną koordynację. Domyślnie wyłączone. Gdy włączone ster kierunku będzie reagował stosownie do ruchu lotek.

<code>--livery=nazwa</code>
::Wybierz malowanie dla samolotu.

<code>--state=wartość</code>
::Ustaw początkowy stan samolotu na podaną wartość. Stany, które można wykorzystać, zależą od statku powietrznego. Na przykład Cessna 172P ma tylko jeden stan <tt>auto</tt>.

= Model lotu =

<code>--fdm={ada | acms | aisim | balloon | jsb | larcsim | magic | network | pipe | ufo | yasim | external | null}</code>
::Wybierz podstawowy model dynamiki lotu. LaRCsim (wartość <code>larcsim</code>) jako przestarzały model został usunięt z wersji dev.

<code>--aero=nazwa</code>
::Wybierz model aerodynamiki samolotu

<code>--model-hz=n</code>
::Uruchom model dynamiki lotu z częstotliwością "n" Hz (iteracje na sekundę).

<code>--speed=n</code>
::Uruchom model dynamiki lotu "n" razy szybciej niż w czasie rzeczywistym.

<code>--trim[={true|false|1|0|yes|no}]</code><br/>
<code>--notrim[={true|false|1|0|yes|no}]</code>
::Ustabilizuj/nie stabilizuj model dynami lotu (tylko z <code>--fdm=jsbsim</code>).

<code>--on-ground[={true|false|1|0|yes|no}]</code><br/>
<code>--in-air[={true|false|1|0|yes|no}]</code>
::Rozpocznij na ziemi (domyślnie) lub w powietrzu. Nie trzeba ustawiać <code>--in-air</code>, gdy użyte jest <code>--altitude</code>.

= Początkowa pozycja i orientacja =

<code>--airport=ICAO</code>
::Określ lotnisko (e.g. EPWA).

<code>--runway=nr_pasa</code>
::Określ początkowy pas startowy (wymaga podania <code>--airport</code>).

<code>--parking-id=nazwa</code> (<code>--parkpos=nazwa</code>)
::Określ miejsce postojowe na lotnisku (wymaga podania <code>--airport</code>).

<code>--carrier={name|ID}</code>
::Określ pozycję startową na lotniskowcu.

<code>--carrier-position={abeam|FLOLS|name}</code>
::Określ pozycję początkową dla lotniskowca, gdzie możesz użyć wstępnie zdefiniowanej <tt>abeam</tt> (rozpoczęcie na trawersie z wiatrem) lub <tt>FLOLS</tt> (rozpoczęcie po podejściu końcowym) lub określ nazwę pozycji parkingowej lotniskowca. Należy również określić lotniskowiec opcją <code>--carrier</code>.

<code>--vor=ID</code>
::Określ pozycję początkową względem VOR-a

<code>--vor-frequency=częstotliwość</code>
::Ustaw częstotliwość dla VOR-a podanego w opcji<code>--vor</code> (wymaga podania opcji <code>--vor</code>).

<code>--ndb=ID</code>
::Określ pozycję początkową względem NDB.

<code>--ndb-frequency=częstotliwość</code>
::Ustaw częstotliwość dla NDB podanego w opcji <code>--ndb</code> (wymaga podania opcji <code>--ndb</code>).

<code>--fix=ID</code>
::Określ pozycję początkową względem skrzyżowania.

<code>--offset-distance=nm</code>
::Określ odległość do punktu odniesienia (mile morskie).

<code>--offset-azimuth=stopnie</code>
::Określ kurs do punktu odniesienia.

<code>--lat=stopnie</code>
::Początkowa szerokość geograficzna (S ze znakiem minus).

<code>--lon=stopnie</code>
::Początkowa długość geograficzna (W ze znakiem minus).

<code>--altitude=stopy</code>
::Początkowa wysokość (w stopach, chyba że włączono <code>--units-meters</code>).

<code>--heading=stopnie</code>
::Określ kąt kierunku/odchylenia (Psi).

<code>--roll=stopnie</code>
::Określ kąt przechyłu (Phi).

<code>--pitch=stopnie</code>
::Określ kąt pochyłu (Theta).

<code>--vc=węzły</code><br/>
<code>--mach=liczba</code>
::Określ prędkość początkową w węzłach lub w liczbie Macha.

<code>--glideslope=stopnie</code>
::Określ kąt schodzenia (może być dodatni).

<code>--roc=fpm</code>
::Określ początkową prędkość pionową w stopach na minutę (wartość może być ujemna).

<code>--uBody=jednostki_na_sek</code>
::Określ prędkość wzdłuż osi X statku (w stopach na sek., chyba że włączono <code>--units-meters</code>).

<code>--vBody=jednostki_na_sek</code>
::Określ prędkość wzdłuż osi Y statku (w stopach na sek., chyba że włączono <code>--units-meters</code>).

<code>--wBody=jednostki_na_sek</code>
::Określ prędkość wzdłuż osi Z statku (w stopach na sek., chyba że włączono <code>--units-meters</code>).

<code>--vNorth=jednostki_na_sek</code>
::Określ prędkość początkową wzdłuż osi północ-południe dla statku.

<code>--vEast=jednostki_na_sek</code>
::Określ prędkość początkową wzdłuż osi wschód-zachód dla statku.

<code>--vDown=jednostki_na_sek</code>
::Określ prędkość początkową wzdłuż osi pionowej statku.

= Opcje dźwięku =

<code>--show-sound-devices[={true|false|1|0|yes|no}]</code>
::Pokaż listę dostępnych urządzeń audio.

<code>--sound-device=nazwa</code>
::Określ urządzenie audio, którego chcesz użyć. Aby uzyskać dostępne nazwy użyj <code>--show-sound-devices</code>.

<code>--sound[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-sound</code><br/>
<code>--disable-sound</code>
::Wyłącz/wyłącz dźwięk.

= Opcje renderowania =

<code>--prop:/sim/rendering/multi-sample-buffers={true|false}</code>
::Włącz/wyłącz bufor wielopróbkowania (antyaliasing).

<code>--prop:/sim/rendering/multi-samples={2|4|8|16}</code>
::Określ liczbę multipróbek (antyaliasing). Prawidłowe wartości to 2, 4, 8, 16.

<code>--aspect-ratio-multiplier=współczynnik</code>
::Określ mnożnik dla współczynnika proporcji.

<code>--bpp={16|24|32}</code>
::Określ głębię kolorów jako liczbę bitów na piksel.

<code>--compositor=ścieżka</code>
::Określ ścieżkę do pliku XML do renderowania wieloprzebiegowego. Ścieżka jest względna do [[$FG_ROOT]] (domyślnie <tt>Compositor/default.xml</tt>). Dla włączenia potoku HDR użyj ścieżki <code>Compositor/HDR/hdr</code>.

<code>--horizon-effect[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-horizon-effect</code><br/>
<code>--disable-horizon-effect</code>
::Włącz/wyłącz iluzję powiększenia ciała niebieskiego w pobliżu horyzontu.

<code>--distance-attenuation[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-distance-attenuation</code><br/>
<code>--disable-distance-attenuation</code>
::Włącz/wyłącz tłumienie światła na drodze startowej.

<code>--specular-highlight[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-specular-highlight</code><br/>
<code>--disable-specular-highlight</code>
::Włącz/wyłącz odbicia lustrzane na teksturowanych obiektach.

<code>--clouds[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-clouds</code><br/>
<code>--disable-clouds</code>
::Włącz/wyłącz dwuwymiarowe (płaskie) warstwy chmur.

<code>--clouds3d[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-clouds3d</code><br/>
<code>--disable-clouds3d</code>
::Włącz/wyłącz trójwymiarowe (wolumetryczne) warstwy chmur.

<code>--texture-cache[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-texture-cache</code><br/>
<code>--disable-texture-cache</code>
::Włącz/wyłącz pamięć podręczną tekstur dla szybkiego wczytywania.

<code>--texture-cache-dir=ścieżka</code>
::Określ ścieżkę pamięć podręcznej dla tekstur (domyślnie [[$FG_HOME]]/TextureCache).

<code>--fullscreen[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fullscreen</code><br/>
<code>--disable-fullscreen</code>
::Włącz/wyłącz tryb pełnoekranowy.

<code>--random-objects[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-random-objects</code><br/>
<code>--disable-random-objects</code>
::Włącz/wyłącz losowe obiekty scenerii (budynki, itp.)

<code>--wireframe[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-wireframe</code><br/>
<code>--disable-wireframe</code>
::Włącz/wyłącz tryb rysowania siatki modeli 3D.

<code>--fog-disable</code><br/>
<code>--fog-fastest</code><br/>
<code>--fog-nicest</code>
::Ustaw mgłę. Opcja <code>--fog-disable</code> wyłączy mgłę, powodując zwiększenie widoczności oraz spadek wydajności (więcej terenu do wyrenderowania). Opcja <code>--fog-fastest</code> włączy renderowanie mgły w sposób mniej realistyczny, ale zwiększając wydajność. Domyślnie użyta jest opcja <code>--fog-nicest</code> renderująca realistyczną mgłę, kosztem wydajności. Te opcje sa przestarzałe.

<code>--fov=stopnie</code>
::Określ kąt pola widzenia.

<code>--geometry=SzerokośćxWysokość</code>
::Określ rozdzielczość okna (np.: <code>--geometry=1366x768</code>).

<code>--graphics-preset={minimal-quality|low-quality|medium-quality|high-quality|ultra-quality}</code>
::Określ predefiniowane ustawienie graficzne.

<code>--materials-file=plik</code>
::Określ plik materiału używany do renderowanie scenerii, domyślnie: [[$FG_ROOT]]/Materials/regions/materials.xml.

<code>--max-fps=Hz</code>
::Określ maksymalną liczbę renderowanych klatek na sekundę.

<code>--shading-smooth</code><br/>
<code>--shading-flat</code>
::Włącz gładkie lub płaskie cieniowanie. Te opcje sa przestarzałe.

<code>--texture-filtering=liczba</code>
::Określ filtrowanie anizotropowe tekstur terenu. Prawidłowe wartości to 1, 2, 4, 8, 16. Wartość domyślna to 1.

<code>--view-offset=value</code>
::Określ domyślny widok do przodu jako odchylenie od kierunku na wprost. Dopuszczalne wartości: <tt>LEFT</tt> (lewo), <tt>RIGHT</tt> (prawo), <tt>CENTER</tt> (wyśrodkuj) lub określona liczba w stopniach.

<code>--terrain-engine={tilecache|pagedLOD}</code>
::Określ silnik terenu, którego chcesz użyć: <tt>tilecache</tt> lub <tt>pagedLOD</tt>.

<code>--lod-levels=poziomy</code>
::Określ poziomy szczegółowości, gdzie poziomy są ciągiem liczb oddzielonych spacjami. Wartość domyślna to "1 3 5 7 9". Dostępne tylko z <code>--terrain-engine=pagedLOD</code>.

<code>--lod-res=rozdzielczość</code>
::Ustaw rozdzielczość siatki terenu. Domyślnie 1. Dostępne tylko z <code>--terrain-engine=pagedLOD</code>.

<code>--lod-texturing={bluemarble|raster|debug}</code>
::Ustaw metodę teksturowania terenu. Domyślnie <tt>bluemarble</tt>. Dostępne tylko z <code>--terrain-engine=pagedLOD</code>.

<code>--lod-range-mult=mnożnik</code>
::Ustaw mnożnik zakresu (punkt od niskiego do wysokiego poziomu szczegółowości). Domyślnie 2. Dostępne tylko z <code>--terrain-engine=pagedLOD</code>.

<code>--season={summer|winter}</code>
::Włącz scenerię letnią (<tt>summer</tt>) lub zimową (<tt>winter</tt>) - domyślnie <tt>summer</tt>. Dostępna do FG 2020.3.

== Sceneria Świata 3.0 (WS3.0) ==
<code>--prop:/scenery/use-vpb=true</code>
::Włącz Scenerię Świata 3.0

= Opcje wyświetlacza przeziernego (HUD) =

<code>--hud[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hud</code><br/>
<code>--disable-hud</code>
::Włącz/wyłącz wyświetlanie HUD-a, ustawienie domyślne.

<code>--anti-alias-hud[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-anti-alias-hud</code><br/>
<code>--disable-anti-alias-hud</code>
::Włącz/wyłącz antyaliasing dla HUD.

<code>--hud-3d[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hud-3d</code><br/>
<code>--disable-hud-3d</code>
::Włącz/wyłącz HUD 3D.

<code>--hud-tris</code><br/>
<code>--hud-culled</code>
::HUD wyświetla liczbę renderowanych trójkątów lub procent odrzuconych trójkątów.

= Opcje czasu =

Poniższe opcje ustawienia czasu i daty nie są ze sobą kompatybilne, więc należy podawać tylko jedną z nich.

<code>--timeofday={real|dawn|morning|noon|afternoon|dusk|evening|midnight}</code>
::Określ porę dnia:
::::<tt>real</tt>: aktualny czas w danym miejscu;
::::<tt>dawn</tt> (świt): czas, kiedy słońce znajduje się pod kątem 90°E na horyzoncie;
::::<tt>morning</tt> (poranek): czas, kiedy słońce znajduje się na horyzoncie 75°E;
::::<tt>noon</tt> (południe): czas, kiedy słońce znajduje się 0° na horyzoncie;
::::<tt>afternoon</tt> (popołudnie): czas, kiedy słońce znajduje 75°W na horyzoncie;
::::<tt>dusk</tt> (zmierzch): czas, kiedy słońce znajduje się na horyzoncie pod kątem 90°W;
::::<tt>evening</tt> (wieczór): czas, kiedy słońce znajduje się na horyzoncie 100°W;
::::<tt>midnight</tt> (północ): czas, kiedy słońce znajduje się na horyzoncie 180°W;

<code>--time-offset=[+-]hh:mm:ss</code>
::Dodaj podane przesunięcie czasu dla <code>--time-match-real</code>.

<code>--time-match-real</code>
::Zsynchronizuj czas z aktualnym czasem w danym miejscu.

<code>--time-match-local</code>
::Zsynchronizuj czas z czasem systemowym komputera.

<code>--start-date-sys=yyyy:mm:dd:hh:mm:ss</code>
::Określ początkową datę i godzinę w odniesieniu do czasu systemowego.

<code>--start-date-gmt=yyyy:mm:dd:hh:mm:ss</code>
::Określ początkową datę i godzinę w odniesieniu do czasu Greenwich.

<code>--start-date-lat=yyyy:mm:dd:hh:mm:ss</code>
::Określ początkową datę i godzinę w odniesieniu do strefy czasowej lotniska początkowego.

= Opcje sieciowe =

<code>--proxy=[nazwa:hasło@]host:port</code>
::Określ serwer proxy i port, który ma być używany. Nazwa użytkownika i hasło są opcjonalne. Jeśli są obecne, powinny być podane jako skróty MD5. Ta opcja jest przydatna tylko wtedy, gdy włączona jest opcja <code>--real-weather-fetch</code>.

<code>--httpd=port</code>
::Włącz interfejs [[Phi]] (serwer HTTP) na określonym porcie.

<code>--telnet={port|socket,bi,hz,localhost,port,tcp}</code> (<code>--props={port|socket,bi,hz,localhost,port,tcp}</code>)
::Włącz serwer telnet na określonym porcie. Opcjonalnie można zmienić hz (ilość pakietów na sekundę).

<code>--jpg-httpd=port</code>
::Włącz serwer HTTP zrzutów ekranu na określonym porcie. Ta opcja została wycofana, zamiast niej użyj <code>--httpd</code> i użyj URL-a /screenshot.

<code>--allow-nasal-from-sockets[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-allow-nasal-from-sockets</code><br/>
<code>--disable-allow-nasal-from-sockets</code>
::Włącz/wyłącz uruchamianie skryptów Nasal przesyłanych przez gniazdo sieciowe. Włączenie oznacza, że połączenia sieciowe będą miały pełny dostęp do symulatora, w tym uruchamianie dowolnych skryptów Nasal. Upewnij się, że masz odpowiednie zabezpieczenia takie jak zapora, która blokuje połączenia zewnętrzne.

<code>--sentry[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-sentry</code><br/>
<code>--disable-sentry</code>
::Włącz/wyłącz wysyłanie raportów o awariach i błędach do zespołu programistów w celu analizy.

= Opcje Multiplayer =

<code>--callsign=nazwa</code>
::Przypisz pilotowi unikalną nazwę (znak wywoławczy). Znak wywoławczy musi mieć co najwyżej 10 znaków i może zawierać tylko cyfry, litery alfabetu angielskiego, myślniki (-) i podkreślenia (_). Dłuższe znaki wywoławcze są obcinane, a znaki nie pasujące do wymienionych powyżej są zastępowane myślnikami.

<code>--multiplay={in|out},hz,adres,port</code>
::Określ ustawienia komunikacji dla trybu multiplayer. Pierwsze pole określa, czy ustawienia dotyczą komunikacji przychodzącej (in) czy wychodzącej (out). Drugie pole (hz) określa częstotliwość, z jaką mają być wysyłane dane. Trzecie pole (adres) musi być ustawione na adres IP interfejsu sieciowego, którego FlightGear powinien używać do wysyłania/odbierania danych lub pozostawić puste, aby symulator mógł korzystać ze wszystkich dostępnych interfejsów. Czwarte pole (port) powinno być ustawione na wykorzystywany port (zwykle 5000).

<code>--fgcom[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fgcom</code><br/>
<code>--disable-fgcom</code>
::Włącz/wyłącz wbudowany [[FGCom]] (głosowa komunikacja z ATC).

<code>--hold-short[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hold-short</code><br/>
<code>--disable-hold-short</code>
::W trybie wieloosobowym, gdy wybierzemy pozycję początkową na pasie startowym, to domyślnie zostaniemy przeniesieni na pozycję hold short, czyli na drodze kołowania, tuż przed pasem. Opcja <code>--disable-hold-short</code> umożliwia wyłączenie tego zachowania, jednak należy mieć na uwadze, że jest to niepożądane, gdyż może zakłócać innym start czy lądowanie.

= Opcje trasy/punktów na trasie =

<code>--wp=ID[@alt]</code>
::Wprowadź identyfikator punktu trasy (VOR, NDB, fix) do autopilota. Opcjonalna część @alt może służyć do określenia wysokości, na której należy przekroczyć dany punkt, np. OKE@3000 Można użyć tej opcji wielokrotnie.

<code>--flight-plan=plik</code>
::Wczytaj plan lotu z pliku.

= Opcje IO =

<code>--generic=params</code>
::Otwórz połączenie za pomocą predefiniowanego interfejsu komunikacyjnego i uprzednio wybranego protokołu.

<code>--atlas=params</code>
::Otwórz połączenie za pomocą protokołu Atlas (używanego przez Atlas i TerraSync).

<code>--atcsim=params</code>
::Otwórz połączenie przy użyciu protokołu ATC Sim (atc610x).

<code>--AV400=params</code>
::Otwórz połączenie, aby sterować GPS Garmin serii 196/296.

<code>--AV400Sim=params</code>
::Zestaw ciągów znaków AV400 wymaganych do napędzania GPS-a Garmin serii 400.

<code>--AV400WSimA=params</code>
::Zestaw ciągów wymaganych wymaganych do sterowania Garmin WAAS GPS (gdzie kanał A wykorzystuje wariant protokołu AVSim400, a kanał B komunikuje się z urządzeniem GPS).

<code>--AV400WSimB=params</code>
::Patrz opcja <code>--AV400WSimA</code>.

<code>--flarm=params</code>
::Otwórz połączenie z wykorzystaniem protokołu FLARM, który zawiera komunikaty NMEA/GPS i raporty o ruchu lotniczym.

<code>--garmin=params</code>
::Otwórz połączenie przy użyciu protokołu Garmin GPS.

<code>--igc=params</code>
::Otwórz połączenie przy użyciu protokołu International Glider Commission (Międzynarodowa Komisja Szybowcowa).

<code>--joyclient=params</code>
::Otwórz połączenie z joystickiem Agwagon.

<code>--jsclient=params</code>
::Otwórz połączenie ze zdalnym joystickiem.

<code>--native-ctrls=params</code>
::Otwórz połączenie przy użyciu protokołu FG Native Controls (przesył informacji o powierzchniach sterowych samolotu).

<code>--native-fdm=params</code>
::Otwórz połączenie przy użyciu protokołu FG Native FDM (przesył informacji o modelu dynamiki lotu).

<code>--native-gui=params</code>
::Otwórz połączenie przy użyciu protokołu FG Native GUI.

<code>--native=params</code>
::Otwórz połączenie przy użyciu protokołu FG Native.

<code>--nmea=params</code>
::Otwórz połączenie za pomocą protokołu NMEA.

<code>--opengc=params</code>
::Otwórz połączenie przy użyciu protokołu OpenGC (oprogramowanie służące do renderowania wysokiej jakości szklanych kokpitów w symulatorach).

<code>--props={port|socket,bi,5,localhost,port,tcp}</code>
::Otwórz połączenie za pomocą interaktywnego menedżera właściwości (tak samo jak <code>--telnet</code>).

<code>--pve=params</code>
::Otwórz połączenie za pomocą protokołu PVE.

<code>--ray=params</code>
::Otwórz połączenie przy użyciu protokołu ruchomego krzesła Raya Woodwortha.

<code>--rul=params</code>
::Otwórz połączenie za pomocą protokołu RUL.

Parametry (params) muszą mieć postać:
medium,direction,hz,medium_options
gdzie:

* <code>medium</code> jest medium używanym przez protokół (<code>serial</code>, <code>socket</code>, <code>file</code>...),
* <code>direction</code> to kierunek komunikacji (<code>in</code>, <code>out</code> lub <code>bi</code>),
* <code>hz</code> to częstotliwość, z którą kanał powinien być przetwarzany (akceptowane są wartości zmiennoprzecinkowe),
* a <code>medium_options</code> to:
** dla protokołów szeregowych: <code>device,baud</code>, gdzie <code>device</code> to nazwa urządzenia, które ma zostać otwarte, a <code>baud</code> to prędkość transmisji;
** dla protokołów gniazd: <code>machine,port,style</code>, gdzie <code>machine</code> jest nazwą maszyny lub adres IP serwera (jeśli symulator ma działać jako klient) lub jest pozostawiona pusta (jeśli symulator ma działać jako serwer), <code>port</code> to numer port, którego należy użyć (lub jest pusty, aby system operacyjny sam wybrał dostępny port), a <code>style</code> to jeden z protokołów <code>tcp</code> lub <code>udp</code>;
** dla protokołów plików: <code>filename</code>, gdzie <code>filename</code> to nazwa pliku do którego dane powinny zostać zapisane.

W systemie Windows musisz użyć specjalnej sekwencji ucieczki, jeśli chcesz określić port COM wyższy niż 9.

Na przykład: <code>--generic=\\.\COM10,out,1,/tmp/data.xml,myproto</code>

Jest to opisane w artykule Microsoft KB tutaj: http://msdn.microsoft.com/en-us/library/aa363858%28v=vs.85%29.aspx

= Opcje awioniki =

<code>--com1=częstotliwość</code>, <code>--com2=częstotliwość</code>
::Ustaw częstotliwość radia COM1, COM2.

<code>--nav1=[radial:]częstotliwość</code>, <code>--nav2=[radial:]częstotliwość</code>
::Ustaw częstotliwość radia NAV1, NAV2, opcjonalnie poprzedzoną radialem.

<code>--adf1=[obrót:]częstotliwość</code>, <code>--adf2=[obrót:]częstotliwość</code>
::Ustaw częstotliwość radia ADF1, ADF2, opcjonalnie poprzedzoną obrotem tarczy.

<code>--dme={nav1|nav2|częstotliwość}</code>
::Podporządkuj ADF jednemu z NAV lub ustaw jego częstotliwość wewnętrzną.

= Opcje środowiska =

<code>--real-weather-fetch[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-real-weather-fetch</code><br/>
<code>--disable-real-weather-fetch</code>
::Włącz/wyłącz pobieranie rzeczywistej pogody na podstawie METAR-u (wymaga połączenia z internetem).

<code>--horizon-effect[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-horizon-effect</code><br/>
<code>--disable-horizon-effect</code>
::Włącz/wyłącz iluzję powiększenia ciała niebieskiego w pobliżu horyzontu.

<code>--visibility=metry</code><br/>
<code>--visibility-miles=mile</code>
::Określ początkową widoczność w metrach lub w milach.

<code>--wind=kierunek[:maks-kierunek]@prędkość[:porywy]</code>
::Określ kierunek z którego wieje wiatr (kierunek) i jego prędkość (w węzłach). Jeśli kierunek wiatru jest zmienny, określ zakres jako kierunek:maks-kierunek, jako minimalny i maksymalny kąt w stopniach. Jeśli chcesz, aby symulator również modelował porywy wiatru, ustaw maksymalne natężenie porywów w węzłach.

<code>--turbulence=współczynnik</code>
::Określ stopień turbulencji od 0.0 (brak) do 1.0 (silna).

<code>--ceiling=FT_ASL[:GRUBOŚĆ_FT]</code>
::Określ pułap zachmurzenia (w stopach nad średnim poziomem morza), opcjonalnie o określonej grubości (domyślnie 2000 stóp).

<code>--random-wind</code>
::Ustaw wiatr generowany losowo, z różnych kierunków o różnej sile.

<code>--metar=depesza METAR</code>
::Ustaw pogodę wg podanego METAR-u, np.: <code>XXXX 012345Z 28035G50KT 250V300 9999 TSRA SCT022CB BKN030 13/09 Q1005</code>. Działa tylko wtedy, gdy pobieranie rzeczywistej pogody jest wyłączone.

= Opcje sytuacji =

<code>--failure={pitot|static|system|vacuum}</code>
::Awaria rurki Pitota, ciśnienia statycznego, układu próżniowego lub elektrycznego (powtórz opcję w przypadku wielu awarii systemu).

= Opcje debugowania =

<code>--console[={true|false|1|0|yes|no}]</code> (<code>-c</code>)
::Włącz/wyłącz konsolę (dla systemu Windows). Skrót <code>-c</code> zawsze wyświetla konsolę.

<code>--developer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-developer</code><br/>
<code>--disable-developer</code>
::Włącz/wyłącz tryb programisty. Włączenie spowoduje logowanie większej ilości zdarzeń.

<code>--fpe[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fpe</code><br/>
<code>--disable-fpe</code>
::Włącz/wyłącz przerwanie po napotkaniu wyjątku zmiennoprzecinkowego.

<code>--fgviewer plik</code>
::Użyj przeglądarki modelu z OpenSceneGraph, zamiast wczytywać cały symulator.

<code>--json-report[={true|false|1|0|yes|no}]</code>
::Włącz/wyłącz wypisanie raportu w formacie JSON na standardowym wyjściu, podając informacje, takie jak wersja FlightGear, [[$FG_ROOT]], [[$FG_HOME]], ścieżki samolotów i scenerii itp.

<code>--log-level={bulk|debug|info|warn|alert}</code>
::Ustaw poziom logowania dla tej sesji. Zobacz także [[Commonly used debugging tools#fgfs.log]].

<code>--log-class={none|ai|aircraft|astro|atc|autopilot|clipper|cockpit| environment|event|flight|general|gl|gui|headless|input|instrumentation| io|math|nasal|navaid|network|osg|particles|sound|systems|terrain| terrasync|undefined|view|all}</code>
::Określenie klasy (klasę) logowania, które mają być używane.

<code>--log-dir=katalog</code>
::Zapisz logi w podanym katalogu. Jeśli podamy desktop, to logi zostaną zapisywane na Pulpicie. Opcję tę można podać kilka razy, używając za każdym razem innego katalogu. Wewnątrz podanego katalogu plik dziennika będzie miał nazwę FlightGear_YYY-MM-DD_num.log, gdzie YYYY-MM-DD to bieżąca data, a num to liczba postępowa zaczynająca się od 0.

<code>--trace-read=właściwość</code>
::Śledź odczyty dla właściwości. Można użyć tej opcji wielokrotnie.

<code>--trace-write=właściwość</code>
::Śledź zapisy dla właściwości. Można użyć tej opcji wielokrotnie.

<code>--uninstall</code>
::Usuń katalog [[$FG_HOME]]. Dla Windows dodatkowo usuwa katalogi TerraSync, Aircraft i TextureCache z katalogu download.

=Treści powiązane=
==Artykuły na Wiki==
* [[Command line]]
* [[Command line options 2020.3]]

==Pliki źródłowe==
*{{fgdata file|options.xml}}
*{{flightgear file|src/Main/options.hxx}}
*{{flightgear file|src/Main/options.cxx}}

[[Category:FlightGear]]
[[Category:Lists]]

[[de:Command Line Options]]
[[en:Command Line Options]]
[[fr:Options de ligne de commande]]

Command line options

2026-04-27T09:11:08Z

PlayeRom: /* IO Options */

{{note|This article presents the current command line options, including the development version. To check the options for '''older version 2020.3.x''', see the [[Command line options 2020.3]] article.}}

'''Command line options''' are a common way to tell applications what to do/how to act on startup. With [[FlightGear]] they are used for many things, from simple ones like selecting an aircraft up to complex stuff like network traffic and weather parameters.

The easiest way to handle those options for FlightGear is using a tool with a graphical user interface like the [[FlightGear Qt launcher]]. This way one doesn't have to bother about them at all.

However, there are users who don't want or are not able to run a GUI and therefore are interested in this. Those who need them or just want to learn more about FlightGear, but have no idea what we are talking about, may read the wiki page on the general usage of the [[command line]]. The launcher GUI works by setting command-line options for the options you choose. Try different options and see what the launcher sets from menu in Qt launcher <code>*** > View command-line</code> or by use {{Key press|Ctrl|L}} keyboard shortcut.

A good place to store the personal options is a file called [[fgfsrc]]. This file is read by FlightGear on each startup.

The following lists show the options for FlightGear including a short description and sorted by categories. Please have in mind that keeping those lists up to date on the wiki is not an easy task. Also there are different versions of FlightGear out there which don't share exactly the same options. Therefore you better also check your versions ones with <code>fgfs --help --verbose</code>. If this command fails, you may add the option <code>--fg-root=[path]</code> as well, see below.

It is sad but true, not even this command is, at least in Git, up to date all the time. At the time of writing at least one option which is supported is not shown with <code>fgfs --help --verbose</code>. So if you have serious issues with an option, the source code is, as always, also the best source for info. In the file ''src/Main/options.cxx'' all the options are listed with their hard coded ''default'' setting and type.

The file [[$FG_ROOT]]/options.xml is used to generate the output for <code>fgfs --help [--verbose]</code>. That's the reason why <code>--fg-root=[path]</code> has to be added to this, if it is not set as environmental variable or as option in fgfsrc.

Usage in terminal: <code>fgfs [OPTION [OPTION ...]]</code>

The way to use options by [[FlightGear Qt launcher|Qt Launcher]]: go to the "Settings" tab and in the "Additional Settings" section enter the following options, each on a new line. The options entered there take precedence over those defined by Qt Launcher. To see the entire list of command line options used by Qt Launcher, use the keyboard shortcut {{Key press|Ctrl|L}} or select "View command-line" from the Launcher menu.

= Legend how to read the following options =

# <code>--option1</code> (<code>--option2</code>) - in this case <code>--option2</code> is the aliast for <code>--option1</code> which is exactly the same as <code>--option1</code>.
# <code>--option1</code><br/><code>--option2</code> - two different options, mutually exclusive. They cannot be used simultaneously, but are connected due to a common description.
# <code>--option1</code>, <code>--option2</code> - two different options that can be used simultaneously and are connected due to a common description.

= Values for options =

Some options do not require a value, such as <code>--help</code>, but there are options for which we must specify a value, such as <code>--fg-root</code>, as well as there are options for which we can optionally specify a value, such as for <code>--launcher</code>. We can separate the value from the option with either the <code>=</code> sign or a space, such as:

--fg-root=/path/to/fgdata
--fg-root /path/to/fgdata

Options that act like an enable/disable switch take optional values as <code>true</code>, <code>1</code>, <code>yes</code> (enable) or <code>false</code>, <code>0</code>, <code>no</code> (disable). If we don't specify any value next to such an option, it will work by default as if we passed <code>true</code>, <code>1</code> or <code>yes</code>, i.e. enabled it, e.g:

--launcher

will enable Launcher, which is equivalent to:

--launcher=yes

On the other hand, we can also pass a value that disables the option, e.g.:

--launcher=no

which will cause Launcher not to be launched. In addition, most of such options have two additional versions without a value, but preceded by the prefix <code>enable-</code> and <code>disable-</code>, e.g.:

--enable-launcher

will also enable Launcher.

= General Options =

<code>--help</code> (<code>-h</code>)
::Show the most relevant command line options.

<code>--verbose</code> (<code>-v</code>)
::Show all command line options when combined with <code>--help</code> or <code>-h</code>.

<code>--version[={true|false|1|0|yes|no}]</code>
::Display the current FlightGear version.

<code>--fg-root=path</code>
::Specify the root data path.

<code>--fg-scenery=path[:path...]</code>
::Specify the base scenery path. Defaults to [[$FG_ROOT]]/Scenery.

<code>--fg-aircraft=path</code>
::Specify additional aircraft directory path(s) (alternatively, you can use <code>--aircraft-dir</code> to target a specific aircraft in a given directory).

<code>--addon=path</code>
::Specify a path to addon. Multiple instances can be used.

<code>--download-dir=path</code>
::Store aircraft and scenery downloaded via the simulator in path. The TerraSync directory may be specifically set with the <code>--terrasync-dir</code> option.

<code>--data=path</code>
::Specify an additional base data directory (FGData), before the [[$FG_ROOT]] directory.

<code>--terrasync[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-terrasync</code><br/>
<code>--disable-terrasync</code>
::Enable/disable automatic scenery downloads/updates.

<code>--terrasync-dir=path</code>
::Specify the [[TerraSync]] scenery path. Defaults to [[$FG_HOME]]/TerraSync.

<code>--language=code</code>
::Select the language for this session. Available codes: <tt>ca</tt>, <tt>de</tt>, <tt>en</tt>, <tt>es</tt>, <tt>fr</tt>, <tt>it</tt>, <tt>ka</tt>, <tt>nl</tt>, <tt>pl</tt>, <tt>pt</tt>, <tt>ru</tt>, <tt>sk</tt>, <tt>tr</tt>, <tt>zh_CN</tt>.

:: In FlightGear 2024.2, <code>--language=default</code> is also supported and selects the ''default translation'', also known as “engineering English”. This “translation” contains exactly the English strings that translators translate; these have only one form for both singular and plural, contrary to the English translation loaded by <code>--language=en</code> which, starting from FlightGear 2024.2, can show different forms depending on a “cardinal number” (this applies to those strings that have been declared with <code>has-plural=true</code> in the default translation, i.e. in one of the XML files from <tt>[[$FG_ROOT]]/Translations/default</tt>).

:: In FlightGear 2024.2, in case the locale specified with <code>--language</code> or via user locale settings doesn't match any of the locales defined in <tt>[[$FG_ROOT]]/Translations/locale.xml</tt>, the effect is the same as with <code>--language=en</code>, i.e. proper English with singular and plural forms that may differ.

<code>--launcher[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-launcher</code><br/>
<code>--disable-launcher</code>
::Enable/disable [[FlightGear Qt launcher|Qt Launcher]]. Without this option or with enabled it, it will immediately start the simulator in the default configuration or in the configuration read from the [[Fgfsrc|fgfsrc]] file - if it exists.

<code>--splash-screen[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-splash-screen</code><br/>
<code>--disable-splash-screen</code>
::Enable/disable splash screen.

<code>--mouse-pointer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-mouse-pointer</code><br/>
<code>--disable-mouse-pointer</code>
::Enable/disable extra mouse pointer (i.e. for full screen Voodoo based cards).

<code>--browser-app=path</code>
::Specify path to your web browser.

<code>--prop:[type:]property=value</code>
::Set the given property to the given value. Type can be one of <tt>string</tt>, <tt>double</tt>, <tt>float</tt>, <tt>long</tt>, <tt>int</tt>, or <tt>bool</tt>.

<code>--prop:browser=property</code>
::After starting the simulator, open the properties dialog immediately on the given property. If you need more windows, just add more browser indexes like <tt>browser[1]</tt>, <tt>browser[2]</tt> etc., for example:
--prop:browser=/sim/presets
--prop:browser[1]=/devices/status/keyboard/event
::which will open two dialogs with the given properties.

<code>--config=path</code>
::Load additional properties from path.

<code>--no-default-config[={true|false|1|0|yes|no}]</code>
::Enable/Disable not loading any default configuration files (like [[Fgfsrc|fgfsrc]]) unless explicitly specified with <code>--config</code>.

<code>--units-feet</code><br/>
<code>--units-meters</code>
::Use feets (default) or meters for distances.

<code>--allow-nasal-read=path[:path...]</code>
::Allow Nasal scripts to read files from directories listed as path (separate multiple paths with a semicolon (Windows) or a colon (UNIX)). By default, for security reasons, Nasal scripts can only read data from certain directories, such as [[$FG_ROOT]], [[$FG_HOME]], etc.

<code>--read-only[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-read-only</code><br/>
<code>--disable-read-only</code>
::Enable/disable folder [[$FG_HOME]] read-only.

<code>--ignore-autosave[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-ignore-autosave</code><br/>
<code>--disable-ignore-autosave</code>
::Enable/disable ignoring the autosave file, i.e. the settings saved in this file will not be loaded during startup, nor will the settings be saved to this file when closing the simulator.

<code>--save-on-exit[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-save-on-exit</code><br/>
<code>--disable-save-on-exit</code>
::Enable/Disable saving preferences at program exit.

<code>--restore-defaults[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-restore-defaults</code><br/>
<code>--disable-restore-defaults</code>
::Enable/Disable resetting all user settings to their defaults (rendering options etc.)

<code>--gui[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-gui</code><br/>
<code>--disable-gui</code>
::Enable/Disable GUI (disabling GUI enables headless mode.)

<code>--jsbsim-output-directive-file=file</code>
::Log JSBSim properties. An output directives file contains an <code><output></code> element, within which should be specified the parameters or parameter groups that should be logged. See [[JSBSim Logging]].

= Features =

<code>--composite-viewer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-composite-viewer</code><br/>
<code>--disable-composite-viewer</code>
::Enable/disable CompositeViewer (extra view windows.) These options have been removed from the dev version, where CompositeViewer is always enabled.

<code>--panel[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-panel</code><br/>
<code>--disable-panel</code>
::Enable/disable 2D instrument panel.

<code>--freeze[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-freeze</code><br/>
<code>--disable-freeze</code>
::Start in a pause state or unpause.

<code>--fuel-freeze[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fuel-freeze</code><br/>
<code>--disable-fuel-freeze</code>
::Fuel tank quantity forced to remain constant or fuel is consumed normally.

<code>--clock-freeze[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-clock-freeze</code><br/>
<code>--disable-clock-freeze</code>
::Do not advance clock or clock advances normally.

<code>--ai-scenario=scenario</code>
::Add and enable a new scenario. Multiple options are allowed. Scenarios are in [[$FG_ROOT]]/AI/.

<code>--ai-models[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-ai-models</code><br/>
<code>--disable-ai-models</code>
::Enable/disable the AI subsystem. When disabled this also disables showing the models of other multiplayer aircraft.

<code>--ai-traffic[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-ai-traffic</code><br/>
<code>--disable-ai-traffic</code>
::Enable/disable the autogenerated traffic subsystem.

<code>--vr[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-vr</code><br/>
<code>--disable-vr</code>
::Enable/disable the Virtual Reality.

<code>--restart-launcher[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-restart-launcher</code><br/>
<code>--disable-restart-launcher</code>
::Enable/Disable automatic opening of the Launcher when exiting FlightGear.

<code>--load-tape={name|url}</code>
::Load recording of earlier flightgear session. For <name>, if <name> ends with ".fgtape" it is treated as the local path of the recording file; otherwise we form the local path by prepending <name> with the tape directory and appending ".fgtape". For <url> (starting with http:// or https://) we download the remote recording (which must be a Continuous recording) in the background to a url-dependent filename while replaying it; if the url-dependent filename already exists it is assumed to be a truncated download and we only download any remaining data.

<code>--load-tape-create-video[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-load-tape-create-video</code><br/>
<code>--disable-load-tape-create-video</code>
::Enable/Disable encode video while replaying tape specified by <code>--load-tape</code>.

<code>--load-tape-fixed-dt=value</code>
::Set fixed-dt mode while replaying tape specified by <code>--load-tape</code>.

= Aircraft =

<code>--aircraft=name</code> (<code>--vehicle=name</code>)
::Select an aircraft profile as defined by a top level -set.xml.

<code>--aircraft-dir=path</code>
::Specify the exact directory to use for the aircraft (normally not required, but may be useful). Interpreted relatively to the current directory. Causes the <code><path-cache></code> from autosave_X_Y.xml, as well as <code>--fg-aircraft</code> options and the FG_AIRCRAFT environment variable to be bypassed.

<code>--show-aircraft[={true|false|1|0|yes|no}]</code>
::Enable/disable printing a list of the currently available aircraft types.

<code>--min-status={alpha|beta|early-production|production}</code>
::Allows you to define a minimum status level (=development status) for all listed aircraft by <code>--show-aircraft</code> option.

<code>--auto-coordination[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-auto-coordination</code><br/>
<code>--disable-auto-coordination</code>
::Enable/disable auto coordination. Disabled as default. If enabled, the rudder will respond according to the movement of the ailerons.

<code>--livery=name</code>
::Select aircraft livery.

<code>--state=value</code>
::Specify the initial state of the aircraft to the given value. The states that can be used depend on the aircraft. For example, the Cessna 172P has only one state: <tt>auto</tt>.

= Flight Model =

<code>--fdm={ada | acms | aisim | balloon | jsb | larcsim | magic | network | pipe | ufo | yasim | external | null}</code>
::Select the core flight dynamics model. LaRCsim (<code>larcsim</code> value) as a deprecated model has been removed from the dev version.

<code>--aero=name</code>
::Select aircraft aerodynamics model to load.

<code>--model-hz=n</code>
::Run the FDM this rate (iterations per second).

<code>--speed=n</code>
::Run the FDM 'n' times faster than real time.

<code>--trim[={true|false|1|0|yes|no}]</code><br/>
<code>--notrim[={true|false|1|0|yes|no}]</code>
::Trim or do not attempt to trim the model (only with <code>--fdm=jsbsim</code>).

<code>--on-ground[={true|false|1|0|yes|no}]</code><br/>
<code>--in-air[={true|false|1|0|yes|no}]</code>
::Start at ground level (default) or in air (implied when using <code>--altitude</code>).

= Initial Position and Orientation =

<code>--airport=ICAO</code>
::Specify airport (e.g. KOAK).

<code>--runway=rwy_no</code>
::Specify starting runway (must also specify an airport).

<code>--parking-id=name</code> (<code>--parkpos=name</code>)
::Specify a gate at the airport (e.g. 747d11).

<code>--carrier={name|ID}</code>
::Specify starting position on an AI carrier.

<code>--carrier-position={abeam|FLOLS|name}</code>
::Specify a starting position relative to the carrier where you can use the predefined <tt>abeam</tt> (start on downwind abeam) or <tt>FLOLS</tt> (start on final approach) values, or specify the name of the carrier's parking position. Must also specify a carrier by <code>--carrier</code>.

<code>--vor=ID</code>
::Specify starting position relative to a VOR.

<code>--vor-frequency=frequency</code>
::Specify the frequency of the VOR. Use with <code>--vor=ID</code>.

<code>--ndb=ID</code>
::Specify starting position relative to an NDB.

<code>--ndb-frequency=frequency</code>
::Specify the frequency of the NDB. Use with <code>--ndb=ID</code>.

<code>--fix=ID</code>
::Specify starting position relative to a fix.

<code>--offset-distance=nm</code>
::Specify distance to reference point (nautical miles).

<code>--offset-azimuth=degrees</code>
::Specify heading to reference point.

<code>--lon=degrees</code>
::Starting longitude (west = -).

<code>--lat=degrees</code>
::Starting latitude (south = -).

<code>--altitude=value</code>
::Starting altitude (in feet unless <code>--units-meters</code> specified).

<code>--heading=degrees</code>
::Specify heading (yaw) angle (Psi).

<code>--roll=degrees</code>
::Specify roll angle (Phi).

<code>--pitch=degrees</code>
::Specify pitch angle (Theta).

<code>--vc=knots</code><br/>
<code>--mach=num</code>
::Specify initial airspeed in knots or mach number.

<code>--glideslope=degrees</code>
::Specify flight path angle (can be positive).

<code>--roc=fpm</code>
::Specify initial climb of rate (can be negative).

<code>--uBody=units_per_sec</code>
::Specify velocity along the body X axis (in feet unless <code>--units-meters</code> specified).

<code>--vBody=units_per_sec</code>
::Specify velocity along the body Y axis (in feet unless <code>--units-meters</code> specified).

<code>--wBody=units_per_sec</code>
::Specify velocity along the body Z axis (in feet unless <code>--units-meters</code> specified).

<code>--vNorth=units_per_sec</code>
::Specify velocity along a South-North axis (in feet unless <code>--units-meters</code> specified).

<code>--vEast=units_per_sec</code>
::Specify velocity along a West-East axis (in feet unless <code>--units-meters</code> specified).

<code>--vDown=units_per_sec</code>
::Specify velocity along a vertical axis (in feet unless <code>--units-meters</code> specified).

= Audio Options =

<code>--show-sound-devices[={true|false|1|0|yes|no}]</code>
::Enable/disable the display of the list of audio devices.

<code>--sound-device=name</code>
::Explicitly specify the audio device to use. To get available names use <code>--show-sound-devices</code>.

<code>--sound[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-sound</code><br/>
<code>--disable-sound</code>
::Enable/disable sound.

= Rendering Options =

<code>--prop:/sim/rendering/multi-sample-buffers={true|false}</code>
::Enable/disable multi sample buffer (anti-aliasing).

<code>--prop:/sim/rendering/multi-samples=value</code>
::Specify number of multi samples (anti-aliasing). Valid values is 2, 4, 8, 16.

<code>--aspect-ratio-multiplier=factor</code>
::Specify a multiplier for the aspect ratio.

<code>--bpp={16|24|32}</code>
::Specify the bits per pixel.

<code>--compositor=path</code>
::Specify the path to XML file for multi-pass rendering. The path is relative to [[$FG_ROOT]] (defaults to <code>Compositor/default</code>.) For enable HDR pipeline use <code>Compositor/HDR/hdr</code> path.

<code>--horizon-effect[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-horizon-effect</code><br/>
<code>--disable-horizon-effect</code>
::Enable/disable celestial body growth illusion near the horizon.

<code>--distance-attenuation[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-distance-attenuation</code><br/>
<code>--disable-distance-attenuation</code>
::Enable/disable runway light distance attenuation.

<code>--specular-highlight[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-specular-highlight</code><br/>
<code>--disable-specular-highlight</code>
::Enable/disable specular reflections on textured objects.

<code>--clouds[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-clouds</code><br/>
<code>--disable-clouds</code>
::Enable/disable 2D (flat) cloud layers.

<code>--clouds3d[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-clouds3d</code><br/>
<code>--disable-clouds3d</code>
::Enable/disable 3D (volumetric) cloud layers.

<code>--texture-cache[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-texture-cache</code><br/>
<code>--disable-texture-cache</code>
::Enable/disable texture cache (DDS).

<code>--texture-cache-dir=path</code>
::Set the DDS texture cache directory to be different than the default location.

<code>--fullscreen[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fullscreen</code><br/>
<code>--disable-fullscreen</code>
::Enable/disable fullscreen mode.

<code>--random-objects[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-random-objects</code><br/>
<code>--disable-random-objects</code>
::Enable/disable random scenery objects (buildings, etc.)

<code>--wireframe[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-wireframe</code><br/>
<code>--disable-wireframe</code>
::Enable/disable wireframe drawing mode.

<code>--fog-disable</code><br/>
<code>--fog-fastest</code><br/>
<code>--fog-nicest</code>
::Set the fog. The <code>--fog-disable</code> option will turn off the fog, resulting in increased visibility and a decrease in performance (more terrain to render). The <code>--fog-fastest</code> option will enable fog rendering in a less realistic way, but improving performance. By default, the <code>--fog-nicest</code> option is used to render a realistic fog, at the expense of performance. These options are deprecated.

<code>--fov=degrees</code>
::Specify field of view angle.

<code>--geometry=WidthxHeight</code>
::Specify window geometry/resolution (640x480, etc).

<code>--graphics-preset={minimal-quality|low-quality|medium-quality|high-quality|ultra-quality}</code>
::Specify a graphic preset.

<code>--materials-file=file</code>
::Specify the materials file used to render the scenery (default: Materials/regions/materials.xml).

<code>--max-fps=Hz</code>
::Maximum frame rate in Hz.

<code>--shading-smooth</code><br/>
<code>--shading-flat</code>
::Enable smooth or flat shading. These options are deprecated.

<code>--texture-filtering={1|2|4|8|16}</code>
::Specify anisotropic filtering of terrain textures. Valid values is 1, 2, 4, 8, 16. Default is 1.

<code>--view-offset={LEFT|CENTER|RIGHT|value}</code>
::Specify the default forward view direction as an offset from straight ahead. Allowable values are <tt>LEFT</tt>, <tt>RIGHT</tt>, <tt>CENTER</tt>, or a specific number in degrees.

<code>--terrain-engine={tilecache|pagedLOD}</code>
::Specify the terrain engine you want to use: <tt>tilecache</tt> or <tt>pagedLOD</tt>.

<code>--lod-levels=levels</code>
::Specify the detail levels, where levels are a space-separated numeric list of levels. The default is "1 3 5 7 9". Use with <code>--terrain-engine=pagedLOD</code>.

<code>--lod-res=resolution</code>
::Specify the resolution of the terrain grid. Defaults is 1. Use with <code>--terrain-engine=pagedLOD</code>.

<code>--lod-texturing={bluemarble|raster|debug}</code>
::Specify the method of texturing the terrain. The default is <tt>bluemarble</tt>. Use with <code>--terrain-engine=pagedLOD</code>.

<code>--lod-range-mult=multiplier</code>
::Specify the range multiplier (point from low to fine detail). Defaults is 2. Use with <code>--terrain-engine=pagedLOD</code>.

== WS3.0 ==

<code>--prop:/scenery/use-vpb=true</code>
::Activate the use of World Scenery 3.0.

= Hud Options =

<code>--hud[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hud</code><br/>
<code>--disable-hud</code>
::Enable/disable Heads Up Display (HUD).

<code>--anti-alias-hud[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-anti-alias-hud</code><br/>
<code>--disable-anti-alias-hud</code>
::Enable/disable anti-aliased HUD.

<code>--hud-3d[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hud-3d</code><br/>
<code>--disable-hud-3d</code>
::Enable/disable 3D HUD.

<code>--hud-tris</code><br/>
<code>--hud-culled</code>
::Hud displays number of triangles rendered or percentage of triangles culled.

= Time Options =

The following time and date setting options are not compatible with each other, so only one of them should be given.

<code>--timeofday={real|dawn|morning|noon|afternoon|dusk|evening|midnight}</code>
::Specify a time of day.

<code>--time-offset=[+-]hh:mm:ss</code>
::Add this time offset to <code>--time-match-real</code>.

<code>--time-match-real</code>
::Synchronize time with current time at chosen airport.

<code>--time-match-local</code>
::Synchronize time with system time of computer.

<code>--start-date-sys=yyyy:mm:dd:hh:mm:ss</code>
::Specify a starting date/time with respect to system time.

<code>--start-date-gmt=yyyy:mm:dd:hh:mm:ss</code>
::Specify a starting date/time with respect to Greenwich Mean Time.

<code>--start-date-lat=yyyy:mm:dd:hh:mm:ss</code>
::Specify a starting date/time with respect to Local Aircraft Time.

= Network Options =

<code>--proxy=[user:password@]host:port</code>
::Specify the proxy server and port to be used. Username and password are optional. If present, they should be listed as MD5 hashes. This option is only useful when <code>--real-weather-fetch</code> is enabled.

<code>--httpd=port</code>
::Enable HTTP server on the specified port.

<code>--telnet={port|socket,bi,hz,localhost,port,tcp}</code> (<code>--props={port|socket,bi,hz,localhost,port,tcp}</code>)
::Enable telnet server on the specified port. Optionally, you can change the hz (number of packets per second).
::Example: <code>--telnet=5000</code> will send 5 packages per second, but <code>--telnet=,,100,,5000,</code> will send 100 packages per second.

<code>--jpg-httpd=port</code>
::Enable screen shot HTTP server on the specified port. This option has been withdrawn, instead use <code>--httpd</code> and /screenshot URL.

<code>--allow-nasal-from-sockets[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-allow-nasal-from-sockets</code><br/>
<code>--disable-allow-nasal-from-sockets</code>
::Enable/disable allowing executing Nasal scripts from sockets. Enable means that network connections will be allowed full access to the simulator including running arbitrary scripts. Ensure you have adequate security such as a firewall which blocks external connections.

<code>--sentry[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-sentry</code><br/>
<code>--disable-sentry</code>
::Enable/disable crash and error reports from being sent to the development team for analysis.

= MultiPlayer Options =

<code>--callsign=name</code>
::Assign a unique name to a player. A call sign must be at most 10 characters long and can only contain numbers, letters of the English alphabet, hyphens (-) and underscores (_). Longer call signs are truncated, and characters that do not match those listed above are replaced with hyphens.

<code>--multiplay={in|out},hz,address,port</code>
::Specify multipilot communication settings. Multiple instances can be used.

<code>--fgcom[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fgcom</code><br/>
<code>--disable-fgcom</code>
::Enable/disable built-in FGCom (voice communication with ATC.)

<code>--hold-short[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-hold-short</code><br/>
<code>--disable-hold-short</code>
::In multiplayer mode, when you select an initial position on the runway, you will be moved by default to the hold-short position (<code>--hold-short</code>), which is on the taxiway, just in front of the runway. The <code>--disable-hold-short</code> option allows you to disable this behavior, but keep in mind that this is undesirable, as it may interfere with others taking off or landing.

= Route/Way Point Options =

<code>--wp=ID[@alt]</code>
::Specify a waypoint for the GC autopilot. Multiple instances can be used.

<code>--flight-plan=file</code>
::Read all waypoints from a file.

= IO Options =

<code>--generic=params</code>
::Open connection using a predefined communication interface and a preselected communication protocol.

<code>--atlas=params</code>
::Open connection using the Atlas protocol.

<code>--atcsim=params</code>
::Open connection using the ATC sim protocol (atc610x).

<code>--AV400=params</code>
::Emit the Garmin AV400 protocol required to drive a Garmin 196/296 series GPS.

<code>--AV400Sim=params</code>
::Emit the set of AV400 strings required to drive a Garmin 400-series GPS from FlightGear.

<code>--AV400WSimA=params</code>, <code>--AV400WSimB=params</code>
::The Garmin WAAS GPS uses 2 serial channels to communicate with the simulator. These 2 channels are represented by the FGAV400WSimA and the FGAV400WSimB classes. The "A" channel is similar to the previous AVSim400 protocol. The "B" channel is considered the "GPS" channel and uses a different protocol than the "A" channel. The GPS unit expects input on the "B" channel at two different frequencies (1hz and 5hz, normally). The "B" channel also expects responses to certain output messages.

<code>--flarm=params</code>
::Open connection using the FLARM protocol, which includes NMEA/GPS and traffic reporting messages.

<code>--garmin=params</code>
::Open connection using the Garmin GPS protocol.

<code>--igc=params</code>
::Open connection using the International Gliding Commission (IGC) protocol.

<code>--joyclient=params</code>
::Open connection to an Agwagon joystick.

<code>--jsclient=params</code>
::Open connection to a remote joystick.

<code>--native=params</code>
::Open connection using the FG Native protocol.

<code>--native-ctrls=params</code>
::Open connection using the FG Native Controls protocol.

<code>--native-fdm=params</code>
::Open connection using the FG Native FDM protocol.

<code>--native-gui=params</code>
::Open connection using the FG Native GUI protocol.

<code>--nmea=params</code>
::Open connection using the NMEA protocol.

<code>--opengc=params</code>
::Open connection using the OpenGC protocol.

<code>--props=params</code>
::Open connection using the interactive property manager (same as <code>--telnet</code>).

<code>--pve=params</code>
::Open connection using the PVE protocol (ProVision Entertainment - some sort of motion platform).

<code>--ray=params</code>
::Open connection using the Ray Woodworth motion chair protocol.

<code>--rul=params</code>
::Open connection using the RUL protocol (some sort of motion platform some guy was building).

Under Windows, you must use a special escape sequence if you need to specify a COM port higher than 9.

Example: <code>--generic=\\.\COM10,out,1,/tmp/data.xml,myproto</code>

This is per the Microsoft KB article here: http://msdn.microsoft.com/en-us/library/aa363858%28v=vs.85%29.aspx

= Avionics Options =

<code>--com1=frequency</code>, <code>--com2=frequency</code>
::Set the COM1 and COM2 radio frequency.

<code>--nav1=[radial:]frequency</code>, <code>--nav2=[radial:]frequency</code>
::Set the NAV1 and NAV2 radio frequency, optionally preceded by a radial.

<code>--adf1=[rotation:]frequency</code>, <code>--adf2=[rotation:]frequency</code>
::Set the ADF1 and ADF2 frequency to frequency kHz. You can optionally specify the rotation angle of its compass card by prefixing the frequency with the angle and a colon. The <code>--adf</code> option is deprecated.

<code>--dme={nav1|nav2|frequency}</code>
::Slave the ADF to one of the NAV radios, or set its internal frequency.

= Environment Options =

<code>--real-weather-fetch[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-real-weather-fetch</code><br/>
<code>--disable-real-weather-fetch</code>
::Enable/disable METAR based real weather fetching. Enable requires an open internet connection.

<code>--horizon-effect[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-horizon-effect</code><br/>
<code>--disable-horizon-effect</code>
::Enable/disable celestial body growth illusion near the horizon.

<code>--visibility=meters</code><br/>
<code>--visibility-miles=miles</code>
::Specify initial visibility in meters or in statute miles. It works only with Basic Weather.

<code>--wind=DIR[:MAXDIR]@SPEED[:GUST]</code>
::Specify the direction from which the wind is blowing (DIR in degrees) and its SPEED (in knots). If the wind direction is variable, specify the range as DIR:MAXDIR, as a minimum and maximum angle in degrees. If you want the simulator to also model wind gusts, set the maximum :GUST rate in knots.

<code>--turbulence=value</code>
::Specify turbulence where value must to be from 0.0 (calm) to 1.0 (severe).

<code>--ceiling=FT_ASL[:THICKNESS_FT]</code>
::Create an overcast ceiling, optionally with a specific thickness (defaults to 2000 ft). This option looks like it has been broken for a long time and doesn't work at all.

<code>--random-wind</code>
::Set up random wind direction and speed.

<code>--metar="metar string"</code>
::Starts with a certain METAR string. Only works if live weather is disabled.

= Situation Options =

<code>--failure={pitot|static|vacuum|electrical}</code>
::Fail the pitot, static, vacuum, or electrical system (repeat the option for multiple system failures).

= Debugging Options =

<code>--console[={true|false|1|0|yes|no}]</code> (<code>-c</code>)
::Enable/Disable displaying console (Windows specific.) Short <code>-c</code> always enable console.

<code>--developer[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-developer</code><br/>
<code>--disable-developer</code>
::Enable/Disable developer mode which will log more events.

<code>--fpe[={true|false|1|0|yes|no}]</code><br/>
<code>--enable-fpe</code><br/>
<code>--disable-fpe</code>
::Enable/Disable aborting on encountering a floating point exception.

<code>--fgviewer file</code>
::Use a model viewer rather than load the entire simulator.

<code>--json-report[={true|false|1|0|yes|no}]</code>
::Enable/Disable printing 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.

<code>--log-level={bulk|debug|info|warn|alert}</code>
::Set the logging level for this session. 0 = verbose, 5 = alerts only. See also [[Commonly used debugging tools#fgfs.log]].

<code>--log-class={none|ai|aircraft|astro|atc|autopilot|clipper|cockpit| environment|event|flight|general|gl|gui|headless|input|instrumentation| io|math|nasal|navaid|network|osg|particles|sound|systems|terrain| terrasync|undefined|view|all}</code>
::Specify which logging class(es) to use.

<code>--log-dir={desktop|path}</code>
::Save the logs in the given directory. If <code>desktop</code> is entered instead of the path, 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 FlightGear_YYYY-MM-DD_num.log, where YYYY-MM-DD is the current date and num is a progressive number starting at 0.

<code>--trace-read=property</code>
::Trace the reads for a property; multiple instances can be used.

<code>--trace-write=property</code>
::Trace the writes for a property; multiple instances can be used.

<code>--uninstall</code>
::Remove [[$FG_HOME]] directory. For Windows, it additionally removes TerraSync, Aircraft and TextureCache directories from download directory.

= Related content =
== Wiki articles ==
* [[Command line]]
* [[Command line options 2020.3]]

== Source files ==
* {{fgdata file|options.xml}}
* {{flightgear file|src/Main/options.hxx}}
* {{flightgear file|src/Main/options.cxx}}

[[Category:FlightGear]]
[[Category:Lists]]

[[de:Command Line Options]]
[[fr:Options de ligne de commande]]
[[pl:Opcje wiersza poleceń]]

Model Cockpit View

2026-04-25T11:12:14Z

PlayeRom:

{{stub}}
{{infobox subsystem
|image = Fgaddonslogo202x89.png |thumb
|name = Model Cockpit View
|started = 07/2007
|description = Model Cockpit View
|status = Inactive (development from 07/2007 to 2017)
|maintainers = {{usr|AndersG}}
|developers = {{usr|AndersG}}, Melchior Franz, maybe others
}}

'''Model Cockpit View''' is a FlightGear [[addon]] that allows to switch the view from any AI/MP models and cockpits. It is based on the previous modules <code>model-view.xml</code>, <code>cockpit-view.xml</code> and <code>model2-view.xml</code>.

{{key press|q}}/{{key press|Shift|Q}} steps through the available MP/AI aircraft.

== Issues ==
Currently the cockpit views starts at (0,0,0) which is a bit of a usability problem - it works for someone that knows it is a bit of a hack but looks bad for anyone else.

The {{key press|q}}/{{key press|Shift|Q}} key bindings might interfere with aircraft that use these keys.

== Status ==
AndersG created a version of the addon<ref>{{cite web
|url = https://forum.flightgear.org/viewtopic.php?f=30&t=32718&start=15#p316599
|title = <nowiki> Re: </nowiki>
|author = <nowiki> AndersG </nowiki>
|date = Aug 14th, 2017
|added = Aug 14th, 2017
}}</ref>
that is available in http://www.gidenstam.org/FlightGear/misc/ModelCockpitView-addon.tar.gz.

wkitty42 was working on converting the cockpit-view mod to the <code>--addon</code> format<ref>{{cite web
|url = https://forum.flightgear.org/viewtopic.php?p=316498#p316498
|title = <nowiki> Re: </nowiki>
|author = <nowiki> wkitty42 </nowiki>
|date = Aug 13th, 2017
|added = Aug 13th, 2017
|script_version = 0.40
}}</ref>
and currently this addon is abandoned.<ref>{{cite web
|url = https://forum.flightgear.org/viewtopic.php?f=30&t=32718&start=45#p430651
|title = <nowiki> Re: </nowiki>
|author = <nowiki> wkitty42 </nowiki>
|date = Mar 24th, 2025
|added = Mar 24th, 2025
|script_version = 0.40
}}</ref>

== Changing the view point ==
By default, the view point will be at (0,0,0), so the view point will be exactly on the bottom for many models.
The viewpoint can be moved up/down/left/right at runtime by pressing RMB+MMB (right and middle mouse buttons) and dragging. Holding control too makes it move forward/aft/left/right instead. The offset so set will apply to all models viewed (in essence it does not change as you switch the model the view follows).

Though this might be useful for analysis purposes, a raised view point is more interesting. The view point can be changed by adding the following code to the addons <code>main.nas</code> file:

<syntaxhighlight lang="xml">
...
if (type != "multiplayer")
color = { text: { color: { red: 0.5, green: 0.8, blue: 0.5 }}};
# move view point above back of vehicle.
if (getprop("/sim/current-view/name") == "Model Cockpit View" and name) {
if (string.match(name,"*gsvehicle*")){
#Ground Service vehicle
setprop("/sim/current-view/z-offset-m", 20);
setprop("/sim/current-view/y-offset-m", 7);
} else if (string.match(name,"*carrier*")){
setprop("/sim/current-view/z-offset-m", 110);
setprop("/sim/current-view/y-offset-m", 47);
} else {
#Aircraft?
setprop("/sim/current-view/z-offset-m", 60);
setprop("/sim/current-view/y-offset-m", 17);
}
}
if (name)
gui.popupTip(name, 2, color);
...
</syntaxhighlight>

The offset values shown here are just arbitrary.

== References ==
{{Appendix}}

[[Category:FlightGear addons]]

Model Cockpit View

2026-04-25T11:09:47Z

PlayeRom: /* Status */

{{stub}}
{{infobox subsystem
|image = Fgaddonslogo202x89.png |thumb
|name = Model Cockpit View
|started = 07/2007
|description = Model Cockpit View
|status = Under active development as of 07/2007
|maintainers = {{usr|AndersG}}
|developers = {{usr|AndersG}}, Melchior Franz, maybe others
}}

'''Model Cockpit View''' is a FlightGear [[addon]] that allows to switch the view from any AI/MP models and cockpits. It is based on the previous modules <code>model-view.xml</code>, <code>cockpit-view.xml</code> and <code>model2-view.xml</code>.

{{key press|q}}/{{key press|Shift|Q}} steps through the available MP/AI aircraft.

== Issues ==
Currently the cockpit views starts at (0,0,0) which is a bit of a usability problem - it works for someone that knows it is a bit of a hack but looks bad for anyone else.

The {{key press|q}}/{{key press|Shift|Q}} key bindings might interfere with aircraft that use these keys.

== Status ==
AndersG created a version of the addon<ref>{{cite web
|url = https://forum.flightgear.org/viewtopic.php?f=30&t=32718&start=15#p316599
|title = <nowiki> Re: </nowiki>
|author = <nowiki> AndersG </nowiki>
|date = Aug 14th, 2017
|added = Aug 14th, 2017
}}</ref>
that is available in http://www.gidenstam.org/FlightGear/misc/ModelCockpitView-addon.tar.gz.

wkitty42 was working on converting the cockpit-view mod to the <code>--addon</code> format<ref>{{cite web
|url = https://forum.flightgear.org/viewtopic.php?p=316498#p316498
|title = <nowiki> Re: </nowiki>
|author = <nowiki> wkitty42 </nowiki>
|date = Aug 13th, 2017
|added = Aug 13th, 2017
|script_version = 0.40
}}</ref>
and currently this addon is abandoned.<ref>{{cite web
|url = https://forum.flightgear.org/viewtopic.php?f=30&t=32718&start=45#p430651
|title = <nowiki> Re: </nowiki>
|author = <nowiki> wkitty42 </nowiki>
|date = Mar 24th, 2025
|added = Mar 24th, 2025
|script_version = 0.40
}}</ref>

== Changing the view point ==
By default, the view point will be at (0,0,0), so the view point will be exactly on the bottom for many models.
The viewpoint can be moved up/down/left/right at runtime by pressing RMB+MMB (right and middle mouse buttons) and dragging. Holding control too makes it move forward/aft/left/right instead. The offset so set will apply to all models viewed (in essence it does not change as you switch the model the view follows).

Though this might be useful for analysis purposes, a raised view point is more interesting. The view point can be changed by adding the following code to the addons <code>main.nas</code> file:

<syntaxhighlight lang="xml">
...
if (type != "multiplayer")
color = { text: { color: { red: 0.5, green: 0.8, blue: 0.5 }}};
# move view point above back of vehicle.
if (getprop("/sim/current-view/name") == "Model Cockpit View" and name) {
if (string.match(name,"*gsvehicle*")){
#Ground Service vehicle
setprop("/sim/current-view/z-offset-m", 20);
setprop("/sim/current-view/y-offset-m", 7);
} else if (string.match(name,"*carrier*")){
setprop("/sim/current-view/z-offset-m", 110);
setprop("/sim/current-view/y-offset-m", 47);
} else {
#Aircraft?
setprop("/sim/current-view/z-offset-m", 60);
setprop("/sim/current-view/y-offset-m", 17);
}
}
if (name)
gui.popupTip(name, 2, color);
...
</syntaxhighlight>

The offset values shown here are just arbitrary.

== References ==
{{Appendix}}

[[Category:FlightGear addons]]

Pl/FlightGear

2026-04-03T16:43:22Z

PlayeRom: /* Sprzęt */

{{Infobox Software
|title = FlightGear Flight Simulator
|logo = FlightGear logo.png
|logosize = 200px
|image = Boeing 777-200ER cockpit.jpg
|alt = W kokpicie [[Boeing 777-200ER]]
|developedby = Developerzy FlightGear i współtwórcy
|initialrelease = Lipec 17, 1997
|latestrelease = {{current release|full}} ({{#time: j xg Y | {{current release|fulldate}} | pl }})
|writtenin = C/C++/Nasal
|os = Windows, Linux, macOS oraz FreeBSD
|platform = wieloplatformowy
|developmentstatus = Aktywny (1996-)
|type = Symulator Lotu
|license = [[GNU General Public License]]
|website = https://www.flightgear.org/
}}

[[File:OV10A-NASA-in-action.jpg|thumb|right|270px|NASA [[OV-10]] we FlightGear 1.0]]

'''FlightGear Flight Simulator''' (w skrócie '''FlightGear''' lub '''FGFS''') to zaawansowana, darmowa i całkowicie otwarto-źródłowa platforma symulacji lotu, stworzona przez wolontariuszy. FlightGear jest wydany na zasadach licencji [[GNU General Public License]] i jest on w większości napisany przy użyciu języka programowania C++.

Coraz bardziej szczegółowe i zaawansowane wersje FlightGeara są corocznie wydawane od zapoczątkowania projektu w 1996 roku.

Najnowsze publiczne wydanie dostępne jest do pobrania na [https://www.flightgear.org/download/ www.flightgear.org/download/] wraz z wersjami dla Microsoft Windows, macOS i Linux.

== Historia ==
{{main article|FlightGear History}}

Rozwój FlightGeara rozpoczął się od propozycji stworzenia otwarto-źródłowego symulatora w 1996 roku, w oparciu o własny kod renderowania grafiki 3D. Rozwój wersji opartej na [[OpenGL]] rozpoczął Curtis Olson w 1997 roku, ale także wiele innych osób miało swój wkład w ten projekt.

FlightGear włączył inne otwarto-źródłowe zasoby, w tym model lotu LaRCsim od NASA oraz powszechnie dostępne dane o elewacji terenu. Pierwsze działające pliki binarne, wykorzystujące OpenGL dla grafiki 3D, pojawiły się w 1997 roku. Entuzjastyczny rozwój kolejnych wersji przez kilka lat zaowocował stopniowo coraz bardziej stabilnymi i zaawansowanymi wersjami. W 2001 roku zespół regularnie wydawał nowe wersje beta, a w 2005 roku dojrzałość oprogramowania doprowadziła do szerszych recenzji i wzrostu popularności. W 2007 roku nastąpiło formalne wyjście z wersji beta wraz z wydaniem wersji 1.0.0, dziesięć lat po pierwszym wydaniu FlightGeara w 1997 roku.

[[File:FG-A-10.jpg|thumb|270px|Kokpit 3D [[A-10]] w wersji 1.0.0, rok 2008]]

W 2008 roku, wersja 1.9.0 FlightGeara przeszła z biblioteki [[PLIB]] na [[OSG]], co spowodowało tymczasową utratę niektórych funkcji programu, takich jak wyświetlanie chmury 3D i cienie, za to nowo wprowadzone funkcje, takie jak cząsteczki, nadały symulacji kolejny stopień realizmu.

== Program ==

Silnik symulacji we FlightGear to [[SimGear]]. Jest on używany zarówno jako aplikacja użytkownika końcowego jak i przy pracach badawczych w środowiskach akademickich w celu rozwoju zagadnień związanych z symulacją lotu.

Przykładem na możliwość dostosowywania FlightGeara jest szeroki wachlarz modeli dostępnych statków powietrznych, od [[:Category:Gliders|szybowców]] przez [[Helicopter|śmigłowców]], [[:Category:Airliners|liniowce]], [[Military aircraft|myśliwców odrzutowych]] do [[Space Shuttle|Wahadłowca Kosmicznego]]. Modele te zostały wykonane i dodane do projektu przez wielu ochotników ze społeczności FlightGeara.

Od wersji 0.9.10 statki powietrzne we FlightGear używają jednego z trzech [[Flight Dynamics Model|modeli dynamiki lotu]] (FDM): [[JSBSim]], [[YASim]] lub [[UIUC]]. Obecnie wyłącznie jeden silnik terenu jest w użyciu, jest nim [[TerraGear]]. Dostępne efekty pogodowe to między innymi chmury 3D, efekty świetlne, pory dnia i nocy.

=== Modele Dynamiki Lotu ===
[[Flight Dynamics Models|Model dynamiki lotu]] (FDM) odpowiada za to w jaki sposób w programie jest symulowany lot statku powietrznego. FlightGear korzysta z własnych oraz zewnętrznych projektów modeli dynamiki lotu. Każdy statek powietrzny musi być tak zaprogramowany, aby korzystał z jednego z dostępnych modeli dynamiki lotu. Obecnie FlightGear jest jedynym, graficznym symulatorem lotu korzystającym ze wszystkich wspomnianych modeli dynamiki lotu, a UIUC i YASim zostały rozwinięte z myślą i w szczególności dla FlightGeara.

Wczesne wersje programu używały FDM, który był oparty na [[LaRCsim]] od NASA. W kolejnych wersjach został on zastąpiony przez bardziej elastyczne FDM.

* [[JSBSim]] - domyślny model dynamiki lotu od 2000 roku.
* [[YASim]] - inny FDM, używający odmiennych metod obliczeniowych. Wprowadzony od wersji 0.7.9 w 2002 roku.
* [[UIUC]] - kolejny FDM, rozwijany przez UIUC Applied Aerodynamics Group z Uniwersytetu w Illinois na Urbana-Champaign, bazujący na LaRCsim. Obecnie już wycofany z wersji deweloperskiej FlightGeara.
* FlightGear może być tak skonfigurowany, aby przyjmował dane z zewnętrznych źródeł FDM takich jak [[MATLAB]].
* Inne niestandardowe FDM zostały napisane dla specyficznych typów statków powietrznych jak balony i sterowce.

=== Zależności FlightGeara ===

W przeciwieństwie do komercyjnych tytułów, głównym rezultatem prac nad projektem jest publikacja kodu źródłowego. Aby skorzystać z programu, można samodzielnie skompilować udostępniony kod dla docelowej platformy.

Wykorzystywane przez FlightGeara biblioteki zmieniały się na przestrzeni czasu. Najważniejszą zależnością pozostaje SimGear, będący silnikiem symulacji dla FlightGeara. [[TerraGear]] nie stanowi bezpośredniej zależności – jest raczej nazwą domyślnego silnika odpowiedzialnego za generowanie terenu.

Do obsługi dźwięku wykorzystywany jest OpenAL (z włączonym wsparciem dla SDL od wersji 0.9.5), natomiast wcześniej w tym celu używano biblioteki PLIB, która odpowiadała również za obsługę sprzętu. Za renderowanie grafiki 3D odpowiada [[OpenGL]] – DirectX nie jest wspierany. Z FlightGearem zintegrowano także silnik graficzny [[OpenSceneGraph]]. Do kompilacji wymagane jest również użycie biblioteki Simple Direct Media Layer (SDL).

Zakres zależności może się różnić w zależności od docelowej platformy. Użytkownicy mogą samodzielnie kompilować kod lub – jeśli nie jest on dostępny bezpośrednio w ramach projektu – korzystać z gotowych wersji binarnych przygotowanych przez osoby trzecie.

== Sprzęt==

Do uruchomienia FlightGeara wymagany jest sprzęt obsługujący [[OpenGL]] oraz akcelerację 3D. Najlepsze wsparcie zapewniają karty graficzne NVIDIA. We wcześniejszych wersjach dostępna była również obsługa kart 3dfx, jednak została ona wycofana wraz ze wzrostem wymagań sprzętowych.

[[File:Fgrun-page2.jpg|thumb|left|270px|[[FlightGear Launch Control|FlightGear Launcher]]]]

== Dodatki i dostosowywanie ==

Istnieją programy, które są zintegrowane z FlightGearem (zależności) lub są programami zewnętrznymi i współpracują z nim. Oprogramowanie takie może być częścią projektu FlightGear lub może być rozwijane niezależnie, ale udostępniane przez projekt FlightGear.

Ważnym dodatkowym oprogramowaniem jest interfejs graficzny, służący do uruchomienia pliku wykonywalnego FlightGeara. We wczesnych wersjach, FlightGear mógł być uruchomiony jedynie z wykorzystaniem [[Pl/Opcje wiersza poleceń|opcji wiersza poleceń]]. Jednakże, w 2003 roku od wersji 0.9.3, został dołączony ''[[FlightGear Launch Control|FGRun]]'' - program startowy z interfejsem graficznym. Obecnie tę rolę spełnia ''[[FlightGear Qt launcher|QT Launcher]]''.
Podobną funkcję spełnia ''[[KFreeFlight]]'' dla środowiska KDE. ''FGTools'' jest alternatywnym front-endem dla środowiska Windows. ''FGKicker'' jest używany dla GTK+.

Inne znaczące programy obejmują edytory i projekty związane z terenem. ''[[Atlas]]'' jest mapą dla FlightGeara; ''[[Kelpie Flight Planner]]'' to rozwijane w Javie narzędzie do planowania lotów.
''[[FlightGear Scenery Designer]]'' to edytor scenerii, pomocny przy pracy z danymi terenu. ''[[World Custom Scenery Project]]'' to projekt pomagający koordynować wspólne wysiłki na rzecz tworzenia scenerii. Na koniec edytor ''[[TaxiDraw]]'' do tworzenia nowych pasów startowych i dróg kołowania.

=== Statki Powietrzne ===
{{Main article|Table of models}}

Na początku, FlightGear dysponował tylko jednym statkiem powietrznym, był to Navion zawarty w projekcie LaRCsim od NASA, który w 2000 roku został zastąpiony przez Cessnę 172P. Rozwój UIUC i JSBSim przyniósł ze sobą kilka kolejnych samolotów, podobnie jak rozwój YASim, który od tego czasu stał się głównym FDM używanym we FlightGear. W wersji 2.12 dostępnych jest ponad 400 samolotów w ponad 900 unikalnych malowaniach, choć tylko kilka z nich wchodzi w skład pakietu podstawowego.

[[File:EHAM.jpg|thumb|270px|[[Boeing 737-300|Boeing 733]] zaparkowany w scenerii [[EHAM]] ]]

=== Sceneria ===
{{Main article|Scenery}}

Projekt [[World Scenery]] dla FlightGeara zawiera dane o wysokości i klasie terenu całego świata.
Obiekty takie jak terminale, wiatraki i mosty są zebrane w [[FlightGear Scenery Database|bazie danych scenerii]].

=== Sieć i wiele monitorów ===

Istnieje kilka możliwości, które pozwalają komunikować się jednej instancji FlightGeara z inną. Dostępny jest protokół [[Multiplayer Howto|multiplayer]], co umożliwia lot w formacji lub symulowanie kontroli ruchu lotniczego w sieci lokalnej. Protokół Multiplayer zostanie wkrótce tak rozbudowany, aby także pozwalał na pracę w internecie. Dodatkową cechą możliwości sieciowych jest opcja podglądu innych pilotów na mapach Google.

Kilka instancji FlightGeara może zostać tak zsynchronizowana, aby korzystały z wielu monitorów. Możliwe jest uzyskanie bardzo dobrej synchronizacji między monitorami jeżeli wszystkie instancje FlightGeara będą pracowały z tą samą częstotliwością wyświetlania klatek.

== Kod FlightGeara vs wersja binarna ==

W przeciwieństwie do komercyjnego oprogramowania, data wydania dotyczy wyłącznie kodu źródłowego, a nie wersji binarnej. Aby stworzyć wykonywalny program, kod źródłowy musi zostać skompilowany, co wymaga kilku bibliotek, włączając w to kilka ogólnych oraz specyficznych dla platfory. Jednak jest to zbyt trudne zadanie dla wielu zwykłych użytkowników, dlatego ochotnicy społeczności pracują, aby udostępnić wersje binarne dla poszczególnych platform i systemów operacyjnych. Dystrybucje te różnią się poziomem stabilności, wydajnością, zależnościami, a także tym, jak aktualne są one w stosunku do kodu źródłowego. Dla przykładu, niektóre ze starszych wersji binarnych będą pracować poprawnie pod Mac OS 9, ale nowsze wydania wymagają określonych wersji Mac OS X.

For example, by late 2012 the latest code release was 2.10 (pre-release) and 2.8.0 (final). Binaries are generally available for the last final code release on all major platforms. [http://www.flightgear.org/download/main-program/ Click here to proceed to the flightgear binaries download page]

Przykładowo, pod koniec 2012 roku najnowszą wersją kodu była wersja 2.10 (przedpremierowa) i 2.8.0 (finalna). Pliki binarne są ogólnie dostępne dla ostatniego finalnego wydania kodu na wszystkich głównych platformach. Przejdź do naszej oficjalnej [https://www.flightgear.org/download/ strony pobierania] aby pobrać pliki binarne FlightGeara.

Pliki binarne dla innych platform, takich jak IRIX, nie są już obsługiwane, chociaż wydania sprzed 1.0 mogą działać i można je znaleźć w [[FlightGear Git|repozytoriach kodu źródłowego git]].

== Recenzje FlightGear ==
{{Main article|FlightGear Reviews}}

== Łącza zewnętrzne ==
{{Main article|Links}}
* {{Wikipedia|FlightGear}}
* [https://www.flightgear.org Oficjalna strona]
* {{forum link|text=Forum}}
* [https://sourceforge.net/p/flightgear/codetickets/ System śledzenia błędów]
* [http://www.flightgear.org/proposal-3.0.1 Oryginalna propozycja stworzenia FlightGear]

== Źródła ==
* [http://www.flightgear.org/proposal-3.0.1 Original Flight Gear Proposal] by David L. Murr (Revision 3.0.1)
* [http://en.wikipedia.org/wiki/FlightGear Wikipedia]

[[ca:FlightGear]]
[[de:FlightGear]]
[[en:FlightGear]]
[[es:FlightGear]]
[[fr:FlightGear]]
[[it:FlightGear]]
[[nl:FlightGear]]
[[pt:FlightGear]]

Pl/FlightGear

2026-04-03T16:41:59Z

PlayeRom: /* Zależności FlightGeara */

{{Infobox Software
|title = FlightGear Flight Simulator
|logo = FlightGear logo.png
|logosize = 200px
|image = Boeing 777-200ER cockpit.jpg
|alt = W kokpicie [[Boeing 777-200ER]]
|developedby = Developerzy FlightGear i współtwórcy
|initialrelease = Lipec 17, 1997
|latestrelease = {{current release|full}} ({{#time: j xg Y | {{current release|fulldate}} | pl }})
|writtenin = C/C++/Nasal
|os = Windows, Linux, macOS oraz FreeBSD
|platform = wieloplatformowy
|developmentstatus = Aktywny (1996-)
|type = Symulator Lotu
|license = [[GNU General Public License]]
|website = https://www.flightgear.org/
}}

[[File:OV10A-NASA-in-action.jpg|thumb|right|270px|NASA [[OV-10]] we FlightGear 1.0]]

'''FlightGear Flight Simulator''' (w skrócie '''FlightGear''' lub '''FGFS''') to zaawansowana, darmowa i całkowicie otwarto-źródłowa platforma symulacji lotu, stworzona przez wolontariuszy. FlightGear jest wydany na zasadach licencji [[GNU General Public License]] i jest on w większości napisany przy użyciu języka programowania C++.

Coraz bardziej szczegółowe i zaawansowane wersje FlightGeara są corocznie wydawane od zapoczątkowania projektu w 1996 roku.

Najnowsze publiczne wydanie dostępne jest do pobrania na [https://www.flightgear.org/download/ www.flightgear.org/download/] wraz z wersjami dla Microsoft Windows, macOS i Linux.

== Historia ==
{{main article|FlightGear History}}

Rozwój FlightGeara rozpoczął się od propozycji stworzenia otwarto-źródłowego symulatora w 1996 roku, w oparciu o własny kod renderowania grafiki 3D. Rozwój wersji opartej na [[OpenGL]] rozpoczął Curtis Olson w 1997 roku, ale także wiele innych osób miało swój wkład w ten projekt.

FlightGear włączył inne otwarto-źródłowe zasoby, w tym model lotu LaRCsim od NASA oraz powszechnie dostępne dane o elewacji terenu. Pierwsze działające pliki binarne, wykorzystujące OpenGL dla grafiki 3D, pojawiły się w 1997 roku. Entuzjastyczny rozwój kolejnych wersji przez kilka lat zaowocował stopniowo coraz bardziej stabilnymi i zaawansowanymi wersjami. W 2001 roku zespół regularnie wydawał nowe wersje beta, a w 2005 roku dojrzałość oprogramowania doprowadziła do szerszych recenzji i wzrostu popularności. W 2007 roku nastąpiło formalne wyjście z wersji beta wraz z wydaniem wersji 1.0.0, dziesięć lat po pierwszym wydaniu FlightGeara w 1997 roku.

[[File:FG-A-10.jpg|thumb|270px|Kokpit 3D [[A-10]] w wersji 1.0.0, rok 2008]]

W 2008 roku, wersja 1.9.0 FlightGeara przeszła z biblioteki [[PLIB]] na [[OSG]], co spowodowało tymczasową utratę niektórych funkcji programu, takich jak wyświetlanie chmury 3D i cienie, za to nowo wprowadzone funkcje, takie jak cząsteczki, nadały symulacji kolejny stopień realizmu.

== Program ==

Silnik symulacji we FlightGear to [[SimGear]]. Jest on używany zarówno jako aplikacja użytkownika końcowego jak i przy pracach badawczych w środowiskach akademickich w celu rozwoju zagadnień związanych z symulacją lotu.

Przykładem na możliwość dostosowywania FlightGeara jest szeroki wachlarz modeli dostępnych statków powietrznych, od [[:Category:Gliders|szybowców]] przez [[Helicopter|śmigłowców]], [[:Category:Airliners|liniowce]], [[Military aircraft|myśliwców odrzutowych]] do [[Space Shuttle|Wahadłowca Kosmicznego]]. Modele te zostały wykonane i dodane do projektu przez wielu ochotników ze społeczności FlightGeara.

Od wersji 0.9.10 statki powietrzne we FlightGear używają jednego z trzech [[Flight Dynamics Model|modeli dynamiki lotu]] (FDM): [[JSBSim]], [[YASim]] lub [[UIUC]]. Obecnie wyłącznie jeden silnik terenu jest w użyciu, jest nim [[TerraGear]]. Dostępne efekty pogodowe to między innymi chmury 3D, efekty świetlne, pory dnia i nocy.

=== Modele Dynamiki Lotu ===
[[Flight Dynamics Models|Model dynamiki lotu]] (FDM) odpowiada za to w jaki sposób w programie jest symulowany lot statku powietrznego. FlightGear korzysta z własnych oraz zewnętrznych projektów modeli dynamiki lotu. Każdy statek powietrzny musi być tak zaprogramowany, aby korzystał z jednego z dostępnych modeli dynamiki lotu. Obecnie FlightGear jest jedynym, graficznym symulatorem lotu korzystającym ze wszystkich wspomnianych modeli dynamiki lotu, a UIUC i YASim zostały rozwinięte z myślą i w szczególności dla FlightGeara.

Wczesne wersje programu używały FDM, który był oparty na [[LaRCsim]] od NASA. W kolejnych wersjach został on zastąpiony przez bardziej elastyczne FDM.

* [[JSBSim]] - domyślny model dynamiki lotu od 2000 roku.
* [[YASim]] - inny FDM, używający odmiennych metod obliczeniowych. Wprowadzony od wersji 0.7.9 w 2002 roku.
* [[UIUC]] - kolejny FDM, rozwijany przez UIUC Applied Aerodynamics Group z Uniwersytetu w Illinois na Urbana-Champaign, bazujący na LaRCsim. Obecnie już wycofany z wersji deweloperskiej FlightGeara.
* FlightGear może być tak skonfigurowany, aby przyjmował dane z zewnętrznych źródeł FDM takich jak [[MATLAB]].
* Inne niestandardowe FDM zostały napisane dla specyficznych typów statków powietrznych jak balony i sterowce.

=== Zależności FlightGeara ===

W przeciwieństwie do komercyjnych tytułów, głównym rezultatem prac nad projektem jest publikacja kodu źródłowego. Aby skorzystać z programu, można samodzielnie skompilować udostępniony kod dla docelowej platformy.

Wykorzystywane przez FlightGeara biblioteki zmieniały się na przestrzeni czasu. Najważniejszą zależnością pozostaje SimGear, będący silnikiem symulacji dla FlightGeara. [[TerraGear]] nie stanowi bezpośredniej zależności – jest raczej nazwą domyślnego silnika odpowiedzialnego za generowanie terenu.

Do obsługi dźwięku wykorzystywany jest OpenAL (z włączonym wsparciem dla SDL od wersji 0.9.5), natomiast wcześniej w tym celu używano biblioteki PLIB, która odpowiadała również za obsługę sprzętu. Za renderowanie grafiki 3D odpowiada [[OpenGL]] – DirectX nie jest wspierany. Z FlightGearem zintegrowano także silnik graficzny [[OpenSceneGraph]]. Do kompilacji wymagane jest również użycie biblioteki Simple Direct Media Layer (SDL).

Zakres zależności może się różnić w zależności od docelowej platformy. Użytkownicy mogą samodzielnie kompilować kod lub – jeśli nie jest on dostępny bezpośrednio w ramach projektu – korzystać z gotowych wersji binarnych przygotowanych przez osoby trzecie.

== Sprzęt==

Sprzęt konieczny do uruchomienia FlightGeara jest ograniczony do sprzętu, który wspiera [[OpenGL]] i akcelerację 3D, przy czym najlepiej wspierana jest NVIDIA. Wczesne wersje posiadały wsparcie dla kart 3dfx, jednak wsparcie to zostało wycofane wraz ze zwiększającymi się wymaganiami sprzętowymi.

[[File:Fgrun-page2.jpg|thumb|left|270px|[[FlightGear Launch Control|FlightGear Launcher]]]]
== Dodatki i dostosowywanie ==

Istnieją programy, które są zintegrowane z FlightGearem (zależności) lub są programami zewnętrznymi i współpracują z nim. Oprogramowanie takie może być częścią projektu FlightGear lub może być rozwijane niezależnie, ale udostępniane przez projekt FlightGear.

Ważnym dodatkowym oprogramowaniem jest interfejs graficzny, służący do uruchomienia pliku wykonywalnego FlightGeara. We wczesnych wersjach, FlightGear mógł być uruchomiony jedynie z wykorzystaniem [[Pl/Opcje wiersza poleceń|opcji wiersza poleceń]]. Jednakże, w 2003 roku od wersji 0.9.3, został dołączony ''[[FlightGear Launch Control|FGRun]]'' - program startowy z interfejsem graficznym. Obecnie tę rolę spełnia ''[[FlightGear Qt launcher|QT Launcher]]''.
Podobną funkcję spełnia ''[[KFreeFlight]]'' dla środowiska KDE. ''FGTools'' jest alternatywnym front-endem dla środowiska Windows. ''FGKicker'' jest używany dla GTK+.

Inne znaczące programy obejmują edytory i projekty związane z terenem. ''[[Atlas]]'' jest mapą dla FlightGeara; ''[[Kelpie Flight Planner]]'' to rozwijane w Javie narzędzie do planowania lotów.
''[[FlightGear Scenery Designer]]'' to edytor scenerii, pomocny przy pracy z danymi terenu. ''[[World Custom Scenery Project]]'' to projekt pomagający koordynować wspólne wysiłki na rzecz tworzenia scenerii. Na koniec edytor ''[[TaxiDraw]]'' do tworzenia nowych pasów startowych i dróg kołowania.

=== Statki Powietrzne ===
{{Main article|Table of models}}

Na początku, FlightGear dysponował tylko jednym statkiem powietrznym, był to Navion zawarty w projekcie LaRCsim od NASA, który w 2000 roku został zastąpiony przez Cessnę 172P. Rozwój UIUC i JSBSim przyniósł ze sobą kilka kolejnych samolotów, podobnie jak rozwój YASim, który od tego czasu stał się głównym FDM używanym we FlightGear. W wersji 2.12 dostępnych jest ponad 400 samolotów w ponad 900 unikalnych malowaniach, choć tylko kilka z nich wchodzi w skład pakietu podstawowego.

[[File:EHAM.jpg|thumb|270px|[[Boeing 737-300|Boeing 733]] zaparkowany w scenerii [[EHAM]] ]]

=== Sceneria ===
{{Main article|Scenery}}

Projekt [[World Scenery]] dla FlightGeara zawiera dane o wysokości i klasie terenu całego świata.
Obiekty takie jak terminale, wiatraki i mosty są zebrane w [[FlightGear Scenery Database|bazie danych scenerii]].

=== Sieć i wiele monitorów ===

Istnieje kilka możliwości, które pozwalają komunikować się jednej instancji FlightGeara z inną. Dostępny jest protokół [[Multiplayer Howto|multiplayer]], co umożliwia lot w formacji lub symulowanie kontroli ruchu lotniczego w sieci lokalnej. Protokół Multiplayer zostanie wkrótce tak rozbudowany, aby także pozwalał na pracę w internecie. Dodatkową cechą możliwości sieciowych jest opcja podglądu innych pilotów na mapach Google.

Kilka instancji FlightGeara może zostać tak zsynchronizowana, aby korzystały z wielu monitorów. Możliwe jest uzyskanie bardzo dobrej synchronizacji między monitorami jeżeli wszystkie instancje FlightGeara będą pracowały z tą samą częstotliwością wyświetlania klatek.

== Kod FlightGeara vs wersja binarna ==

W przeciwieństwie do komercyjnego oprogramowania, data wydania dotyczy wyłącznie kodu źródłowego, a nie wersji binarnej. Aby stworzyć wykonywalny program, kod źródłowy musi zostać skompilowany, co wymaga kilku bibliotek, włączając w to kilka ogólnych oraz specyficznych dla platfory. Jednak jest to zbyt trudne zadanie dla wielu zwykłych użytkowników, dlatego ochotnicy społeczności pracują, aby udostępnić wersje binarne dla poszczególnych platform i systemów operacyjnych. Dystrybucje te różnią się poziomem stabilności, wydajnością, zależnościami, a także tym, jak aktualne są one w stosunku do kodu źródłowego. Dla przykładu, niektóre ze starszych wersji binarnych będą pracować poprawnie pod Mac OS 9, ale nowsze wydania wymagają określonych wersji Mac OS X.

For example, by late 2012 the latest code release was 2.10 (pre-release) and 2.8.0 (final). Binaries are generally available for the last final code release on all major platforms. [http://www.flightgear.org/download/main-program/ Click here to proceed to the flightgear binaries download page]

Przykładowo, pod koniec 2012 roku najnowszą wersją kodu była wersja 2.10 (przedpremierowa) i 2.8.0 (finalna). Pliki binarne są ogólnie dostępne dla ostatniego finalnego wydania kodu na wszystkich głównych platformach. Przejdź do naszej oficjalnej [https://www.flightgear.org/download/ strony pobierania] aby pobrać pliki binarne FlightGeara.

Pliki binarne dla innych platform, takich jak IRIX, nie są już obsługiwane, chociaż wydania sprzed 1.0 mogą działać i można je znaleźć w [[FlightGear Git|repozytoriach kodu źródłowego git]].

== Recenzje FlightGear ==
{{Main article|FlightGear Reviews}}

== Łącza zewnętrzne ==
{{Main article|Links}}
* {{Wikipedia|FlightGear}}
* [https://www.flightgear.org Oficjalna strona]
* {{forum link|text=Forum}}
* [https://sourceforge.net/p/flightgear/codetickets/ System śledzenia błędów]
* [http://www.flightgear.org/proposal-3.0.1 Oryginalna propozycja stworzenia FlightGear]

== Źródła ==
* [http://www.flightgear.org/proposal-3.0.1 Original Flight Gear Proposal] by David L. Murr (Revision 3.0.1)
* [http://en.wikipedia.org/wiki/FlightGear Wikipedia]

[[ca:FlightGear]]
[[de:FlightGear]]
[[en:FlightGear]]
[[es:FlightGear]]
[[fr:FlightGear]]
[[it:FlightGear]]
[[nl:FlightGear]]
[[pt:FlightGear]]

Pl/FlightGear

2026-04-03T16:37:13Z

PlayeRom: /* Modele Dynamiki Lotu */

{{Infobox Software
|title = FlightGear Flight Simulator
|logo = FlightGear logo.png
|logosize = 200px
|image = Boeing 777-200ER cockpit.jpg
|alt = W kokpicie [[Boeing 777-200ER]]
|developedby = Developerzy FlightGear i współtwórcy
|initialrelease = Lipec 17, 1997
|latestrelease = {{current release|full}} ({{#time: j xg Y | {{current release|fulldate}} | pl }})
|writtenin = C/C++/Nasal
|os = Windows, Linux, macOS oraz FreeBSD
|platform = wieloplatformowy
|developmentstatus = Aktywny (1996-)
|type = Symulator Lotu
|license = [[GNU General Public License]]
|website = https://www.flightgear.org/
}}

[[File:OV10A-NASA-in-action.jpg|thumb|right|270px|NASA [[OV-10]] we FlightGear 1.0]]

'''FlightGear Flight Simulator''' (w skrócie '''FlightGear''' lub '''FGFS''') to zaawansowana, darmowa i całkowicie otwarto-źródłowa platforma symulacji lotu, stworzona przez wolontariuszy. FlightGear jest wydany na zasadach licencji [[GNU General Public License]] i jest on w większości napisany przy użyciu języka programowania C++.

Coraz bardziej szczegółowe i zaawansowane wersje FlightGeara są corocznie wydawane od zapoczątkowania projektu w 1996 roku.

Najnowsze publiczne wydanie dostępne jest do pobrania na [https://www.flightgear.org/download/ www.flightgear.org/download/] wraz z wersjami dla Microsoft Windows, macOS i Linux.

== Historia ==
{{main article|FlightGear History}}

Rozwój FlightGeara rozpoczął się od propozycji stworzenia otwarto-źródłowego symulatora w 1996 roku, w oparciu o własny kod renderowania grafiki 3D. Rozwój wersji opartej na [[OpenGL]] rozpoczął Curtis Olson w 1997 roku, ale także wiele innych osób miało swój wkład w ten projekt.

FlightGear włączył inne otwarto-źródłowe zasoby, w tym model lotu LaRCsim od NASA oraz powszechnie dostępne dane o elewacji terenu. Pierwsze działające pliki binarne, wykorzystujące OpenGL dla grafiki 3D, pojawiły się w 1997 roku. Entuzjastyczny rozwój kolejnych wersji przez kilka lat zaowocował stopniowo coraz bardziej stabilnymi i zaawansowanymi wersjami. W 2001 roku zespół regularnie wydawał nowe wersje beta, a w 2005 roku dojrzałość oprogramowania doprowadziła do szerszych recenzji i wzrostu popularności. W 2007 roku nastąpiło formalne wyjście z wersji beta wraz z wydaniem wersji 1.0.0, dziesięć lat po pierwszym wydaniu FlightGeara w 1997 roku.

[[File:FG-A-10.jpg|thumb|270px|Kokpit 3D [[A-10]] w wersji 1.0.0, rok 2008]]

W 2008 roku, wersja 1.9.0 FlightGeara przeszła z biblioteki [[PLIB]] na [[OSG]], co spowodowało tymczasową utratę niektórych funkcji programu, takich jak wyświetlanie chmury 3D i cienie, za to nowo wprowadzone funkcje, takie jak cząsteczki, nadały symulacji kolejny stopień realizmu.

== Program ==

Silnik symulacji we FlightGear to [[SimGear]]. Jest on używany zarówno jako aplikacja użytkownika końcowego jak i przy pracach badawczych w środowiskach akademickich w celu rozwoju zagadnień związanych z symulacją lotu.

Przykładem na możliwość dostosowywania FlightGeara jest szeroki wachlarz modeli dostępnych statków powietrznych, od [[:Category:Gliders|szybowców]] przez [[Helicopter|śmigłowców]], [[:Category:Airliners|liniowce]], [[Military aircraft|myśliwców odrzutowych]] do [[Space Shuttle|Wahadłowca Kosmicznego]]. Modele te zostały wykonane i dodane do projektu przez wielu ochotników ze społeczności FlightGeara.

Od wersji 0.9.10 statki powietrzne we FlightGear używają jednego z trzech [[Flight Dynamics Model|modeli dynamiki lotu]] (FDM): [[JSBSim]], [[YASim]] lub [[UIUC]]. Obecnie wyłącznie jeden silnik terenu jest w użyciu, jest nim [[TerraGear]]. Dostępne efekty pogodowe to między innymi chmury 3D, efekty świetlne, pory dnia i nocy.

=== Modele Dynamiki Lotu ===
[[Flight Dynamics Models|Model dynamiki lotu]] (FDM) odpowiada za to w jaki sposób w programie jest symulowany lot statku powietrznego. FlightGear korzysta z własnych oraz zewnętrznych projektów modeli dynamiki lotu. Każdy statek powietrzny musi być tak zaprogramowany, aby korzystał z jednego z dostępnych modeli dynamiki lotu. Obecnie FlightGear jest jedynym, graficznym symulatorem lotu korzystającym ze wszystkich wspomnianych modeli dynamiki lotu, a UIUC i YASim zostały rozwinięte z myślą i w szczególności dla FlightGeara.

Wczesne wersje programu używały FDM, który był oparty na [[LaRCsim]] od NASA. W kolejnych wersjach został on zastąpiony przez bardziej elastyczne FDM.

* [[JSBSim]] - domyślny model dynamiki lotu od 2000 roku.
* [[YASim]] - inny FDM, używający odmiennych metod obliczeniowych. Wprowadzony od wersji 0.7.9 w 2002 roku.
* [[UIUC]] - kolejny FDM, rozwijany przez UIUC Applied Aerodynamics Group z Uniwersytetu w Illinois na Urbana-Champaign, bazujący na LaRCsim. Obecnie już wycofany z wersji deweloperskiej FlightGeara.
* FlightGear może być tak skonfigurowany, aby przyjmował dane z zewnętrznych źródeł FDM takich jak [[MATLAB]].
* Inne niestandardowe FDM zostały napisane dla specyficznych typów statków powietrznych jak balony i sterowce.

=== Zależności FlightGeara ===

W przeciwieństwie do komercyjnych tytułów, głównym wynikiem pracy projektu jest wydanie zestawu kodów źródłowych. Aby użyć programu należy skompilować udostępniony kod dla docelowej platformy, na której ma pracować. Biblioteki użyte przez FlightGeara były różne w zależności od okresu. Główną biblioteką zależną jest SimGear, która jest silnikiem symulacji dla FlightGeara. [[TerraGear]] nie jest zależnością, a raczej tylko nazwą dla domyślnego silnika odpowiadającego za generowanie terenu we FlightGear. OpenAL jest używany dla obsługi dźwięku, włączając wsparcie dla SDL (od wersji 0.9.5). PLIB jest użyte do obsługi sprzętowej, także dla obsługi dźwięku przed wprowadzeniem OpenAL. [[OpenGL]] jest użyty dla swoich funkcji 3D, DirectX nie jest wspierany. Silnik graficzny [[OpenSceneGraph]] jest również zintegrowany z FlightGearem. Na koniec do kompilacji jest konieczna biblioteka Simple Direct Media Layer (SDL). Niektóre zależności mogą się różnić w zależności od tego na jaką platformę docelową jest kompilowany kod. Użytkownicy FlightGeara powinni sami kompilować kod lub jeżeli nie jest on dostępny w ramach projektu, korzystać z wersji binarnej udostępnionej przez osoby trzecie.

== Sprzęt==

Sprzęt konieczny do uruchomienia FlightGeara jest ograniczony do sprzętu, który wspiera [[OpenGL]] i akcelerację 3D, przy czym najlepiej wspierana jest NVIDIA. Wczesne wersje posiadały wsparcie dla kart 3dfx, jednak wsparcie to zostało wycofane wraz ze zwiększającymi się wymaganiami sprzętowymi.

[[File:Fgrun-page2.jpg|thumb|left|270px|[[FlightGear Launch Control|FlightGear Launcher]]]]
== Dodatki i dostosowywanie ==

Istnieją programy, które są zintegrowane z FlightGearem (zależności) lub są programami zewnętrznymi i współpracują z nim. Oprogramowanie takie może być częścią projektu FlightGear lub może być rozwijane niezależnie, ale udostępniane przez projekt FlightGear.

Ważnym dodatkowym oprogramowaniem jest interfejs graficzny, służący do uruchomienia pliku wykonywalnego FlightGeara. We wczesnych wersjach, FlightGear mógł być uruchomiony jedynie z wykorzystaniem [[Pl/Opcje wiersza poleceń|opcji wiersza poleceń]]. Jednakże, w 2003 roku od wersji 0.9.3, został dołączony ''[[FlightGear Launch Control|FGRun]]'' - program startowy z interfejsem graficznym. Obecnie tę rolę spełnia ''[[FlightGear Qt launcher|QT Launcher]]''.
Podobną funkcję spełnia ''[[KFreeFlight]]'' dla środowiska KDE. ''FGTools'' jest alternatywnym front-endem dla środowiska Windows. ''FGKicker'' jest używany dla GTK+.

Inne znaczące programy obejmują edytory i projekty związane z terenem. ''[[Atlas]]'' jest mapą dla FlightGeara; ''[[Kelpie Flight Planner]]'' to rozwijane w Javie narzędzie do planowania lotów.
''[[FlightGear Scenery Designer]]'' to edytor scenerii, pomocny przy pracy z danymi terenu. ''[[World Custom Scenery Project]]'' to projekt pomagający koordynować wspólne wysiłki na rzecz tworzenia scenerii. Na koniec edytor ''[[TaxiDraw]]'' do tworzenia nowych pasów startowych i dróg kołowania.

=== Statki Powietrzne ===
{{Main article|Table of models}}

Na początku, FlightGear dysponował tylko jednym statkiem powietrznym, był to Navion zawarty w projekcie LaRCsim od NASA, który w 2000 roku został zastąpiony przez Cessnę 172P. Rozwój UIUC i JSBSim przyniósł ze sobą kilka kolejnych samolotów, podobnie jak rozwój YASim, który od tego czasu stał się głównym FDM używanym we FlightGear. W wersji 2.12 dostępnych jest ponad 400 samolotów w ponad 900 unikalnych malowaniach, choć tylko kilka z nich wchodzi w skład pakietu podstawowego.

[[File:EHAM.jpg|thumb|270px|[[Boeing 737-300|Boeing 733]] zaparkowany w scenerii [[EHAM]] ]]

=== Sceneria ===
{{Main article|Scenery}}

Projekt [[World Scenery]] dla FlightGeara zawiera dane o wysokości i klasie terenu całego świata.
Obiekty takie jak terminale, wiatraki i mosty są zebrane w [[FlightGear Scenery Database|bazie danych scenerii]].

=== Sieć i wiele monitorów ===

Istnieje kilka możliwości, które pozwalają komunikować się jednej instancji FlightGeara z inną. Dostępny jest protokół [[Multiplayer Howto|multiplayer]], co umożliwia lot w formacji lub symulowanie kontroli ruchu lotniczego w sieci lokalnej. Protokół Multiplayer zostanie wkrótce tak rozbudowany, aby także pozwalał na pracę w internecie. Dodatkową cechą możliwości sieciowych jest opcja podglądu innych pilotów na mapach Google.

Kilka instancji FlightGeara może zostać tak zsynchronizowana, aby korzystały z wielu monitorów. Możliwe jest uzyskanie bardzo dobrej synchronizacji między monitorami jeżeli wszystkie instancje FlightGeara będą pracowały z tą samą częstotliwością wyświetlania klatek.

== Kod FlightGeara vs wersja binarna ==

W przeciwieństwie do komercyjnego oprogramowania, data wydania dotyczy wyłącznie kodu źródłowego, a nie wersji binarnej. Aby stworzyć wykonywalny program, kod źródłowy musi zostać skompilowany, co wymaga kilku bibliotek, włączając w to kilka ogólnych oraz specyficznych dla platfory. Jednak jest to zbyt trudne zadanie dla wielu zwykłych użytkowników, dlatego ochotnicy społeczności pracują, aby udostępnić wersje binarne dla poszczególnych platform i systemów operacyjnych. Dystrybucje te różnią się poziomem stabilności, wydajnością, zależnościami, a także tym, jak aktualne są one w stosunku do kodu źródłowego. Dla przykładu, niektóre ze starszych wersji binarnych będą pracować poprawnie pod Mac OS 9, ale nowsze wydania wymagają określonych wersji Mac OS X.

For example, by late 2012 the latest code release was 2.10 (pre-release) and 2.8.0 (final). Binaries are generally available for the last final code release on all major platforms. [http://www.flightgear.org/download/main-program/ Click here to proceed to the flightgear binaries download page]

Przykładowo, pod koniec 2012 roku najnowszą wersją kodu była wersja 2.10 (przedpremierowa) i 2.8.0 (finalna). Pliki binarne są ogólnie dostępne dla ostatniego finalnego wydania kodu na wszystkich głównych platformach. Przejdź do naszej oficjalnej [https://www.flightgear.org/download/ strony pobierania] aby pobrać pliki binarne FlightGeara.

Pliki binarne dla innych platform, takich jak IRIX, nie są już obsługiwane, chociaż wydania sprzed 1.0 mogą działać i można je znaleźć w [[FlightGear Git|repozytoriach kodu źródłowego git]].

== Recenzje FlightGear ==
{{Main article|FlightGear Reviews}}

== Łącza zewnętrzne ==
{{Main article|Links}}
* {{Wikipedia|FlightGear}}
* [https://www.flightgear.org Oficjalna strona]
* {{forum link|text=Forum}}
* [https://sourceforge.net/p/flightgear/codetickets/ System śledzenia błędów]
* [http://www.flightgear.org/proposal-3.0.1 Oryginalna propozycja stworzenia FlightGear]

== Źródła ==
* [http://www.flightgear.org/proposal-3.0.1 Original Flight Gear Proposal] by David L. Murr (Revision 3.0.1)
* [http://en.wikipedia.org/wiki/FlightGear Wikipedia]

[[ca:FlightGear]]
[[de:FlightGear]]
[[en:FlightGear]]
[[es:FlightGear]]
[[fr:FlightGear]]
[[it:FlightGear]]
[[nl:FlightGear]]
[[pt:FlightGear]]

Pl/FlightGear

2026-04-03T16:33:53Z

PlayeRom:

{{Infobox Software
|title = FlightGear Flight Simulator
|logo = FlightGear logo.png
|logosize = 200px
|image = Boeing 777-200ER cockpit.jpg
|alt = W kokpicie [[Boeing 777-200ER]]
|developedby = Developerzy FlightGear i współtwórcy
|initialrelease = Lipec 17, 1997
|latestrelease = {{current release|full}} ({{#time: j xg Y | {{current release|fulldate}} | pl }})
|writtenin = C/C++/Nasal
|os = Windows, Linux, macOS oraz FreeBSD
|platform = wieloplatformowy
|developmentstatus = Aktywny (1996-)
|type = Symulator Lotu
|license = [[GNU General Public License]]
|website = https://www.flightgear.org/
}}

[[File:OV10A-NASA-in-action.jpg|thumb|right|270px|NASA [[OV-10]] we FlightGear 1.0]]

'''FlightGear Flight Simulator''' (w skrócie '''FlightGear''' lub '''FGFS''') to zaawansowana, darmowa i całkowicie otwarto-źródłowa platforma symulacji lotu, stworzona przez wolontariuszy. FlightGear jest wydany na zasadach licencji [[GNU General Public License]] i jest on w większości napisany przy użyciu języka programowania C++.

Coraz bardziej szczegółowe i zaawansowane wersje FlightGeara są corocznie wydawane od zapoczątkowania projektu w 1996 roku.

Najnowsze publiczne wydanie dostępne jest do pobrania na [https://www.flightgear.org/download/ www.flightgear.org/download/] wraz z wersjami dla Microsoft Windows, macOS i Linux.

== Historia ==
{{main article|FlightGear History}}

Rozwój FlightGeara rozpoczął się od propozycji stworzenia otwarto-źródłowego symulatora w 1996 roku, w oparciu o własny kod renderowania grafiki 3D. Rozwój wersji opartej na [[OpenGL]] rozpoczął Curtis Olson w 1997 roku, ale także wiele innych osób miało swój wkład w ten projekt.

FlightGear włączył inne otwarto-źródłowe zasoby, w tym model lotu LaRCsim od NASA oraz powszechnie dostępne dane o elewacji terenu. Pierwsze działające pliki binarne, wykorzystujące OpenGL dla grafiki 3D, pojawiły się w 1997 roku. Entuzjastyczny rozwój kolejnych wersji przez kilka lat zaowocował stopniowo coraz bardziej stabilnymi i zaawansowanymi wersjami. W 2001 roku zespół regularnie wydawał nowe wersje beta, a w 2005 roku dojrzałość oprogramowania doprowadziła do szerszych recenzji i wzrostu popularności. W 2007 roku nastąpiło formalne wyjście z wersji beta wraz z wydaniem wersji 1.0.0, dziesięć lat po pierwszym wydaniu FlightGeara w 1997 roku.

[[File:FG-A-10.jpg|thumb|270px|Kokpit 3D [[A-10]] w wersji 1.0.0, rok 2008]]

W 2008 roku, wersja 1.9.0 FlightGeara przeszła z biblioteki [[PLIB]] na [[OSG]], co spowodowało tymczasową utratę niektórych funkcji programu, takich jak wyświetlanie chmury 3D i cienie, za to nowo wprowadzone funkcje, takie jak cząsteczki, nadały symulacji kolejny stopień realizmu.

== Program ==

Silnik symulacji we FlightGear to [[SimGear]]. Jest on używany zarówno jako aplikacja użytkownika końcowego jak i przy pracach badawczych w środowiskach akademickich w celu rozwoju zagadnień związanych z symulacją lotu.

Przykładem na możliwość dostosowywania FlightGeara jest szeroki wachlarz modeli dostępnych statków powietrznych, od [[:Category:Gliders|szybowców]] przez [[Helicopter|śmigłowców]], [[:Category:Airliners|liniowce]], [[Military aircraft|myśliwców odrzutowych]] do [[Space Shuttle|Wahadłowca Kosmicznego]]. Modele te zostały wykonane i dodane do projektu przez wielu ochotników ze społeczności FlightGeara.

Od wersji 0.9.10 statki powietrzne we FlightGear używają jednego z trzech [[Flight Dynamics Model|modeli dynamiki lotu]] (FDM): [[JSBSim]], [[YASim]] lub [[UIUC]]. Obecnie wyłącznie jeden silnik terenu jest w użyciu, jest nim [[TerraGear]]. Dostępne efekty pogodowe to między innymi chmury 3D, efekty świetlne, pory dnia i nocy.

=== Modele Dynamiki Lotu ===
[[Flight Dynamics Models|Model dynamiki lotu]] (FDM) odpowiada za to w jaki sposób w programie jest symulowany lot statku powietrznego. FlightGear korzysta z własnych oraz zewnętrznych projektów modeli dynamiki lotu. Każdy statek powietrzny musi być tak zaprogramowany, aby korzystał z jednego z dostępnych modeli dynamiki lotu. Obecnie FlightGear jest jedynym, graficznym symulatorem lotu korzystającym ze wszystkich wspomnianych modeli dynamiki lotu, a UIUC i YASim zostały rozwinięte z myślą i w szczególności dla FlightGeara.

Wczesne wersje programu używały FDM, który był oparty na [[LaRCsim]] od NASA. W kolejnych wersjach został on zastąpiony przez bardziej elastyczne FDM.

* [[JSBSim]] - domyślny model dynamiki lotu od 2000 roku.
* [[YASim]] - inny FDM, używający odmiennych metod obliczeniowych. Wprowadzony od wersji 0.7.9 w 2002 roku.
* [[UIUC]] - kolejny FDM, rozwinięty przez UIUC Applied Aerodynamics Group z Uniwersytetu w Illinois na Urbana-Champaign, bazujący na LaRCsim.
* FlightGear może być tak skonfigurowany tak, aby przyjmował dane z zewnętrznych źródeł FDM takich jak [[MATLAB]].
* Inne niestandardowe FDM zostały napisane dla specyficznych typów statków powietrznych jak balony i sterowce.

=== Zależności FlightGeara ===

W przeciwieństwie do komercyjnych tytułów, głównym wynikiem pracy projektu jest wydanie zestawu kodów źródłowych. Aby użyć programu należy skompilować udostępniony kod dla docelowej platformy, na której ma pracować. Biblioteki użyte przez FlightGeara były różne w zależności od okresu. Główną biblioteką zależną jest SimGear, która jest silnikiem symulacji dla FlightGeara. [[TerraGear]] nie jest zależnością, a raczej tylko nazwą dla domyślnego silnika odpowiadającego za generowanie terenu we FlightGear. OpenAL jest używany dla obsługi dźwięku, włączając wsparcie dla SDL (od wersji 0.9.5). PLIB jest użyte do obsługi sprzętowej, także dla obsługi dźwięku przed wprowadzeniem OpenAL. [[OpenGL]] jest użyty dla swoich funkcji 3D, DirectX nie jest wspierany. Silnik graficzny [[OpenSceneGraph]] jest również zintegrowany z FlightGearem. Na koniec do kompilacji jest konieczna biblioteka Simple Direct Media Layer (SDL). Niektóre zależności mogą się różnić w zależności od tego na jaką platformę docelową jest kompilowany kod. Użytkownicy FlightGeara powinni sami kompilować kod lub jeżeli nie jest on dostępny w ramach projektu, korzystać z wersji binarnej udostępnionej przez osoby trzecie.

== Sprzęt==

Sprzęt konieczny do uruchomienia FlightGeara jest ograniczony do sprzętu, który wspiera [[OpenGL]] i akcelerację 3D, przy czym najlepiej wspierana jest NVIDIA. Wczesne wersje posiadały wsparcie dla kart 3dfx, jednak wsparcie to zostało wycofane wraz ze zwiększającymi się wymaganiami sprzętowymi.

[[File:Fgrun-page2.jpg|thumb|left|270px|[[FlightGear Launch Control|FlightGear Launcher]]]]
== Dodatki i dostosowywanie ==

Istnieją programy, które są zintegrowane z FlightGearem (zależności) lub są programami zewnętrznymi i współpracują z nim. Oprogramowanie takie może być częścią projektu FlightGear lub może być rozwijane niezależnie, ale udostępniane przez projekt FlightGear.

Ważnym dodatkowym oprogramowaniem jest interfejs graficzny, służący do uruchomienia pliku wykonywalnego FlightGeara. We wczesnych wersjach, FlightGear mógł być uruchomiony jedynie z wykorzystaniem [[Pl/Opcje wiersza poleceń|opcji wiersza poleceń]]. Jednakże, w 2003 roku od wersji 0.9.3, został dołączony ''[[FlightGear Launch Control|FGRun]]'' - program startowy z interfejsem graficznym. Obecnie tę rolę spełnia ''[[FlightGear Qt launcher|QT Launcher]]''.
Podobną funkcję spełnia ''[[KFreeFlight]]'' dla środowiska KDE. ''FGTools'' jest alternatywnym front-endem dla środowiska Windows. ''FGKicker'' jest używany dla GTK+.

Inne znaczące programy obejmują edytory i projekty związane z terenem. ''[[Atlas]]'' jest mapą dla FlightGeara; ''[[Kelpie Flight Planner]]'' to rozwijane w Javie narzędzie do planowania lotów.
''[[FlightGear Scenery Designer]]'' to edytor scenerii, pomocny przy pracy z danymi terenu. ''[[World Custom Scenery Project]]'' to projekt pomagający koordynować wspólne wysiłki na rzecz tworzenia scenerii. Na koniec edytor ''[[TaxiDraw]]'' do tworzenia nowych pasów startowych i dróg kołowania.

=== Statki Powietrzne ===
{{Main article|Table of models}}

Na początku, FlightGear dysponował tylko jednym statkiem powietrznym, był to Navion zawarty w projekcie LaRCsim od NASA, który w 2000 roku został zastąpiony przez Cessnę 172P. Rozwój UIUC i JSBSim przyniósł ze sobą kilka kolejnych samolotów, podobnie jak rozwój YASim, który od tego czasu stał się głównym FDM używanym we FlightGear. W wersji 2.12 dostępnych jest ponad 400 samolotów w ponad 900 unikalnych malowaniach, choć tylko kilka z nich wchodzi w skład pakietu podstawowego.

[[File:EHAM.jpg|thumb|270px|[[Boeing 737-300|Boeing 733]] zaparkowany w scenerii [[EHAM]] ]]

=== Sceneria ===
{{Main article|Scenery}}

Projekt [[World Scenery]] dla FlightGeara zawiera dane o wysokości i klasie terenu całego świata.
Obiekty takie jak terminale, wiatraki i mosty są zebrane w [[FlightGear Scenery Database|bazie danych scenerii]].

=== Sieć i wiele monitorów ===

Istnieje kilka możliwości, które pozwalają komunikować się jednej instancji FlightGeara z inną. Dostępny jest protokół [[Multiplayer Howto|multiplayer]], co umożliwia lot w formacji lub symulowanie kontroli ruchu lotniczego w sieci lokalnej. Protokół Multiplayer zostanie wkrótce tak rozbudowany, aby także pozwalał na pracę w internecie. Dodatkową cechą możliwości sieciowych jest opcja podglądu innych pilotów na mapach Google.

Kilka instancji FlightGeara może zostać tak zsynchronizowana, aby korzystały z wielu monitorów. Możliwe jest uzyskanie bardzo dobrej synchronizacji między monitorami jeżeli wszystkie instancje FlightGeara będą pracowały z tą samą częstotliwością wyświetlania klatek.

== Kod FlightGeara vs wersja binarna ==

W przeciwieństwie do komercyjnego oprogramowania, data wydania dotyczy wyłącznie kodu źródłowego, a nie wersji binarnej. Aby stworzyć wykonywalny program, kod źródłowy musi zostać skompilowany, co wymaga kilku bibliotek, włączając w to kilka ogólnych oraz specyficznych dla platfory. Jednak jest to zbyt trudne zadanie dla wielu zwykłych użytkowników, dlatego ochotnicy społeczności pracują, aby udostępnić wersje binarne dla poszczególnych platform i systemów operacyjnych. Dystrybucje te różnią się poziomem stabilności, wydajnością, zależnościami, a także tym, jak aktualne są one w stosunku do kodu źródłowego. Dla przykładu, niektóre ze starszych wersji binarnych będą pracować poprawnie pod Mac OS 9, ale nowsze wydania wymagają określonych wersji Mac OS X.

For example, by late 2012 the latest code release was 2.10 (pre-release) and 2.8.0 (final). Binaries are generally available for the last final code release on all major platforms. [http://www.flightgear.org/download/main-program/ Click here to proceed to the flightgear binaries download page]

Przykładowo, pod koniec 2012 roku najnowszą wersją kodu była wersja 2.10 (przedpremierowa) i 2.8.0 (finalna). Pliki binarne są ogólnie dostępne dla ostatniego finalnego wydania kodu na wszystkich głównych platformach. Przejdź do naszej oficjalnej [https://www.flightgear.org/download/ strony pobierania] aby pobrać pliki binarne FlightGeara.

Pliki binarne dla innych platform, takich jak IRIX, nie są już obsługiwane, chociaż wydania sprzed 1.0 mogą działać i można je znaleźć w [[FlightGear Git|repozytoriach kodu źródłowego git]].

== Recenzje FlightGear ==
{{Main article|FlightGear Reviews}}

== Łącza zewnętrzne ==
{{Main article|Links}}
* {{Wikipedia|FlightGear}}
* [https://www.flightgear.org Oficjalna strona]
* {{forum link|text=Forum}}
* [https://sourceforge.net/p/flightgear/codetickets/ System śledzenia błędów]
* [http://www.flightgear.org/proposal-3.0.1 Oryginalna propozycja stworzenia FlightGear]

== Źródła ==
* [http://www.flightgear.org/proposal-3.0.1 Original Flight Gear Proposal] by David L. Murr (Revision 3.0.1)
* [http://en.wikipedia.org/wiki/FlightGear Wikipedia]

[[ca:FlightGear]]
[[de:FlightGear]]
[[en:FlightGear]]
[[es:FlightGear]]
[[fr:FlightGear]]
[[it:FlightGear]]
[[nl:FlightGear]]
[[pt:FlightGear]]

Bendix/King KAP140 Autopilot

2026-04-01T16:11:06Z

PlayeRom:

The '''''Bendix/King KAP 140''''' '''Two Axis/Altitude Preselect Autopilot System''' is the [[autopilot]] of the default [[Cessna 172]], controlling the [[elevator]] and [[aileron]]s.

== Quick Guide ==
[[File:KAP140.jpg|KAP140 Two Axis with Preselect Altitude]]

Normally the autopilot boots as soon as the electrical system has power<ref>newer models simulate preflight checks, so it's not immediately available after power-on.</ref>. It is commonly wired to an electrical avionics bus and secured by a dedicated breaker; if it stays dark, check power, avionics bus switches and the breaker.

# To activate the autopilot in wings level (ROL) and vertical speed (VS) modes, press and hold the AP button for 0.25 seconds<ref>for older models, just press</ref>. The autopilot will try to keep the wings level by keeping the turn rate at zero. The autopilot will also try to maintain the vertical speed at activation. Use the UP and DN buttons to set the desired vertical speed.
# With the autopilot active you can use the HDG button to toggle between wings level (ROL) and heading select (HDG) modes. In heading select mode the autopilot will try to maintain the heading selected by the heading bug on the directional gyro.
# Use NAV button to toggle between navigation mode (NAV) and wings level (ROL) mode. NAV mode is flying to NAV1 or GPS. That is one of the Heading modes in KAP140 that direction when heading bug OBS operated. Please be careful.
# Toggle other mode and approach (APR) mode when APR button pushed and following marker beacon, VOR, GPS and [[ILS]] (localizer and glide slope) for automatic approach. This mode is recommended for instrument approach.
# The REV button enables the back course mode having the autopilot flying away from the runway. This mode is like APR mode except that the direction is away from the localizer (LOC) and that glide slope (GS) is not used.
# Use the ALT button to toggle between vertical speed (VS) and altitude hold (ALT) modes. In altitude hold mode the UP and DN buttons change the altitude by 20 feet per press.
# The ARM button enables altitude preselect by the rotary knob using procedure below, pushing it again disables altitude preselect.
## Input the current atmospheric pressure using the BARO button and rotary knob
## Check that the display is showing altitude and set your desired altitude, using the rotary knob.
## Set your desired vertical speed using UP and DN button.
## Press the ARM button that is enable ARM mode.
# The BARO button sets the atmospheric pressure. When the BARO button is pushed, enter desired atmospheric pressure using the rotary dial/knob. When pushed long, it switches the setting display to hPa (and back)<ref>only on newer simulated models</ref> (hint: you can do InHG<>hPa conversion easily with this)
# Press the AP button to deactivate the autopilot. The horizontal and vertical modes can not be activated independently.

Please read the Pilot's Guide for complete instructions on the use of the KAP140 Autopilot system.

== Limits ==
* Not certified for use below 200ft [[AGL]], below 80 or above 160 knots [[IAS]] or when alternate static port is active.
* Only activate when flaps are retracted.
* Do not override the autopilot with flight controls, instead deactivate it temporarily to make manual adjustments.
* Do not activate the autopilot near the ground (takeoff, landing) or at low speeds: it will mess up and may crash you into the ground.
* It also has no autoland capability, so it can't land you based on ILS signals.
* Don't activate it when in an unstable or mistrimmed flight attitude. Tough it will try(!) to stabilize the plane, this is unsafe.
* It will not rescue you out of a stall, so watch the airspeed regularly. If the plane slows down, the autopilot will increase pitch to maintain the VS/ALT mode ordered, putting you into a stall. Disengage the autopilot and manually stabilize your flight.
* Altitude catching only works if you are flying towards the desired setting. For example, if you are at 1500ft, entered 2000ft as target and then descend, it will not intercept but fly you into the ground. Similarly, if you enter an altitude below you and accidentally climb, you will eventually reach the planes service ceiling and stall. The "ALT ARM" mode does not mean "bring me to that altitude".
* Like with altitude interception, intercepting a VOR radial or ILS will not work, if the heading bug was not aligned or if you try to intercept from a custom angle (ie. engaging NAV mode from ROL).

== Altitude alert (beeping sound) ==
A nice feature for assisting manual flights is the altitude alert. This is the aural beeping alert when you get near the selected altitude preset:
* When getting near 1000ft of the selected altitude, it starts to beep five times and show a steady "ALERT" right below the altitude.
* When intercepting the altitude, the ALERT annunciator vanishes if you get 200ft near, and will shortly flash up when crossing the selected altitude to signal it "catched on".
* When now exceeding the +-200ft band, it will alert by flashing and beeping.

This feature just needs a calibrated baro setting and a selected altitude, thus it is also active when using the modes utilizing altitude preset described below.

== Example workflow ==
This example tries to show you how to deal with the autopilot to achieve common tasks. There are more advanced techniques to achieve with the autopilot, but they are out of scope for this quick introduction. Please refer to the 'KAP 140 Pilot's Guide' which is linked below.

For better familiarization it would be good to follow trough the following guide inside flightgear.

{{note| Be aware of procedure differences when you have an [[HSI|Horizontal Situation Indicator (HSI)]] installed in the aircraft: In this case, the KAP 140 will not have an automatic 45°-Intercept for NAV/APR/REV modes when switching from HDG-mode and you need to select the desired intercept course manually by turning the heading bug to the desired intercept course. }}

=== Before-takeoff preparations ===
* For the HDG/NAV mode it is important to calibrate the [[Avionics_and_instruments#Directional_Gyro|Directional Gyro (DG)]] to the magnetic compass (with running motor, so the DG has power): read the magnetic compass and rotate the DG so its upper bearing mark reflects that course (use the red heading bug if necessary, it makes it easier at the beginning). If your DG was not calibrated, this will not be the magnetic course and you probably will not get where you wanted to.
* For the ALT mode it is important to calibrate the barometric setting of the autopilot to the one of the altimeter: read the altimeters baro setting from the Kollsman window (the small window at the altimeter), press the "BARO" key at the autopilot and rotate the right "altitude-preselect knob" so the autopilot shows the same setting. If you miss to calibrate the baro setting, you will under-/overshoot altitude presets
* You should run through the HDG and VS modes on ground as preflight check to make sure the autopilot is operating the aileron, elevator and trim wheel
* If you intend to follow the runway heading after takeoff, now is a good time to adjust the heading bug.
* If you intend to climb to a specific altitude and let the autopilot intercept it, you should now rotate the altitude preselect knob of the autopilot to the desired altitude.

=== After Takeoff: Hold heading, continue climbing ===
It is not advised to engage the autopilot immediately for takeoff as it will mess up with lower speeds. Establish a smooth climb rate and trimmed flight first.

When you achieved a stable climb rate after takeoff, engage the autopilot by pressing "AP". It will engage in ROL/VS mode: keeps the wings level and maintain climb at the current rate. The moment you engage the autopilot it will show "ROL", "VS", and at the right side the currently set climb rate for some seconds. Always visually confirm the autopilot shows the modes you expect!

If not done yet, rotate the red heading bug at the DG to the desired heading before switching to HDG mode.

Once you press the HGT button, the autopilot will switch from ROL to the HDG mode, and the plane now follows the desired course. When you change the heading bug, the plane will bank and follow the new heading (it will do this at standard turn rate).

=== Climb to Altitude, then hold it (intercept altitude) ===
The autpilot now should be in HDG/VS mode. You should check the vertical speed the autopilot automatically set to the climb rate you had when engaging it. Using the buttons "UP" and "DN" you can adjust the vertical speed setting to the desired value.

To let the autopilot intercept the desired altitude, you need to enter it using the knob on the right side. Turn in the desired altitude.
Doing this should automatically "arm" the autopilot (it shows "ALT ARM"), telling you that it waits to reach the entered altitude. If it was not arming automatically, you can arm it by manually pressing "ARM".

The plane will now climb to the altitude you requested. When you get at 1000ft near your setting, it will beep to let you know its close. Once you reach the altitude it will reduce the climb rate to zero, leveling out at the desired altitude: this is indicated by the "ALT ARM" vanishing.
If you are not at the altitude you entered, you probably forgot to calibrate the baro setting.

=== Enroute climb / descend ===
In case you want to change the currently maintained altitude, you can do so by two means:
# ''Small adjustments'' can be made by pressing just the UP/DN buttons. Each press will adjust the set altitude for 20ft.<ref>In reality you can hold the button to trigger climb/descend at 500ft/m until you release the key. Recent KAP140 simulations implement this.</ref> Note that we are in ALT mode, so we adjust absolute altiutde with UP/DN knobs, not climb rate!
# For ''larger adjustments'' you just rotate the altitude preselect knob to the new desired altitude. The autopilot will show "ALT ARM". When you are ready to climb or descend, put the autopilot to VS mode by pressing the ALT button. Now push UP/DN buttons to climb or descend, and everything else will behave like already described above. You can adjust the desired climb rate anytime. When intercepting, the autopilot will automatically enter ALT mode again (which changes the behaviour of UP/DN buttons to absolute corrections too!).
# For other cases you can also use the manual ALT mode: Put the autopilot in VS mode by pressing "ALT", adjust the climb rate to your liking and as soon as you feel the altitude is right, you can press "ALT" again. The AP will show "ALT" immediately, indicating it is holding this altitude. If your climb rate was a little higher, you probably overshoot the desired altitude, but the autopilot will soon return to it.

Note that you can use these techniques with ROL, HDG and NAV modes.

=== VOR interception (NAV mode) ===
For longer trips it is nice to let the autopilot track a [[VOR]] radial. The difference to the HDG mode is that the plane will compensate for wind drift as it seeks to keep the [https://en.wikipedia.org/wiki/Course_deviation_indicator CDI]-needle centered.

To use the NAV mode you have to tune NAV1 to the VORs frequency and select the desired radial with the OBS knob of your [https://en.wikipedia.org/wiki/Course_deviation_indicator CDI1] (which links to NAV1).
Now you can intercept the radial, and you have two options to do that:
# ''From HDG mode'': select the radial also on your DG heading bug (the plane will try to follow that now). Then engage by pressing "NAV". The autopilot will show "NAV ARM" and turn the plane to an 45° interception angle, but it will remain in HDG mode. Once you are close enough, the NAV-mode will kick in ("NAV ARM" vanishes and NAV shows) - the plane now follows the radial.
# ''From ROL mode'' (all angle intercept): It works like HDG mode, but once you push the NAV knob, the plane will intercept the radial at the angle you are currently flying. To initially bring the plane to the desired angle, use either HDG-mode with the heading bug, or fly manually, then engage ROL mode by pressing HDG.
Both modes will show a flashing "HDG" annunciator to remind you that you have to set the DG heading bug to the radial in both cases (the autopilot computes the needed course from that)!

=== ILS assisted approach (APR mode) ===
The NAV and APR modes are really similar, but the APR mode does additionally follow also the glideslope signal from an [https://en.wikipedia.org/wiki/Instrument_landing_system ILS], and the ILS has a fixed radial (so it ignores the OBS knob setting of the CDI!).

The interception works exactly as in the NAV mode described above. If you engage the APR mode knob the plane will start to intercept the signal, showing "APR ARM" and continue with the currently selected lateral mode (ROL or HDG with 45° intercept angle). Remember to set the DG heading bug to the desired approach course ("HDG" will flash to remember you of that).

As soon as the plane intercepts the localizer (that drives the CDI needle left/right), it will behave like in NAV mode. "APR ARM" will vanish and switch to "APR", showing you are in approach mode now.

When the APR mode engages, the GS mode will try to intercept the vertical glideslope beam. As long as you stay below the beam, it will show "GS ARM". When the vertical glideslope is intercepted, the plane will start to follow it downwards.

'''Attention! This mode is dangerous''', because it will drive you into the ground if you don't disengage the autopilot. It is not meant to land you automatically, just to guide you close to the runway. As soon as you are near the runway you should disengage and land manually.

=== Flying opposite direction of VOR or ILS (REV mode) ===
Using the REV mode allows you to fly away from an VOR or ILS localizer signal (note that glideslope is ignored).
It works the same as NAV or APR, just in the opposite compass direction. This is helpful if you want to fly straight away from the runway at start or to fly away from a VOR that you tuned the inbound course into the OBS.

As APR and NAV, you can intercept the radial or localizer either from ROL or HDG mode.
In either case, dial in the Front Inbound course into the OBS and the DG heading bug, and not the direction you want to fly.
Course reversal is done from the autopilot automatically.

== Related content ==
* [[Joystick Autopilot Bindings]] Snippets for joystick.xml file that allow control of most of the autopilot functions using the joystick.
: {{icaution|These joystick bindings only work with the older KAP versions, not the new one with the preflight check simulated!}}

== External links ==
*[https://bkx.bendixking.com/downloads/006-18034-0000_3.pdf Bendix/King KAP 140 Pilot's Guide download link] (PDF, 6.8 MB), Honywell, rev. 3, Nov 2005.
*[https://www.bendixking.com/content/dam/bendixking/en/documents/document-lists/downloads-and-manuals/006-18034-0000-KAP-140-Pilots-Guide.pdf Bendix/King KAP 140 Pilot's Guide], Honeywell, rev. 3, Nov 2005.

==References==

[[Category:Aircraft instruments]]

[[de:Autopilot Bendix/King KAP140]]
[[es:Piloto automático Bendix/King KAP140]]

<references />

Nasal Browser

2026-03-30T10:01:05Z

PlayeRom:

[[File:Nasal Namespace Browser Prototype.png|thumb|Screen shot showing the new [[Nasal Browser|Nasal Namespace Browser]] that is currently being worked on by Philosopher.]]

{{Nasal Navigation}}

The '''Nasal '''('''Namespace''')''' Browser''' is a dialog created by user Philosopher that allows the user to peek at the internal state of Nasal (starting from the global namespace). It displays an alphabetical list of keys mapped to values using the [[Canvas]] framework. Hashes and vectors are shown as their size and can be entered into via clicking on them; scalars' complete values are shown while ghosts and other types and represented in brackets.

The source code can be viewed [{{gitorious url
| proj = fg
| repo = canvas-hackers-fgdata
| path = Nasal/nasal_browser.nas
| branch = topics/nasal-browser-rebased
| view = raw
}} here]

{{Note|Per-update performance of the dialog (i.e. how fast it runs) is determined by how big the namespace is. On the developer's computer, it takes about 20-30 ms to update the global namespace, much less for much smaller namespaces. The dialog is automatically updated about every 0.6 seconds.|width=70%}}

== Features ==
Each entry is color-coded by type and scrollable via the Canvas scroll widget, sorted either by name or type and name. In a hash, each key is shown as either a string, a number, or a symbol, depending on what it really is (i.e. a scalar may be numeric but still a string; also, interned symbols are special cases of strings). Strings are shown in single quotes, symbols and numbers are shown without quotes. For strings, the brightness of the color is optionally reduced.

If the binary includes the <code>debug.decompile()</code> extension function (i.e. is part of [[User:Philosopher/Nasal introspection|extended-nasal]]) then functions can optionally be shown with their arguments, e.g. <code>isa = <func(obj,class)></code> and <code>_setlistener = <internal func></code> (in the sense of a function implemented in C/C++).

Values can be edited when they are clicked on; the edit bar then becomes activated and will capture key presses. A valid Nasal expression should be entered, which will be executed on {{key press|Enter}}.

== 2025 Revival ==

Since 2025, the Nasal Browser project has been revived and is now maintained as a standalone addon. As the original source code repository is no longer available, this version serves as its direct successor, updated for compatibility with modern FlightGear versions.

The new version is hosted on GitHub: {{github source|user=PlayeRom|repo=flightgear-addon-nasal-namespace-browser|text=playerom/flightgear-addon-nasal-namespace-browser}}. It is fully integrated with the FlightGear addon system, providing a modernized interface for browsing the Nasal namespace while preserving historical functionality.

Notably, the addon '''includes the original source code''', which can be optionally enabled for those who prefer the classic experience or wish to compare implementations.

* '''Modernized UI:''' Improved compatibility with recent FlightGear releases.
* '''Easy Installation:''' Fully compatible with the FlightGear Addon system.
* '''Project Homepage & Source:''' {{github source|user=PlayeRom|repo=flightgear-addon-nasal-namespace-browser|text=playerom/flightgear-addon-nasal-namespace-browser}}
* '''Compatibility:''' FlightGear 2024.1+

FlightGear Newsletter

2026-03-30T09:02:55Z

PlayeRom: /* Archive */

[[File:magagazine.png|right]]

The '''FlightGear Newsletter''' is intended to provide a collection of the latest developments from the worldwide [[FlightGear]] community. With so much development ongoing, it's almost impossible for anyone to keep up. The newsletter was started in July 2009, and is presented on a monthly basis. It is a collaborative effort that is created, edited and distributed via the [[FlightGear Wiki]], and all FlightGear users, contributors and developers are invited to contribute.

=== Archive ===
<div class="noresize">
{| class="prettytable"
! align="left" | 2026
! align="left" | 2025
! align="left" | 2024
! align="left" | 2023
! align="left" | 2022
! align="left" | 2021
! align="left" | 2020
! align="left" | 2019
! align="left" | 2018
! align="left" | 2017
! align="left" | 2016
! align="left" | 2015
! align="left" | 2014
! align="left" | 2013
! align="left" | 2012
! align="left" | 2011
! align="left" | 2010
! align="left" | 2009
|-
| valign="top" |
* [[FlightGear Newsletter January 2026|January]]
* [[FlightGear Newsletter February 2026|February]]
* [[FlightGear Newsletter March 2026|March]]
| valign="top" |
* [[FlightGear Newsletter January 2025|January]]
* [[FlightGear Newsletter February 2025|February]]
* [[FlightGear Newsletter March 2025|March]]
* [[FlightGear Newsletter April 2025|April]]
* [[FlightGear Newsletter May 2025|May]]
* [[FlightGear Newsletter June 2025|June]]
* [[FlightGear Newsletter July 2025|July]]
* [[FlightGear Newsletter August 2025|August]]
* [[FlightGear Newsletter September 2025|September]]
* [[FlightGear Newsletter October 2025|October]]
* [[FlightGear Newsletter November 2025|November]]
* [[FlightGear Newsletter December 2025|December]]
| valign="top" |
* [[FlightGear Newsletter January 2024|January]]
* [[FlightGear Newsletter February 2024|February]]
* [[FlightGear Newsletter March 2024|March]]
* [[FlightGear Newsletter April 2024|April]]
* [[FlightGear Newsletter May 2024|May]]
* [[FlightGear Newsletter June 2024|June]]
* [[FlightGear Newsletter July 2024|July]]
* [[FlightGear Newsletter August 2024|August]]
* [[FlightGear Newsletter September 2024|September]]
* [[FlightGear Newsletter October 2024|October]]
* [[FlightGear Newsletter November 2024|November]]
* [[FlightGear Newsletter December 2024|December]]
| valign="top" |
* [[FlightGear Newsletter January 2023|January]]
* [[FlightGear Newsletter February 2023|February]]
* [[FlightGear Newsletter March 2023|March]]
* [[FlightGear Newsletter April 2023|April]]
* [[FlightGear Newsletter May 2023|May]]
* [[FlightGear Newsletter June 2023|June]]
* [[FlightGear Newsletter July 2023|July]]
* [[FlightGear Newsletter August 2023|August]]
* [[FlightGear Newsletter September 2023|September]]
* [[FlightGear Newsletter October 2023|October]]
* [[FlightGear Newsletter November 2023|November]]
* [[FlightGear Newsletter December 2023|December]]
| valign="top" |
* [[FlightGear Newsletter January 2022|January]]
* [[FlightGear Newsletter February 2022|February]]
* [[FlightGear Newsletter March 2022|March]]
* [[FlightGear Newsletter April 2022|April]]
* [[FlightGear Newsletter May 2022|May]]
* June
* [[FlightGear Newsletter July 2022|July]]
* [[FlightGear Newsletter August 2022|August]]
* [[FlightGear Newsletter September 2022|September]]
* [[FlightGear Newsletter November 2022|November]]
* [[FlightGear Newsletter December 2022|December]]
| valign="top" |
* [[FlightGear Newsletter January 2021|January]]
* [[FlightGear Newsletter February 2021|February]]
* [[FlightGear Newsletter March 2021|March]]
* [[FlightGear Newsletter April 2021|April]]
* [[FlightGear Newsletter May 2021|May]]
* [[FlightGear Newsletter June 2021|June]]
* [[FlightGear Newsletter July 2021|July]]
* [[FlightGear Newsletter August 2021|August]]
* [[FlightGear Newsletter September 2021|September]]
* [[FlightGear Newsletter October 2021|October]]
* [[FlightGear Newsletter November 2021|November]]
* [[FlightGear Newsletter December 2021|December]]
| valign="top" |
* [[FlightGear Newsletter January 2020|January]]
* [[FlightGear Newsletter February 2020|February]]
* [[FlightGear Newsletter March 2020|March]]
* [[FlightGear Newsletter April 2020|April]]
* [[FlightGear Newsletter May 2020|May]]
* [[FlightGear Newsletter June 2020|June]]
* [[FlightGear Newsletter July 2020|July]]
* [[FlightGear Newsletter August 2020|August]]
* [[FlightGear Newsletter September 2020|September]]
* [[FlightGear Newsletter October 2020|October]]
* [[FlightGear Newsletter November 2020|November]]
* [[FlightGear Newsletter December 2020|December]]
| valign="top" |
* [[FlightGear Newsletter January 2019|January]]
* [[FlightGear Newsletter February 2019|February]]
* [[FlightGear Newsletter March 2019|March]]
* [[FlightGear Newsletter April 2019|April]]
* [[FlightGear Newsletter May 2019|May]]
* [[FlightGear Newsletter June 2019|June]]
* [[FlightGear Newsletter July 2019|July]]
* [[FlightGear Newsletter August 2019|August]]
* [[FlightGear Newsletter September 2019|September]]
* [[FlightGear Newsletter October 2019|October]]
* [[FlightGear Newsletter November 2019|November]]
| valign="top" |
* [[FlightGear Newsletter January 2018|January]]
* [[FlightGear Newsletter February 2018|February]]
* [[FlightGear Newsletter March 2018|March]]
* [[FlightGear Newsletter April 2018|April]]
* [[FlightGear Newsletter May 2018|May]]
* [[FlightGear Newsletter June 2018|June]]
* [[FlightGear Newsletter July 2018|July]]
* [[FlightGear Newsletter August 2018|August]]
* [[FlightGear Newsletter September 2018|September]]
* [[FlightGear Newsletter October 2018|October]]
* [[FlightGear Newsletter November 2018|November]]
* [[FlightGear Newsletter December 2018|December]]
| valign="top" |
* [[FlightGear Newsletter January 2017|January]]
* [[FlightGear Newsletter February 2017|February]]
* [[FlightGear Newsletter March 2017|March]]
* [[FlightGear Newsletter April 2017|April]]
* [[FlightGear Newsletter May 2017|May]]
* [[FlightGear Newsletter June 2017|June]]
* [[FlightGear Newsletter July 2017|July]]
* [[FlightGear Newsletter August 2017|August]]
* [[FlightGear Newsletter September 2017|September]]
* [[FlightGear Newsletter October 2017|October]]
* [[FlightGear Newsletter November 2017|November]]
* [[FlightGear Newsletter December 2017|December]]
| valign="top" |
* [[FlightGear Newsletter January 2016|January]]
* [[FlightGear Newsletter February 2016|February]]
* [[FlightGear Newsletter March 2016|March]]
* [[FlightGear Newsletter April 2016|April]]
* [[FlightGear Newsletter May 2016|May]]
* [[FlightGear Newsletter June 2016|June]]
* [[FlightGear Newsletter July 2016|July]]
* [[FlightGear Newsletter August 2016|August]]
* [[FlightGear Newsletter September 2016|September]]
* [[FlightGear Newsletter October 2016|October]]
* [[FlightGear Newsletter November 2016|November]]
* [[FlightGear Newsletter December 2016|December]]
| valign="top" |
* [[FlightGear Newsletter January 2015|January]]
* [[FlightGear Newsletter February 2015|February]]
* [[FlightGear Newsletter March 2015|March]]
* [[FlightGear Newsletter April 2015|April]]
* [[FlightGear Newsletter May 2015|May]]
* [[FlightGear Newsletter June 2015|June]]
* [[FlightGear Newsletter July 2015|July]]
* [[FlightGear Newsletter August 2015|August]]
* [[FlightGear Newsletter September 2015|September]]
* [[FlightGear Newsletter October 2015|October]]
* [[FlightGear Newsletter November 2015|November]]
* [[FlightGear Newsletter December 2015|December]]
| valign="top" |
* [[FlightGear Newsletter January 2014|January]]
* [[FlightGear Newsletter February 2014|February]]
* [[FlightGear Newsletter March 2014|March]]
* [[FlightGear Newsletter April 2014|April]]
* [[FlightGear Newsletter May 2014|May]]
* [[FlightGear Newsletter June 2014|June]]
* [[FlightGear Newsletter July 2014|July]]
* [[FlightGear Newsletter August 2014|August]]
* [[FlightGear Newsletter September 2014|September]]
* [[FlightGear Newsletter October 2014|October]]
* [[FlightGear Newsletter November 2014|November]]
* [[FlightGear Newsletter December 2014|December]]
| valign="top" |
* [[FlightGear Newsletter January 2013|January]]
* [[FlightGear Newsletter February 2013|February]]
* [[FlightGear Newsletter March 2013|March]]
* [[FlightGear Newsletter April 2013|April]]
* [[FlightGear Newsletter May 2013|May]]
* [[FlightGear Newsletter June 2013|June]]
* [[FlightGear Newsletter July 2013|July]]
* [[FlightGear Newsletter August 2013|August]]
* [[FlightGear Newsletter September 2013|September]]
* [[FlightGear Newsletter October 2013|October]]
* [[FlightGear Newsletter November 2013|November]]
* [[FlightGear Newsletter December 2013|December]]
| valign="top" |
* [[FlightGear Newsletter January 2012|January]]
* [[FlightGear Newsletter February 2012|February]]
* [[FlightGear Newsletter March 2012|March]]
* [[FlightGear Newsletter April 2012|April]]
* [[FlightGear Newsletter May 2012|May]]
* [[FlightGear Newsletter June 2012|June]]
* [[FlightGear Newsletter July 2012|July]]
* [[FlightGear Newsletter August 2012|August]]
* [[FlightGear Newsletter September 2012|September]]
* [[FlightGear Newsletter October 2012|October]]
* [[FlightGear Newsletter November 2012|November]]
* [[FlightGear Newsletter December 2012|December]]
| valign="top" |
* [[FlightGear Newsletter January 2011|January]]
* [[FlightGear Newsletter February 2011|February]]
* [[FlightGear Newsletter March 2011|March]]
* [[FlightGear Newsletter April 2011|April]]
* [[FlightGear Newsletter May 2011|May]]
* [[FlightGear Newsletter June 2011|June]]
* [[FlightGear Newsletter July 2011|July]]
* [[FlightGear Newsletter August 2011|August]]
* [[FlightGear Newsletter September 2011|September]]
* [[FlightGear Newsletter October 2011|October]]
* [[FlightGear Newsletter November 2011|November]]
* [[FlightGear Newsletter December 2011|December]]
| valign="top" |
* [[FlightGear Newsletter January 2010|January]]
* [[FlightGear Newsletter February 2010|February]]
* [[FlightGear Newsletter March 2010|March]]
* [[FlightGear Newsletter April 2010|April]]
* [[FlightGear Newsletter May 2010|May]]
* [[FlightGear Newsletter June 2010|June]]
* [[FlightGear Newsletter July 2010|July]]
* [[FlightGear Newsletter August 2010|August]]
* [[FlightGear Newsletter September 2010|September]]
* [[FlightGear Newsletter October 2010|October]]
* [[FlightGear Newsletter November 2010|November]]
* [[FlightGear Newsletter December 2010|December]]
| valign="top" |
* [[FlightGear Newsletter July 2009|July]]
* [[FlightGear Newsletter August 2009|August]]
* [[FlightGear Newsletter September 2009|September]]
* [[FlightGear Newsletter October 2009|October]]
* [[FlightGear Newsletter November 2009|November]]
* [[FlightGear Newsletter December 2009|December]]
|}
</div>

Some newsletter editions have been translated in other languages:
* [[File:De.gif|16px|link=:De:FlightGear Newsletter]] [[:De:FlightGear Newsletter|Deutsch]]
* [[File:Es.gif|16px|link=:Es:FlightGear Newsletter]] [[:Es:FlightGear Newsletter|Español]]
* [[File:Fr.gif|16px|link=:Fr:FlightGear Newsletter]] [[:Fr:FlightGear Newsletter|Français]]

=== You are invited to contribute! ===
We would like to emphasize that the monthly newsletter can not live without the contributions of FlightGear users and developers. The FlightGear Newsletter is a community-driven newsletter, which means that it is created and edited by people like ''you''. You don't need to be a long-time FlightGear user (or even a developer) to contribute to the newsletter.

In fact, helping write the monthly FlightGear newsletter is an excellent way for getting started contributing to the FlightGear community very quickly and very easily.

Even if you don't have to add anything yourself, just reviewing and improving additions by others is also highly appreciated, as are efforts to help translate newsletters or add screen shots (e.g. taken from the forum or mailing lists) to the newsletter. Screen shots can be uploaded at [[Special:Upload]].

Everyone with a wiki account (free to [[Special:UserLogin|register]]) can edit the newsletter and every contribution is welcome. So if you know about any FlightGear related projects such as for example updated scenery or aircraft, please do feel invited to add such news to the newsletter.

A simple template providing a basic structure for each upcoming newsletter can be taken from [[Talk:Next newsletter]]. This template can be copied/pasted into each new newsletter to help users getting started providing contents.

The draft for the upcoming newsletter can always be found at [[Next newsletter]].

If English is not your native language, please don't be concerned about contributing to the newsletter, you can always easily ask fellow FlightGear users to review or proof-read your changes. Also, one of the easiest ways to get started is simply copying/pasting text from forum or mailing list discussions, such as announcements (e.g., new aircraft, new scenery, etc.).

Another neat option to get started is adding links to FlightGear-related YouTube videos. For this, we have a dedicated section in each newsletter: "[[FlightGear Newsletter {{#time: F Y | last month }}#FlightGear on YouTube|FlightGear on YouTube]]."

If you want to embed a video, please see {{mediawiki|Extension:EmbedVideo#Usage}}

If you are looking for other ways to get involved, please see [[Volunteer]].

[[Category:FlightGear Newsletter| ]]
[[Category:Community|Newsletter]]
[[Category:Lists|Newsletter]]

[[de:FlightGear Newsletter]]
[[es:FlightGear Newsletter]]
[[fr:FlightGear Newsletter]]

Nasal FAQ

2026-03-26T13:29:51Z

PlayeRom: /* How to play sounds using Nasal script? */

{{Template:Nasal Navigation}}

This is meant to provide a place for '''frequently asked questions related to [[Nasal]]''' and related to using Nasal in [[FlightGear]], it's largely inspired by several related discussions on both, the FlightGear forums as well as the [[Mailing list|FlightGear mailing lists]].

== What are the major features of Nasal? ==
(Based on [http://www.mail-archive.com/flightgear-devel@lists.sourceforge.net/msg21428.html] and [http://plausible.org/nasal/])

=== Design ===
* Designed as an extension language, well suited for embedded applications
* Nasal can be instructed to run for only a certain number of "cycles" before returning. Later calls will automatically pick up the interpreter state where it left off.
* Small Interpreter, written in ANSI C, even smaller than lua
* Nasal's VM uses internally a stack machine model
* Nasal does not depend on any third party libraries other than the standard C library.
* Nasal provides optional bindings for libraries such as for example gtk, cairo, regex, readline, sqlite or unix
* Nasal does not depend on third party tools like (f)lex and yacc/bison.
* Nasal builds simply and easily, supports a reasonably simple extension API and cohabitates well with other code
* Nasal is threadsafe
* Nasal does not use a global interpreter lock (i.e. GIL in Python or Lua)
* Nasal is stackless for interpreted code
* Nasal has complete programmatic control over the runtime namespace for any piece of code, making "modules" a question of script coding and allowing a bunch of neat metaprogramming tricks
* Unicode Support
* Support for multiple execution contexts and subcontexts

=== Language ===
* Supported Types: Vectors, Hashes and Scalars
* Literal numbers can be decimal, exponential, or hex constants. All numbers are stored internally as IEEE double-precision values.
* Nasal supports exception handling as a first-class language feature, with built-in runtime-inspectable stack trace
* Standard OOP syntax (obj.field) using Hashes
* Nasal is a true functional language with recursion, lexical scoping, runtime binding, anonymous lambda expressions and true closures.
* Nasal has a true garbage collector.
* Nasal's data model matches what you are used to from perl, python and javascript.
* Nasal has syntax (e.g. based on concepts borrowed from ECMAScript/JavaScript) that makes sense in the modern world and to programmers exposed to other languages like Javascript.

== How to play sounds using Nasal script? ==
This works via property-fgcommands as per $FG_ROOT/Docs/README.commands:
<syntaxhighlight lang="nasal">
var sound = {
path : DIRECTORYPATH,
file : FILENAME,
volume: VOLUME,
queue : "instant", # Other optional choices, do not include queue for default, or user defined queue name
};

fgcommand("play-audio-sample", props.Node.new(sound));
</syntaxhighlight>

You'll want to adjust the capital variables with your own path/file name and volume, e.g. using a helper class :
<syntaxhighlight lang="nasal">
var Sound = {
# static
default_path: getprop("/sim/fg-root") ~ '/Sounds',

# constructor
new: func(filename, volume = 0.5, path = nil) {
var m = Props.Node.new({
path : path or default_path,
file : filename,
volume: volume,
});

return m;
},
};

fgcommand("play-audio-sample", Sound.new(filename: 'blade_vortex.wav', volume: 0.8));

# You could put your sound file in the same folder and load it from there,
# if you aren't using an existing sound:

var node = Sound.new(
filename: 'mySoundFile.wav',
volume: 0.8,
path: getprop("/sim/fg-root") ~ '/Aircraft/Foo/Sounds',
);

fgcommand("play-audio-sample", node);
</syntaxhighlight>

The same way one would do animations using Nasal:The current sound model is property-driven. You can create a new sound event (see the *-sound.xml files under Aircraft for examples) and drive it from a given set of properties. You can then set those properties from Nasal.

Adjust properties in Nasal (they may be "private" properties in your own subtree of the property list, say /tmp/<aircraft>) and let the sound configuration file act on those properties.
(from flightgear-devel).

If your sounds are aircraft-specific, then the mechanism of putting it into the -sound.xml file is probably exactly what you want.
Things like playing sounds from the UI are more problematic from the current interface.

Start with a single beep.wav with an XML definition like:

<sim>
...
<fx>
...
<beep>
<name>engstart</name>
<path>Sounds/beep.wav</path>
<property>/tmp/somewhere/beep</property>
</beep>

Now you can trigger the beep by toggling the property from false to true. With a little work with settimer(), you can get it to beep with different patterns and frequencies, etc...

For additional information, you'll want to check out [[$FG_ROOT]]/Docs/README.xmlsound

=== Using cmdarg() ===
cmdarg() returns the listened-to property as props.Node object, so you can use it with all its methods (see [[$FG_ROOT]]/Nasal/props.nas),
for example:

print(cmdarg().getPath(), " has been changed to ", cmdarg().getValue())

[[Category:Nasal]]

Nasal FAQ

2026-03-26T13:29:17Z

PlayeRom: /* How to play sounds using Nasal script? */

Nasal library

2026-01-16T21:10:17Z

PlayeRom: /* has_member() */

{{Nasal Navigation|nocat=1}}
This page documents the global '''library functions and variables''' of FlightGear's built-in scripting language, [[Nasal]]. This includes ''[[#Core library functions|core library functions]]'', which were included in Nasal before its integration into FlightGear, the ''[[#Extension functions|extension functions]]'', which have been subsequently added, and are specifically designed for FlightGear, and the ''[[#variables|global variables]]'', which are conversion variables, added with extension functions, for converting between units. The relevant folders in [[Git]] are:
* {{flightgear file|src/Scripting}}
* {{simgear file|simgear/nasal}}

All these functions and variables are in the global namespace, that is, they are directly accessible (e.g., one can call <syntaxhighlight lang="nasal" inline>magvar()</syntaxhighlight> instead of <syntaxhighlight lang="nasal" inline>namespace.magvar()</syntaxhighlight>). However, if a namespace must be used, <code>globals</code> is the correct namespace, but using it is not recommended. For a more complete explanation, see [[Nasal Namespaces in-depth]].

{{tip|Copy & paste the examples into your [[Nasal Console]] and execute them to see what they do.|width=70%}}

== Core library functions ==
This is the list of the basic '''core library functions.''' Most of these functions were part of the original Nasal library (before its integration in to FlightGear), while some have been added or changed over time. See also:
* http://plausible.org/nasal/lib.html ([http://web.archive.org/web/20101010094553/http://plausible.org/nasal/lib.html archive])
* {{simgear file|simgear/nasal/lib.c}} ([http://sourceforge.net/p/flightgear/simgear/ci/next/log/?path=/simgear/nasal/lib.c history])

=== append() ===
{{Nasal doc
|syntax = append(vector, element[, element[, ...]]);
|source = {{simgear file|simgear/nasal/lib.c|l=45|t=Source}}
|text = This function appends, or adds, the given element(s) to the end of the vector given in the first argument. Returns the vector operated on.
|param1 = vector
|param1text = The vector to which the arguments will be appended.
|param2 = element
|param2text = An element to be added to the vector.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector
append(vector, 4); # Append the number 4 to the end of the vector
debug.dump(vector); # Print the contents of the vector
|example2 =
var vector = [1, 2, 3]; # Initialize the vector
append(vector, 4, 5, 6); # Append the numbers 4, 5, and 6 to the end of the vector
debug.dump(vector); # Print the contents of the vector
}}

=== bind() ===
{{Nasal doc
|syntax = bind(function, locals[, outer_scope]);
|source = {{simgear file|simgear/nasal/lib.c|l=638|t=Source}}
|text = This creates a new function object. A function in Nasal is three things: the actual code, a hash/namespace of local variables available to the function namespace, and the closure object of that namespace. These correspond to the three arguments respectively.
|param1 = function
|param1text = Function to evaluate.
|param2 = locals
|param2text = Hash containing values that will become the namespace (first closure) for the function.
|param3 = outer_scope
|param3text = Optional function which is bound to the next closure. This can be bound to yet another, making a linked list.
|example1 = # This is a namespace/hash with a single member, named "key," which is initialized to 12
var Namespace = {
key: 12
};

# This is different namespace/hash containing a function
# dividing a variable "key" (which is unavailable/nil in this namespace) by 2
var AnotherNamespace = {
ret: func {
key /= 2;
}
};

# To see that key is not available, try to call AnotherNamespace.ret() first
call(AnotherNamespace.ret, [], nil, nil, var errors = []);
if(size(errors)){
print("Key could not be divided/resolved!");
debug.printerror(errors);
}

# Associate the AnotherNamespace.ret() function with the first namespace
# so that "key" is now available
var function = bind(AnotherNamespace.ret, Namespace);

# Invoke the new function
function();

# Print out the value of Namespace.key
# It was changed to 12 from 6 by AnotherNamespace.ret()
print(Namespace.key);
}}

=== call() ===
{{Nasal doc
|syntax = call(func[, args[, me[, locals[, error]]]);
|source = {{simgear file|simgear/nasal/lib.c|l=376|t=Source}}
|text = Calls the given function with the given arguments and returns the result. This function is very useful as it allows much more control over function calls and catches any errors or {{func link|die()}} calls that would normally trigger run-time errors cancelling execution of the script otherwise.
|param1 = func
|param1text = Function to execute.
|param2 = args
|param2text = Vector containing arguments to give to the called function.
|param3 = me
|param3text = <code>'''me'''</code> reference for the function call (i.e., for method calls). If given, this will override any <code>'''me'''</code> value existing in the namespace (locals argument).
|param4 = locals
|param4text = A hash with key/value pairs that will be available to the called function, typically used as the namespace for the function to be called.
|param5 = error
|param5text = A vector to append errors to. If the called function generates an error, the error, place, and line will be written to this. These errors can be printed using {{func link|printerror()|debug}}.
|example1 =
# prints "Called from call()"
call(func {
print("Called from call()");
});
|example2 =
# prints "a = 1 : b = 2
call(func(a, b){
print("a = ", a, " : b = ", b);
},
[1, 2]
);
|example3 =
var Hash = {
new: func {
var m = { parents: [Hash] };

m.el1 = "string1";
m.el2 = "string2";

return m;
}
};

# prints "me.el1 = string1", then "me.el2 = string2" on the next line
call(func(a, b){
print("me.el", a, " = ", me["el" ~ a]);
print("me.el", b, " = ", me["el" ~ b]);
},
[1, 2],
Hash.new()
);
|example4 =
# prints the value of math.pi
call(func {
print(pi);
}, nil, nil,
math
);
|example5 =
call(func {
print(math.ip); # math.ip doesn't exist
}, nil, nil, nil,
var errs = []
);
debug.printerror(errs); # The error is caught and printed using debug.printerror()
}}

=== caller() ===
{{Nasal doc
|syntax = caller([level]);
|source = {{simgear file|simgear/nasal/lib.c|l=540|t=Source}}
|text = Returns a vector containing a record from the current call stack. The level numbering starts from the currently executing function (level 0). Level 1 (the default) is the caller of the current function, and so on.

The result is a four-element vector containing '''[0]''' a hash of local variables, '''[1]''' the function object, '''[2]''' the full source file name (incl. path) and '''[3]''' the line number.
|param1 = level
|param1text = Optional integer specifying the stack level to return a result from. Defaults to 1 (i.e. the caller of the currently executing function).
|example1 =
var myFunction = func(a, b) {
debug.dump(caller(0)[0]); # prints a hash of local variables, including arguments a and b
return 2 * 2;
};

print("2 x 2 = ", myFunction(2, 2));
|example2 =
var get_arg_value = func() {
print("Argument to myFunc = ", caller(1)[0]['a']); # print the value of myFunc's single argument, using caller()
};

var myFunc = func(a) {
get_arg_value();
};

myFunc(3);
|example3text = This is a real example taken from {{fgdata file|Nasal/canvas/MapStructure.nas}}. Function <code>r()</code> (above the TODOs) returns a hash with the key/value pairs as per its arguments. For example, something like this is returned: <code>{ name: "<name>", vis: true, zindex: nil }</code>.
|example3 =
var MapStructure_selfTest = func() {
var temp = {};
temp.dlg = canvas.Window.new([600, 400], "dialog");
temp.canvas = temp.dlg.createCanvas().setColorBackground(1, 1, 1, 0.5);
temp.root = temp.canvas.createGroup();

var testMap = temp.root.createChild("map");
testMap.setController("Aircraft position");
testMap.setRange(25); # TODO: implement zooming/panning via mouse/wheel here, for lack of buttons :-/
testMap.setTranslation(
temp.canvas.get("view[0]") / 2,
temp.canvas.get("view[1]") / 2,
);

var r = func(name, vis = true, zindex = nil) {
return caller(0)[0];
}

# TODO: we'll need some z-indexing here, right now it's just random
# TODO: use foreach/keys to show all layers in this case by traversing SymbolLayer.registry directly ?
# maybe encode implicit z-indexing for each lcontroller ctor call ? - i.e. preferred above/below order ?
var types = [
r('TFC', false),
r('APT'),
r('DME'),
r('VOR'),
r('NDB'),
r('FIX', false),
r('RTE'),
r('WPT'),
r('FLT'),
r('WXR'),
r('APS'),
];

foreach (var type; types) {
testMap.addLayer(
factory: canvas.SymbolLayer,
type_arg: type.name,
visible: type.vis,
priority: type.zindex,
);
}
}; # MapStructure_selfTest
}}

=== chr() ===
{{Nasal doc
|syntax = chr(code);
|source = {{simgear file|simgear/nasal/lib.c|l=240|t=Source}}
|text = Returns a character as per the single argument. Extended ASCII is supported (see http://www.asciitable.com/ for a list of supported characters), although this may vary between different systems. For a list of the most commonly used characters, see the {{wikipedia|ASCII#ASCII printable code chart|ASCII printable code chart}} ('''Dec''' column). The following table lists supported control characters, along with their equivalent control characters in Nasal strings. {{Note|In Nasal, only strings enclosed with double-quotes (<code>"string"</code>) supports control chracters. Strings in single quotes (<code>'string'</code>) do not.}}
{{{!}} class="wikitable"
! Code !! Name !! Equivalent to
{{!-}}
{{!}} 10 {{!!}} {{Wikipedia|Newline}} {{!!}} <code>\n</code>
{{!-}}
{{!}} 9 {{!!}} {{Wikipedia|Tab key#Tab characters|Horizontal tab}} {{!!}} <code>\t</code>
{{!-}}
{{!}} 13 {{!!}} {{Wikipedia|Carriage return}} {{!!}} <code>\r</code>
{{!}}}
|param1 = code
|param1text = Integer character code for the desired glyph.
|example1 = print("Code 65 = ", chr(65)); # prints "Code 65 = A"
|example2text = This example displays all of the characters in a list, in the format <code>Code '''n''' = >'''char'''<</code>, '''n''' being the index, and '''char''' being the character.
|example2 =
for(var i = 0; i <= 255; i += 1){
print("Code ", i, " = >", chr(i), "<");
}
}}

=== closure() ===
{{Nasal doc
|syntax = closure(func[, level]);
|source = {{simgear file|simgear/nasal/lib.c|l=557|t=Source}}
|text = Returns the hash table containing the lexical namespace of the given function. The level numbering start with level 0 being the namespace of '''func'''.
|param1 = func
|param1text = Function to evaluate.
|param2 = level
|param2text = Optional integer specifying the scope level. Defaults to 0 (the namespace of '''func''').
|example1 =
var get_math_e = func {
return e; # return the value of math.e
}

var myFunction = bind(get_math_e, math); # bind get_math_e to the math namespace, so that math.e is immediately available to get_math_e
debug.dump(closure(myFunction)); # print the hash of the namespace "get_math_e"

print(myFunction());
}}

=== cmp() ===
{{Nasal doc
|syntax = cmp(a, b);
|source = {{simgear file|simgear/nasal/lib.c|l=169|t=Source}}
|text = Compares two strings, returning -1 if '''a''' is less than '''b''', 0 if they are identical and 1 if '''a''' is greater than '''b'''.
|param1 = a
|param1text = First string argument for comparison.
|param2 = b
|param2text = Second string argument for comparison.
|example1 = print(cmp("1", "two")); # prints -1
|example2 = print(cmp("string", "string")); # prints 0
|example3 = print(cmp("one", "2")); # prints 1
|example4 = print(cmp("string1", "string2")); # prints -1
}}

=== compile() ===
{{Nasal doc
|syntax = compile(code[, filename]);
|source = {{simgear file|simgear/nasal/lib.c|l=349|t=Source}}
|text = Compiles the specified code string and returns a function object bound to the current lexical context. If there is an error, the function dies, with the argument to {{func link|die()}} being '''filename'''.
|param1 = code
|param1text = String containing Nasal code to be compiled.
|param2 = filename
|param2text = Optional string used for error messages/logging. Defaults to <code><compile></code>
|example1 =
var myCode = 'print("hello");';
var helloFunc = compile(myCode, "myCode");
helloFunc();
|example2text = <code>compile</code> is very convenient to support Nasal loaded from other files. For instance, [[PropertyList XML files]] (such as GUI dialogs) may contain embedded Nasal sections that need to be parsed, processed and compiled. For an example of how to do this, save the below XML code as <tt>''[[$FG_ROOT]]/gui/dialogs/test.xml''</tt>.
<syntaxhighlight lang="xml">
<?xml version="1.0"?>

<PropertyList>

<nasal><![CDATA[
print("You have FlightGear v", getprop("/sim/version/flightgear"));
]]></nasal>

</PropertyList>
</syntaxhighlight>
Now, start FlightGear and execute this code in the [[Nasal Console]].
|example2 =
# Build the path
var FGRoot = getprop("/sim/fg-root");
var filename = "/gui/dialogs/test.xml";
var path = FGRoot ~ filename;

var blob = io.read_properties(path);
var script = blob.getValues().nasal; # Get the nasal string

# Compile the script. We're passing the filename here for better runtime diagnostics
var code = call(func {
compile(script, filename);
}, nil, nil, var compilation_errors = []);

if(size(compilation_errors)){
die("Error compiling code in: " ~ filename);
}

# Invoke the compiled script, equivalent to code();
# We're using call() here to detect errors:
call(code, [], nil, nil, var runtime_errors = []);

if(size(runtime_errors)){
die("Error calling code compiled loaded from: " ~ filename);
}
|example3text = The <code>compile()</code> function also allows you to parse a JSON string into a hash. Simplest example:
|example3 =
var jsonFunc = compile('{"version":"1.2.0","author":{"name":"John"} }');
var json = jsonFunc(); # return hash
logprint(LOG_ALERT, json["version"]); # print "1.2.0"
logprint(LOG_ALERT, json["author"]["name"]); # print "John"
}}

=== contains() ===
{{Nasal doc
|syntax = contains(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=249|t=Source}}
|text = Returns 1 (True) if the hash contains the specified key, or 0 (False) if not.
|param1 = hash
|param1text = The hash to search in.
|param2 = key
|param2text = The scalar to be searched for, contained as a key in the hash.
|example1 =
# Initialize a hash
var hash = {
element: "value"
};
print(contains(hash, "element") ? "Yes" : "No"); # This will print "Yes"
print(contains(hash, "element2") ? "Yes" : "No"); # This will print "No"
}}

===contains()===
{{Requires commit|desc=Vector support|details=see {{Merge-request|project=fgdata|id=305}}|commit=ee39abbd3b70c9b6d5e3a1c4ccedddaac1a92b11|repo=Simgear}}
{{Nasal doc
|syntax = contains(vector, item);
|source = {{simgear file|simgear/nasal/lib.c|l=249|t=Source}}
|text = Returns 1 (True) if the vector contains the specified item, or 0 (False) if not.
|param1 = vector
|param1text = The vector to search in.
|param2 = item
|param2text = The object to be searched for in the vector.
|example1 =
# Initialize a vector
var vec = ["element", "foo"];
print(contains(vec, "element") ? "Yes" : "No"); # This will print "Yes"
print(contains(vec, "element2") ? "Yes" : "No"); # This will print "No"
}}

===delete() ===
{{Nasal doc
|syntax = delete(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=118|t=Source}}
|text = Deletes the key from the hash if it exists. Operationally, this is NOT identical to setting the hash value specified by the key to <code>'''nil'''</code> as the key will stay in the hash (at least for a while). This variant potentially frees storage by deleting the reference to the key and by shrinking the hash. Returns the hash that has been operated on.
|param1 = hash
|param1text = The hash from which to delete the key.
|param2 = key
|param2text = The scalar to be deleted, contained as a key in the hash.
|example1 =
# Initialize the hash
var hash = {
element1: "value1",
element2: "value2"
};
delete(hash, "element1"); # Delete element1
debug.dump(hash); # prints the hash, which is now minus element1
}}

===die()===
{{Nasal doc
|syntax = die(error);
|source = {{simgear file|simgear/nasal/lib.c|l=417|t=Source}}
|text = Terminates execution and unwinds the stack. The place and the line will be added to the '''error'''. This invokes the same internal exception handler used for internal runtime errors. Use this to signal fatal errors, or to implement exception handling. The error thrown (including internal runtime errors) can be caught with {{func link|call()}}.
|param1 = error
|param1text = String describing the error.
:{{inote|This parameter is technically optional, but it is highly recommended to use it.}}
|example1 =
print("Will print");
die("Don't go any further!");
print("Won't print"); # Will not be printed because die() stops the process
}}

=== find()===
{{Nasal doc
|syntax = find(needle, haystack);
|source = {{simgear file|simgear/nasal/lib.c|l=586|t=Source}}
|text = Finds and returns the index of the first occurrence of the string '''needle''' in the string '''haystack''', or -1 if no such occurrence was found.
|param1 = needle
|param1text = String to search for.
|param2 = haystack
|param2text = String to search in.
|example1 = print(find("c", "abcdef")); # prints 2
|example2 = print(find("x", "abcdef")); # prints -1
|example3 = print(find("cd", "abcdef")); # prints 2
}}

===ghosttype()===
{{Nasal doc
|syntax = ghosttype(ghost);
|source = {{simgear file|simgear/nasal/lib.c|l=336|t=Source}}
|text = Returns a string containing either a descriptive name of a ghost (a raw C/C++ object), or a unique id (the pointer to the C/C++ <code>naGhostType</code> instance) if no name has been set. Ghost is an acronym that stands for '''G'''arbage-collected '''H'''andle to '''O'''ut'''S'''ide '''T'''hingy.
|param1 = ghost
|param1text = Ghost to return a description for.
|example1 = print(ghosttype(airportinfo())); # prints "airport"
}}

===id()===
{{Nasal doc
|syntax = id(object);
|source = {{simgear file|simgear/nasal/lib.c|l=706|t=Source}}
|text = Returns a string containing information on the type and ID of the object provided in the single argument. The information is returned in the form of <code>'''<type>''':'''<id>'''</code>, where '''<type>''' is the type of object, and '''<id>''' is the ID.
|param1 = object
|param1text = Can be either of a string, a vector, a hash, a code, a function, or a ghost.
|example1 = print(id("A")); # prints "str:000000001624A590"
}}

===int() ===
{{Nasal doc
|syntax = int(number);
|source = {{simgear file|simgear/nasal/lib.c|l=125|t=Source}}
|text = Returns the integer part of the numeric value of the single argument, or <code>'''nil'''</code> if none exists.
|param1 = number
|param1text = Number or string with just a number in it to return an integer from.
|example1 = print(int(23)); # prints "23"
|example2 = print(int(23.123)); # prints "23"
|example3 = debug.dump(int("string")); # prints "nil"
}}

===keys()===
{{Nasal doc
|syntax = keys(hash);
|source = {{simgear file|simgear/nasal/lib.c|l=36|t=Source}}
|text = Returns a vector containing the list of keys found in the single hash argument.
|param1 = hash
|param1text = The hash to return the keys from.
|example1 =
# Initialize a hash
var hash = {
element1: "value",
element2: "value"
};
debug.dump(keys(hash)); # print the vector
}}

===left()===
{{Nasal doc
|syntax = left(string, length);
|source = {{simgear file|simgear/nasal/lib.c|l=214|t=Source}}
|version = 2.12
|commit = {{simgear commit|bd7163|t=commit}}
|text = Returns a substring of '''string''', starting from the left.
|param1 = string
|param1text = String to return part of.
|param2 = length
|param2text = Integer specifying the length of the substring to return.
|example1 = print(left("string", 2)); # prints "st"
}}

=== num()===
{{Nasal doc
|syntax = num(number);
|source = {{simgear file|simgear/nasal/lib.c|l=149|t=Source}}
|text = Returns the numerical value of the single string argument, or <code>'''nil'''</code> if none exists.
|param1 = number
|param1text = String with just a number in it to return a number from.
|example1 = print(num("23")); # prints "23"
|example2 = print(num("23.123")); # prints "23.123"
|example3 = debug.dump(num("string")); # prints "nil"
}}

===pop()===
{{Nasal doc
|syntax = pop(vector);
|source = {{simgear file|simgear/nasal/lib.c|l=85|t=Source}}
|text = Removes and returns the last element of the single vector argument, or <code>'''nil'''</code> if the vector is empty.
|param1 = vector
|param1text = Vector to remove an element from.
|example1 =
var vector = [1, 2, 3];
pop(vector);
debug.dump(vector); # prints "[1, 2]"
|example2 =
var vector = [1, 2, 3];
debug.dump(pop(vector)); # prints "3"
|example3 =
var vector = [];
debug.dump(pop(vector)); # prints "nil"
}}

=== range() ===
{{Nasal doc
|syntax = range([start, ]stop[, step]);
|source = {{simgear file|simgear/nasal/lib.c|l=756|t=Source}}
|text = Creates a vector of numbers starting from <code>start</code> (default 0) up to but not including <code>stop</code>, incremented by <code>step</code> (default 1). Note: To specify <code>step</code>, you must also provide <code>start</code>; otherwise the second argument is interpreted as <code>stop</code>.
|param1 = start
|param1text = Optional. The starting number of the sequence. Defaults to 0 if omitted. Required if you want to specify <code>step</code>.
|param2 = stop
|param2text = Required. The number at which to stop the sequence (not included).
|param3 = step
|param3text = Optional. The increment between each number in the sequence. Defaults to 1. Only valid if <code>start</code> is also specified.
|example1 =
var vec = range(5); # Creates a vector [0, 1, 2, 3, 4]
var vec = range(2, 5); # Creates a vector [2, 3, 4]
var vec = range(0, 10, 2); # Creates a vector [0, 2, 4, 6, 8]
var vec = range(0, 0); # Creates an empty vector []
var vec = range(0, 1); # Creates a vector [0]
}}

=== remove() ===
{{Nasal doc
|syntax = remove(vector, value);
|source = {{simgear file|simgear/nasal/lib.c|l=53|t=Source}}
|text = Removes all elements equal to the given value from a vector and returns the modified vector.
|param1 = vector
|param1text = The vector from which elements are to be removed.
|param2 = value
|param2text = A value to remove from the vector.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector.
remove(vector, 2); # Remove the value 2 from the vector.
debug.dump(vector); # Print the contents of the vector: "[1, 3]".
|example2 =
var vector = ["text", "text", "text"]; # Initialize the vector.
remove(vector, "text"); # Remove the value "text" from the vector.
debug.dump(vector); # Print the contents of the vector: "[]".
}}

=== removeat() ===
{{Nasal doc
|syntax = removeat(vector, index);
|source = {{simgear file|simgear/nasal/lib.c|l=72|t=Source}}
|text = Removes the element at the specified index from the vector and returns it.
|param1 = vector
|param1text = The vector from which the element will be removed.
|param2 = index
|param2text = Index of the item to be deleted.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector.
removeat(vector, 0); # Remove the index 0 from the vector.
debug.dump(vector); # Print the contents of the vector: "[2, 3]".
}}

===right()===
{{Nasal doc
|syntax = right(string, length);
|source = {{simgear file|simgear/nasal/lib.c|l=226|t=Source}}
|version = 2.12
|commit = {{simgear commit|bd7163|t=commit}}
|text = Returns a substring of '''string''', starting from the right.
|param1 = string
|param1text = String to return part of.
|param2 = length
|param2text = Integer specifying the length of the substring to return.
|example1 = print(right("string", 2)); # prints "ng"
}}

=== setsize()===
{{Nasal doc
|syntax = setsize(vector, size);
|source = {{simgear file|simgear/nasal/lib.c|l=91|t=Source}}
|text = Sets the size of a vector. The first argument specifies a vector, the second a number representing the desired size of that vector. If the vector is currently larger than the specified size, it is truncated. If it is smaller, it is padded with <code>'''nil'''</code> entries. Returns the vector operated upon.
|param1 = vector
|param1text = The vector to be operated on.
|param2 = size
|param2text = The desired size of the vector in number of entries.
|example1 =
var vector = [1, 2, 3]; # Initialize a vector
setsize(vector, 4);
debug.dump(vector); # print the vector "[1, 2, 3, nil]"
|example2 =
var vector = [1, 2, 3]; # Initialize a vector
setsize(vector, 2);
debug.dump(vector); # print the vector "[1, 2]"
}}

===size()===
{{Nasal doc
|syntax = size(object);
|source = {{simgear file|simgear/nasal/lib.c|l=26|t=Source}}
|text = Returns the size of the single argument. For strings, this is the length in bytes. For vectors, this is the number of elements. For hashes, it is the number of key/value pairs. If the argument is <code>'''nil'''</code> or a number, this error will be thrown: <code>object has no size()</code>.
|param1 = object
|param1text = Object to find the size of. Must be a string, a vector or a hash.
|example1 =
var string = "string";
print(size(string)); # prints "6"
|example2 =
var vector = [1, 2, 3];
print(size(vector)); # prints "3"
|example3 =
var hash = {
element1: "value1",
element2: "value2",
element3: "value3"
};
print(size(hash)); # prints "3"
}}

=== sort()===
{{Nasal doc
|syntax = sort(vector, function);
|source = {{simgear file|simgear/nasal/lib.c|l=678|t=Source}}
|text = Returns a vector containing the elements in the input '''vector''' sorted in according to the rule given by '''function'''. Implemented with the ANSI C {{func link|qsort()|link=http://www.cplusplus.com/reference/cstdlib/qsort/}}, <code>sort()</code> is stable. This means that if the rules in the first example are used, equal elements in the output vector will appear in the same relative order as they do in the input. It is run in a loop, so '''function''' is run several times.
|param1 = vector
|param1text = Input vector to sort.
|param2 = function
|param2text = Function according to which the elements will be sorted by. It should take two arguments and should return one of 1, 0, or -1.
{{{!}} class="wikitable"
! Return value !! Meaning
{{!-}}
{{!}} less than 0 {{!!}} first argument should go before second argument
{{!-}}
{{!}} 0 {{!!}} first argument equals second argument
{{!-}}
{{!}} greater than 0 {{!!}} first argument should go after second argument
{{!}}}

|example1text = This example sorts elements from smallest to greatest.
|example1 =
var sort_rules = func(a, b) {
if (a < b) {
return -1; # A should before b in the returned vector
} elsif (a == b) {
return 0; # A is equivalent to b
} else {
return 1; # A should after b in the returned vector
}
}
debug.dump(sort([3, 2, 5, 6, 4, 1], sort_rules)); # prints "[1, 2, 3, 4, 5, 6]"
|example2text = This example sorts elements from greatest to smallest.
|example2 =
# Outputs the elements in reverse order (greatest to smallest)
var sort_rules = func(a, b) {
if (a < b) {
return 1; # -1 in the above example
} elsif (a == b) {
return 0;
} else {
return -1; # 1 in the above example
}
}
debug.dump(sort([3, 2, 5, 6, 4, 1], sort_rules)); # prints "[6, 5, 4, 3, 2, 1]"
|example3text = This example sorts a vector of strings (runways for example) from smallest to greatest.
|example3 =
var runways = ["09R", "27R", "26L", "09L", "15"];
var rwy = sort(runways, func(a, b) cmp(a, b));
debug.dump(rwy); # prints ['09L', '09R', '15', '26L', '27R']
}}

=== split()===
{{Nasal doc
|syntax = split(delimiter, string);
|source = {{simgear file|simgear/nasal/lib.c|l=596|t=Source}}
|text = Splits the input string into a vector of substrings bounded by occurrences of the delimiter substring. See [[Nasal_library/string#string.join(sep,list)|string.join()]].
|param1 = delimiter
|param1text = String that will split the substrings in the returned vector.
|param2 = string
|param2text = String to split up.
|example1 = debug.dump(split("cd", "abcdef")); # prints "['ab', 'ef']"
|example2 = debug.dump(split(".", "3.2.0")); # prints "[3, 2, 0]"
|example3 = debug.dump(split("/", "path/to/file")); # prints "['path', 'to', 'file']"
}}

===sprintf()===
{{Nasal doc
|syntax = <nowiki>sprintf(format[, arg[, arg, [...]]]);</nowiki>
|source = {{simgear file|simgear/nasal/lib.c|l=491|t=Source}}
|text = Creates and returns a string formatted using ANSI C {{func link|vsnprintf()|link=http://en.cppreference.com/w/c/io/vfprintf}} <ref>
{{Cite web
|url = http://sourceforge.net/p/flightgear/simgear/ci/next/tree/simgear/nasal/lib.c#l308
|title = fgdata/simgear/simgear/nasal/lib.c, line 308
|accessdate = October 2015
}}
</ref>. Below is a table of supported format specifiers.
{{{!}} class="wikitable" width="75%"
{{!}}+ %[flags][width][.precision]specifier
! colspan="2" {{!}} Flags
{{!-}}
! Flag !! Output
{{!-}}
{{!}} <code>+</code> {{!!}} Forces to precede the result with a plus or minus sign ('''+''' or '''-''') even for positive numbers. By default, only negative numbers are preceded with a '''-''' sign.
{{!-}}
{{!}} ''space'' {{!!}} Prefixes non-signed numbers with a space.
{{!-}}
{{!}} <code>-</code> {{!!}} Left-align the output of this placeholder (the default is to right-align the output) when the width option is specified.
{{!-}}
{{!}} <code>0</code> {{!!}} Use 0 instead of spaces to pad a field when the width option is specified.
{{!-}}
{{!}} <code>#</code> {{!!}} Used with <code>o</code>, <code>x</code> or <code>X</code> specifiers the value is preceded with <tt>0</tt>, <tt>0x</tt> or <tt>0X</tt> respectively for values different than zero. Used with <code>e</code>, <code>E</code> and <code>f</code>, it forces the written output to contain a decimal point even if no digits would follow. By default, if no digits follow, no decimal point is written. Used with <code>g</code> or <code>G</code> the result is the same as with <code>e</code> or <code>E</code> but trailing zeros are not removed.
{{!-}}
! colspan="2" {{!}} Width
{{!-}}
{{!}} colspan="2" {{!}} Integer specifying the minimum number of characters to be returned. This includes the decimal point and decimal fraction as well as + or - signs.
{{!-}}
! colspan="2" {{!}} Precision
{{!-}}
{{!}} colspan="2" {{!}} Integer preceded by a dot specifying the number of decimal places to be written.
{{!-}}
! colspan="2" {{!}} Specifiers
{{!-}}
! Specifier !! Output
{{!-}}
{{!}} <code>d</code>, <code>i</code> {{!!}} Signed decimal number.
{{!-}}
{{!}} <code>s</code> {{!!}} A string
{{!-}}
{{!}} <code>%</code> {{!!}} Percent (%) character.
{{!-}}
{{!}} <code>c</code> {{!!}} A single character assigned to a character code, the code given in an integer argument. See http://www.asciitable.com/ for a list of supported characters and their codes.
{{!-}}
{{!}} <code>o</code> {{!!}} Unsigned integer as an octal number.
{{!-}}
{{!}} <code>u</code> {{!!}} Unsigned decimal integer.
{{!-}}
{{!}} <code>x</code>, <code>X</code> {{!!}} Unsigned integer as a hexadecimal number. If <code>x</code> is used, any letters in the number are lowercase, while <code>X</code> gives uppercase.
{{!-}}
{{!}} <code>e</code>, <code>E</code> {{!!}} Double value in scientific notation (i.e., ''[-]ddd.ddd'''e'''[+/-]ddd''), with an exponent being denoted by <tt>e</tt> or <tt>E</tt> depending on whether an upper or lowercase is used respectively.
{{!-}}
{{!}} <code>f</code> {{!!}} Floating-point number, in fixed decimal notation, by default with 6 decimal places.
{{!-}}
{{!}} <code>F</code> {{!!}} Appears to be available<ref>
{{Cite web
|url = http://sourceforge.net/p/flightgear/simgear/ci/next/tree/simgear/nasal/lib.c#l389
|title = fgdata/simgear/simgear/nasal/lib.c, line 389
|accessdate = October 2015
}}
</ref>, but doesn't work.
{{!-}}
{{!}} <code>g</code>, <code>G</code> {{!!}} Double in either normal or exponential notation, whichever is more appropriate for its magnitude. <code>g</code> uses lower-case letters, <code>G</code> uses upper-case letters. This type differs slightly from fixed-point notation in that insignificant zeroes to the right of the decimal point are not included. Also, the decimal point is not included on whole numbers.
{{!}}}

|param1 = format
|param1text = String specifying the format. Can be used with or without a format specifiers. See below for examples.
|param2 = arg
|param2text = Argument specifying a value to replace a format placeholder (such as <code>%d</code>) in the format string. Not required if there are no format specifiers.

|example1 = print(sprintf("%i", 54)); # prints "54"
|example2 = print(sprintf("Pi = %+.10f", math.pi)); # prints "Pi = +3.1415926536"
|example3 =
print(sprintf("%6d", 23)); # prints " 23"
print(sprintf("%06d", 23)); # prints "000023"
|example4 =
var FGVer = getprop("/sim/version/flightgear");
print(sprintf("You have FlightGear v%s", FGVer)); # prints "You have FlightGear v<your version>"
|example5 =
print(sprintf("Hexadecimal 100000 = %X", 100000)); # prints "Hexadecimal 100000 = 186A0"
print(sprintf("Hexadecimal 100000 = %x", 100000)); # prints "Hexadecimal 100000 = 186a0"
|example6 = print(sprintf("Code 65 is %c", 65)); # prints "Code 65 is A"
|example7 =
print(sprintf("%e", 54)); # prints "5.400000e+001"
print(sprintf("%E", 54)); # prints "5.400000E+001"
|example8 = print(sprintf("%o", 54)); # prints "66"
|example9 = print(sprintf("50%% of 100 is %i", 100 / 2)); # prints "50% of 100 is 50"
|example10 =
print(sprintf("%.2f", 1.4)); # prints "1.40"
print(sprintf("%.1f", 1.4)); # prints "1.4"
print(sprintf("% 4.1f", 1.4)); # prints " 1.4"
print(sprintf("%04.1f", 1.4)); # prints "01.4"
print(sprintf("% 6.1f", 1.4)); # prints " 1.4"
print(sprintf("%06.1f", 1.4)); # prints "0001.4"
}}

===str()===
{{Nasal doc
|syntax = str(value);
|source = {{simgear file|simgear/nasal/lib.c|l=186|t=Source}}
|text = Convert given value (scalar) to string. If <code>value</code> is a number, it will be converted to a string. If <code>value</code> is a string, the same string will be returned. If <code>value</code> is not a scalar (hash, vector, nil), <code>nil</code> will be returned.
|param1 = value
|param1text = The value to convert to string.
|example1 =
var result = str(true); # result is a string "1"
var result = str(false); # result is a string "0"
var result = str(12); # result is a string "12"
var result = str(12.5); # result is a string "12.5"
var result = str(-12.5); # result is a string "-12.5"
var result = str("12.5"); # result is a string "12.5"
var result = str([1, 2]); # result is a nil
var result = str({ x: 0 }); # result is a nil
var result = str(nil); # result is a nil
}}

===streq()===
{{Nasal doc
|syntax = streq(a, b);
|source = {{simgear file|simgear/nasal/lib.c|l=164|t=Source}}
|text = Tests the string values of the two arguments for equality. This function is needed because the <code>'''=='''</code> operator (see [[Nasal_Operators#Equality|Nasal Operators]]) tests for numeric equality first. If either or both the arguments are not strings, 0 (False) will be returned. Returns either 0 (False) or 1 (True). {{Note|This function is rarely required in typical code.}}
|param1 = a
|param1text = First argument for testing equality.
|param2 = b
|param2text = Second argument for testing equality.
|example1 = print(streq("0", "0")); # prints "1" (True)
|example2 =
print(0 == 0.0); # prints "1" (True)
print(streq("0", "0.0")); # prints "0" (False)
}}

===substr()===
{{Nasal doc
|syntax = substr(string, start [, length]);
|source = {{simgear file|simgear/nasal/lib.c|l=194|t=Source}}
|text = Similar the {{func link|subvec()}}, but operates on strings. Computes and returns a substring. The first argument specifies a string, the second is the index of the start of a substring, the optional third argument specifies a length (the default is to return the rest of the string from the start).
|param1 = string
|param1text = String to return a substring from.
|param2 = start
|param2text = Integer specifying the start of a substring. Negative values specify a position from the end of the string.
|param3 = length
|param3text = Optional argument specifying the length of the substring. Defaults to the end of the string.
|example1 = print(substr("abcde", 1, 3)); # prints "bcd"
|example2 = print(substr("abcde", 1)); # prints "bcde"
|example3 = print(substr("abcde", 2, 1)); # prints "c"
|example4 = print(substr("abcde", -2)); # prints "de"
|example5 = print(substr("abcde", -3, 2)); # prints "cd"
}}

===subvec()===
{{Nasal doc
|syntax = subvec(vector, start[, length]);
|source = {{simgear file|simgear/nasal/lib.c|l=98|t=Source}}
|text = Returns a sub-range of a vector. The first argument specifies a vector, the second a starting index, and the optional third argument indicates a length (the default is to the end of the vector).
|param1 = vector
|param1text = The vector to take the sub-vector from.
|param2 = start
|param2text = The starting point of the sub-vector within the given vector.
|param3 = length
|param3text = Optional argument specifying the length of the sub-vector, from the starting point.
'''Notes:'''
* Omitting the ''vector'' and ''start'' arguments is not an error (possibly it should be) but the return value is ''nil''.
* A negative ''start'' argument ''is'' an error. This seems wrong. Perhaps the language designer could comment.
* A value of ''start'' greater than ''size(vector)'' causes an error. A value equal to ''size(vector)'' returns an empty vector.
* If the value of ''length'' is greater than ''size(vector) - start'' then it is ignored. That is, all elements from ''start'' to the end of ''vector'' are returned. If ''length'' is zero then an empty vector is returned. A negative value of ''length'' causes an error.
|example1 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 0)); # prints "[1, 2, 3]"
|example2 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 1)); # prints "[2, 3]"
|example3 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 1, 1)); # prints "[2]"
}}

=== typeof()===
{{Nasal doc
|syntax = typeof(object);
|source = {{simgear file|simgear/nasal/lib.c|l=287|t=Source}}
|text = Returns a string indicating the whether the object is <code>'''nil'''</code>, a scalar (number or string), a vector, a hash, a function, or a ghost.
|param1 = object
|param1text = Object to return the type of.
|example1 =
var object = nil;
print(typeof(object)); # prints "nil"
|example2 =
var object = "Hello world!";
print(typeof(object)); # prints "scalar"
|example3 =
var object = math.pi;
print(typeof(object)); # prints "scalar"
|example4 =
var object = [1, 2, 3];
print(typeof(object)); # prints "vector"
|example5 =
var object = {};
print(typeof(object)); # prints "hash"
|example6 =
var object = func {};
print(typeof(object)); # prints "func"
|example7 =
var object = airportinfo();
print(typeof(object)); # prints "ghost"
}}



==Extension functions==
The '''extension functions''' are global functions that have been added to Nasal since its integration into FlightGear. Unlike the core library functions, they are generally specifically designed to interact directly with FlightGear. Extension functions come from three source files:
*{{flightgear file|src/Scripting/NasalPositioned.cxx}}
*{{flightgear file|src/Scripting/NasalSys.cxx}}
*{{fgdata file|Nasal/globals.nas}}

===abort()===
{{Nasal doc
|syntax = abort();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=565|t=Source}}
|text = This function is a wrapper for the C++ {{func link|abort()|link=http://www.cplusplus.com/reference/cstdlib/abort/}} function. It simply aborts FlightGear with an error, which varies depending on the operating system. This function should not really be used; instead, please use the "exit" [[Fgcommands|fgcommand]], which will exit FlightGear more gracefully (see example below).
|example1text = This example will immediately stop FlightGear with an error, such as "FlightGear has stopped working."
|example1 = abort();
|example2text = For exiting FlightGear in a better way, please use the following code:
|example2 = fgcommand("exit");
}}

=== abs() ===
{{Nasal doc
|syntax = abs(number);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = This simple function returns the {{wikipedia|absolute value|noicon=1}} of the provided number.
|param1 = number
|param1text = This argument is required and should be a number.
|example1 = print(abs(1)); # prints "1"
|example2 = print(abs(-1)); # prints "1"
}}

===aircraftToCart() ===
This new function in FG 2017.2.1 takes coordinates in aircraft structural coordinate system, and translate them into geocentric coordinates.
Example for (5,6,7):
<syntaxhighlight lang="nasal">
var pos = aircraftToCart({x: -5, y: 6, z: -7});
var coord = geo.Coord.new();
coord.set_xyz(pos.x, pos.y, pos.z);
</syntaxhighlight>
Notice: x and z is inverted sign on purpose.
if you want lat. lon, alt from that, just call: (degrees and meters)

<syntaxhighlight lang="nasal">
coord.lat()
coord.lon()
coord.alt()
</syntaxhighlight>

===addcommand() ===
{{Nasal doc
|syntax = addcommand(name, code);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=659|t=Source}}
|version = 2.12
|commit = {{flightgear commit|7b663c|t=commit}}
|text = {{see also|Howto:Add new fgcommands to FlightGear}}

This function enables the addition of a new custom [[fgcommands|fgcommand]] to FlightGear from within Nasal. An fgcommand created using this method can be used in exactly the same way as the built-in fgcommands. Also, an fgcommand created via this method will always return True or 1, like all other fgcommands.
|param1 = name
|param1text = This will become the name of the new fgcommand. Must be a string.
|param2 = code
|param2text = The code that will be executed when the fgcommand is run. Must be a function.
|example1text = This example adds a new fgcommand and then runs it. Although it executes a simple {{func link|print()}} statement, any valid Nasal code can be used.
|example1 = addcommand("myFGCmd", func(node) {
print("fgcommand 'myFGCmd' has been run.");
props.dump( node );
});
fgcommand("myFGCmd", props.Node.new({foo:1, bar:2}) );
|example2text = This example demonstrates how parameters are defined in a new fgcommand.
|example2 = addcommand("myFGCmd", func(node){
print(node.getNode("number").getValue()); # prints the value of "number," which is 12
});
fgcommand("myFGCmd", props.Node.new({"number": 12}));
}}

===airportinfo()===
{{Nasal doc
|syntax = airportinfo();
airportinfo(type);
airportinfo(id);
airportinfo(lat, lon[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1024|t=Source}}
|text = Function for retrieval of airport, heliport, or seaplane base information. It returns a Nasal ghost; however, its structure is like that of a Nasal hash. The following information is returned:
* '''parents''': A vector containing a hash of various functions to access information about the runway. These functions are:
** '''findBestRunwayForPos()''' return runway as ghost by given geo position, e.g. <code>var rwy = airportinfo().findBestRunwayForPos(geo.aircraft_position());</code>.
** '''runway()''' return runway as ghost by runway ID, e.g. <code>var rwy = airportinfo().runway("18R");</code>.
** '''runwaysWithoutReciprocals()''' return vector of runways as ghost.
** '''helipad()''' return helipad as ghost by helipad ID, e.g. <code>var heli = airportinfo().helipad("H19");</code>.
** '''tower()''' return hash with <code>lat</code>, <code>lon</code>, <code>elevation</code> fields.
** '''comms()''' return vector of hashes, each hash with <code>frequency</code> and <code>ident</code> fields.
** '''sids()''' return vector of strings with SID IDs.
** '''stars()''' return vector of strings with STAR IDs.
** '''getApproachList()''' return vector of string with approaches.
** '''parking()''' return vector of hashes, each hash with <code>lat</code>, <code>lon</code>, <code>elevation</code>, <code>name</code> fields.
** '''getSid()''' return SID as ghost, e.g. <code>var sid = airportinfo().getSid("SA1A");</code>.
** '''getStar()''' return STAR as ghost, e.g. <code>var star = airportinfo().getStar("KEILA1");</code>.
** '''getIAP()''' return IAP as ghost, e.g. <code>var iap = airportinfo().getIAP("ILS02");</code>.
** '''getApproach()''' return approach as ghost, e.g. <code>var approach = airportinfo().getApproach("ILS02");</code>.
** '''tostring()''' just return string "an airport ICAO".
** See also {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1902}}.
* '''lon''': Longitude of the location.
* '''lat''': Latitude of the location.
* '''has_metar''': True or false depending whether the airport has a [[METAR]] code defined for it.
* '''elevation''': Elevation of the location in metres.
* '''id''': ICAO code of the airport (or ID of the seaplane base/heliport).
* '''name''': Name of the airport/heliport/seaplane base.
* '''runways'''
** '''<runway name>'''
*** '''id''': Name of runway.
*** '''lat''': Latitude of the runway.
*** '''lon''': Longitude of the runway.
*** '''heading''': True heading of the runway.
*** '''length''': Length of the runway in metres.
*** '''width''': Width of the runway in metres.
*** '''surface''': Runway surface type.
*** '''threshold''': Length of the runway's {{wikipedia|displaced threshold}} in metres. Will return 0 if there is none.
*** '''stopway''': Length of the runway's stopway (the area before the threshold) in metres. Will return 0 if there is none.
*** '''reciprocal''': <code>runway</code> ghost of the reciprocal runway.
*** '''ils_frequency_mhz''': ILS frequency in megahertz.
*** '''ils''': <code>navaid</code> ghost of the ILS transmitter.
* '''helipads'''
** '''<helipad name>'''
*** '''id''': Name of helipad.
*** '''lat''': Latitude of the helipad.
*** '''lon''': Longitude of the helipad.
*** '''heading''': True heading of the helipad.
*** '''length''': Length of the helipad in metres.
*** '''width''': Width of the helipad in metres.
*** '''surface''': Helipad surface type.
* '''taxiways'''
** '''<taxiway name>'''
*** '''id''': Name of taxiway.
*** '''lat''': Latitude of the taxiway.
*** '''lon''': Longitude of the taxiway.
*** '''heading''': Heading of the taxiway.
*** '''length''': Length of the taxiway in metres.
*** '''width''': Width of the taxiway in metres.
*** '''surface''': Taxiway surface type.

Information is extracted in the same way as accessing members of a Nasal hash. For example:
<syntaxhighlight lang="nasal">
# prints to lengths of the runways of the nearest airport in feet and metres
var info = airportinfo();
print("-- Lengths of the runways at ", info.name, " (", info.id, ") --");
foreach(var rwy; keys(info.runways)){
print(rwy, ": ", math.round(info.runways[rwy].length * M2FT), " ft (", info.runways[rwy].length, " m)");
}
</syntaxhighlight>

Note that searches for locations that are a long way away (e.g., the nearest seaplane base to the middle of the Sahara) may cause FlightGear to pause for an amount of time.
|param1 = id
|param1text = The {{wikipedia|International Civil Aviation Organization airport code|ICAO code|noicon=1}} of an airport to retrieve information about.
|param2 = type
|param2text = When this argument is used, the function will return the closest airport of a certain type. Can be one of "heliport," "seaport," or "airport" (default).
: {{inote|Running this function without any parameters is equivalent to this:
: <syntaxhighlight lang="nasal">
airportinfo("airport");
</syntaxhighlight>
}}
|param3 = lat ''and'' lon
|param3text = When these parameters are used, the function will return information on the nearest airport, heliport or seaplane base (depending on the '''type''' parameter) to those coordinates.
|example1 = var info = airportinfo();
print("Nearest airport: ", info.name, " (", info.id, ")"); # prints the name and ICAO code of the nearest airport
|example2 = var info = airportinfo("heliport");
print("Elevation of the nearest heliport: ", math.round(info.elevation * M2FT), " ft"); # prints the elevation and name of the nearest heliport
|example3 = var info = airportinfo("KSQL");
print("-- Runways of ", info.name, " (", info.id, "): --");
foreach(var rwy; keys(info.runways)) {
print(rwy); # prints the runways of KSQL
}
|example4 = var info = airportinfo(37.81909385, -122.4722484);
print("Coordinates of the nearest airport: ", info.lat, ", ", info.lon); # print the name and ICAO of the nearest airport to the Golden Gate Bridge
|example5 = var info = airportinfo(37.81909385, -122.4722484, "seaport");
print("Nearest seaplane base: ", info.name, " (", info.id, ")"); # print the name and ID of the nearest seaplane base to the Golden Gate Bridge
|example6text = This example prints the all information from an <code>airportinfo()</code> call.
|example6 = var info = airportinfo("KSFO");
print(info.name);
print(info.id);
print(info.lat);
print(info.lon);
print(info.has_metar);
print(info.elevation);
foreach(var rwy; keys(info.runways)){
print("-- ", rwy, " --");
print(info.runways[rwy].lat);
print(info.runways[rwy].lon);
print(info.runways[rwy].length);
print(info.runways[rwy].width);
print(info.runways[rwy].heading);
print(info.runways[rwy].stopway);
print(info.runways[rwy].threshold);
<nowiki>}</nowiki>
}}

===airwaysRoute() ===
{{Nasal doc
|syntax = airwaysRoute(start, end[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1933|t=Source}}
|text = {{see also|Nasal Flightplan}}
This function returns a vector containing waypoints between two given waypoints. The returned waypoints are ghosts, but can be accessed in the same way as a Nasal hash. See [[Nasal Flightplan]] for more information.
|param1 = start
|param1text = Start waypoint, in the form of a waypoint ghost, such as that provided by {{func link|flightplan()}}.
|param2 = end
|param2text = Same as above.
|param3 = type
|param3text = Instructs the function to compute a high level route (when set to "highlevel"), or a low level route (when set to "lowlevel"). Defaults to "highlevel."
|example1text = In the [[route manager]] dialog, add two waypoints to the flightplan, ideally ones that are far apart (tip: use the [[Map]] for this). Then run this code in your Nasal Console.
|example1 = var fp = flightplan();
var start = fp.getWP(0);
var end = fp.getWP(fp.getPlanSize() - 1);
var rt = airwaysRoute(start, end);
foreach(var wp; rt){
print(wp.wp_name); # print the waypoints in the computed route
}
|example2text = Exactly the same as above, but computes a low level path.
|example2 = var fp = flightplan();
var start = fp.getWP(0);
var end = fp.getWP(fp.getPlanSize() - 1);
var rt = airwaysRoute(start, end, "lowlevel");
foreach(var wp; rt){
print(wp.wp_name); # print the waypoints in the computed route
<nowiki>}</nowiki>
}}

===airway()===

{{Nasal doc
|syntax = airway(ident [, pos]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2644|t=Source}}
|text = {{see also|Nasal Flightplan}}
This function returns a ghost containing an airway of a specified id.
|param1 = ident
|param1text = a Positioned ghost (leg, navaid, airport) and so on, passed to the search function.
|param2 = pos
}}

===assert()===
{{Nasal doc
|syntax = assert(condition[, message]);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|version = 3.2
|commit = {{fgdata commit|8b16a7|t=commit}}
|text = Returns either true if the condition evaluates as true, or aborts with a {{func link|die()}} call, which can be customised.
|param1 = condition
|param1text = Condition to evaluate.
|param2 = message
|param2text = Optional message that will be used in any {{func link|die()}} call. Defaults to "assertion failed!"
|example1 = var a = 1;
var b = 2;
print(assert(a < b)); # prints "1" (true)
|example2 = var a = 1;
var b = 2;
assert(a > b, 'a is not greater than b'); # aborts with a custom error message
}}

===carttogeod()===
{{Nasal doc
|syntax = carttogeod(x, y, z);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=945|t=Source}}
|text = Converts {{wikipedia|ECEF|Earth-centered, Earth-fixed}} coordinates (x, y and z) to {{wikipedia|geodetic coordinates}} (latitude, longitude, and altitude). A vector is returned containing latitude and longitude, both in degrees, and altitude, which is returned in metres above the equatorial radius of Earth as defined by the {{wikipedia|WGS 84}} (6,378,137 metres).<ref>{{simgear file|simgear/math/sg_geodesy.hxx|l=43}}</ref>
|param1 = x
|param1text = Mandatory x-axis value, in metres.
|param2 = y
|param2text = Mandatory y-axis value, in metres.
|param3 = z
|param3text = Mandatory z-axis value, in metres.
|example1 = var (lat, lon, alt) = carttogeod(6378137, 0, 0); # point is the intersection of the prime meridian and equator.
print("Latitude: ", lat); # prints lat, lon and alt, which are all zero, see above
print("Longitude: ", lon);
print("Altitude: ", alt);
}}

===cmdarg()===
{{Nasal doc
|private = _cmdarg()
|syntax = cmdarg();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=513|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = <code>cmdarg()</code> returns the property root of certain types of XML files. These could be nodes in the [[Property Tree]], or temporary and/or non-public nodes outside the Property tree.
It is used by Nasal scripts embedded in XML files. It returns a <code>props.Node</code> object (see {{fgdata file|Nasal/props.nas}}), and you can use all of its methods on the returned value. <code>cmdarg()</code> should only be used in four types/places of XML files:
* Bindings: This is needed so that the value of a joystick's axis can be accessed internally.
* Dialogs: This will return the root of the dialog in the Property Tree. This is useful for dialogs that are created/modified procedurally (e.g. for populating/changing widgets while loading the dialog).
* Embedded Canvases: The Nasal code behind [[Canvas]] windows [[Howto:Adding a canvas to a GUI dialog|embedded in PUI dialogs]] can use it to accessing the root directory of their Canvas.
* Animation XML files: If the animation XML file is used in an AI/MP model, <code>cmdarg()</code> will return the root of the AI model in the <code>/ai/models/</code> directory. Examples: <code>/ai/models/aircraft[3]/</code>, <code>/ai/models/multiplayer[1]/</code>

You should not use <code>cmdarg()</code> in places other than those stated above. Although it won't cause an error, it will return the value of the last legitimate <code>cmdarg()</code> call.

Also, you should not delay <code>cmdarg()</code> using {{func link|maketimer()}}, {{func link|settimer()}} or {{func link|setlistener()}}, because it will return an unrelated property.
|example1 = fgcommand("dialog-show", {"dialog-name": "cmdarg-demo"});
|example1text = <br>This example demonstrates the usage of <code>cmdarg()</code> in a binding. Save the below XML snippet as <tt>[[$FG_ROOT]]/gui/dialogs/cmdarg-demo.xml</tt>. Then run the Nasal snippet below in your [[Nasal Console]]. Upon clicking {{button|Close}}, a message will be printed sowing the root of the binding in the Property Tree.
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>cmdarg-demo</name>
<layout>vbox</layout>

<text>
<label>Click "Close" to activate the demonstration (a message in the console).</label>
</text>

<button>
<legend>Close</legend>
<binding>
<command>nasal</command>
<script>print("Button binding root: '" ~ cmdarg().getPath() ~ "'");</script>
</binding>
<binding>
<command>dialog-close</command>
</binding>
</button>

</PropertyList>
</syntaxhighlight>
|example2text = This example demonstrates the usage of <code>cmdarg()</code> in Nasal code within dialogs. Open <tt>[[$FG_ROOT]]/gui/dialogs/cmdarg-demo.xml</tt> from the previous example, copy & paste the code below, and save it. Then run the same Nasal snippet as the previous example in your Nasal Console. If you click {{button|Click me!}}, the button's label will change to "I've been changed!"
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>cmdarg-demo</name>
<layout>vbox</layout>

<text>
<label>Click "Click me!" to activate the demonstration (the button's label will change).</label>
</text>

<button>
<legend>Click me!</legend>
<binding>
<command>nasal</command>
<script>change_label();</script>
</binding>
</button>

<button>
<legend>Close</legend>
<binding>
<command>dialog-close</command>
</binding>
</button>

<nasal>
<open><![CDATA[
var dlg_root = cmdarg();
var dlg_name = {"dialog-name": "cmdarg-demo"};
var change_label = func {
dlg_root.getNode("button[0]/legend").setValue("I've been changed!");
fgcommand("dialog-close", dlg_name);
fgcommand("dialog-show", dlg_name);
}
]]></open>
</nasal>

</PropertyList>
</syntaxhighlight>
|example3text = For an example of <code>cmdarg()</code> used with Canvas, please see [[Howto:Adding a canvas to a GUI dialog#FGPlot|Howto:Adding a canvas to a GUI dialog]].
}}

===courseAndDistance()===
{{Nasal doc
|syntax = courseAndDistance(to);
courseAndDistance(from, to);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1668|t=Source}}
|text = Returns a vector containing the course from one point to another and the distance between them in nautical miles. The course is the initial bearing (see [http://www.movable-type.co.uk/scripts/latlong.html#bearing here]), and is in the range 0–360. Both arguments can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object with geodetic coordinates (cartesian coordinates will not be accepted)
|param1 = from
|param1text = Optional parameter defining the from where the function should calculate its results. If the function is given one argument ('''to'''), the aircraft's current position will be used. As well as the argument types as defined above, this argument can be two numbers separated with a comma, as if the function is taking three arguments. See example 5 below.
|param2 = to
|param2text = Like the first parameter, but defines the second point.
|example1text = This example demonstrates the usage of the function with the <code>airport</code> ghost type.
|example1 = var from = airportinfo("KSFO");
var to = airportinfo("KSQL");
var (course, dist) = courseAndDistance(from, to);
print(course); # prints course from KSFO to KSQL
print(dist); # prints distance in nm from KSFO to KSQL
|example2text = This example demonstrates the usage of the function with hashes containing ''lat'' and ''lon''.
|example2 = var from = {lat: 0, lon: 0};
var to = {lat: 1, lon: 1};
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example3text = This example demonstrates usage of a geo.Coord object.
|example3 = var from = geo.Coord.new().set_latlon(0, 0);
var to = geo.Coord.new().set_latlon(1, 1);
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example4text = This example demonstrates usage of differing parameter types.
|example4 = var from = airportinfo("KSFO");
var to = geo.Coord.new().set_latlon(0, 0);
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example5text = The same as above, but the other way round.
|example5 = var to = {lat: 1, lon: 1};
var (course, dist) = courseAndDistance(0, 0, to);
print(course);
print(dist);
|example6text = Usage of just one parameter.
|example6 = var dest = airportinfo("KSQL");
var (course, dist) = courseAndDistance(dest);
print("Turn to heading ", math.round(course), ". You have ", sprintf("%.2f", dist), " nm to go");
}}

===createFlightplan()===
{{Nasal doc
|syntax = createFlightplan(path);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2331|t=Source}}
|text = Creates an empty flightplan object. It accepts one argument, ''path'' passed an absolute path to a .fgfp / .gpx file, it will populate the flightplan with waypoints from the file.
|param1 = path
|param1text = Optional parameter defining the file from which a flightplan will be populated.
|example1 =
var path = getprop("/sim/fg-home") ~ "/Export/test.fgfp";
var flightplan = createFlightplan(path);
debug.dump(flightplan);
}}

===createDiscontinuity()===
{{Nasal doc
|syntax = createDiscontinuity();
|text = Returns a <code>waypoint</code> ghost object. A route discontinuity is inserted by an {{abbr|FMS|Flight Management System}} when it is unsure how to connect two waypoints.
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2045|t=Source}}
|version = 2016.1
|commit = {{flightgear commit|caead6|t=commit}}
}}
===createViaTo()===
{{Nasal doc
|syntax = createViaTo(airway, waypoint);
|text = Returns a <code>waypoint</code> ghost object. It represents a route "via '''airway''' to '''waypoint'''".
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2009|t=Source}}
|version = 2016.1
|commit = {{flightgear commit|caead6|t=commit}}
|param1 = airway
|param1text = The name of an airway.
|param2 = waypoint
|param2text = Must be in the airway and one of:
* The name of a waypoint.
* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, or <code>fix</code> ghost object.
}}
===createWP()===
{{Nasal doc
|syntax = createWP(pos, name[, flag]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1964|t=Source}}
|text = Creates a new waypoint ghost object.
|param1 = pos
|param1text = Dictates the position of the new waypoint. It can be one of the following:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. See example 4 below.
|param2 = name
|param2text = String that will become the name of the new waypoint.
|param3 = flag
|param3text = Optional string that will tell FlightGear what type of waypoint it is. Must be one of "sid," "star," "approach," "missed," or "pseudo."
|example1text = Creates a waypoint directly in front and 1 km away and appends it to the flight plan.
|example1 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example2 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP({lat: pos.lat(), lon: pos.lon()}, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example3 = var apt = airportinfo();
var wp = createWP(apt, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example4 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos.lat(), pos.lon(), "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example5text = Creates a new waypoint and adds it to the flight plan. Waypoints of the type "pseudo" are then removed from the flight plan, including the new waypoint. The {{func link|print()}} statements show this.
|example5 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos, "NEWWP", "pseudo");
var fp = flightplan();
fp.appendWP(wp);
print(fp.getPlanSize());
fp.clearWPType("pseudo");
print(fp.getPlanSize());
}}

===createWPFrom()===
{{Nasal doc
|syntax = createWPFrom(object[, flag]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1989|t=Source}}
|text = Creates a new waypoint object from another object.
|param1 = object
|param1text = A ghost object. Must be a ghost type that is one of "airport," "navaid," "runway," or "fix."
|param2 = flag
|param2text = Optional string that will tell FlightGear what type of waypoint it is. Must be one of "sid," "star," "approach," "missed," or "pseudo."
|example1text = Creates a new waypoint and appends it to the flight plan.
|example1 = var apt = airportinfo("KSFO");
var wp = createWPFrom(apt);
var fp = flightplan();
fp.appendWP(wp);
|example2text = Creates a new waypoint and appends it to the flight plan. This way point is then removed; the {{func link|print()}} statements prove this.
|example2 = var apt = airportinfo("KSFO");
var wp = createWPFrom(apt, "pseudo");
print(wp.wp_name);
var fp = flightplan();
fp.appendWP(wp);
print(fp.getPlanSize());
fp.clearWPType("pseudo");
print(fp.getPlanSize());
}}

===defined()===
{{Nasal doc
|syntax = defined(symbol);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns 1 (true) or 0 (false) depending on whether a variable exists.
|param1 = symbol
|param1text = A string that will be what the function searches for.
|example1 = var number = 12;
var check_exist = func {
print("Variable 'number' ", defined("number") == 1 ? "exists" : "does not exist"); # 'number' does exist
print("Variable 'number2' ", defined("number2") == 1 ? "exists" : "does not exist"); # 'number2' does not exist
}
check_exist();
}}

===directory()===
{{Nasal doc
|syntax = directory(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=572|t=Source}}
|text = Returns a vector containing a list of the folders and files in a given file path or <code>'''nil'''</code> if the path doesn't exist. Hidden folders and files are not added to the vector.
{{inote|The first two elements of the vector will be <code>'.'</code> and <code>'..'</code>. These are for navigating back up the file tree, but have no use in Nasal. They can be safely removed from the vector.}}
|param1 = path
|param1text = Absolute file path.
|example1text = Gets the folders and files in [[$FG_ROOT]], and then removes the extra first two elements (see note above).
|example1 = var dir = directory(getprop("/sim/fg-root")); # get directory
dir = subvec(dir, 2); # strips off the first two elements
debug.dump(dir); # dump the vector
}}

===fgcommand()===
{{Nasal doc
|syntax = fgcommand(cmd[, args]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=456|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = Runs an fgcommand. See also {{readme file|commands}} and [[Bindings]] for more information. See {{flightgear file|src/Main/fg_commands.cxx|l=1425}} for the full list of fgcommands. Note that fgcommands generated by {{func link|addcommand()}} can also be run using this function. Also, the full list of fgcommands depends on the version of FlightGear you have. Returns 1 (true) if the fgcommand succeeded or 0 (false) if it failed.
|param1 = cmd
|param1text = String that is the name of the command that is to be run.
|param2 = args
|param2text = If the fgcommand takes arguments, they are inputted using this argument. Can either be a <code>props.Node</code> object, or a hash (see examples below).
|example1 = fgcommand("null"); # does nothing
|example2 = var args = props.Node.new({'script': 'print("Running fgcommand");'});
if (fgcommand("nasal", args)) { # prints "Running fgcommand" and then one of these print statements
print("Fgcommand succeeded");
} else {
print("Fgcommand encountered a problem");
}
|example3 = var args = { 'dialog-name': 'about' };
fgcommand("dialog-show", args); # shows the 'about' dialog
}}

===findAirportsByICAO() ===
{{Nasal doc
|syntax = findAirportsByICAO(search[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1096|t=Source}}
|text = Returns a vector containing <code>airport</code> ghost objects which are (by default) airports whose ICAO code matches the search string. The results are sorted by range from closest to furthest.
|param1 = search
|param1text = Search string for the function. Can either be a partial or a full ICAO code.
:{{icaution|The more matches there are for the given code, the longer the function will take. Passing just one character (e.g., "K"), might make FlightGear hang for a certain amount of time.}}
|param2 = type
|param2text = This will narrow the search to airports of a certain type. By default, only airports are searched for. May be one of "airport," "heliport," or "seaport."
|example1 = var apts = findAirportsByICAO("KSF"); # finds all airports matching "KSF"
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")"); # prints them
}
|example2 = var apts = findAirportsByICAO("SP0", "seaport"); # finds all seaplane bases matching "SP0"
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")"); # prints them
}
|example3 = var apt = findAirportsByICAO("XBET"); # one way to check if an airport does exist"
if (size(apt) == 0) {
print("Airport does not exist"); # this one will be printed
} else {
print("Airport does exist");
<nowiki>}</nowiki>
}}

===findAirportsWithinRange()===
{{Nasal doc
|syntax = findAirportsWithinRange([pos, ]range[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1066|t=Source}}
|text = Returns a vector of <code>airport</code> ghost object which are (by default) airports that are within a given range of a given position, or the aircraft's current position. The results are sorted by range from closest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findAirportsWithinRange(lat, lon, range, type);</code>.
|param2 = range
|param2text = Mandatory number giving the range in nautical miles within which to search for airports/heliports/seaplane bases.only airports are searched for.
|param3 = type
|param3text = This will narrow the search to airports of a certain type. By default, only airports are searched for. May be one of "airport," "heliport," or "seaport."
|example1text = Searches for airports within 10 nm of [[KSFO]].
|example1 = var pos = airportinfo("KSFO");
var apts = findAirportsWithinRange(pos, 10);
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
}
|example2text = Searches for seaplane bases within 15 nm of [[KSFO]].
|example2 = var pos = airportinfo("KSFO");
var apts = findAirportsWithinRange(pos, 15, "seaport");
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
}
|example3text = Searches for airports within 10 nm of your current position.
|example3 = var apts = findAirportsWithinRange(10);
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
<nowiki>}</nowiki>
}}

===findCommByFrequencyMHz()===
findCommByFrequencyMHz([pos, ]freq[, type]);
[[sourceforge:p/flightgear/flightgear/ci/next/tree/src/Scripting/NasalPositioned.cxx#l1547|source]]

Returns a <code>comm</code> ghost object for a station matching a given frequency. If there is more than one station with that frequency, the nearest station is returned.

'''pos'''

: Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findCommByFrequencyMHz(lat, lon, freq, type);</code>.
; freq
: Frequency, in megahertz, of the station to search for.
; type
: This will narrow the search to station of a certain type. Defaults to "all." For the full list of accepted type arguments, see flightgear/src/Navaids/positioned.cxx (line 160)
'''Example'''
var com = findCommByFrequencyMHz(123.6);
print("ID: ", com.id); # prints info about the comm station
print("Name: ", com.name);
print("Latitude: ", com.lat);
print("Longitude: ", com.lon);
print("Type: ", com.type);
print("Frequency: ", sprintf("%.3f", com.frequency), " Mhz");

=== findFixesByID() ===
{{Nasal doc
|syntax = findFixesByID([pos, ]id);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1627|t=Source}}
|text = Returns a vector containing <code>fix</code> ghost objects matching a given ID, sorted by range from a certain position.
{{inote|Fixes are (usually) also known as waypoints.}}
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findFixesByID(lat, lon, id);</code>.
|param2 = id
|param2text = Full or partial ID of the fix to search for.
:{{inote|1=Inputting a partial ID does not work correctly (see [http://forum.flightgear.org/viewtopic.php?f=30&t=28129 here]). It is best to just input a full ID.}}
|example1 = var fixes = findFixesByID("POGIC");
foreach(var fix; fixes){
print(fix.id, " - lat: ", fix.lat, " {{!}} lon: ", fix.lon); # prints information about POGIC
}
|example2 = var fix = findFixesByID("ZUNAP");
fix = fix[0];
var (course, dist) = courseAndDistance(fix);
print("Turn to heading ", math.round(course), ". You have ", sprintf("%.2f", dist), " nm to go to reach ", fixes[0].id);
}}

===findNavaidByFrequencyMHz()===
{{Nasal doc
|syntax = findNavaidByFrequencyMHz([pos, ]freq[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1547|t=Source}}
|text = Returns a <code>navaid</code> ghost object for a navaid matching a given frequency. If there is more than one navaid with that frequency, the nearest station is returned.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidByFrequencyMHz(lat, lon, freq, type);</code>.
|param2 = freq
|param2text = Frequency, in megahertz, of the navaid to search for.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaid = findNavaidByFrequencyMHz(109.55);
print("ID: ", navaid.id); # prints info about the navaid
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 100), " Mhz");
print("Range: ", navaid.range_nm, " nm");
if(navaid.course) print("Course: ", navaid.course);
}}

=== findNavaidsByFrequencyMHz()===
{{Nasal doc
|syntax = findNavaidsByFrequencyMHz([pos, ]freq[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1572|t=Source}}
|text = Returns a vector conatining <code>navaid</code> ghost objects for navaids that match a given frequency, sorted from nearest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsByFrequencyMHz(lat, lon, freq, type);</code>.
|param2 = freq
|param2text = Frequency, in megahertz, of the navaid to search for.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaids = findNavaidsByFrequencyMHz(109.55);
foreach(var navaid; navaids){
print("--");
print("ID: ", navaid.id); # prints info about the navaid
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 100), " Mhz");
print("Range: ", navaid.range_nm, " nm");
if(navaid.course) print("Course: ", navaid.course);
print("--");
<nowiki>}</nowiki>
}}

===findNavaidsByID()===
{{Nasal doc
|syntax = findNavaidsByID([pos, ]id[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1600|t=Source}}
|text = Returns a vector containing <code>navaid</code> ghost objects matching a given ID, sorted by range from a certain position.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsByID(lat, lon, id, type);</code>.
|param2 = id
|param2text = Full or partial ID of the fix to search for.
:{{inote|1=Inputting a partial ID does not work correctly (see [http://forum.flightgear.org/viewtopic.php?f=30&t=28129 here]). It is best to just input a full ID.}}
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaid = findNavaidsByID("MXW");
navaid = navaid[0];
print("ID: ", navaid.id); # prints info about 'MXW' (a VOR station)
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 1000), " Mhz");
print("Range: ", navaid.range_nm, " nm");
}}

===findNavaidsWithinRange()===
{{Nasal doc
|syntax = findNavaidsWithinRange([pos, ]range[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1518|t=Source}}
|text = Returns a vector of <code>navaid</code> ghost objects which are within a given range of a given position (by default the aircraft's current position). The results are sorted from closest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsWithinRange(lat, lon, range, type);</code>.
|param2 = range
|param2text = Mandatory number giving the range in nautical miles within which to search for navaids.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1text = Searches for navaids within 10 nm of [[KSFO]].
|example1 = var pos = airportinfo("KSFO");
var navs = findNavaidsWithinRange(pos, 10);
foreach(var nav; navs){
print(nav.name, " (ID: ", nav.id, ")");
}
|example2text = Searches for navaids within 10 nm of your current position.
|example2 = var navs = findNavaidsWithinRange(10);
foreach(var nav; navs){
print(nav.name, " (ID: ", nav.id, ")");
<nowiki>}</nowiki>
}}

===finddata()===
{{Nasal doc
|syntax = finddata(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=603|t=Source}}
|text = Takes a relative path and tries to return an absolute one. It works by appending the relative path to some paths and testing to see if they exist. As of FlightGear v3.7, these paths are the TerraSync directory (tested first) and [[$FG_ROOT]].
|param1 = path
|param1text = A relative path as a string.
|example1 = var path = finddata("Aircraft/Generic");
print(path); # prints the absolute path to $FG_ROOT/Aircraft/Generic
|example2 = var path = finddata("Airports");
print(path); # prints the absolute path to <TerraSync dir>/Airports
|example3 = var path = finddata("preferences.xml");
print(path); # prints the absolute path to $FG_ROOT/preferences.xml
}}

===flightplan()===
{{Nasal doc
|syntax = flightplan([path]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1738|t=Source}}
|text = {{see also|Nasal Flightplan}}
Returns a flight plan object, either one for the current flight plan, or one loaded from a given path.
|param1 = path
|param1text = Optional path to flight plan XML file.
|example1text = Gets the active flight plan and gets the ID of the current waypoint. Note that this example requires a flight plan to be set in the [[Route Manager]] first.
|example1 = var fp = flightplan();
print(fp.getWP(fp.current).id);
|example2text = Creates a new flight plan from an XML file and prints the IDs of the waypoints. Note that this example requires a flight plan to have been created and saved as <tt>''[[$FG_HOME]]/fp-demo.xml''</tt>.
|example2 = var path = getprop('/sim/fg-home') ~ '/fp-demo.xml';
var fp = flightplan(path);
for(var i = 0; i < fp.getPlanSize(); i += 1){
print(fp.getWP(i).id);
<nowiki>}</nowiki>
}}

===geodinfo()===
{{Nasal doc
|syntax = geodinfo(lat, lon[, max_alt]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=981|t=Source}}
|text = Returns a vector containing two entries or <code>'''nil'''</code> if no information could be obtained because the terrain tile wasn't loaded. The first entry in the vector is the elevation (in meters) for the given point, and the second is a hash with information about the assigned material (as defined in <tt>''[[$FG_ROOT]]/Materials''</tt>), or <code>'''nil'''</code> if there was no material information available (for example, because there is an untextured building at that location). The structure of the hash is as follows (see also {{readme file|materials}}):
* '''light_coverage:''' The coverage of a single point of light in m<sup>2</sup>.
* '''bumpiness:''' Normalized bumpiness factor for the material.
* '''load_resistance:''' The amount of pressure in N/m<sup>2</sup> the material can withstand without deformation.
* '''solid:''' 1 (true) or false (0) depending on whether the material is solid or not.
* '''names:''' Vector of scenery types (usually generated by [[TerraGear]]) that will use this material.
* '''friction_factor:''' Normalized friction factor of the material.
* '''rolling_friction:''' The rolling friction coefficient of the material.

Note that this function is a ''very'' CPU-intensive operation, particularly in FlightGear v2.4 and earlier. It is advised to use this function as little as possible.
|param1 = lat
|param1text = Latitude, inputted as a number.
|param2 = lon
|param2text = Longitude, inputted as a number.
|param3 = max_alt
|param3text = The altitude, in metres, from which the function will begin searching for the height of the terrain. Defaults to 10,000 metres. If the terrain is higher than this argument specifies, <code>'''nil'''</code> will be returned.
|example1text = Dumps information about ground underneath the aircraft.
|example1 = var pos = geo.aircraft_position();
var info = geodinfo(pos.lat(), pos.lon());
debug.dump(info);
|example2text = Prints whether the ground underneath the aircraft is solid or is water.
|example2 = var pos = geo.aircraft_position();
var info = geodinfo(pos.lat(), pos.lon());
if (info != nil and info[1] != nil) {
print("The ground underneath the aircraft is ", info[1].solid == 1 ? "solid." : "water.");
<nowiki>}</nowiki>
}}

=== geodtocart() ===
{{Nasal doc
|syntax = geodtocart(lat, lon, alt);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=962|t=Source}}
|text = Converts {{wikipedia|geodetic coordinates}} (latitude, longitude, and altitude) to {{wikipedia|ECEF|Earth-centered, Earth-fixed}} coordinates (x, y and z). A vector is returned containing x, y, and z in metres. The equatorial radius of earth used is that defined by the {{wikipedia|WGS 84}} (6,378,137 metres). All argument are mandatory.
|param1 = lat
|param1text = Latitude, in degrees.
|param2 = lon
|param2text = Longitude, in degrees.
|param3 = alt
|param3text = Altitude, in metres.
|example1 = var (x, y, z) = geodtocart(0, 0, 0); # point is the intersection of the prime meridian and equator.
print("x: ", x); # prints "x: 6378137"
print("y: ", y); # prints "y: 0"
print("z: ", z); # prints "y: 0"
}}

=== get_cart_ground_intersection()===
Introduced in 2017.2.1, see [[Terrain Detection]].

===getprop()===
{{Nasal doc
|syntax = <nowiki>getprop(path[, path[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=345|t=Source}}
|text = Returns the value of a node in the [[Property Tree]] or <code>'''nil'''</code> if the node does not exist or the value is not a number (NaN).
|param1 = path
|param1text = There needs to be at least one argument, but there is no limit to the maximum amount of arguments that can be given. The arguments will be concatenated together to form a property tree path. The arguments must be strings, but in FlightGear v3.2 onwards, there is also support (added by {{flightgear commit|34ed79}}) for numeric arguments as indices. See example 2 below.
|example1 = print("You have FlightGear v", getprop("/sim/version/flightgear")); # prints FlightGear version
|example2text = Note that the example below will only work in FlightGear 3.2 and above.
|example2 = for(var i = 0; i < 8; i += 1){
print("View #", i + 1, " is named ", getprop("/sim/view", i, "name"));
}
|example3text = Same as above, but is supported by all versions of FlightGear.
|example3 = for(var i = 0; i < 8; i += 1){
print("View #", i + 1, " is named ", getprop("/sim/view[" ~ i ~ "]/name"));
<nowiki>}</nowiki>
}}
==== See also====
{{note| If you have to read/write the same property multiple times (e.g. in an update loop), it is more efficient to use a node object:
To get a Node rather than its value, use <code>props.globals.getNode()</code> - see [[Nasal_library/props]]. }}

===greatCircleMove()===
{{Nasal doc
|syntax = greatCircleMove([pos, ]course, dist);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1681|t=Source}}
|text = Calculates a new set of geodetic coordinates using inputs of course and distance, either from the aircraft's current position (by default) or from another set of coordinates. Returns a hash containing two members, ''lat'' and ''lon'' (latitude and longitude respectively).
|param1 = pos
|param1text = Optional position to calculate from. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost object.
:* A hash with ''lat'' and ''lon'' members
:* A <code>geo.Coord</code> object
:* A lat/lon pair, that is, a pair of numbers (latitude followed by longitude) separated by a comma: <code>greatCircleMove(lat,lon, ...)</code>.
|param2 = course
|param2text = Course to new set of coordinates, in degrees (in the range 0–360).
|param3 = dist
|param3text = Distance in nautical miles to the new set of coordinates.
|example1 = var pos = greatCircleMove(0,0, 0, 1);
debug.dump(pos); # print hash with coordinates
|example2 = var fix = findFixesByID("POGIC");
fix = fix[0];
var pos = greatCircleMove(fix, 45, 10);
debug.dump(pos); # print hash with coordinates
}}

===interpolate()===
{{Nasal doc
|private = _interpolate()
|syntax = <nowiki>interpolate(prop, value1, time1[, value2, time2[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=522|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = Linearly interpolates a node in the property tree to a given value in a specified time. The value/time pairs will be run one after the other in the order that they are passed to the function. Note that the interpolation will continue even when the simulation is paused.
|param1 = prop
|param1text = String or <code>props.Node</code> object that indicates a node in the property tree to be used.
|param2 = value''n''
|param2text = Target value to change the property to in the set amount of time. This should be a number.
|param3 = time''n''
|param3text = Time in seconds, that will be taken for the interpolation.
|example1text = Paste the code below into the Nasal Console and execute. Then, open the Property Browser and look for the property. Finally, run the code again, and watch the value of the property change.
|example1 = setprop("/test", 0); # (re-)set property
interpolate("/test",
50, 5, # interpolate to 50 in 5 seconds
10, 2, # interpolate to 10 in 2 seconds
0, 5); # interpolate to 0 in 5 seconds
|example2 = # Apply the left brake at 20% per second
var prop = "controls/gear/brake-left";
var dist = 1 - getprop(prop);
if (dist == 1) {
interpolate(prop, 1, dist / 0.2);
<nowiki>}</nowiki>
}}

===isa()===
{{Nasal doc
|syntax = isa(object, class);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Checks if an object is an instance of, or inherits from, a second object (or class), returning 1 (true) if it is and 0 (false) if otherwise.
|param1 = object
|param1text = Object to check.
|param2 = class
|param2text = Class/object to check that '''object''' inherits from or is an instance of.
|example1 = var coord = geo.Coord.new();
if(isa(coord, geo.Coord)){
print("Variable 'coord' is an instance of class 'geo.Coord'"); # this one will be printed
} else {
print("Variable 'coord' is not an instance of class 'geo.Coord'");
}
|example2 = var coord = geo.Coord.new();
if(isa(coord, props.Node)){
print("Variable 'coord' is an instance of class 'props.Node'");
} else {
print("Variable 'coord' is not an instance of class 'props.Node'"); # this one will be printed
}
|example3text = The example below demonstrates checking of inheritance.
|example3 = var Const = {
constant: 2,
getConst: func {
return me.constant;
}
};

var Add = {
new: func {
return { parents: [Add, Const] };
},

addToConst: func(a){
return a * me.getConst();
}
};

var m = Add.new();
print(m.addToConst(4));

if(isa(m, Add)) print("Variable 'm' is an instance of class 'Add'"); # will be printed
if(isa(m, Const)) print("Variable 'm' is an instance of class 'Const'"); # will also be printed
}}

===logprint()===
{{Nasal doc
|syntax = <nowiki>logprint(priority[, msg[, msg[, ...]]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=431|t=Source}}
|text = Concatenates a message and logs it with a given priority level. Unlike {{func link|print()}} and {{func link|printlog()}}, message outputted by this function will be logged in your <code>[[Commonly used debugging tools#fgfs.log|fgfs.log]]</code> file as coming from the Nasal file itself rather than from {{flightgear file|src/Scripting/NasalSys.cxx}}.
|param1 = priority
|param1text = Number specifying the priority level of the outputted message:
:{{{!}} class="wikitable"
! Number !! Debug type
{{!-}}
{{!}} 1 {{!!}} Bulk
{{!-}}
{{!}} 2 {{!!}} Debug
{{!-}}
{{!}} 3 {{!!}} Info
{{!-}}
{{!}} 4 {{!!}} Warn
{{!-}}
{{!}} 5 {{!!}} Alert
{{!}}}
|param2 = msg
|param2text = The message. There is no limit to the arguments you give give. They will be concatenated together before logging.
|example1 = # logs the value of pi to three decimal places with log level 3
logprint(3, "pi = ", sprintf("%.3f", math.pi));
|example2 = logprint(5, "Alert! This is an important message!");
}}
{{note|
The following constants have been added to the development branch of FlightGear ("next") and will be releases with FG 2020.1 so you won't have to remember the numbers anymore:

LOG_BULK, LOG_WARN, LOG_DEBUG, LOG_INFO, LOG_ALERT, DEV_WARN, DEV_ALERT }}

===magvar() ===
{{Nasal doc
|syntax = magvar([pos]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1642|t=Source}}
|text = Returns the {{wikipedia|magnetic variation}} at a given set of coordinates. The table below gives the magnetic model used depending on the version of FlightGear.
{{{!}} class="wikitable"
! FlightGear versions !! Model !! Reference date
{{!-}}
{{!}} 3.6 and above {{!!}} {{wikipedia|World Magnetic Model}} (WMM) 2015 {{!!}} 1 January 2015
{{!-}}
{{!}} 0.9.11-pre1 to 3.4 {{!!}} WMM 2005 {{!!}} 1 January 2005
{{!-}}
{{!}} 0.7.3 to 0.9.10 {{!!}} WMM 2000 {{!!}} 1 January 2000
{{!}}}
|param1 = pos
|param1text = Optional position to calculate from. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost object.
:* A hash with ''lat'' and ''lon'' members
:* A <code>geo.Coord</code> object
:* A lat/lon pair, that is, a pair of numbers (latitude followed by longitude) separated by a comma: <code>magvar(lat,lon)</code>.
|example1 = print(magvar(0, 0)); # prints the magnetic variation at 0, 0
}}

===maketimer() ===
{{Nasal doc
|syntax = maketimer(interval[, self], function);
|source = ''Implemented using the {{API Link|flightgear|class|TimerObj}} class.''<br>{{flightgear file|src/Scripting/NasalSys.cxx|l=90|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=533|t=Part 2}}
|version = 2.12
|commit = {{flightgear commit|ab939f|t=commit}}
|text = Returns a timer object containing the following methods and members:
* '''start()''': Starts the timer.
* '''stop()''': Stops the timer.
* '''restart(interval)''': Restarts the timer with the given interval.
* '''singleShot''': Bool showing whether the timer is only to be run once, or continuously until told to stop. Can be both set and read from (see examples).
* '''isRunning''': Read-only bool telling whether the timer is currently running.
* '''simulatedTime''': (FG 2017.1+; {{flightgear commit|0af316|t=commit}}) Bool telling whether the timer is using simulated time (which accounts for pause, etc.). Defaults to false (use real time). Can be both read and set. This cannot be changed while the timer is running.
Unlike {{func link|settimer()}}, which it replaces, <code>maketimer()</code> provides more control over the timer. In addition, it can help reduce memory usage.
|param1 = interval
|param1text = Interval in seconds for the timer.
|param2 = self
|param2text = Optional parameter specifying what any <code>'''me'''</code> references in the function being called will refer to.
|param3 = function
|param3text = Function to be called at the given interval.
|example1 = var timer = maketimer(1, func(){
print("Hello, World!"); # print "Hello, World!" once every second (call timer.stop() to stop it)
});
timer.start();
|example2 = var timer = maketimer(1, math, func(){
print(me.math); # 'me' reference is the 'math' namespace
});
timer.singleShot = 1; # timer will only be run once
timer.start();
|example3 = var timer = maketimer(1, func(){
print("Hello, World!"); # print "Hello, World!" once every second (call timer.stop() to stop it)
});
timer.start();
print(timer.isRunning); # prints 1
|example4text = In the example below, "Hello, World!" will be printed after one second the first time, and after two seconds thereafter.
|example4 = var update = func(){
print("Hello, World!");
timer.restart(2); # restarts the timer with a two second interval
}

var timer = maketimer(1, update);
timer.singleShot = 1;
timer.start();
}}

===maketimestamp()===
{{Nasal doc
|syntax = maketimestamp()
|source = ''Implemented using the {{API Link|flightgear|class|TimeStampObj}} class.''<br>{{flightgear file|src/Scripting/NasalSys.cxx|l=214|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=589|t=Part 2}}
|version = 2019.2
|commit = {{flightgear commit|7db06300|t=commit}}
|text = Returns a time stamp object to allow high resolution timing of Nasal operations. When created the timer will automatically be stamped. The object has the following methods:
* '''stamp()''': Resets the timing operation. Call this first.
* '''elapsedMSec()''': returns number of milliseconds elapsed since stamp() called. Resolution may vary depending on platform but is usually at least millisecond accuracy.
* '''elapsedUSec()''': returns number of microseconds elapsed since stamp() called. Resolution may vary depending on platform but is usually at least millisecond accuracy.
|
|example1text = In the example below the number of milliseconds elapsed will be printed.
|example1 = var timestamp = maketimestamp();
timestamp.stamp();
print(timestamp.elapsedMSec(), "ms elapsed");
print(timestamp.elapsedMSec(), "ms elapsed");
}}

===md5()===
{{Nasal doc
|syntax = md5(string);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=758|t=Source}}
|version = 3.2
|commit = {{flightgear commit|cfbf9e|t=commit}}
|text = Returns a the {{wikipedia|MD5}} hash (as a string) of the inputted string.
|param1 = string
|param1text = String the generate the hash of. Mandatory.
|example1text = The below code should output <code>65a8e27d8879283831b664bd8b7f0ad4</code>.
|example1 = print(md5("Hello, World!"));
}}

===navinfo()===
{{Nasal doc
|syntax = navinfo(lat, lon, type, id);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1453|t=Source}}
|text = Returns vector <code>navaid</code> ghost objects matching the given '''type''' and '''id''' or <code>'''nil'''</code> on error.
|param1 = lat ''and'' lon
|param1text = If given, the returned navaids will be put into order of ascending distance from the location.
|param2 = type
|param2text = Narrows the search to the given type. Must be one of "any," "fix," "vor," "ndb," "ils," "dme," or "tacan." Defaults to the equivalent of "any."
|param3 = id
|param3text = ID to search for. Note that, although all the parameters are technically optional, this parameter must be given, otherwise an empty vector will be returned.
|example1 = navinfo("vor"); # returns all VORs
|example2 = navinfo("HAM"); # return all navaids whose names start with "HAM"
|example3 = navinfo("vor", "HAM"); # return all VORs whose names start with "HAM"
|example4 = navinfo(34,48,"vor","HAM"); # return all VORs whose names start with "HAM" and sorted by distance relative to 34°, 48°
}}

===parse_markdown()===
{{Nasal doc
|syntax = parse_markdown(markdown);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=745|t=Part 1}} {{!}} {{simgear file|simgear/misc/SimpleMarkdown.cxx|t=Part 2}}
|version = 3.2
|text = Parses a string containing {{wikipedia|Markdown}} and returns the result as a string. As of FlightGear 2016.1, it is just a simple parser, and does the following:
* It strips whitespace from the beginning of the string.
* It supports [http://daringfireball.net/projects/markdown/syntax#p paragraphs and line breaks].
* It collapses whitespace.
* It converts unordered [http://daringfireball.net/projects/markdown/syntax#list lists] to use a bullet character (•). Note that the bullet character is implemented in hexadecimal UTF-8 character bytes (<code>E2 80 A2</code>), as so may not work properly when the being displayed in an encoding other than UTF-8.
|param1 = markdown
|param1text = String containing Markdown to be parsed.
|example1text =
Save the below code as <tt>''[[$FG_ROOT]]/gui/dialogs/test.xml''</tt>, then run the Nasal code below it to open the dialog. To change the markdown to be parsed, simply change the code in the highlighted section, save it, and reload the GUI (<tt>Debug > Reload GUI</tt>).
<syntaxhighlight lang="xml" highlight="41-50">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>test</name>
<layout>vbox</layout>

<group>
<layout>hbox</layout>

<empty>
<stretch>true</stretch>
</empty>

<text>
<label>parse_markdown() test dialog</label>
</text>

<empty>
<stretch>true</stretch>
</empty>

<button>
<legend></legend>
<pref-width>16</pref-width>
<pref-height>16</pref-height>
<binding>
<command>dialog-close</command>
</binding>
</button>

</group>

<canvas>
<name>Canvas plot</name>
<stretch>true</stretch>
<pref-width>400</pref-width>
<pref-height>300</pref-height>
<nasal>
<load><![CDATA[
var text = 'Items:
* apples
* oranges
* pears

Some text.
Some more items:
* apples
* oranges
* pears';

var parsed = parse_markdown(text);

var root_canvas = canvas.get(cmdarg());
root_canvas.setColorBackground(255, 255, 255);
var root = root_canvas.createGroup();

var text_dis = root.createChild("text")
.setText(parsed)
.setTranslation(5, 5)
.setFont("LiberationFonts\LiberationSans-Regular.ttf")
.setFontSize(15)
.setColor(0, 0, 0)
.setDrawMode(canvas.Text.TEXT)
.setAlignment("left-top");
]]></load>
</nasal>
</canvas>

</PropertyList>
</syntaxhighlight>
|example1 = fgcommand("dialog-show", {"dialog-name": "test"});
|example2text = The example below parses Markdown and outputs it in a HTML document. The parsed text is placed in <syntaxhighlight lang="xml" inline><pre></pre></syntaxhighlight> tags. To change the Markdown to be parsed, simply edit the variable <tt>markdown</tt> at the top of the code.
|example2 = <nowiki>var markdown = 'Items:
* apples
* oranges
* pears

Some text.
Some more items:
* apples
* oranges
* pears';

var parsed = parse_markdown(markdown);

debug.dump(parsed);

var path = string.normpath(getprop("/sim/fg-home") ~ '/Export/parse_markdown()-test.html');

var file = io.open(path, "w");

var html = "<!DOCTYPE html>\n\n<html>\n\n<head>\n\t<meta charset=\"UTF-8\">\n\t<title>parse_markdown() test generated by Nasal</title>\n</head>\n\n<body>\n\t<pre>" ~ parsed ~ "</pre>\n</body>\n\n</html>";

io.write(file, html);
io.close(file);
print("Done, file ready for viewing (" ~ path ~ ")");</nowiki>
}}

===parsexml()===
{{Nasal doc
|syntax = <nowiki>parsexml(path[, start[, end[, data[, pro_ins]]]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=710|t=Source}}
|text = This function is an interface into the built-in [http://expat.sourceforge.net/ Expat XML parser]. The absolute path to the file is returned as string, or <code>'''nil'''</code> is returned on error.
|param1 = path
|param1text = Mandatory absolute path to the XML file to be parsed.
|param2 = start
|param2text = Optional callback function that will be called for every starting tag. The function should take two argument: the tag name and a hash containing attributes.
|param3 = end
|param3text = Optional callback function that will be called for every ending tag. The function should take one argument: the tag name.
|param4 = data
|param4text = Optional callback function that will be called for every piece of data within a set of tags. The function should take one argument: the data as a string.
|param5 = pro_ins
|param5text = Optional callback function that will be called for every {{wikipedia|Processing Instruction|processing instruction}}. The function should take two argument: the target and the data string.
|example1text = Save the below XML code in <tt>''[[$FG_HOME]]/Export/demo.xml''</tt>. Then, execute the Nasal code below in the Nasal Console. The XML will be parsed and each bit of the code will be printed.
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<?xml-stylesheet type="text/xsl" href="style.xsl"?>

<foo>
<blah type="string"><![CDATA[ <sender>John Smith</sender> ]]></blah>
<blah2 type="string">Orange & lemons</blah2>
</foo>
</syntaxhighlight>
|example1 = var start = func(name, attr){
print("Starting tag: '", name, "'");
foreach(var a; keys(attr)){
print("\twith attribute ", a, '="', attr[a], '"');
}
}

var end = func(name){
print("Ending tag: '", name, "'");
}

var data = func(data){
print("Data = '", data, "'");
}

var pro_instr = func(target, data){
print("Processing instruction: target = '", target, "', data = '", data, "'");
}

parsexml(getprop("/sim/fg-home") ~ '/Export/demo.xml', start, end, data, pro_instr);
}}

===print()===
{{Note|As of 07/2020, we are in the process of slowly deprecating and removing Nasal print() (in fgdata) where possible in favor of log [[#logprint()]] which takes a priority level.

This is part of the goal that we achieve zero output at log-level at alert, and everything shown at ‘warn; is really a warning, not just information.<ref>https://sourceforge.net/p/flightgear/mailman/message/37042224/</ref>}}

{{Nasal doc
|syntax = <nowiki>print(data[, data[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=415|t=Source}}
|text = Concatenates its arguments and then prints it to the terminal and the [[Commonly used debugging tools#fgfs.log|log]]. Note that a newline is automatically added.
|param1 = data
|param1text = Data to print. Only strings and numbers can be printed; other data types will not be. There many be any number of arguments; they will just be concatenated together.
|example1 = print("Just", " a ", "test"); # prints "Just a test"
|example2 = print("pi = ", math.pi); # prints "pi = 3.141592..."
}}

=== printf() ===
{{Nasal doc
|syntax = <nowiki>printf(format[, arg[, arg, [...]]]);</nowiki>
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Creates and prints a formatted string. For a description of its arguments, see {{func link|sprintf()}} (it is, in fact, implemented using <code>sprintf()</code>).
|example1 = printf("In hexadecimal, 100000 = %X", 186A0); # prints "In hexadecimal, 100000 = 186A0"
}}

===printlog()===
{{caution|This function is deprecated and doesn't work. Please use the new one {{func link|logprint()}}.}}
{{Nasal doc
|syntax = <nowiki>printlog(level, data[, data[, ...]]);</nowiki>
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Prints the given message with the given log level. If the log level is higher or equal to <code>/sim/logging/priority</code>, it is printed.
|param1 = level
|param1text = Mandatory log level as a string. Must be one of "none," "bulk," "debug," "info," "warn," or "alert." Note that "none" will mean that the message will never be printed.
|param2 = data
|param2text = Data to be printed. Only strings and numbers will be printed; others will not be. There may be any number of arguments; they will just be concatenated together.
|example1 = printlog("alert", "This is an alert"); # message will be printed
|example2 = printlog("info", "Just informing you about something"); # message will be printed only if log level is set to "info" or less
}}

===rand()===
{{Nasal doc
|syntax = rand();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=554|t=Source}}
|text = Returns a random floating point number between 0 (inclusive) and 1 (exclusive). It takes no arguments.
|example1 = print(rand()); # prints random number
}}

===registerFlightPlanDelegate()===
{{Nasal doc
|syntax = registerFlightPlanDelegate(init_func);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1879|t=Source}}
|text = Registers a flight plan delegate. See <tt>''{{fgdata file|Nasal/route_manager.nas|t=$FG_ROOT/Nasal/route_manager.nas}}''</tt> for examples.
|param1 = init_func
|param1text = Initialization function which will be called during FlightGear's startup.
}}
===removecommand()===
{{Nasal doc
|syntax = removecommand(cmd);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=668|t=Source}}
|text = Removes the given fgcommand. Returns <code>'''nil'''</code>.
{{caution|This will remove '''any''' [[fgcommands|fgcommand]], even those implemented in C++, so use with caution!}}
|param1 = cmd
|param1text = String specifying the name of the command to remove.
|example1 = addcommand("hello", func(){
print("Hello");
});
fgcommand("hello"); # "Hello" will be printed
removecommand("hello"); # removes it
}}

===removelistener()===
{{Nasal doc
|syntax = removelistener(id);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=1384|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=506|t=Part 2}}
|text = Removes and deactivates the given listener and returns the number of listeners left or <code>'''nil'''</code> on error.
{{note|It is good practice to remove listeners when they are not required anymore. This prevents the listeners reducing FlightGear's run performance.}}
|param1 = id
|param1text = ID of listener as returned by {{func link|setlistener()}}.
|example1 = var ls = setlistener("/sim/test", func(){
print("Property '/sim/test' has been changed");
});
setprop("/sim/test", "blah"); # trigger listener
var rem = removelistener(ls); # remove listener
print("There are ", rem, " listeners remaining");
}}

===resolvepath()===
{{Nasal doc
|syntax = resolvepath(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=604|t=Source}}
|text = Takes a relative path as a string and uses [[SimGear]]'s path-resolving framework to return an absolute path as a string. If the path could not be resolved, an empty string is returned. See [[Resolving Paths]] for a detailed description of the algorithm. This function can also be used to check if a file exists.
|param1 = path
|param1text = Relative path to be completed.
|example1 = print(resolvepath("Nasal/globals.nas")); # prints the equivalent of $FG_ROOT/Nasal/globals.nas
|example2 = print(resolvepath("blah")); # prints nothing; could not be resolved
|example3 = var file_path = resolvepath("Aircraft/SenecaII/some-file");
if (file_path != ""){
gui.popupTip("some-file found", 2);
} else {
gui.popupTip("some-file not found", 2);
<nowiki>}</nowiki>
}}

===setlistener()===
{{Nasal doc
|syntax = <nowiki>setlistener(node, code[, init[, type]]);</nowiki>
|private = _setlistener()
|source = {{flightgear file|src/Scripting/Nasal|l=499|t=Part 1}} {{!}} {{flightgear file|src/Scripting/Nasal|l=1350|t=Part 2}}<br>''Listener implemented using the {{API Link|flightgear|class|FGNasalListener}} class.''
|text = Creates a listener which will be triggered when the given property is changed (depending on the '''type'''). A unique integer ID is returned; this can later be used as the argument to {{func link|removelistener()}}.
{{note|Listeners are known to be a source of resource leaks. To avoid this, please take measures such as:
* Using {{func link|removelistener()}} when they are not needed any more.
* Using a single initialization listener.
* Avoiding tying listeners to properties that are rapidly updated (e.g., many times per frame).
}}
|param1 = node
|param1text = Mandatory string or <code>props.Node</code> object pointing to a property in the [[Property Tree]].
|param2 = code
|param2text = Mandatory callback function to execute when the listener is triggered. The function can take up to four arguments in the following order:
* '''changed''': a <code>props.Node</code> object pointing to the changed node.
* '''listen''': a <code>props.Node</code> object pointing to the listened-to node. Note that this argument maybe different depending on the '''type'''.
* '''mode''': an integer telling how the listener was triggered. 0 means that the value was changed. 1 means that a child property was added. -1 means that a child property was removed.
* '''is_child''': boolean telling whether '''changed''' is a child property of the listened-to '''node''' or not. 1 (true) if it is, 0 (false) otherwise.
|param3 = init
|param3text = If set to 1 (true), the listener will additionally be triggered when it is created. This argument is optional and defaults to 0 (false).
|param4 = type
|param4text = Integer specifying the listener's behavior. 0 means that the listener will only trigger when the property is changed. 1 means that the trigger will always be triggered when the property is written to. 2 will mean that the listener will be triggered even if child properties are modified. This argument is optional and defaults to 1.
|example1 = var prop = props.globals.initNode("/sim/test", "", "STRING"); # create property
var id = setlistener("/sim/test", func(n){ # create listener
print("Value: ", n.getValue());
});
setprop("/sim/test", "blah"); # trigger listener
removelistener(id); # remove listener
prop.remove(); # remove property
}}

===setprop()===
{{Nasal doc
|syntax = <nowiki>setprop(path[, path[, ...]], value);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=385|t=Source}}
|text = Sets the value of a property in the [[Property Tree]]. If the property does not exist, it will be created. Returns 1 (true) on success or 0 (false) if there was an error.
{{note|If you want to remove a property, you will have to use one of the <code>props</code> helpers:
<syntaxhighlight lang="nasal">
props.globals.getNode("foo/bar").remove(); # take out the complete node
props.globals.getNode("foo").removeChild("bar"); # take out a certain child node
</syntaxhighlight>
}}
|param1 = path
|param1text = There needs to be at least one '''path''' argument, but there is no limit to the maximum amount that can be given. They will be concatenated together to form a property tree path. The arguments must be strings, but in FlightGear v3.2 onwards, there also is support (added by {{flightgear commit|34ed79}}) for numeric arguments as indices. See example 2 below.
|param2 = value
|param2text = Value to write to the given property. Must be either a string or a number.
|example1 = setprop("/sim/demo", "This is a demo");
|example2text = Note that the example below will only work in FlightGear 3.2 and above.
|example2 = for(var i = 0; i < 3; i += 1){
setprop("/sim/demo", i, "Demo #" ~ i));
}
|example3text = Same as above, but is supported by all versions of FlightGear.
|example3 = for(var i = 0; i < 3; i += 1){
setprop("/sim/demo[" ~ i ~ "]", "Demo #" ~ i));
<nowiki>}</nowiki>
}}
====See also====
{{note| If you have to read/write the same property multiple times (e.g. in an update loop), it is more efficient to use a node object:
To get a Node rather than its value, use <code>props.globals.getNode()</code> - see [[Nasal_library/props]]. }}

===settimer() ===
{{Nasal doc
|syntax = settimer(function, delta[, realtime]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=499|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=1286|t=Part 2}}
|text = Runs the given function a specified amount of seconds after the current time. Returns <code>'''nil'''</code>.
{{note|Improper use of <code>settimer()</code> may cause resource leaks. It is also highly recommended that the newer {{func link|maketimer()}} should be used instead of this function.}}
|param1 = function
|param1text = Mandatory function that will be called. It may be necessary to enclose code in an anonymous function (see example).
|param2 = delta
|param2text = Mandatory amount of time in seconds after which the function will be called.
|param3 = realtime
|param3text = If 1 (true), "real time" will be used instead of "simulation time." Defaults to 0 (false). Note that if "simulation time" is used, the timer will not run while FlightGear is paused.
|example1 = var myFunc = func(){
print("Hello");
}

settimer(myFunc, 2); # runs myFunc after 2 seconds
|example2 = var sqr = func(a){
return a * a;
}

settimer(func(){
print(sqr(2)); # will print 4 after 2 seconds
}, 2);
}}

===srand() ===
{{Nasal doc
|syntax = srand();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=559|t=Source}}
|text = Makes the pseudorandom number generator (see {{func link|rand()}}) generate a new {{wikipedia|random seed|noicon=1}} based on time. Returns 0.
}}
===systime()===
{{Nasal doc
|syntax = systime();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=770|t=Source}}
|text = Returns the {{wikipedia|Unix time}} (seconds since since 00:00:00 UTC, 1/1/1970) as a floating point number with high resolution. This function is useful for benchmarking purposes (see example 2).
{{note|1=High resolution timers under Windows can produce inaccurate or fixed sub-millisecond results.<ref>{{cite web|url=http://forum.flightgear.org/viewtopic.php?f=30&t=29259|title=Nasal: systime() ??!?|author=Necolatis|date=Apr 2nd, 2016}}</ref> This is due to the underlying {{func link|GetSystemTimeAsFileTime()|link=https://msdn.microsoft.com/en-us/library/windows/desktop/ms724397(v=vs.85).aspx}} API call, which depends on hardware availability of suitable high resolution timers. See also [https://msdn.microsoft.com/en-us/library/windows/desktop/dn553408(v=vs.85).aspx Acquiring high-resolution time stamps]}}
|example1 = print("Unix time: ", systime()); # prints Unix time
|example2 = var myFunc = func(){
for(var i = 0; i <= 10; i += 1){
print("Interation #", i);
}
}
var t = systime(); # record time
myFunc(); # run function
var t2 = systime(); # record new time
print("myFunc() took ", t2 - t, " seconds"); # print result
}}

===thisfunc()===
{{Nasal doc
|syntax = thisfunc();
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns the function from which this function is called. This allows a function to reliably and safely call itself from within a closure.
|example1 = var stringify_vec = func(input){
if (typeof(input) == "scalar"){
return sprintf("%s", input);
} elsif (typeof(input) == "vector") {
if (size(input) == 0) return "[]";
var this = thisfunc();
var buffer = "[";
for(var i = 0; i < size(input); i += 1){
buffer ~= this(input[i]);
if (i == size(input) - 1) {
buffer ~= "]";
} else {
buffer ~= ", ";
}
}
return buffer;
} else {
die("stringify_vec(): Error! Invalid input. Must be a vector or scalar");
}
}

var test_vec = ["a", "b", "c", [1, 2, 3], "d"];
debug.dump(stringify_vec(test_vec)); # prints "[a, b, c, [1, 2, 3], d]"
test_vec = [];
debug.dump(stringify_vec(test_vec)); # prints "[]"
test_vec = {};
debug.dump(stringify_vec(test_vec)); # will throw an error
}}

===tileIndex() ===
{{Nasal doc
|syntax = tileIndex();
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1720|t=Source}}
|text = Returns the index of the tile at the aircraft's current position as a string. This corresponds to the name of the STG file of the tile. For example, at [[KSFO]], this would be <code>942050</code>, corresponding to <tt>''[[$FG_SCENERY]]/Terrain/w130n30/w123n3/942050.stg''</tt>.
|example1 = print(tileIndex()); # print index
}}

=== tilePath()===
{{Nasal doc
|syntax = tilePath();
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1712|t=Source}}
|text = Returns the base path of the tile at the aircraft's current position as a string. For example, at KSFO, this would be <code>w130n30/w123n3</code>, corresponding to <tt>''[[$FG_SCENERY]]/Terrain/w130n30/w123n3''</tt>.
|example1 = print(tilePath()); # print path
}}

=== values()===
{{Nasal doc
|syntax = values(hash);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns a vector containing the values of the given hash.
|param1 = hash
|param1text = Mandatory hash to get the values of.
|example1 = var hash = {
"a": 1,
"b": 2,
"c": 3
};

foreach(var val; values(hash)){
print(val);
}
|example2text = The below example does exactly the same thing as the above example, but does not use <code>values()</code>:
|example2 = var hash = {
"a": 1,
"b": 2,
"c": 3
};

foreach(var key; keys(hash)){
print(hash[key]);
<nowiki>}</nowiki>
}}

==Extension functions new in FG 2020.1 ==
The following functions have been added to the nasal core library and will be released with FlightGear version 2020.1.
Before the release they are available in the development branch "next".

===isfunc()===
Returns 1 if type or argument is a function, otherwise 0.

===isghost()===
Returns 1 if type or argument is a ghost, otherwise 0.

=== ishash()===
Returns 1 if type or argument is a hash, otherwise 0.

===isint()===
{{Nasal doc
|syntax = isint(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if argument has a numeric value and x == floor(x), e.g. integer.
}}

===isnum()===
{{Nasal doc
|syntax = isnum(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if typeof(x) is "scalar" and x has a numeric value otherwise 0.
}}

===isscalar()===
{{Nasal doc
|syntax = isscalar(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if type or argument is a scalar (string or numeric), otherwise (vector, hash, func, ...) it returns 0. This is useful to check if a variable can be converted to string e.g. when useing the string concat operator "~".
|example1 = var a = "foo";
var b=42;
if (isscalar(a) and isscalar(b)) print(a~b);
if (isstr(a)) print("a is a string");
if (isint(b)) print("b is an integer");
# if (isscalar(a))... is equivalent to if (typeof(a) == "scalar")...
}}

===isstr()===
Returns 1 if type or argument is a string, otherwise 0.

===isvec()===
Returns 1 if type or argument is a vector, otherwise 0.

===vecindex()===
{{Nasal doc
|syntax = vecindex(vector, value);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns the index of value or nil, if value is not found in vector.
|example1=
var myvector = ["apple", "bananna", "coconut"];
# to check if a vector contains a certain value compare vecindex to nil
if (vecindex(myvector, "apple") != nil) {
print("found apple");
}
# WARNING: this will not work as desired because index is 0
if (vecindex(myvector, "apple")) {
print("found apple");
<nowiki>}</nowiki>

}}

==Extension functions new in "dev" version ==
The following functions have been added to the nasal core library curernty on "dev" version.

===member()===
{{Nasal doc
|syntax = member(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=796|t=Source}}
|text = The function searches for a key in the given hash, including the <code>parents</code>. If the key is found, its value is returned; otherwise, it returns <code>nil</code>.
|param1 = hash
|param1text = The hash in which the key is searched.
|param2 = key
|param2text = Key as a string whose value we want to return.
|example1 =
var Hash = {
key: 12,
};

member(Hash, 'key'); # return 12
member(Hash, 'missing'); # return nil
|example2 = # member() also includes parents

var Base = {
key: 'text',
};

var Child = {
parents: [Base],
};

member(Child, 'key'); # return 'text'
member(Child, 'missing'); # return nil
}}

===has_member()===
{{Nasal doc
|syntax = has_member(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=811|t=Source}}
|text = The function searches for a key in the given hash, including the <code>parents</code>. If the key is found, <code>true</code> is returned, otherwise <code>false</code>.
|param1 = hash
|param1text = The hash in which the key is searched.
|param2 = key
|param2text = Key as a string.
|example1 =
var Hash = {
key: 12,
};

has_member(Hash, 'key'); # return true
has_member(Hash, 'missing'); # return false
|example2 = # has_member() also includes parents

var Base = {
key: 'text',
};

var Child = {
parents: [Base],
};

has_member(Child, 'key'); # return true
has_member(Child, 'missing'); # return false
}}

==Variables==
Various global constants (technically variables) are provided for use in converting between different units. They are all found in {{fgdata file|Nasal/globals.nas|text=$FG_ROOT/Nasal/globals.nas}}.

===D2R===
{{Nasal doc
|syntax = var radians = degrees * D2R;
|text = Converts an angle from degrees to radians when multiplied by the angle in degrees. Equal to <code>π / 180</code>.
}}
===FPS2KT===
{{Nasal doc
|syntax = var knots = feet_per_second * FPS2KT;
|text = Converts a velocity from feet per second to knots when multiplied by the velocity in feet per second. Approximately equal to 0.5925.
}}
===FT2M===
{{Nasal doc
|syntax = var metres = feet * FT2M;
|text = Converts a length from feet to metres when multiplied by the length in feet. Equal to 0.3048.
}}
===GAL2L ===
{{Nasal doc
|syntax = var litres = gallons * GAL2L;
|text = Converts a volume from US liquid gallons to litres when multiplied by the volume in gallons. Approximately equal to 3.7854.
}}
===IN2M===
{{Nasal doc
|syntax = var metres = inches * IN2M;
|text = Converts a length from inches to metres when multiplied by the length in inches. Equal to 0.0254.
}}
===KG2LB===
{{Nasal doc
|syntax = var pounds = kilograms * KG2LB;
|text = Converts a mass from kilograms to pounds when multiplied by the mass in kilograms. Approximately equal to 2.2046.
}}
===KT2FPS===
{{Nasal doc
|syntax = var feet_per_second = knots * KT2FPS;
|text = Converts a velocity from knots to feet per second when multiplied by the velocity in knots. Approximately equal to 1.6878.
}}
===KT2MPS===
{{Nasal doc
|syntax = var metres_per_second = knots * KT2MPS;
|text = Converts a velocity from knots to metres per second when multiplied by the velocity in knots. Approximately equal to 0.5144.
}}
===L2GAL===
{{Nasal doc
|syntax = var gallons = litres * L2GAL;
|text = Converts a volume from litres to US liquid gallons when multiplied by the volume in litres. Approximately equal to 0.2642.
}}
===LB2KG===
{{Nasal doc
|syntax = var kilograms = pounds * LB2KG;
|text = Converts a mass from pounds to kilograms when multiplied by the mass in pounds. Approximately equal to 0.4536.
}}
===M2FT ===
{{Nasal doc
|syntax = var feet = metres * M2FT;
|text = Converts a length from metres to feet when multiplied by the length in metres. Approximately equal to 3.2808.
}}
===M2IN===
{{Nasal doc
|syntax = var inches = metres * M2IN;
|text = Converts a length from metres to inches when multiplied by the length in metres. Approximately equal to 39.3701.
}}
===M2NM ===
{{Nasal doc
|syntax = var nautical_miles = metres * M2NM;
|text = Converts a length from metres to nautical miles when multiplied by the length in metres. Approximately equal to 0.00054.
}}
===MPS2KT ===
{{Nasal doc
|syntax = var knots = metres_per_second * MPS2KT;
|text = Converts a velocity from metres per second to knots when multiplied by the velocity in metres per second. Approximately equal to 1.9438.
}}
===NM2M ===
{{Nasal doc
|syntax = var metres = nautical_miles * NM2M;
|text = Converts a length from nautical miles to metres when multiplied by the length in nautical miles. Equal to 1,852.
}}
===R2D===
{{Nasal doc
|syntax = var degrees = radians * R2D;
|text = Converts an angle from radians to degrees when multiplied by the angle in radians. Equal to <code>180 / π</code>.
}}

{{Appendix}}

{{Nasal namespaces}}

Nasal library

2026-01-16T19:37:21Z

PlayeRom: /* has_member() */

{{Nasal Navigation|nocat=1}}
This page documents the global '''library functions and variables''' of FlightGear's built-in scripting language, [[Nasal]]. This includes ''[[#Core library functions|core library functions]]'', which were included in Nasal before its integration into FlightGear, the ''[[#Extension functions|extension functions]]'', which have been subsequently added, and are specifically designed for FlightGear, and the ''[[#variables|global variables]]'', which are conversion variables, added with extension functions, for converting between units. The relevant folders in [[Git]] are:
* {{flightgear file|src/Scripting}}
* {{simgear file|simgear/nasal}}

All these functions and variables are in the global namespace, that is, they are directly accessible (e.g., one can call <syntaxhighlight lang="nasal" inline>magvar()</syntaxhighlight> instead of <syntaxhighlight lang="nasal" inline>namespace.magvar()</syntaxhighlight>). However, if a namespace must be used, <code>globals</code> is the correct namespace, but using it is not recommended. For a more complete explanation, see [[Nasal Namespaces in-depth]].

{{tip|Copy & paste the examples into your [[Nasal Console]] and execute them to see what they do.|width=70%}}

== Core library functions ==
This is the list of the basic '''core library functions.''' Most of these functions were part of the original Nasal library (before its integration in to FlightGear), while some have been added or changed over time. See also:
* http://plausible.org/nasal/lib.html ([http://web.archive.org/web/20101010094553/http://plausible.org/nasal/lib.html archive])
* {{simgear file|simgear/nasal/lib.c}} ([http://sourceforge.net/p/flightgear/simgear/ci/next/log/?path=/simgear/nasal/lib.c history])

=== append() ===
{{Nasal doc
|syntax = append(vector, element[, element[, ...]]);
|source = {{simgear file|simgear/nasal/lib.c|l=45|t=Source}}
|text = This function appends, or adds, the given element(s) to the end of the vector given in the first argument. Returns the vector operated on.
|param1 = vector
|param1text = The vector to which the arguments will be appended.
|param2 = element
|param2text = An element to be added to the vector.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector
append(vector, 4); # Append the number 4 to the end of the vector
debug.dump(vector); # Print the contents of the vector
|example2 =
var vector = [1, 2, 3]; # Initialize the vector
append(vector, 4, 5, 6); # Append the numbers 4, 5, and 6 to the end of the vector
debug.dump(vector); # Print the contents of the vector
}}

=== bind() ===
{{Nasal doc
|syntax = bind(function, locals[, outer_scope]);
|source = {{simgear file|simgear/nasal/lib.c|l=638|t=Source}}
|text = This creates a new function object. A function in Nasal is three things: the actual code, a hash/namespace of local variables available to the function namespace, and the closure object of that namespace. These correspond to the three arguments respectively.
|param1 = function
|param1text = Function to evaluate.
|param2 = locals
|param2text = Hash containing values that will become the namespace (first closure) for the function.
|param3 = outer_scope
|param3text = Optional function which is bound to the next closure. This can be bound to yet another, making a linked list.
|example1 = # This is a namespace/hash with a single member, named "key," which is initialized to 12
var Namespace = {
key: 12
};

# This is different namespace/hash containing a function
# dividing a variable "key" (which is unavailable/nil in this namespace) by 2
var AnotherNamespace = {
ret: func {
key /= 2;
}
};

# To see that key is not available, try to call AnotherNamespace.ret() first
call(AnotherNamespace.ret, [], nil, nil, var errors = []);
if(size(errors)){
print("Key could not be divided/resolved!");
debug.printerror(errors);
}

# Associate the AnotherNamespace.ret() function with the first namespace
# so that "key" is now available
var function = bind(AnotherNamespace.ret, Namespace);

# Invoke the new function
function();

# Print out the value of Namespace.key
# It was changed to 12 from 6 by AnotherNamespace.ret()
print(Namespace.key);
}}

=== call() ===
{{Nasal doc
|syntax = call(func[, args[, me[, locals[, error]]]);
|source = {{simgear file|simgear/nasal/lib.c|l=376|t=Source}}
|text = Calls the given function with the given arguments and returns the result. This function is very useful as it allows much more control over function calls and catches any errors or {{func link|die()}} calls that would normally trigger run-time errors cancelling execution of the script otherwise.
|param1 = func
|param1text = Function to execute.
|param2 = args
|param2text = Vector containing arguments to give to the called function.
|param3 = me
|param3text = <code>'''me'''</code> reference for the function call (i.e., for method calls). If given, this will override any <code>'''me'''</code> value existing in the namespace (locals argument).
|param4 = locals
|param4text = A hash with key/value pairs that will be available to the called function, typically used as the namespace for the function to be called.
|param5 = error
|param5text = A vector to append errors to. If the called function generates an error, the error, place, and line will be written to this. These errors can be printed using {{func link|printerror()|debug}}.
|example1 =
# prints "Called from call()"
call(func {
print("Called from call()");
});
|example2 =
# prints "a = 1 : b = 2
call(func(a, b){
print("a = ", a, " : b = ", b);
},
[1, 2]
);
|example3 =
var Hash = {
new: func {
var m = { parents: [Hash] };

m.el1 = "string1";
m.el2 = "string2";

return m;
}
};

# prints "me.el1 = string1", then "me.el2 = string2" on the next line
call(func(a, b){
print("me.el", a, " = ", me["el" ~ a]);
print("me.el", b, " = ", me["el" ~ b]);
},
[1, 2],
Hash.new()
);
|example4 =
# prints the value of math.pi
call(func {
print(pi);
}, nil, nil,
math
);
|example5 =
call(func {
print(math.ip); # math.ip doesn't exist
}, nil, nil, nil,
var errs = []
);
debug.printerror(errs); # The error is caught and printed using debug.printerror()
}}

=== caller() ===
{{Nasal doc
|syntax = caller([level]);
|source = {{simgear file|simgear/nasal/lib.c|l=540|t=Source}}
|text = Returns a vector containing a record from the current call stack. The level numbering starts from the currently executing function (level 0). Level 1 (the default) is the caller of the current function, and so on.

The result is a four-element vector containing '''[0]''' a hash of local variables, '''[1]''' the function object, '''[2]''' the full source file name (incl. path) and '''[3]''' the line number.
|param1 = level
|param1text = Optional integer specifying the stack level to return a result from. Defaults to 1 (i.e. the caller of the currently executing function).
|example1 =
var myFunction = func(a, b) {
debug.dump(caller(0)[0]); # prints a hash of local variables, including arguments a and b
return 2 * 2;
};

print("2 x 2 = ", myFunction(2, 2));
|example2 =
var get_arg_value = func() {
print("Argument to myFunc = ", caller(1)[0]['a']); # print the value of myFunc's single argument, using caller()
};

var myFunc = func(a) {
get_arg_value();
};

myFunc(3);
|example3text = This is a real example taken from {{fgdata file|Nasal/canvas/MapStructure.nas}}. Function <code>r()</code> (above the TODOs) returns a hash with the key/value pairs as per its arguments. For example, something like this is returned: <code>{ name: "<name>", vis: true, zindex: nil }</code>.
|example3 =
var MapStructure_selfTest = func() {
var temp = {};
temp.dlg = canvas.Window.new([600, 400], "dialog");
temp.canvas = temp.dlg.createCanvas().setColorBackground(1, 1, 1, 0.5);
temp.root = temp.canvas.createGroup();

var testMap = temp.root.createChild("map");
testMap.setController("Aircraft position");
testMap.setRange(25); # TODO: implement zooming/panning via mouse/wheel here, for lack of buttons :-/
testMap.setTranslation(
temp.canvas.get("view[0]") / 2,
temp.canvas.get("view[1]") / 2,
);

var r = func(name, vis = true, zindex = nil) {
return caller(0)[0];
}

# TODO: we'll need some z-indexing here, right now it's just random
# TODO: use foreach/keys to show all layers in this case by traversing SymbolLayer.registry directly ?
# maybe encode implicit z-indexing for each lcontroller ctor call ? - i.e. preferred above/below order ?
var types = [
r('TFC', false),
r('APT'),
r('DME'),
r('VOR'),
r('NDB'),
r('FIX', false),
r('RTE'),
r('WPT'),
r('FLT'),
r('WXR'),
r('APS'),
];

foreach (var type; types) {
testMap.addLayer(
factory: canvas.SymbolLayer,
type_arg: type.name,
visible: type.vis,
priority: type.zindex,
);
}
}; # MapStructure_selfTest
}}

=== chr() ===
{{Nasal doc
|syntax = chr(code);
|source = {{simgear file|simgear/nasal/lib.c|l=240|t=Source}}
|text = Returns a character as per the single argument. Extended ASCII is supported (see http://www.asciitable.com/ for a list of supported characters), although this may vary between different systems. For a list of the most commonly used characters, see the {{wikipedia|ASCII#ASCII printable code chart|ASCII printable code chart}} ('''Dec''' column). The following table lists supported control characters, along with their equivalent control characters in Nasal strings. {{Note|In Nasal, only strings enclosed with double-quotes (<code>"string"</code>) supports control chracters. Strings in single quotes (<code>'string'</code>) do not.}}
{{{!}} class="wikitable"
! Code !! Name !! Equivalent to
{{!-}}
{{!}} 10 {{!!}} {{Wikipedia|Newline}} {{!!}} <code>\n</code>
{{!-}}
{{!}} 9 {{!!}} {{Wikipedia|Tab key#Tab characters|Horizontal tab}} {{!!}} <code>\t</code>
{{!-}}
{{!}} 13 {{!!}} {{Wikipedia|Carriage return}} {{!!}} <code>\r</code>
{{!}}}
|param1 = code
|param1text = Integer character code for the desired glyph.
|example1 = print("Code 65 = ", chr(65)); # prints "Code 65 = A"
|example2text = This example displays all of the characters in a list, in the format <code>Code '''n''' = >'''char'''<</code>, '''n''' being the index, and '''char''' being the character.
|example2 =
for(var i = 0; i <= 255; i += 1){
print("Code ", i, " = >", chr(i), "<");
}
}}

=== closure() ===
{{Nasal doc
|syntax = closure(func[, level]);
|source = {{simgear file|simgear/nasal/lib.c|l=557|t=Source}}
|text = Returns the hash table containing the lexical namespace of the given function. The level numbering start with level 0 being the namespace of '''func'''.
|param1 = func
|param1text = Function to evaluate.
|param2 = level
|param2text = Optional integer specifying the scope level. Defaults to 0 (the namespace of '''func''').
|example1 =
var get_math_e = func {
return e; # return the value of math.e
}

var myFunction = bind(get_math_e, math); # bind get_math_e to the math namespace, so that math.e is immediately available to get_math_e
debug.dump(closure(myFunction)); # print the hash of the namespace "get_math_e"

print(myFunction());
}}

=== cmp() ===
{{Nasal doc
|syntax = cmp(a, b);
|source = {{simgear file|simgear/nasal/lib.c|l=169|t=Source}}
|text = Compares two strings, returning -1 if '''a''' is less than '''b''', 0 if they are identical and 1 if '''a''' is greater than '''b'''.
|param1 = a
|param1text = First string argument for comparison.
|param2 = b
|param2text = Second string argument for comparison.
|example1 = print(cmp("1", "two")); # prints -1
|example2 = print(cmp("string", "string")); # prints 0
|example3 = print(cmp("one", "2")); # prints 1
|example4 = print(cmp("string1", "string2")); # prints -1
}}

=== compile() ===
{{Nasal doc
|syntax = compile(code[, filename]);
|source = {{simgear file|simgear/nasal/lib.c|l=349|t=Source}}
|text = Compiles the specified code string and returns a function object bound to the current lexical context. If there is an error, the function dies, with the argument to {{func link|die()}} being '''filename'''.
|param1 = code
|param1text = String containing Nasal code to be compiled.
|param2 = filename
|param2text = Optional string used for error messages/logging. Defaults to <code><compile></code>
|example1 =
var myCode = 'print("hello");';
var helloFunc = compile(myCode, "myCode");
helloFunc();
|example2text = <code>compile</code> is very convenient to support Nasal loaded from other files. For instance, [[PropertyList XML files]] (such as GUI dialogs) may contain embedded Nasal sections that need to be parsed, processed and compiled. For an example of how to do this, save the below XML code as <tt>''[[$FG_ROOT]]/gui/dialogs/test.xml''</tt>.
<syntaxhighlight lang="xml">
<?xml version="1.0"?>

<PropertyList>

<nasal><![CDATA[
print("You have FlightGear v", getprop("/sim/version/flightgear"));
]]></nasal>

</PropertyList>
</syntaxhighlight>
Now, start FlightGear and execute this code in the [[Nasal Console]].
|example2 =
# Build the path
var FGRoot = getprop("/sim/fg-root");
var filename = "/gui/dialogs/test.xml";
var path = FGRoot ~ filename;

var blob = io.read_properties(path);
var script = blob.getValues().nasal; # Get the nasal string

# Compile the script. We're passing the filename here for better runtime diagnostics
var code = call(func {
compile(script, filename);
}, nil, nil, var compilation_errors = []);

if(size(compilation_errors)){
die("Error compiling code in: " ~ filename);
}

# Invoke the compiled script, equivalent to code();
# We're using call() here to detect errors:
call(code, [], nil, nil, var runtime_errors = []);

if(size(runtime_errors)){
die("Error calling code compiled loaded from: " ~ filename);
}
|example3text = The <code>compile()</code> function also allows you to parse a JSON string into a hash. Simplest example:
|example3 =
var jsonFunc = compile('{"version":"1.2.0","author":{"name":"John"} }');
var json = jsonFunc(); # return hash
logprint(LOG_ALERT, json["version"]); # print "1.2.0"
logprint(LOG_ALERT, json["author"]["name"]); # print "John"
}}

=== contains() ===
{{Nasal doc
|syntax = contains(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=249|t=Source}}
|text = Returns 1 (True) if the hash contains the specified key, or 0 (False) if not.
|param1 = hash
|param1text = The hash to search in.
|param2 = key
|param2text = The scalar to be searched for, contained as a key in the hash.
|example1 =
# Initialize a hash
var hash = {
element: "value"
};
print(contains(hash, "element") ? "Yes" : "No"); # This will print "Yes"
print(contains(hash, "element2") ? "Yes" : "No"); # This will print "No"
}}

===contains()===
{{Requires commit|desc=Vector support|details=see {{Merge-request|project=fgdata|id=305}}|commit=ee39abbd3b70c9b6d5e3a1c4ccedddaac1a92b11|repo=Simgear}}
{{Nasal doc
|syntax = contains(vector, item);
|source = {{simgear file|simgear/nasal/lib.c|l=249|t=Source}}
|text = Returns 1 (True) if the vector contains the specified item, or 0 (False) if not.
|param1 = vector
|param1text = The vector to search in.
|param2 = item
|param2text = The object to be searched for in the vector.
|example1 =
# Initialize a vector
var vec = ["element", "foo"];
print(contains(vec, "element") ? "Yes" : "No"); # This will print "Yes"
print(contains(vec, "element2") ? "Yes" : "No"); # This will print "No"
}}

===delete() ===
{{Nasal doc
|syntax = delete(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=118|t=Source}}
|text = Deletes the key from the hash if it exists. Operationally, this is NOT identical to setting the hash value specified by the key to <code>'''nil'''</code> as the key will stay in the hash (at least for a while). This variant potentially frees storage by deleting the reference to the key and by shrinking the hash. Returns the hash that has been operated on.
|param1 = hash
|param1text = The hash from which to delete the key.
|param2 = key
|param2text = The scalar to be deleted, contained as a key in the hash.
|example1 =
# Initialize the hash
var hash = {
element1: "value1",
element2: "value2"
};
delete(hash, "element1"); # Delete element1
debug.dump(hash); # prints the hash, which is now minus element1
}}

===die()===
{{Nasal doc
|syntax = die(error);
|source = {{simgear file|simgear/nasal/lib.c|l=417|t=Source}}
|text = Terminates execution and unwinds the stack. The place and the line will be added to the '''error'''. This invokes the same internal exception handler used for internal runtime errors. Use this to signal fatal errors, or to implement exception handling. The error thrown (including internal runtime errors) can be caught with {{func link|call()}}.
|param1 = error
|param1text = String describing the error.
:{{inote|This parameter is technically optional, but it is highly recommended to use it.}}
|example1 =
print("Will print");
die("Don't go any further!");
print("Won't print"); # Will not be printed because die() stops the process
}}

=== find()===
{{Nasal doc
|syntax = find(needle, haystack);
|source = {{simgear file|simgear/nasal/lib.c|l=586|t=Source}}
|text = Finds and returns the index of the first occurrence of the string '''needle''' in the string '''haystack''', or -1 if no such occurrence was found.
|param1 = needle
|param1text = String to search for.
|param2 = haystack
|param2text = String to search in.
|example1 = print(find("c", "abcdef")); # prints 2
|example2 = print(find("x", "abcdef")); # prints -1
|example3 = print(find("cd", "abcdef")); # prints 2
}}

===ghosttype()===
{{Nasal doc
|syntax = ghosttype(ghost);
|source = {{simgear file|simgear/nasal/lib.c|l=336|t=Source}}
|text = Returns a string containing either a descriptive name of a ghost (a raw C/C++ object), or a unique id (the pointer to the C/C++ <code>naGhostType</code> instance) if no name has been set. Ghost is an acronym that stands for '''G'''arbage-collected '''H'''andle to '''O'''ut'''S'''ide '''T'''hingy.
|param1 = ghost
|param1text = Ghost to return a description for.
|example1 = print(ghosttype(airportinfo())); # prints "airport"
}}

===id()===
{{Nasal doc
|syntax = id(object);
|source = {{simgear file|simgear/nasal/lib.c|l=706|t=Source}}
|text = Returns a string containing information on the type and ID of the object provided in the single argument. The information is returned in the form of <code>'''<type>''':'''<id>'''</code>, where '''<type>''' is the type of object, and '''<id>''' is the ID.
|param1 = object
|param1text = Can be either of a string, a vector, a hash, a code, a function, or a ghost.
|example1 = print(id("A")); # prints "str:000000001624A590"
}}

===int() ===
{{Nasal doc
|syntax = int(number);
|source = {{simgear file|simgear/nasal/lib.c|l=125|t=Source}}
|text = Returns the integer part of the numeric value of the single argument, or <code>'''nil'''</code> if none exists.
|param1 = number
|param1text = Number or string with just a number in it to return an integer from.
|example1 = print(int(23)); # prints "23"
|example2 = print(int(23.123)); # prints "23"
|example3 = debug.dump(int("string")); # prints "nil"
}}

===keys()===
{{Nasal doc
|syntax = keys(hash);
|source = {{simgear file|simgear/nasal/lib.c|l=36|t=Source}}
|text = Returns a vector containing the list of keys found in the single hash argument.
|param1 = hash
|param1text = The hash to return the keys from.
|example1 =
# Initialize a hash
var hash = {
element1: "value",
element2: "value"
};
debug.dump(keys(hash)); # print the vector
}}

===left()===
{{Nasal doc
|syntax = left(string, length);
|source = {{simgear file|simgear/nasal/lib.c|l=214|t=Source}}
|version = 2.12
|commit = {{simgear commit|bd7163|t=commit}}
|text = Returns a substring of '''string''', starting from the left.
|param1 = string
|param1text = String to return part of.
|param2 = length
|param2text = Integer specifying the length of the substring to return.
|example1 = print(left("string", 2)); # prints "st"
}}

=== num()===
{{Nasal doc
|syntax = num(number);
|source = {{simgear file|simgear/nasal/lib.c|l=149|t=Source}}
|text = Returns the numerical value of the single string argument, or <code>'''nil'''</code> if none exists.
|param1 = number
|param1text = String with just a number in it to return a number from.
|example1 = print(num("23")); # prints "23"
|example2 = print(num("23.123")); # prints "23.123"
|example3 = debug.dump(num("string")); # prints "nil"
}}

===pop()===
{{Nasal doc
|syntax = pop(vector);
|source = {{simgear file|simgear/nasal/lib.c|l=85|t=Source}}
|text = Removes and returns the last element of the single vector argument, or <code>'''nil'''</code> if the vector is empty.
|param1 = vector
|param1text = Vector to remove an element from.
|example1 =
var vector = [1, 2, 3];
pop(vector);
debug.dump(vector); # prints "[1, 2]"
|example2 =
var vector = [1, 2, 3];
debug.dump(pop(vector)); # prints "3"
|example3 =
var vector = [];
debug.dump(pop(vector)); # prints "nil"
}}

=== range() ===
{{Nasal doc
|syntax = range([start, ]stop[, step]);
|source = {{simgear file|simgear/nasal/lib.c|l=756|t=Source}}
|text = Creates a vector of numbers starting from <code>start</code> (default 0) up to but not including <code>stop</code>, incremented by <code>step</code> (default 1). Note: To specify <code>step</code>, you must also provide <code>start</code>; otherwise the second argument is interpreted as <code>stop</code>.
|param1 = start
|param1text = Optional. The starting number of the sequence. Defaults to 0 if omitted. Required if you want to specify <code>step</code>.
|param2 = stop
|param2text = Required. The number at which to stop the sequence (not included).
|param3 = step
|param3text = Optional. The increment between each number in the sequence. Defaults to 1. Only valid if <code>start</code> is also specified.
|example1 =
var vec = range(5); # Creates a vector [0, 1, 2, 3, 4]
var vec = range(2, 5); # Creates a vector [2, 3, 4]
var vec = range(0, 10, 2); # Creates a vector [0, 2, 4, 6, 8]
var vec = range(0, 0); # Creates an empty vector []
var vec = range(0, 1); # Creates a vector [0]
}}

=== remove() ===
{{Nasal doc
|syntax = remove(vector, value);
|source = {{simgear file|simgear/nasal/lib.c|l=53|t=Source}}
|text = Removes all elements equal to the given value from a vector and returns the modified vector.
|param1 = vector
|param1text = The vector from which elements are to be removed.
|param2 = value
|param2text = A value to remove from the vector.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector.
remove(vector, 2); # Remove the value 2 from the vector.
debug.dump(vector); # Print the contents of the vector: "[1, 3]".
|example2 =
var vector = ["text", "text", "text"]; # Initialize the vector.
remove(vector, "text"); # Remove the value "text" from the vector.
debug.dump(vector); # Print the contents of the vector: "[]".
}}

=== removeat() ===
{{Nasal doc
|syntax = removeat(vector, index);
|source = {{simgear file|simgear/nasal/lib.c|l=72|t=Source}}
|text = Removes the element at the specified index from the vector and returns it.
|param1 = vector
|param1text = The vector from which the element will be removed.
|param2 = index
|param2text = Index of the item to be deleted.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector.
removeat(vector, 0); # Remove the index 0 from the vector.
debug.dump(vector); # Print the contents of the vector: "[2, 3]".
}}

===right()===
{{Nasal doc
|syntax = right(string, length);
|source = {{simgear file|simgear/nasal/lib.c|l=226|t=Source}}
|version = 2.12
|commit = {{simgear commit|bd7163|t=commit}}
|text = Returns a substring of '''string''', starting from the right.
|param1 = string
|param1text = String to return part of.
|param2 = length
|param2text = Integer specifying the length of the substring to return.
|example1 = print(right("string", 2)); # prints "ng"
}}

=== setsize()===
{{Nasal doc
|syntax = setsize(vector, size);
|source = {{simgear file|simgear/nasal/lib.c|l=91|t=Source}}
|text = Sets the size of a vector. The first argument specifies a vector, the second a number representing the desired size of that vector. If the vector is currently larger than the specified size, it is truncated. If it is smaller, it is padded with <code>'''nil'''</code> entries. Returns the vector operated upon.
|param1 = vector
|param1text = The vector to be operated on.
|param2 = size
|param2text = The desired size of the vector in number of entries.
|example1 =
var vector = [1, 2, 3]; # Initialize a vector
setsize(vector, 4);
debug.dump(vector); # print the vector "[1, 2, 3, nil]"
|example2 =
var vector = [1, 2, 3]; # Initialize a vector
setsize(vector, 2);
debug.dump(vector); # print the vector "[1, 2]"
}}

===size()===
{{Nasal doc
|syntax = size(object);
|source = {{simgear file|simgear/nasal/lib.c|l=26|t=Source}}
|text = Returns the size of the single argument. For strings, this is the length in bytes. For vectors, this is the number of elements. For hashes, it is the number of key/value pairs. If the argument is <code>'''nil'''</code> or a number, this error will be thrown: <code>object has no size()</code>.
|param1 = object
|param1text = Object to find the size of. Must be a string, a vector or a hash.
|example1 =
var string = "string";
print(size(string)); # prints "6"
|example2 =
var vector = [1, 2, 3];
print(size(vector)); # prints "3"
|example3 =
var hash = {
element1: "value1",
element2: "value2",
element3: "value3"
};
print(size(hash)); # prints "3"
}}

=== sort()===
{{Nasal doc
|syntax = sort(vector, function);
|source = {{simgear file|simgear/nasal/lib.c|l=678|t=Source}}
|text = Returns a vector containing the elements in the input '''vector''' sorted in according to the rule given by '''function'''. Implemented with the ANSI C {{func link|qsort()|link=http://www.cplusplus.com/reference/cstdlib/qsort/}}, <code>sort()</code> is stable. This means that if the rules in the first example are used, equal elements in the output vector will appear in the same relative order as they do in the input. It is run in a loop, so '''function''' is run several times.
|param1 = vector
|param1text = Input vector to sort.
|param2 = function
|param2text = Function according to which the elements will be sorted by. It should take two arguments and should return one of 1, 0, or -1.
{{{!}} class="wikitable"
! Return value !! Meaning
{{!-}}
{{!}} less than 0 {{!!}} first argument should go before second argument
{{!-}}
{{!}} 0 {{!!}} first argument equals second argument
{{!-}}
{{!}} greater than 0 {{!!}} first argument should go after second argument
{{!}}}

|example1text = This example sorts elements from smallest to greatest.
|example1 =
var sort_rules = func(a, b) {
if (a < b) {
return -1; # A should before b in the returned vector
} elsif (a == b) {
return 0; # A is equivalent to b
} else {
return 1; # A should after b in the returned vector
}
}
debug.dump(sort([3, 2, 5, 6, 4, 1], sort_rules)); # prints "[1, 2, 3, 4, 5, 6]"
|example2text = This example sorts elements from greatest to smallest.
|example2 =
# Outputs the elements in reverse order (greatest to smallest)
var sort_rules = func(a, b) {
if (a < b) {
return 1; # -1 in the above example
} elsif (a == b) {
return 0;
} else {
return -1; # 1 in the above example
}
}
debug.dump(sort([3, 2, 5, 6, 4, 1], sort_rules)); # prints "[6, 5, 4, 3, 2, 1]"
|example3text = This example sorts a vector of strings (runways for example) from smallest to greatest.
|example3 =
var runways = ["09R", "27R", "26L", "09L", "15"];
var rwy = sort(runways, func(a, b) cmp(a, b));
debug.dump(rwy); # prints ['09L', '09R', '15', '26L', '27R']
}}

=== split()===
{{Nasal doc
|syntax = split(delimiter, string);
|source = {{simgear file|simgear/nasal/lib.c|l=596|t=Source}}
|text = Splits the input string into a vector of substrings bounded by occurrences of the delimiter substring. See [[Nasal_library/string#string.join(sep,list)|string.join()]].
|param1 = delimiter
|param1text = String that will split the substrings in the returned vector.
|param2 = string
|param2text = String to split up.
|example1 = debug.dump(split("cd", "abcdef")); # prints "['ab', 'ef']"
|example2 = debug.dump(split(".", "3.2.0")); # prints "[3, 2, 0]"
|example3 = debug.dump(split("/", "path/to/file")); # prints "['path', 'to', 'file']"
}}

===sprintf()===
{{Nasal doc
|syntax = <nowiki>sprintf(format[, arg[, arg, [...]]]);</nowiki>
|source = {{simgear file|simgear/nasal/lib.c|l=491|t=Source}}
|text = Creates and returns a string formatted using ANSI C {{func link|vsnprintf()|link=http://en.cppreference.com/w/c/io/vfprintf}} <ref>
{{Cite web
|url = http://sourceforge.net/p/flightgear/simgear/ci/next/tree/simgear/nasal/lib.c#l308
|title = fgdata/simgear/simgear/nasal/lib.c, line 308
|accessdate = October 2015
}}
</ref>. Below is a table of supported format specifiers.
{{{!}} class="wikitable" width="75%"
{{!}}+ %[flags][width][.precision]specifier
! colspan="2" {{!}} Flags
{{!-}}
! Flag !! Output
{{!-}}
{{!}} <code>+</code> {{!!}} Forces to precede the result with a plus or minus sign ('''+''' or '''-''') even for positive numbers. By default, only negative numbers are preceded with a '''-''' sign.
{{!-}}
{{!}} ''space'' {{!!}} Prefixes non-signed numbers with a space.
{{!-}}
{{!}} <code>-</code> {{!!}} Left-align the output of this placeholder (the default is to right-align the output) when the width option is specified.
{{!-}}
{{!}} <code>0</code> {{!!}} Use 0 instead of spaces to pad a field when the width option is specified.
{{!-}}
{{!}} <code>#</code> {{!!}} Used with <code>o</code>, <code>x</code> or <code>X</code> specifiers the value is preceded with <tt>0</tt>, <tt>0x</tt> or <tt>0X</tt> respectively for values different than zero. Used with <code>e</code>, <code>E</code> and <code>f</code>, it forces the written output to contain a decimal point even if no digits would follow. By default, if no digits follow, no decimal point is written. Used with <code>g</code> or <code>G</code> the result is the same as with <code>e</code> or <code>E</code> but trailing zeros are not removed.
{{!-}}
! colspan="2" {{!}} Width
{{!-}}
{{!}} colspan="2" {{!}} Integer specifying the minimum number of characters to be returned. This includes the decimal point and decimal fraction as well as + or - signs.
{{!-}}
! colspan="2" {{!}} Precision
{{!-}}
{{!}} colspan="2" {{!}} Integer preceded by a dot specifying the number of decimal places to be written.
{{!-}}
! colspan="2" {{!}} Specifiers
{{!-}}
! Specifier !! Output
{{!-}}
{{!}} <code>d</code>, <code>i</code> {{!!}} Signed decimal number.
{{!-}}
{{!}} <code>s</code> {{!!}} A string
{{!-}}
{{!}} <code>%</code> {{!!}} Percent (%) character.
{{!-}}
{{!}} <code>c</code> {{!!}} A single character assigned to a character code, the code given in an integer argument. See http://www.asciitable.com/ for a list of supported characters and their codes.
{{!-}}
{{!}} <code>o</code> {{!!}} Unsigned integer as an octal number.
{{!-}}
{{!}} <code>u</code> {{!!}} Unsigned decimal integer.
{{!-}}
{{!}} <code>x</code>, <code>X</code> {{!!}} Unsigned integer as a hexadecimal number. If <code>x</code> is used, any letters in the number are lowercase, while <code>X</code> gives uppercase.
{{!-}}
{{!}} <code>e</code>, <code>E</code> {{!!}} Double value in scientific notation (i.e., ''[-]ddd.ddd'''e'''[+/-]ddd''), with an exponent being denoted by <tt>e</tt> or <tt>E</tt> depending on whether an upper or lowercase is used respectively.
{{!-}}
{{!}} <code>f</code> {{!!}} Floating-point number, in fixed decimal notation, by default with 6 decimal places.
{{!-}}
{{!}} <code>F</code> {{!!}} Appears to be available<ref>
{{Cite web
|url = http://sourceforge.net/p/flightgear/simgear/ci/next/tree/simgear/nasal/lib.c#l389
|title = fgdata/simgear/simgear/nasal/lib.c, line 389
|accessdate = October 2015
}}
</ref>, but doesn't work.
{{!-}}
{{!}} <code>g</code>, <code>G</code> {{!!}} Double in either normal or exponential notation, whichever is more appropriate for its magnitude. <code>g</code> uses lower-case letters, <code>G</code> uses upper-case letters. This type differs slightly from fixed-point notation in that insignificant zeroes to the right of the decimal point are not included. Also, the decimal point is not included on whole numbers.
{{!}}}

|param1 = format
|param1text = String specifying the format. Can be used with or without a format specifiers. See below for examples.
|param2 = arg
|param2text = Argument specifying a value to replace a format placeholder (such as <code>%d</code>) in the format string. Not required if there are no format specifiers.

|example1 = print(sprintf("%i", 54)); # prints "54"
|example2 = print(sprintf("Pi = %+.10f", math.pi)); # prints "Pi = +3.1415926536"
|example3 =
print(sprintf("%6d", 23)); # prints " 23"
print(sprintf("%06d", 23)); # prints "000023"
|example4 =
var FGVer = getprop("/sim/version/flightgear");
print(sprintf("You have FlightGear v%s", FGVer)); # prints "You have FlightGear v<your version>"
|example5 =
print(sprintf("Hexadecimal 100000 = %X", 100000)); # prints "Hexadecimal 100000 = 186A0"
print(sprintf("Hexadecimal 100000 = %x", 100000)); # prints "Hexadecimal 100000 = 186a0"
|example6 = print(sprintf("Code 65 is %c", 65)); # prints "Code 65 is A"
|example7 =
print(sprintf("%e", 54)); # prints "5.400000e+001"
print(sprintf("%E", 54)); # prints "5.400000E+001"
|example8 = print(sprintf("%o", 54)); # prints "66"
|example9 = print(sprintf("50%% of 100 is %i", 100 / 2)); # prints "50% of 100 is 50"
|example10 =
print(sprintf("%.2f", 1.4)); # prints "1.40"
print(sprintf("%.1f", 1.4)); # prints "1.4"
print(sprintf("% 4.1f", 1.4)); # prints " 1.4"
print(sprintf("%04.1f", 1.4)); # prints "01.4"
print(sprintf("% 6.1f", 1.4)); # prints " 1.4"
print(sprintf("%06.1f", 1.4)); # prints "0001.4"
}}

===str()===
{{Nasal doc
|syntax = str(value);
|source = {{simgear file|simgear/nasal/lib.c|l=186|t=Source}}
|text = Convert given value (scalar) to string. If <code>value</code> is a number, it will be converted to a string. If <code>value</code> is a string, the same string will be returned. If <code>value</code> is not a scalar (hash, vector, nil), <code>nil</code> will be returned.
|param1 = value
|param1text = The value to convert to string.
|example1 =
var result = str(true); # result is a string "1"
var result = str(false); # result is a string "0"
var result = str(12); # result is a string "12"
var result = str(12.5); # result is a string "12.5"
var result = str(-12.5); # result is a string "-12.5"
var result = str("12.5"); # result is a string "12.5"
var result = str([1, 2]); # result is a nil
var result = str({ x: 0 }); # result is a nil
var result = str(nil); # result is a nil
}}

===streq()===
{{Nasal doc
|syntax = streq(a, b);
|source = {{simgear file|simgear/nasal/lib.c|l=164|t=Source}}
|text = Tests the string values of the two arguments for equality. This function is needed because the <code>'''=='''</code> operator (see [[Nasal_Operators#Equality|Nasal Operators]]) tests for numeric equality first. If either or both the arguments are not strings, 0 (False) will be returned. Returns either 0 (False) or 1 (True). {{Note|This function is rarely required in typical code.}}
|param1 = a
|param1text = First argument for testing equality.
|param2 = b
|param2text = Second argument for testing equality.
|example1 = print(streq("0", "0")); # prints "1" (True)
|example2 =
print(0 == 0.0); # prints "1" (True)
print(streq("0", "0.0")); # prints "0" (False)
}}

===substr()===
{{Nasal doc
|syntax = substr(string, start [, length]);
|source = {{simgear file|simgear/nasal/lib.c|l=194|t=Source}}
|text = Similar the {{func link|subvec()}}, but operates on strings. Computes and returns a substring. The first argument specifies a string, the second is the index of the start of a substring, the optional third argument specifies a length (the default is to return the rest of the string from the start).
|param1 = string
|param1text = String to return a substring from.
|param2 = start
|param2text = Integer specifying the start of a substring. Negative values specify a position from the end of the string.
|param3 = length
|param3text = Optional argument specifying the length of the substring. Defaults to the end of the string.
|example1 = print(substr("abcde", 1, 3)); # prints "bcd"
|example2 = print(substr("abcde", 1)); # prints "bcde"
|example3 = print(substr("abcde", 2, 1)); # prints "c"
|example4 = print(substr("abcde", -2)); # prints "de"
|example5 = print(substr("abcde", -3, 2)); # prints "cd"
}}

===subvec()===
{{Nasal doc
|syntax = subvec(vector, start[, length]);
|source = {{simgear file|simgear/nasal/lib.c|l=98|t=Source}}
|text = Returns a sub-range of a vector. The first argument specifies a vector, the second a starting index, and the optional third argument indicates a length (the default is to the end of the vector).
|param1 = vector
|param1text = The vector to take the sub-vector from.
|param2 = start
|param2text = The starting point of the sub-vector within the given vector.
|param3 = length
|param3text = Optional argument specifying the length of the sub-vector, from the starting point.
'''Notes:'''
* Omitting the ''vector'' and ''start'' arguments is not an error (possibly it should be) but the return value is ''nil''.
* A negative ''start'' argument ''is'' an error. This seems wrong. Perhaps the language designer could comment.
* A value of ''start'' greater than ''size(vector)'' causes an error. A value equal to ''size(vector)'' returns an empty vector.
* If the value of ''length'' is greater than ''size(vector) - start'' then it is ignored. That is, all elements from ''start'' to the end of ''vector'' are returned. If ''length'' is zero then an empty vector is returned. A negative value of ''length'' causes an error.
|example1 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 0)); # prints "[1, 2, 3]"
|example2 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 1)); # prints "[2, 3]"
|example3 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 1, 1)); # prints "[2]"
}}

=== typeof()===
{{Nasal doc
|syntax = typeof(object);
|source = {{simgear file|simgear/nasal/lib.c|l=287|t=Source}}
|text = Returns a string indicating the whether the object is <code>'''nil'''</code>, a scalar (number or string), a vector, a hash, a function, or a ghost.
|param1 = object
|param1text = Object to return the type of.
|example1 =
var object = nil;
print(typeof(object)); # prints "nil"
|example2 =
var object = "Hello world!";
print(typeof(object)); # prints "scalar"
|example3 =
var object = math.pi;
print(typeof(object)); # prints "scalar"
|example4 =
var object = [1, 2, 3];
print(typeof(object)); # prints "vector"
|example5 =
var object = {};
print(typeof(object)); # prints "hash"
|example6 =
var object = func {};
print(typeof(object)); # prints "func"
|example7 =
var object = airportinfo();
print(typeof(object)); # prints "ghost"
}}



==Extension functions==
The '''extension functions''' are global functions that have been added to Nasal since its integration into FlightGear. Unlike the core library functions, they are generally specifically designed to interact directly with FlightGear. Extension functions come from three source files:
*{{flightgear file|src/Scripting/NasalPositioned.cxx}}
*{{flightgear file|src/Scripting/NasalSys.cxx}}
*{{fgdata file|Nasal/globals.nas}}

===abort()===
{{Nasal doc
|syntax = abort();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=565|t=Source}}
|text = This function is a wrapper for the C++ {{func link|abort()|link=http://www.cplusplus.com/reference/cstdlib/abort/}} function. It simply aborts FlightGear with an error, which varies depending on the operating system. This function should not really be used; instead, please use the "exit" [[Fgcommands|fgcommand]], which will exit FlightGear more gracefully (see example below).
|example1text = This example will immediately stop FlightGear with an error, such as "FlightGear has stopped working."
|example1 = abort();
|example2text = For exiting FlightGear in a better way, please use the following code:
|example2 = fgcommand("exit");
}}

=== abs() ===
{{Nasal doc
|syntax = abs(number);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = This simple function returns the {{wikipedia|absolute value|noicon=1}} of the provided number.
|param1 = number
|param1text = This argument is required and should be a number.
|example1 = print(abs(1)); # prints "1"
|example2 = print(abs(-1)); # prints "1"
}}

===aircraftToCart() ===
This new function in FG 2017.2.1 takes coordinates in aircraft structural coordinate system, and translate them into geocentric coordinates.
Example for (5,6,7):
<syntaxhighlight lang="nasal">
var pos = aircraftToCart({x: -5, y: 6, z: -7});
var coord = geo.Coord.new();
coord.set_xyz(pos.x, pos.y, pos.z);
</syntaxhighlight>
Notice: x and z is inverted sign on purpose.
if you want lat. lon, alt from that, just call: (degrees and meters)

<syntaxhighlight lang="nasal">
coord.lat()
coord.lon()
coord.alt()
</syntaxhighlight>

===addcommand() ===
{{Nasal doc
|syntax = addcommand(name, code);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=659|t=Source}}
|version = 2.12
|commit = {{flightgear commit|7b663c|t=commit}}
|text = {{see also|Howto:Add new fgcommands to FlightGear}}

This function enables the addition of a new custom [[fgcommands|fgcommand]] to FlightGear from within Nasal. An fgcommand created using this method can be used in exactly the same way as the built-in fgcommands. Also, an fgcommand created via this method will always return True or 1, like all other fgcommands.
|param1 = name
|param1text = This will become the name of the new fgcommand. Must be a string.
|param2 = code
|param2text = The code that will be executed when the fgcommand is run. Must be a function.
|example1text = This example adds a new fgcommand and then runs it. Although it executes a simple {{func link|print()}} statement, any valid Nasal code can be used.
|example1 = addcommand("myFGCmd", func(node) {
print("fgcommand 'myFGCmd' has been run.");
props.dump( node );
});
fgcommand("myFGCmd", props.Node.new({foo:1, bar:2}) );
|example2text = This example demonstrates how parameters are defined in a new fgcommand.
|example2 = addcommand("myFGCmd", func(node){
print(node.getNode("number").getValue()); # prints the value of "number," which is 12
});
fgcommand("myFGCmd", props.Node.new({"number": 12}));
}}

===airportinfo()===
{{Nasal doc
|syntax = airportinfo();
airportinfo(type);
airportinfo(id);
airportinfo(lat, lon[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1024|t=Source}}
|text = Function for retrieval of airport, heliport, or seaplane base information. It returns a Nasal ghost; however, its structure is like that of a Nasal hash. The following information is returned:
* '''parents''': A vector containing a hash of various functions to access information about the runway. These functions are:
** '''findBestRunwayForPos()''' return runway as ghost by given geo position, e.g. <code>var rwy = airportinfo().findBestRunwayForPos(geo.aircraft_position());</code>.
** '''runway()''' return runway as ghost by runway ID, e.g. <code>var rwy = airportinfo().runway("18R");</code>.
** '''runwaysWithoutReciprocals()''' return vector of runways as ghost.
** '''helipad()''' return helipad as ghost by helipad ID, e.g. <code>var heli = airportinfo().helipad("H19");</code>.
** '''tower()''' return hash with <code>lat</code>, <code>lon</code>, <code>elevation</code> fields.
** '''comms()''' return vector of hashes, each hash with <code>frequency</code> and <code>ident</code> fields.
** '''sids()''' return vector of strings with SID IDs.
** '''stars()''' return vector of strings with STAR IDs.
** '''getApproachList()''' return vector of string with approaches.
** '''parking()''' return vector of hashes, each hash with <code>lat</code>, <code>lon</code>, <code>elevation</code>, <code>name</code> fields.
** '''getSid()''' return SID as ghost, e.g. <code>var sid = airportinfo().getSid("SA1A");</code>.
** '''getStar()''' return STAR as ghost, e.g. <code>var star = airportinfo().getStar("KEILA1");</code>.
** '''getIAP()''' return IAP as ghost, e.g. <code>var iap = airportinfo().getIAP("ILS02");</code>.
** '''getApproach()''' return approach as ghost, e.g. <code>var approach = airportinfo().getApproach("ILS02");</code>.
** '''tostring()''' just return string "an airport ICAO".
** See also {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1902}}.
* '''lon''': Longitude of the location.
* '''lat''': Latitude of the location.
* '''has_metar''': True or false depending whether the airport has a [[METAR]] code defined for it.
* '''elevation''': Elevation of the location in metres.
* '''id''': ICAO code of the airport (or ID of the seaplane base/heliport).
* '''name''': Name of the airport/heliport/seaplane base.
* '''runways'''
** '''<runway name>'''
*** '''id''': Name of runway.
*** '''lat''': Latitude of the runway.
*** '''lon''': Longitude of the runway.
*** '''heading''': True heading of the runway.
*** '''length''': Length of the runway in metres.
*** '''width''': Width of the runway in metres.
*** '''surface''': Runway surface type.
*** '''threshold''': Length of the runway's {{wikipedia|displaced threshold}} in metres. Will return 0 if there is none.
*** '''stopway''': Length of the runway's stopway (the area before the threshold) in metres. Will return 0 if there is none.
*** '''reciprocal''': <code>runway</code> ghost of the reciprocal runway.
*** '''ils_frequency_mhz''': ILS frequency in megahertz.
*** '''ils''': <code>navaid</code> ghost of the ILS transmitter.
* '''helipads'''
** '''<helipad name>'''
*** '''id''': Name of helipad.
*** '''lat''': Latitude of the helipad.
*** '''lon''': Longitude of the helipad.
*** '''heading''': True heading of the helipad.
*** '''length''': Length of the helipad in metres.
*** '''width''': Width of the helipad in metres.
*** '''surface''': Helipad surface type.
* '''taxiways'''
** '''<taxiway name>'''
*** '''id''': Name of taxiway.
*** '''lat''': Latitude of the taxiway.
*** '''lon''': Longitude of the taxiway.
*** '''heading''': Heading of the taxiway.
*** '''length''': Length of the taxiway in metres.
*** '''width''': Width of the taxiway in metres.
*** '''surface''': Taxiway surface type.

Information is extracted in the same way as accessing members of a Nasal hash. For example:
<syntaxhighlight lang="nasal">
# prints to lengths of the runways of the nearest airport in feet and metres
var info = airportinfo();
print("-- Lengths of the runways at ", info.name, " (", info.id, ") --");
foreach(var rwy; keys(info.runways)){
print(rwy, ": ", math.round(info.runways[rwy].length * M2FT), " ft (", info.runways[rwy].length, " m)");
}
</syntaxhighlight>

Note that searches for locations that are a long way away (e.g., the nearest seaplane base to the middle of the Sahara) may cause FlightGear to pause for an amount of time.
|param1 = id
|param1text = The {{wikipedia|International Civil Aviation Organization airport code|ICAO code|noicon=1}} of an airport to retrieve information about.
|param2 = type
|param2text = When this argument is used, the function will return the closest airport of a certain type. Can be one of "heliport," "seaport," or "airport" (default).
: {{inote|Running this function without any parameters is equivalent to this:
: <syntaxhighlight lang="nasal">
airportinfo("airport");
</syntaxhighlight>
}}
|param3 = lat ''and'' lon
|param3text = When these parameters are used, the function will return information on the nearest airport, heliport or seaplane base (depending on the '''type''' parameter) to those coordinates.
|example1 = var info = airportinfo();
print("Nearest airport: ", info.name, " (", info.id, ")"); # prints the name and ICAO code of the nearest airport
|example2 = var info = airportinfo("heliport");
print("Elevation of the nearest heliport: ", math.round(info.elevation * M2FT), " ft"); # prints the elevation and name of the nearest heliport
|example3 = var info = airportinfo("KSQL");
print("-- Runways of ", info.name, " (", info.id, "): --");
foreach(var rwy; keys(info.runways)) {
print(rwy); # prints the runways of KSQL
}
|example4 = var info = airportinfo(37.81909385, -122.4722484);
print("Coordinates of the nearest airport: ", info.lat, ", ", info.lon); # print the name and ICAO of the nearest airport to the Golden Gate Bridge
|example5 = var info = airportinfo(37.81909385, -122.4722484, "seaport");
print("Nearest seaplane base: ", info.name, " (", info.id, ")"); # print the name and ID of the nearest seaplane base to the Golden Gate Bridge
|example6text = This example prints the all information from an <code>airportinfo()</code> call.
|example6 = var info = airportinfo("KSFO");
print(info.name);
print(info.id);
print(info.lat);
print(info.lon);
print(info.has_metar);
print(info.elevation);
foreach(var rwy; keys(info.runways)){
print("-- ", rwy, " --");
print(info.runways[rwy].lat);
print(info.runways[rwy].lon);
print(info.runways[rwy].length);
print(info.runways[rwy].width);
print(info.runways[rwy].heading);
print(info.runways[rwy].stopway);
print(info.runways[rwy].threshold);
<nowiki>}</nowiki>
}}

===airwaysRoute() ===
{{Nasal doc
|syntax = airwaysRoute(start, end[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1933|t=Source}}
|text = {{see also|Nasal Flightplan}}
This function returns a vector containing waypoints between two given waypoints. The returned waypoints are ghosts, but can be accessed in the same way as a Nasal hash. See [[Nasal Flightplan]] for more information.
|param1 = start
|param1text = Start waypoint, in the form of a waypoint ghost, such as that provided by {{func link|flightplan()}}.
|param2 = end
|param2text = Same as above.
|param3 = type
|param3text = Instructs the function to compute a high level route (when set to "highlevel"), or a low level route (when set to "lowlevel"). Defaults to "highlevel."
|example1text = In the [[route manager]] dialog, add two waypoints to the flightplan, ideally ones that are far apart (tip: use the [[Map]] for this). Then run this code in your Nasal Console.
|example1 = var fp = flightplan();
var start = fp.getWP(0);
var end = fp.getWP(fp.getPlanSize() - 1);
var rt = airwaysRoute(start, end);
foreach(var wp; rt){
print(wp.wp_name); # print the waypoints in the computed route
}
|example2text = Exactly the same as above, but computes a low level path.
|example2 = var fp = flightplan();
var start = fp.getWP(0);
var end = fp.getWP(fp.getPlanSize() - 1);
var rt = airwaysRoute(start, end, "lowlevel");
foreach(var wp; rt){
print(wp.wp_name); # print the waypoints in the computed route
<nowiki>}</nowiki>
}}

===airway()===

{{Nasal doc
|syntax = airway(ident [, pos]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2644|t=Source}}
|text = {{see also|Nasal Flightplan}}
This function returns a ghost containing an airway of a specified id.
|param1 = ident
|param1text = a Positioned ghost (leg, navaid, airport) and so on, passed to the search function.
|param2 = pos
}}

===assert()===
{{Nasal doc
|syntax = assert(condition[, message]);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|version = 3.2
|commit = {{fgdata commit|8b16a7|t=commit}}
|text = Returns either true if the condition evaluates as true, or aborts with a {{func link|die()}} call, which can be customised.
|param1 = condition
|param1text = Condition to evaluate.
|param2 = message
|param2text = Optional message that will be used in any {{func link|die()}} call. Defaults to "assertion failed!"
|example1 = var a = 1;
var b = 2;
print(assert(a < b)); # prints "1" (true)
|example2 = var a = 1;
var b = 2;
assert(a > b, 'a is not greater than b'); # aborts with a custom error message
}}

===carttogeod()===
{{Nasal doc
|syntax = carttogeod(x, y, z);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=945|t=Source}}
|text = Converts {{wikipedia|ECEF|Earth-centered, Earth-fixed}} coordinates (x, y and z) to {{wikipedia|geodetic coordinates}} (latitude, longitude, and altitude). A vector is returned containing latitude and longitude, both in degrees, and altitude, which is returned in metres above the equatorial radius of Earth as defined by the {{wikipedia|WGS 84}} (6,378,137 metres).<ref>{{simgear file|simgear/math/sg_geodesy.hxx|l=43}}</ref>
|param1 = x
|param1text = Mandatory x-axis value, in metres.
|param2 = y
|param2text = Mandatory y-axis value, in metres.
|param3 = z
|param3text = Mandatory z-axis value, in metres.
|example1 = var (lat, lon, alt) = carttogeod(6378137, 0, 0); # point is the intersection of the prime meridian and equator.
print("Latitude: ", lat); # prints lat, lon and alt, which are all zero, see above
print("Longitude: ", lon);
print("Altitude: ", alt);
}}

===cmdarg()===
{{Nasal doc
|private = _cmdarg()
|syntax = cmdarg();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=513|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = <code>cmdarg()</code> returns the property root of certain types of XML files. These could be nodes in the [[Property Tree]], or temporary and/or non-public nodes outside the Property tree.
It is used by Nasal scripts embedded in XML files. It returns a <code>props.Node</code> object (see {{fgdata file|Nasal/props.nas}}), and you can use all of its methods on the returned value. <code>cmdarg()</code> should only be used in four types/places of XML files:
* Bindings: This is needed so that the value of a joystick's axis can be accessed internally.
* Dialogs: This will return the root of the dialog in the Property Tree. This is useful for dialogs that are created/modified procedurally (e.g. for populating/changing widgets while loading the dialog).
* Embedded Canvases: The Nasal code behind [[Canvas]] windows [[Howto:Adding a canvas to a GUI dialog|embedded in PUI dialogs]] can use it to accessing the root directory of their Canvas.
* Animation XML files: If the animation XML file is used in an AI/MP model, <code>cmdarg()</code> will return the root of the AI model in the <code>/ai/models/</code> directory. Examples: <code>/ai/models/aircraft[3]/</code>, <code>/ai/models/multiplayer[1]/</code>

You should not use <code>cmdarg()</code> in places other than those stated above. Although it won't cause an error, it will return the value of the last legitimate <code>cmdarg()</code> call.

Also, you should not delay <code>cmdarg()</code> using {{func link|maketimer()}}, {{func link|settimer()}} or {{func link|setlistener()}}, because it will return an unrelated property.
|example1 = fgcommand("dialog-show", {"dialog-name": "cmdarg-demo"});
|example1text = <br>This example demonstrates the usage of <code>cmdarg()</code> in a binding. Save the below XML snippet as <tt>[[$FG_ROOT]]/gui/dialogs/cmdarg-demo.xml</tt>. Then run the Nasal snippet below in your [[Nasal Console]]. Upon clicking {{button|Close}}, a message will be printed sowing the root of the binding in the Property Tree.
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>cmdarg-demo</name>
<layout>vbox</layout>

<text>
<label>Click "Close" to activate the demonstration (a message in the console).</label>
</text>

<button>
<legend>Close</legend>
<binding>
<command>nasal</command>
<script>print("Button binding root: '" ~ cmdarg().getPath() ~ "'");</script>
</binding>
<binding>
<command>dialog-close</command>
</binding>
</button>

</PropertyList>
</syntaxhighlight>
|example2text = This example demonstrates the usage of <code>cmdarg()</code> in Nasal code within dialogs. Open <tt>[[$FG_ROOT]]/gui/dialogs/cmdarg-demo.xml</tt> from the previous example, copy & paste the code below, and save it. Then run the same Nasal snippet as the previous example in your Nasal Console. If you click {{button|Click me!}}, the button's label will change to "I've been changed!"
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>cmdarg-demo</name>
<layout>vbox</layout>

<text>
<label>Click "Click me!" to activate the demonstration (the button's label will change).</label>
</text>

<button>
<legend>Click me!</legend>
<binding>
<command>nasal</command>
<script>change_label();</script>
</binding>
</button>

<button>
<legend>Close</legend>
<binding>
<command>dialog-close</command>
</binding>
</button>

<nasal>
<open><![CDATA[
var dlg_root = cmdarg();
var dlg_name = {"dialog-name": "cmdarg-demo"};
var change_label = func {
dlg_root.getNode("button[0]/legend").setValue("I've been changed!");
fgcommand("dialog-close", dlg_name);
fgcommand("dialog-show", dlg_name);
}
]]></open>
</nasal>

</PropertyList>
</syntaxhighlight>
|example3text = For an example of <code>cmdarg()</code> used with Canvas, please see [[Howto:Adding a canvas to a GUI dialog#FGPlot|Howto:Adding a canvas to a GUI dialog]].
}}

===courseAndDistance()===
{{Nasal doc
|syntax = courseAndDistance(to);
courseAndDistance(from, to);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1668|t=Source}}
|text = Returns a vector containing the course from one point to another and the distance between them in nautical miles. The course is the initial bearing (see [http://www.movable-type.co.uk/scripts/latlong.html#bearing here]), and is in the range 0–360. Both arguments can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object with geodetic coordinates (cartesian coordinates will not be accepted)
|param1 = from
|param1text = Optional parameter defining the from where the function should calculate its results. If the function is given one argument ('''to'''), the aircraft's current position will be used. As well as the argument types as defined above, this argument can be two numbers separated with a comma, as if the function is taking three arguments. See example 5 below.
|param2 = to
|param2text = Like the first parameter, but defines the second point.
|example1text = This example demonstrates the usage of the function with the <code>airport</code> ghost type.
|example1 = var from = airportinfo("KSFO");
var to = airportinfo("KSQL");
var (course, dist) = courseAndDistance(from, to);
print(course); # prints course from KSFO to KSQL
print(dist); # prints distance in nm from KSFO to KSQL
|example2text = This example demonstrates the usage of the function with hashes containing ''lat'' and ''lon''.
|example2 = var from = {lat: 0, lon: 0};
var to = {lat: 1, lon: 1};
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example3text = This example demonstrates usage of a geo.Coord object.
|example3 = var from = geo.Coord.new().set_latlon(0, 0);
var to = geo.Coord.new().set_latlon(1, 1);
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example4text = This example demonstrates usage of differing parameter types.
|example4 = var from = airportinfo("KSFO");
var to = geo.Coord.new().set_latlon(0, 0);
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example5text = The same as above, but the other way round.
|example5 = var to = {lat: 1, lon: 1};
var (course, dist) = courseAndDistance(0, 0, to);
print(course);
print(dist);
|example6text = Usage of just one parameter.
|example6 = var dest = airportinfo("KSQL");
var (course, dist) = courseAndDistance(dest);
print("Turn to heading ", math.round(course), ". You have ", sprintf("%.2f", dist), " nm to go");
}}

===createFlightplan()===
{{Nasal doc
|syntax = createFlightplan(path);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2331|t=Source}}
|text = Creates an empty flightplan object. It accepts one argument, ''path'' passed an absolute path to a .fgfp / .gpx file, it will populate the flightplan with waypoints from the file.
|param1 = path
|param1text = Optional parameter defining the file from which a flightplan will be populated.
|example1 =
var path = getprop("/sim/fg-home") ~ "/Export/test.fgfp";
var flightplan = createFlightplan(path);
debug.dump(flightplan);
}}

===createDiscontinuity()===
{{Nasal doc
|syntax = createDiscontinuity();
|text = Returns a <code>waypoint</code> ghost object. A route discontinuity is inserted by an {{abbr|FMS|Flight Management System}} when it is unsure how to connect two waypoints.
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2045|t=Source}}
|version = 2016.1
|commit = {{flightgear commit|caead6|t=commit}}
}}
===createViaTo()===
{{Nasal doc
|syntax = createViaTo(airway, waypoint);
|text = Returns a <code>waypoint</code> ghost object. It represents a route "via '''airway''' to '''waypoint'''".
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2009|t=Source}}
|version = 2016.1
|commit = {{flightgear commit|caead6|t=commit}}
|param1 = airway
|param1text = The name of an airway.
|param2 = waypoint
|param2text = Must be in the airway and one of:
* The name of a waypoint.
* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, or <code>fix</code> ghost object.
}}
===createWP()===
{{Nasal doc
|syntax = createWP(pos, name[, flag]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1964|t=Source}}
|text = Creates a new waypoint ghost object.
|param1 = pos
|param1text = Dictates the position of the new waypoint. It can be one of the following:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. See example 4 below.
|param2 = name
|param2text = String that will become the name of the new waypoint.
|param3 = flag
|param3text = Optional string that will tell FlightGear what type of waypoint it is. Must be one of "sid," "star," "approach," "missed," or "pseudo."
|example1text = Creates a waypoint directly in front and 1 km away and appends it to the flight plan.
|example1 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example2 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP({lat: pos.lat(), lon: pos.lon()}, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example3 = var apt = airportinfo();
var wp = createWP(apt, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example4 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos.lat(), pos.lon(), "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example5text = Creates a new waypoint and adds it to the flight plan. Waypoints of the type "pseudo" are then removed from the flight plan, including the new waypoint. The {{func link|print()}} statements show this.
|example5 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos, "NEWWP", "pseudo");
var fp = flightplan();
fp.appendWP(wp);
print(fp.getPlanSize());
fp.clearWPType("pseudo");
print(fp.getPlanSize());
}}

===createWPFrom()===
{{Nasal doc
|syntax = createWPFrom(object[, flag]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1989|t=Source}}
|text = Creates a new waypoint object from another object.
|param1 = object
|param1text = A ghost object. Must be a ghost type that is one of "airport," "navaid," "runway," or "fix."
|param2 = flag
|param2text = Optional string that will tell FlightGear what type of waypoint it is. Must be one of "sid," "star," "approach," "missed," or "pseudo."
|example1text = Creates a new waypoint and appends it to the flight plan.
|example1 = var apt = airportinfo("KSFO");
var wp = createWPFrom(apt);
var fp = flightplan();
fp.appendWP(wp);
|example2text = Creates a new waypoint and appends it to the flight plan. This way point is then removed; the {{func link|print()}} statements prove this.
|example2 = var apt = airportinfo("KSFO");
var wp = createWPFrom(apt, "pseudo");
print(wp.wp_name);
var fp = flightplan();
fp.appendWP(wp);
print(fp.getPlanSize());
fp.clearWPType("pseudo");
print(fp.getPlanSize());
}}

===defined()===
{{Nasal doc
|syntax = defined(symbol);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns 1 (true) or 0 (false) depending on whether a variable exists.
|param1 = symbol
|param1text = A string that will be what the function searches for.
|example1 = var number = 12;
var check_exist = func {
print("Variable 'number' ", defined("number") == 1 ? "exists" : "does not exist"); # 'number' does exist
print("Variable 'number2' ", defined("number2") == 1 ? "exists" : "does not exist"); # 'number2' does not exist
}
check_exist();
}}

===directory()===
{{Nasal doc
|syntax = directory(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=572|t=Source}}
|text = Returns a vector containing a list of the folders and files in a given file path or <code>'''nil'''</code> if the path doesn't exist. Hidden folders and files are not added to the vector.
{{inote|The first two elements of the vector will be <code>'.'</code> and <code>'..'</code>. These are for navigating back up the file tree, but have no use in Nasal. They can be safely removed from the vector.}}
|param1 = path
|param1text = Absolute file path.
|example1text = Gets the folders and files in [[$FG_ROOT]], and then removes the extra first two elements (see note above).
|example1 = var dir = directory(getprop("/sim/fg-root")); # get directory
dir = subvec(dir, 2); # strips off the first two elements
debug.dump(dir); # dump the vector
}}

===fgcommand()===
{{Nasal doc
|syntax = fgcommand(cmd[, args]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=456|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = Runs an fgcommand. See also {{readme file|commands}} and [[Bindings]] for more information. See {{flightgear file|src/Main/fg_commands.cxx|l=1425}} for the full list of fgcommands. Note that fgcommands generated by {{func link|addcommand()}} can also be run using this function. Also, the full list of fgcommands depends on the version of FlightGear you have. Returns 1 (true) if the fgcommand succeeded or 0 (false) if it failed.
|param1 = cmd
|param1text = String that is the name of the command that is to be run.
|param2 = args
|param2text = If the fgcommand takes arguments, they are inputted using this argument. Can either be a <code>props.Node</code> object, or a hash (see examples below).
|example1 = fgcommand("null"); # does nothing
|example2 = var args = props.Node.new({'script': 'print("Running fgcommand");'});
if (fgcommand("nasal", args)) { # prints "Running fgcommand" and then one of these print statements
print("Fgcommand succeeded");
} else {
print("Fgcommand encountered a problem");
}
|example3 = var args = { 'dialog-name': 'about' };
fgcommand("dialog-show", args); # shows the 'about' dialog
}}

===findAirportsByICAO() ===
{{Nasal doc
|syntax = findAirportsByICAO(search[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1096|t=Source}}
|text = Returns a vector containing <code>airport</code> ghost objects which are (by default) airports whose ICAO code matches the search string. The results are sorted by range from closest to furthest.
|param1 = search
|param1text = Search string for the function. Can either be a partial or a full ICAO code.
:{{icaution|The more matches there are for the given code, the longer the function will take. Passing just one character (e.g., "K"), might make FlightGear hang for a certain amount of time.}}
|param2 = type
|param2text = This will narrow the search to airports of a certain type. By default, only airports are searched for. May be one of "airport," "heliport," or "seaport."
|example1 = var apts = findAirportsByICAO("KSF"); # finds all airports matching "KSF"
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")"); # prints them
}
|example2 = var apts = findAirportsByICAO("SP0", "seaport"); # finds all seaplane bases matching "SP0"
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")"); # prints them
}
|example3 = var apt = findAirportsByICAO("XBET"); # one way to check if an airport does exist"
if (size(apt) == 0) {
print("Airport does not exist"); # this one will be printed
} else {
print("Airport does exist");
<nowiki>}</nowiki>
}}

===findAirportsWithinRange()===
{{Nasal doc
|syntax = findAirportsWithinRange([pos, ]range[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1066|t=Source}}
|text = Returns a vector of <code>airport</code> ghost object which are (by default) airports that are within a given range of a given position, or the aircraft's current position. The results are sorted by range from closest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findAirportsWithinRange(lat, lon, range, type);</code>.
|param2 = range
|param2text = Mandatory number giving the range in nautical miles within which to search for airports/heliports/seaplane bases.only airports are searched for.
|param3 = type
|param3text = This will narrow the search to airports of a certain type. By default, only airports are searched for. May be one of "airport," "heliport," or "seaport."
|example1text = Searches for airports within 10 nm of [[KSFO]].
|example1 = var pos = airportinfo("KSFO");
var apts = findAirportsWithinRange(pos, 10);
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
}
|example2text = Searches for seaplane bases within 15 nm of [[KSFO]].
|example2 = var pos = airportinfo("KSFO");
var apts = findAirportsWithinRange(pos, 15, "seaport");
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
}
|example3text = Searches for airports within 10 nm of your current position.
|example3 = var apts = findAirportsWithinRange(10);
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
<nowiki>}</nowiki>
}}

===findCommByFrequencyMHz()===
findCommByFrequencyMHz([pos, ]freq[, type]);
[[sourceforge:p/flightgear/flightgear/ci/next/tree/src/Scripting/NasalPositioned.cxx#l1547|source]]

Returns a <code>comm</code> ghost object for a station matching a given frequency. If there is more than one station with that frequency, the nearest station is returned.

'''pos'''

: Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findCommByFrequencyMHz(lat, lon, freq, type);</code>.
; freq
: Frequency, in megahertz, of the station to search for.
; type
: This will narrow the search to station of a certain type. Defaults to "all." For the full list of accepted type arguments, see flightgear/src/Navaids/positioned.cxx (line 160)
'''Example'''
var com = findCommByFrequencyMHz(123.6);
print("ID: ", com.id); # prints info about the comm station
print("Name: ", com.name);
print("Latitude: ", com.lat);
print("Longitude: ", com.lon);
print("Type: ", com.type);
print("Frequency: ", sprintf("%.3f", com.frequency), " Mhz");

=== findFixesByID() ===
{{Nasal doc
|syntax = findFixesByID([pos, ]id);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1627|t=Source}}
|text = Returns a vector containing <code>fix</code> ghost objects matching a given ID, sorted by range from a certain position.
{{inote|Fixes are (usually) also known as waypoints.}}
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findFixesByID(lat, lon, id);</code>.
|param2 = id
|param2text = Full or partial ID of the fix to search for.
:{{inote|1=Inputting a partial ID does not work correctly (see [http://forum.flightgear.org/viewtopic.php?f=30&t=28129 here]). It is best to just input a full ID.}}
|example1 = var fixes = findFixesByID("POGIC");
foreach(var fix; fixes){
print(fix.id, " - lat: ", fix.lat, " {{!}} lon: ", fix.lon); # prints information about POGIC
}
|example2 = var fix = findFixesByID("ZUNAP");
fix = fix[0];
var (course, dist) = courseAndDistance(fix);
print("Turn to heading ", math.round(course), ". You have ", sprintf("%.2f", dist), " nm to go to reach ", fixes[0].id);
}}

===findNavaidByFrequencyMHz()===
{{Nasal doc
|syntax = findNavaidByFrequencyMHz([pos, ]freq[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1547|t=Source}}
|text = Returns a <code>navaid</code> ghost object for a navaid matching a given frequency. If there is more than one navaid with that frequency, the nearest station is returned.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidByFrequencyMHz(lat, lon, freq, type);</code>.
|param2 = freq
|param2text = Frequency, in megahertz, of the navaid to search for.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaid = findNavaidByFrequencyMHz(109.55);
print("ID: ", navaid.id); # prints info about the navaid
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 100), " Mhz");
print("Range: ", navaid.range_nm, " nm");
if(navaid.course) print("Course: ", navaid.course);
}}

=== findNavaidsByFrequencyMHz()===
{{Nasal doc
|syntax = findNavaidsByFrequencyMHz([pos, ]freq[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1572|t=Source}}
|text = Returns a vector conatining <code>navaid</code> ghost objects for navaids that match a given frequency, sorted from nearest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsByFrequencyMHz(lat, lon, freq, type);</code>.
|param2 = freq
|param2text = Frequency, in megahertz, of the navaid to search for.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaids = findNavaidsByFrequencyMHz(109.55);
foreach(var navaid; navaids){
print("--");
print("ID: ", navaid.id); # prints info about the navaid
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 100), " Mhz");
print("Range: ", navaid.range_nm, " nm");
if(navaid.course) print("Course: ", navaid.course);
print("--");
<nowiki>}</nowiki>
}}

===findNavaidsByID()===
{{Nasal doc
|syntax = findNavaidsByID([pos, ]id[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1600|t=Source}}
|text = Returns a vector containing <code>navaid</code> ghost objects matching a given ID, sorted by range from a certain position.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsByID(lat, lon, id, type);</code>.
|param2 = id
|param2text = Full or partial ID of the fix to search for.
:{{inote|1=Inputting a partial ID does not work correctly (see [http://forum.flightgear.org/viewtopic.php?f=30&t=28129 here]). It is best to just input a full ID.}}
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaid = findNavaidsByID("MXW");
navaid = navaid[0];
print("ID: ", navaid.id); # prints info about 'MXW' (a VOR station)
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 1000), " Mhz");
print("Range: ", navaid.range_nm, " nm");
}}

===findNavaidsWithinRange()===
{{Nasal doc
|syntax = findNavaidsWithinRange([pos, ]range[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1518|t=Source}}
|text = Returns a vector of <code>navaid</code> ghost objects which are within a given range of a given position (by default the aircraft's current position). The results are sorted from closest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsWithinRange(lat, lon, range, type);</code>.
|param2 = range
|param2text = Mandatory number giving the range in nautical miles within which to search for navaids.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1text = Searches for navaids within 10 nm of [[KSFO]].
|example1 = var pos = airportinfo("KSFO");
var navs = findNavaidsWithinRange(pos, 10);
foreach(var nav; navs){
print(nav.name, " (ID: ", nav.id, ")");
}
|example2text = Searches for navaids within 10 nm of your current position.
|example2 = var navs = findNavaidsWithinRange(10);
foreach(var nav; navs){
print(nav.name, " (ID: ", nav.id, ")");
<nowiki>}</nowiki>
}}

===finddata()===
{{Nasal doc
|syntax = finddata(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=603|t=Source}}
|text = Takes a relative path and tries to return an absolute one. It works by appending the relative path to some paths and testing to see if they exist. As of FlightGear v3.7, these paths are the TerraSync directory (tested first) and [[$FG_ROOT]].
|param1 = path
|param1text = A relative path as a string.
|example1 = var path = finddata("Aircraft/Generic");
print(path); # prints the absolute path to $FG_ROOT/Aircraft/Generic
|example2 = var path = finddata("Airports");
print(path); # prints the absolute path to <TerraSync dir>/Airports
|example3 = var path = finddata("preferences.xml");
print(path); # prints the absolute path to $FG_ROOT/preferences.xml
}}

===flightplan()===
{{Nasal doc
|syntax = flightplan([path]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1738|t=Source}}
|text = {{see also|Nasal Flightplan}}
Returns a flight plan object, either one for the current flight plan, or one loaded from a given path.
|param1 = path
|param1text = Optional path to flight plan XML file.
|example1text = Gets the active flight plan and gets the ID of the current waypoint. Note that this example requires a flight plan to be set in the [[Route Manager]] first.
|example1 = var fp = flightplan();
print(fp.getWP(fp.current).id);
|example2text = Creates a new flight plan from an XML file and prints the IDs of the waypoints. Note that this example requires a flight plan to have been created and saved as <tt>''[[$FG_HOME]]/fp-demo.xml''</tt>.
|example2 = var path = getprop('/sim/fg-home') ~ '/fp-demo.xml';
var fp = flightplan(path);
for(var i = 0; i < fp.getPlanSize(); i += 1){
print(fp.getWP(i).id);
<nowiki>}</nowiki>
}}

===geodinfo()===
{{Nasal doc
|syntax = geodinfo(lat, lon[, max_alt]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=981|t=Source}}
|text = Returns a vector containing two entries or <code>'''nil'''</code> if no information could be obtained because the terrain tile wasn't loaded. The first entry in the vector is the elevation (in meters) for the given point, and the second is a hash with information about the assigned material (as defined in <tt>''[[$FG_ROOT]]/Materials''</tt>), or <code>'''nil'''</code> if there was no material information available (for example, because there is an untextured building at that location). The structure of the hash is as follows (see also {{readme file|materials}}):
* '''light_coverage:''' The coverage of a single point of light in m<sup>2</sup>.
* '''bumpiness:''' Normalized bumpiness factor for the material.
* '''load_resistance:''' The amount of pressure in N/m<sup>2</sup> the material can withstand without deformation.
* '''solid:''' 1 (true) or false (0) depending on whether the material is solid or not.
* '''names:''' Vector of scenery types (usually generated by [[TerraGear]]) that will use this material.
* '''friction_factor:''' Normalized friction factor of the material.
* '''rolling_friction:''' The rolling friction coefficient of the material.

Note that this function is a ''very'' CPU-intensive operation, particularly in FlightGear v2.4 and earlier. It is advised to use this function as little as possible.
|param1 = lat
|param1text = Latitude, inputted as a number.
|param2 = lon
|param2text = Longitude, inputted as a number.
|param3 = max_alt
|param3text = The altitude, in metres, from which the function will begin searching for the height of the terrain. Defaults to 10,000 metres. If the terrain is higher than this argument specifies, <code>'''nil'''</code> will be returned.
|example1text = Dumps information about ground underneath the aircraft.
|example1 = var pos = geo.aircraft_position();
var info = geodinfo(pos.lat(), pos.lon());
debug.dump(info);
|example2text = Prints whether the ground underneath the aircraft is solid or is water.
|example2 = var pos = geo.aircraft_position();
var info = geodinfo(pos.lat(), pos.lon());
if (info != nil and info[1] != nil) {
print("The ground underneath the aircraft is ", info[1].solid == 1 ? "solid." : "water.");
<nowiki>}</nowiki>
}}

=== geodtocart() ===
{{Nasal doc
|syntax = geodtocart(lat, lon, alt);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=962|t=Source}}
|text = Converts {{wikipedia|geodetic coordinates}} (latitude, longitude, and altitude) to {{wikipedia|ECEF|Earth-centered, Earth-fixed}} coordinates (x, y and z). A vector is returned containing x, y, and z in metres. The equatorial radius of earth used is that defined by the {{wikipedia|WGS 84}} (6,378,137 metres). All argument are mandatory.
|param1 = lat
|param1text = Latitude, in degrees.
|param2 = lon
|param2text = Longitude, in degrees.
|param3 = alt
|param3text = Altitude, in metres.
|example1 = var (x, y, z) = geodtocart(0, 0, 0); # point is the intersection of the prime meridian and equator.
print("x: ", x); # prints "x: 6378137"
print("y: ", y); # prints "y: 0"
print("z: ", z); # prints "y: 0"
}}

=== get_cart_ground_intersection()===
Introduced in 2017.2.1, see [[Terrain Detection]].

===getprop()===
{{Nasal doc
|syntax = <nowiki>getprop(path[, path[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=345|t=Source}}
|text = Returns the value of a node in the [[Property Tree]] or <code>'''nil'''</code> if the node does not exist or the value is not a number (NaN).
|param1 = path
|param1text = There needs to be at least one argument, but there is no limit to the maximum amount of arguments that can be given. The arguments will be concatenated together to form a property tree path. The arguments must be strings, but in FlightGear v3.2 onwards, there is also support (added by {{flightgear commit|34ed79}}) for numeric arguments as indices. See example 2 below.
|example1 = print("You have FlightGear v", getprop("/sim/version/flightgear")); # prints FlightGear version
|example2text = Note that the example below will only work in FlightGear 3.2 and above.
|example2 = for(var i = 0; i < 8; i += 1){
print("View #", i + 1, " is named ", getprop("/sim/view", i, "name"));
}
|example3text = Same as above, but is supported by all versions of FlightGear.
|example3 = for(var i = 0; i < 8; i += 1){
print("View #", i + 1, " is named ", getprop("/sim/view[" ~ i ~ "]/name"));
<nowiki>}</nowiki>
}}
==== See also====
{{note| If you have to read/write the same property multiple times (e.g. in an update loop), it is more efficient to use a node object:
To get a Node rather than its value, use <code>props.globals.getNode()</code> - see [[Nasal_library/props]]. }}

===greatCircleMove()===
{{Nasal doc
|syntax = greatCircleMove([pos, ]course, dist);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1681|t=Source}}
|text = Calculates a new set of geodetic coordinates using inputs of course and distance, either from the aircraft's current position (by default) or from another set of coordinates. Returns a hash containing two members, ''lat'' and ''lon'' (latitude and longitude respectively).
|param1 = pos
|param1text = Optional position to calculate from. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost object.
:* A hash with ''lat'' and ''lon'' members
:* A <code>geo.Coord</code> object
:* A lat/lon pair, that is, a pair of numbers (latitude followed by longitude) separated by a comma: <code>greatCircleMove(lat,lon, ...)</code>.
|param2 = course
|param2text = Course to new set of coordinates, in degrees (in the range 0–360).
|param3 = dist
|param3text = Distance in nautical miles to the new set of coordinates.
|example1 = var pos = greatCircleMove(0,0, 0, 1);
debug.dump(pos); # print hash with coordinates
|example2 = var fix = findFixesByID("POGIC");
fix = fix[0];
var pos = greatCircleMove(fix, 45, 10);
debug.dump(pos); # print hash with coordinates
}}

===interpolate()===
{{Nasal doc
|private = _interpolate()
|syntax = <nowiki>interpolate(prop, value1, time1[, value2, time2[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=522|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = Linearly interpolates a node in the property tree to a given value in a specified time. The value/time pairs will be run one after the other in the order that they are passed to the function. Note that the interpolation will continue even when the simulation is paused.
|param1 = prop
|param1text = String or <code>props.Node</code> object that indicates a node in the property tree to be used.
|param2 = value''n''
|param2text = Target value to change the property to in the set amount of time. This should be a number.
|param3 = time''n''
|param3text = Time in seconds, that will be taken for the interpolation.
|example1text = Paste the code below into the Nasal Console and execute. Then, open the Property Browser and look for the property. Finally, run the code again, and watch the value of the property change.
|example1 = setprop("/test", 0); # (re-)set property
interpolate("/test",
50, 5, # interpolate to 50 in 5 seconds
10, 2, # interpolate to 10 in 2 seconds
0, 5); # interpolate to 0 in 5 seconds
|example2 = # Apply the left brake at 20% per second
var prop = "controls/gear/brake-left";
var dist = 1 - getprop(prop);
if (dist == 1) {
interpolate(prop, 1, dist / 0.2);
<nowiki>}</nowiki>
}}

===isa()===
{{Nasal doc
|syntax = isa(object, class);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Checks if an object is an instance of, or inherits from, a second object (or class), returning 1 (true) if it is and 0 (false) if otherwise.
|param1 = object
|param1text = Object to check.
|param2 = class
|param2text = Class/object to check that '''object''' inherits from or is an instance of.
|example1 = var coord = geo.Coord.new();
if(isa(coord, geo.Coord)){
print("Variable 'coord' is an instance of class 'geo.Coord'"); # this one will be printed
} else {
print("Variable 'coord' is not an instance of class 'geo.Coord'");
}
|example2 = var coord = geo.Coord.new();
if(isa(coord, props.Node)){
print("Variable 'coord' is an instance of class 'props.Node'");
} else {
print("Variable 'coord' is not an instance of class 'props.Node'"); # this one will be printed
}
|example3text = The example below demonstrates checking of inheritance.
|example3 = var Const = {
constant: 2,
getConst: func {
return me.constant;
}
};

var Add = {
new: func {
return { parents: [Add, Const] };
},

addToConst: func(a){
return a * me.getConst();
}
};

var m = Add.new();
print(m.addToConst(4));

if(isa(m, Add)) print("Variable 'm' is an instance of class 'Add'"); # will be printed
if(isa(m, Const)) print("Variable 'm' is an instance of class 'Const'"); # will also be printed
}}

===logprint()===
{{Nasal doc
|syntax = <nowiki>logprint(priority[, msg[, msg[, ...]]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=431|t=Source}}
|text = Concatenates a message and logs it with a given priority level. Unlike {{func link|print()}} and {{func link|printlog()}}, message outputted by this function will be logged in your <code>[[Commonly used debugging tools#fgfs.log|fgfs.log]]</code> file as coming from the Nasal file itself rather than from {{flightgear file|src/Scripting/NasalSys.cxx}}.
|param1 = priority
|param1text = Number specifying the priority level of the outputted message:
:{{{!}} class="wikitable"
! Number !! Debug type
{{!-}}
{{!}} 1 {{!!}} Bulk
{{!-}}
{{!}} 2 {{!!}} Debug
{{!-}}
{{!}} 3 {{!!}} Info
{{!-}}
{{!}} 4 {{!!}} Warn
{{!-}}
{{!}} 5 {{!!}} Alert
{{!}}}
|param2 = msg
|param2text = The message. There is no limit to the arguments you give give. They will be concatenated together before logging.
|example1 = # logs the value of pi to three decimal places with log level 3
logprint(3, "pi = ", sprintf("%.3f", math.pi));
|example2 = logprint(5, "Alert! This is an important message!");
}}
{{note|
The following constants have been added to the development branch of FlightGear ("next") and will be releases with FG 2020.1 so you won't have to remember the numbers anymore:

LOG_BULK, LOG_WARN, LOG_DEBUG, LOG_INFO, LOG_ALERT, DEV_WARN, DEV_ALERT }}

===magvar() ===
{{Nasal doc
|syntax = magvar([pos]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1642|t=Source}}
|text = Returns the {{wikipedia|magnetic variation}} at a given set of coordinates. The table below gives the magnetic model used depending on the version of FlightGear.
{{{!}} class="wikitable"
! FlightGear versions !! Model !! Reference date
{{!-}}
{{!}} 3.6 and above {{!!}} {{wikipedia|World Magnetic Model}} (WMM) 2015 {{!!}} 1 January 2015
{{!-}}
{{!}} 0.9.11-pre1 to 3.4 {{!!}} WMM 2005 {{!!}} 1 January 2005
{{!-}}
{{!}} 0.7.3 to 0.9.10 {{!!}} WMM 2000 {{!!}} 1 January 2000
{{!}}}
|param1 = pos
|param1text = Optional position to calculate from. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost object.
:* A hash with ''lat'' and ''lon'' members
:* A <code>geo.Coord</code> object
:* A lat/lon pair, that is, a pair of numbers (latitude followed by longitude) separated by a comma: <code>magvar(lat,lon)</code>.
|example1 = print(magvar(0, 0)); # prints the magnetic variation at 0, 0
}}

===maketimer() ===
{{Nasal doc
|syntax = maketimer(interval[, self], function);
|source = ''Implemented using the {{API Link|flightgear|class|TimerObj}} class.''<br>{{flightgear file|src/Scripting/NasalSys.cxx|l=90|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=533|t=Part 2}}
|version = 2.12
|commit = {{flightgear commit|ab939f|t=commit}}
|text = Returns a timer object containing the following methods and members:
* '''start()''': Starts the timer.
* '''stop()''': Stops the timer.
* '''restart(interval)''': Restarts the timer with the given interval.
* '''singleShot''': Bool showing whether the timer is only to be run once, or continuously until told to stop. Can be both set and read from (see examples).
* '''isRunning''': Read-only bool telling whether the timer is currently running.
* '''simulatedTime''': (FG 2017.1+; {{flightgear commit|0af316|t=commit}}) Bool telling whether the timer is using simulated time (which accounts for pause, etc.). Defaults to false (use real time). Can be both read and set. This cannot be changed while the timer is running.
Unlike {{func link|settimer()}}, which it replaces, <code>maketimer()</code> provides more control over the timer. In addition, it can help reduce memory usage.
|param1 = interval
|param1text = Interval in seconds for the timer.
|param2 = self
|param2text = Optional parameter specifying what any <code>'''me'''</code> references in the function being called will refer to.
|param3 = function
|param3text = Function to be called at the given interval.
|example1 = var timer = maketimer(1, func(){
print("Hello, World!"); # print "Hello, World!" once every second (call timer.stop() to stop it)
});
timer.start();
|example2 = var timer = maketimer(1, math, func(){
print(me.math); # 'me' reference is the 'math' namespace
});
timer.singleShot = 1; # timer will only be run once
timer.start();
|example3 = var timer = maketimer(1, func(){
print("Hello, World!"); # print "Hello, World!" once every second (call timer.stop() to stop it)
});
timer.start();
print(timer.isRunning); # prints 1
|example4text = In the example below, "Hello, World!" will be printed after one second the first time, and after two seconds thereafter.
|example4 = var update = func(){
print("Hello, World!");
timer.restart(2); # restarts the timer with a two second interval
}

var timer = maketimer(1, update);
timer.singleShot = 1;
timer.start();
}}

===maketimestamp()===
{{Nasal doc
|syntax = maketimestamp()
|source = ''Implemented using the {{API Link|flightgear|class|TimeStampObj}} class.''<br>{{flightgear file|src/Scripting/NasalSys.cxx|l=214|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=589|t=Part 2}}
|version = 2019.2
|commit = {{flightgear commit|7db06300|t=commit}}
|text = Returns a time stamp object to allow high resolution timing of Nasal operations. When created the timer will automatically be stamped. The object has the following methods:
* '''stamp()''': Resets the timing operation. Call this first.
* '''elapsedMSec()''': returns number of milliseconds elapsed since stamp() called. Resolution may vary depending on platform but is usually at least millisecond accuracy.
* '''elapsedUSec()''': returns number of microseconds elapsed since stamp() called. Resolution may vary depending on platform but is usually at least millisecond accuracy.
|
|example1text = In the example below the number of milliseconds elapsed will be printed.
|example1 = var timestamp = maketimestamp();
timestamp.stamp();
print(timestamp.elapsedMSec(), "ms elapsed");
print(timestamp.elapsedMSec(), "ms elapsed");
}}

===md5()===
{{Nasal doc
|syntax = md5(string);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=758|t=Source}}
|version = 3.2
|commit = {{flightgear commit|cfbf9e|t=commit}}
|text = Returns a the {{wikipedia|MD5}} hash (as a string) of the inputted string.
|param1 = string
|param1text = String the generate the hash of. Mandatory.
|example1text = The below code should output <code>65a8e27d8879283831b664bd8b7f0ad4</code>.
|example1 = print(md5("Hello, World!"));
}}

===navinfo()===
{{Nasal doc
|syntax = navinfo(lat, lon, type, id);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1453|t=Source}}
|text = Returns vector <code>navaid</code> ghost objects matching the given '''type''' and '''id''' or <code>'''nil'''</code> on error.
|param1 = lat ''and'' lon
|param1text = If given, the returned navaids will be put into order of ascending distance from the location.
|param2 = type
|param2text = Narrows the search to the given type. Must be one of "any," "fix," "vor," "ndb," "ils," "dme," or "tacan." Defaults to the equivalent of "any."
|param3 = id
|param3text = ID to search for. Note that, although all the parameters are technically optional, this parameter must be given, otherwise an empty vector will be returned.
|example1 = navinfo("vor"); # returns all VORs
|example2 = navinfo("HAM"); # return all navaids whose names start with "HAM"
|example3 = navinfo("vor", "HAM"); # return all VORs whose names start with "HAM"
|example4 = navinfo(34,48,"vor","HAM"); # return all VORs whose names start with "HAM" and sorted by distance relative to 34°, 48°
}}

===parse_markdown()===
{{Nasal doc
|syntax = parse_markdown(markdown);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=745|t=Part 1}} {{!}} {{simgear file|simgear/misc/SimpleMarkdown.cxx|t=Part 2}}
|version = 3.2
|text = Parses a string containing {{wikipedia|Markdown}} and returns the result as a string. As of FlightGear 2016.1, it is just a simple parser, and does the following:
* It strips whitespace from the beginning of the string.
* It supports [http://daringfireball.net/projects/markdown/syntax#p paragraphs and line breaks].
* It collapses whitespace.
* It converts unordered [http://daringfireball.net/projects/markdown/syntax#list lists] to use a bullet character (•). Note that the bullet character is implemented in hexadecimal UTF-8 character bytes (<code>E2 80 A2</code>), as so may not work properly when the being displayed in an encoding other than UTF-8.
|param1 = markdown
|param1text = String containing Markdown to be parsed.
|example1text =
Save the below code as <tt>''[[$FG_ROOT]]/gui/dialogs/test.xml''</tt>, then run the Nasal code below it to open the dialog. To change the markdown to be parsed, simply change the code in the highlighted section, save it, and reload the GUI (<tt>Debug > Reload GUI</tt>).
<syntaxhighlight lang="xml" highlight="41-50">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>test</name>
<layout>vbox</layout>

<group>
<layout>hbox</layout>

<empty>
<stretch>true</stretch>
</empty>

<text>
<label>parse_markdown() test dialog</label>
</text>

<empty>
<stretch>true</stretch>
</empty>

<button>
<legend></legend>
<pref-width>16</pref-width>
<pref-height>16</pref-height>
<binding>
<command>dialog-close</command>
</binding>
</button>

</group>

<canvas>
<name>Canvas plot</name>
<stretch>true</stretch>
<pref-width>400</pref-width>
<pref-height>300</pref-height>
<nasal>
<load><![CDATA[
var text = 'Items:
* apples
* oranges
* pears

Some text.
Some more items:
* apples
* oranges
* pears';

var parsed = parse_markdown(text);

var root_canvas = canvas.get(cmdarg());
root_canvas.setColorBackground(255, 255, 255);
var root = root_canvas.createGroup();

var text_dis = root.createChild("text")
.setText(parsed)
.setTranslation(5, 5)
.setFont("LiberationFonts\LiberationSans-Regular.ttf")
.setFontSize(15)
.setColor(0, 0, 0)
.setDrawMode(canvas.Text.TEXT)
.setAlignment("left-top");
]]></load>
</nasal>
</canvas>

</PropertyList>
</syntaxhighlight>
|example1 = fgcommand("dialog-show", {"dialog-name": "test"});
|example2text = The example below parses Markdown and outputs it in a HTML document. The parsed text is placed in <syntaxhighlight lang="xml" inline><pre></pre></syntaxhighlight> tags. To change the Markdown to be parsed, simply edit the variable <tt>markdown</tt> at the top of the code.
|example2 = <nowiki>var markdown = 'Items:
* apples
* oranges
* pears

Some text.
Some more items:
* apples
* oranges
* pears';

var parsed = parse_markdown(markdown);

debug.dump(parsed);

var path = string.normpath(getprop("/sim/fg-home") ~ '/Export/parse_markdown()-test.html');

var file = io.open(path, "w");

var html = "<!DOCTYPE html>\n\n<html>\n\n<head>\n\t<meta charset=\"UTF-8\">\n\t<title>parse_markdown() test generated by Nasal</title>\n</head>\n\n<body>\n\t<pre>" ~ parsed ~ "</pre>\n</body>\n\n</html>";

io.write(file, html);
io.close(file);
print("Done, file ready for viewing (" ~ path ~ ")");</nowiki>
}}

===parsexml()===
{{Nasal doc
|syntax = <nowiki>parsexml(path[, start[, end[, data[, pro_ins]]]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=710|t=Source}}
|text = This function is an interface into the built-in [http://expat.sourceforge.net/ Expat XML parser]. The absolute path to the file is returned as string, or <code>'''nil'''</code> is returned on error.
|param1 = path
|param1text = Mandatory absolute path to the XML file to be parsed.
|param2 = start
|param2text = Optional callback function that will be called for every starting tag. The function should take two argument: the tag name and a hash containing attributes.
|param3 = end
|param3text = Optional callback function that will be called for every ending tag. The function should take one argument: the tag name.
|param4 = data
|param4text = Optional callback function that will be called for every piece of data within a set of tags. The function should take one argument: the data as a string.
|param5 = pro_ins
|param5text = Optional callback function that will be called for every {{wikipedia|Processing Instruction|processing instruction}}. The function should take two argument: the target and the data string.
|example1text = Save the below XML code in <tt>''[[$FG_HOME]]/Export/demo.xml''</tt>. Then, execute the Nasal code below in the Nasal Console. The XML will be parsed and each bit of the code will be printed.
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<?xml-stylesheet type="text/xsl" href="style.xsl"?>

<foo>
<blah type="string"><![CDATA[ <sender>John Smith</sender> ]]></blah>
<blah2 type="string">Orange & lemons</blah2>
</foo>
</syntaxhighlight>
|example1 = var start = func(name, attr){
print("Starting tag: '", name, "'");
foreach(var a; keys(attr)){
print("\twith attribute ", a, '="', attr[a], '"');
}
}

var end = func(name){
print("Ending tag: '", name, "'");
}

var data = func(data){
print("Data = '", data, "'");
}

var pro_instr = func(target, data){
print("Processing instruction: target = '", target, "', data = '", data, "'");
}

parsexml(getprop("/sim/fg-home") ~ '/Export/demo.xml', start, end, data, pro_instr);
}}

===print()===
{{Note|As of 07/2020, we are in the process of slowly deprecating and removing Nasal print() (in fgdata) where possible in favor of log [[#logprint()]] which takes a priority level.

This is part of the goal that we achieve zero output at log-level at alert, and everything shown at ‘warn; is really a warning, not just information.<ref>https://sourceforge.net/p/flightgear/mailman/message/37042224/</ref>}}

{{Nasal doc
|syntax = <nowiki>print(data[, data[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=415|t=Source}}
|text = Concatenates its arguments and then prints it to the terminal and the [[Commonly used debugging tools#fgfs.log|log]]. Note that a newline is automatically added.
|param1 = data
|param1text = Data to print. Only strings and numbers can be printed; other data types will not be. There many be any number of arguments; they will just be concatenated together.
|example1 = print("Just", " a ", "test"); # prints "Just a test"
|example2 = print("pi = ", math.pi); # prints "pi = 3.141592..."
}}

=== printf() ===
{{Nasal doc
|syntax = <nowiki>printf(format[, arg[, arg, [...]]]);</nowiki>
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Creates and prints a formatted string. For a description of its arguments, see {{func link|sprintf()}} (it is, in fact, implemented using <code>sprintf()</code>).
|example1 = printf("In hexadecimal, 100000 = %X", 186A0); # prints "In hexadecimal, 100000 = 186A0"
}}

===printlog()===
{{caution|This function is deprecated and doesn't work. Please use the new one {{func link|logprint()}}.}}
{{Nasal doc
|syntax = <nowiki>printlog(level, data[, data[, ...]]);</nowiki>
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Prints the given message with the given log level. If the log level is higher or equal to <code>/sim/logging/priority</code>, it is printed.
|param1 = level
|param1text = Mandatory log level as a string. Must be one of "none," "bulk," "debug," "info," "warn," or "alert." Note that "none" will mean that the message will never be printed.
|param2 = data
|param2text = Data to be printed. Only strings and numbers will be printed; others will not be. There may be any number of arguments; they will just be concatenated together.
|example1 = printlog("alert", "This is an alert"); # message will be printed
|example2 = printlog("info", "Just informing you about something"); # message will be printed only if log level is set to "info" or less
}}

===rand()===
{{Nasal doc
|syntax = rand();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=554|t=Source}}
|text = Returns a random floating point number between 0 (inclusive) and 1 (exclusive). It takes no arguments.
|example1 = print(rand()); # prints random number
}}

===registerFlightPlanDelegate()===
{{Nasal doc
|syntax = registerFlightPlanDelegate(init_func);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1879|t=Source}}
|text = Registers a flight plan delegate. See <tt>''{{fgdata file|Nasal/route_manager.nas|t=$FG_ROOT/Nasal/route_manager.nas}}''</tt> for examples.
|param1 = init_func
|param1text = Initialization function which will be called during FlightGear's startup.
}}
===removecommand()===
{{Nasal doc
|syntax = removecommand(cmd);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=668|t=Source}}
|text = Removes the given fgcommand. Returns <code>'''nil'''</code>.
{{caution|This will remove '''any''' [[fgcommands|fgcommand]], even those implemented in C++, so use with caution!}}
|param1 = cmd
|param1text = String specifying the name of the command to remove.
|example1 = addcommand("hello", func(){
print("Hello");
});
fgcommand("hello"); # "Hello" will be printed
removecommand("hello"); # removes it
}}

===removelistener()===
{{Nasal doc
|syntax = removelistener(id);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=1384|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=506|t=Part 2}}
|text = Removes and deactivates the given listener and returns the number of listeners left or <code>'''nil'''</code> on error.
{{note|It is good practice to remove listeners when they are not required anymore. This prevents the listeners reducing FlightGear's run performance.}}
|param1 = id
|param1text = ID of listener as returned by {{func link|setlistener()}}.
|example1 = var ls = setlistener("/sim/test", func(){
print("Property '/sim/test' has been changed");
});
setprop("/sim/test", "blah"); # trigger listener
var rem = removelistener(ls); # remove listener
print("There are ", rem, " listeners remaining");
}}

===resolvepath()===
{{Nasal doc
|syntax = resolvepath(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=604|t=Source}}
|text = Takes a relative path as a string and uses [[SimGear]]'s path-resolving framework to return an absolute path as a string. If the path could not be resolved, an empty string is returned. See [[Resolving Paths]] for a detailed description of the algorithm. This function can also be used to check if a file exists.
|param1 = path
|param1text = Relative path to be completed.
|example1 = print(resolvepath("Nasal/globals.nas")); # prints the equivalent of $FG_ROOT/Nasal/globals.nas
|example2 = print(resolvepath("blah")); # prints nothing; could not be resolved
|example3 = var file_path = resolvepath("Aircraft/SenecaII/some-file");
if (file_path != ""){
gui.popupTip("some-file found", 2);
} else {
gui.popupTip("some-file not found", 2);
<nowiki>}</nowiki>
}}

===setlistener()===
{{Nasal doc
|syntax = <nowiki>setlistener(node, code[, init[, type]]);</nowiki>
|private = _setlistener()
|source = {{flightgear file|src/Scripting/Nasal|l=499|t=Part 1}} {{!}} {{flightgear file|src/Scripting/Nasal|l=1350|t=Part 2}}<br>''Listener implemented using the {{API Link|flightgear|class|FGNasalListener}} class.''
|text = Creates a listener which will be triggered when the given property is changed (depending on the '''type'''). A unique integer ID is returned; this can later be used as the argument to {{func link|removelistener()}}.
{{note|Listeners are known to be a source of resource leaks. To avoid this, please take measures such as:
* Using {{func link|removelistener()}} when they are not needed any more.
* Using a single initialization listener.
* Avoiding tying listeners to properties that are rapidly updated (e.g., many times per frame).
}}
|param1 = node
|param1text = Mandatory string or <code>props.Node</code> object pointing to a property in the [[Property Tree]].
|param2 = code
|param2text = Mandatory callback function to execute when the listener is triggered. The function can take up to four arguments in the following order:
* '''changed''': a <code>props.Node</code> object pointing to the changed node.
* '''listen''': a <code>props.Node</code> object pointing to the listened-to node. Note that this argument maybe different depending on the '''type'''.
* '''mode''': an integer telling how the listener was triggered. 0 means that the value was changed. 1 means that a child property was added. -1 means that a child property was removed.
* '''is_child''': boolean telling whether '''changed''' is a child property of the listened-to '''node''' or not. 1 (true) if it is, 0 (false) otherwise.
|param3 = init
|param3text = If set to 1 (true), the listener will additionally be triggered when it is created. This argument is optional and defaults to 0 (false).
|param4 = type
|param4text = Integer specifying the listener's behavior. 0 means that the listener will only trigger when the property is changed. 1 means that the trigger will always be triggered when the property is written to. 2 will mean that the listener will be triggered even if child properties are modified. This argument is optional and defaults to 1.
|example1 = var prop = props.globals.initNode("/sim/test", "", "STRING"); # create property
var id = setlistener("/sim/test", func(n){ # create listener
print("Value: ", n.getValue());
});
setprop("/sim/test", "blah"); # trigger listener
removelistener(id); # remove listener
prop.remove(); # remove property
}}

===setprop()===
{{Nasal doc
|syntax = <nowiki>setprop(path[, path[, ...]], value);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=385|t=Source}}
|text = Sets the value of a property in the [[Property Tree]]. If the property does not exist, it will be created. Returns 1 (true) on success or 0 (false) if there was an error.
{{note|If you want to remove a property, you will have to use one of the <code>props</code> helpers:
<syntaxhighlight lang="nasal">
props.globals.getNode("foo/bar").remove(); # take out the complete node
props.globals.getNode("foo").removeChild("bar"); # take out a certain child node
</syntaxhighlight>
}}
|param1 = path
|param1text = There needs to be at least one '''path''' argument, but there is no limit to the maximum amount that can be given. They will be concatenated together to form a property tree path. The arguments must be strings, but in FlightGear v3.2 onwards, there also is support (added by {{flightgear commit|34ed79}}) for numeric arguments as indices. See example 2 below.
|param2 = value
|param2text = Value to write to the given property. Must be either a string or a number.
|example1 = setprop("/sim/demo", "This is a demo");
|example2text = Note that the example below will only work in FlightGear 3.2 and above.
|example2 = for(var i = 0; i < 3; i += 1){
setprop("/sim/demo", i, "Demo #" ~ i));
}
|example3text = Same as above, but is supported by all versions of FlightGear.
|example3 = for(var i = 0; i < 3; i += 1){
setprop("/sim/demo[" ~ i ~ "]", "Demo #" ~ i));
<nowiki>}</nowiki>
}}
====See also====
{{note| If you have to read/write the same property multiple times (e.g. in an update loop), it is more efficient to use a node object:
To get a Node rather than its value, use <code>props.globals.getNode()</code> - see [[Nasal_library/props]]. }}

===settimer() ===
{{Nasal doc
|syntax = settimer(function, delta[, realtime]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=499|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=1286|t=Part 2}}
|text = Runs the given function a specified amount of seconds after the current time. Returns <code>'''nil'''</code>.
{{note|Improper use of <code>settimer()</code> may cause resource leaks. It is also highly recommended that the newer {{func link|maketimer()}} should be used instead of this function.}}
|param1 = function
|param1text = Mandatory function that will be called. It may be necessary to enclose code in an anonymous function (see example).
|param2 = delta
|param2text = Mandatory amount of time in seconds after which the function will be called.
|param3 = realtime
|param3text = If 1 (true), "real time" will be used instead of "simulation time." Defaults to 0 (false). Note that if "simulation time" is used, the timer will not run while FlightGear is paused.
|example1 = var myFunc = func(){
print("Hello");
}

settimer(myFunc, 2); # runs myFunc after 2 seconds
|example2 = var sqr = func(a){
return a * a;
}

settimer(func(){
print(sqr(2)); # will print 4 after 2 seconds
}, 2);
}}

===srand() ===
{{Nasal doc
|syntax = srand();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=559|t=Source}}
|text = Makes the pseudorandom number generator (see {{func link|rand()}}) generate a new {{wikipedia|random seed|noicon=1}} based on time. Returns 0.
}}
===systime()===
{{Nasal doc
|syntax = systime();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=770|t=Source}}
|text = Returns the {{wikipedia|Unix time}} (seconds since since 00:00:00 UTC, 1/1/1970) as a floating point number with high resolution. This function is useful for benchmarking purposes (see example 2).
{{note|1=High resolution timers under Windows can produce inaccurate or fixed sub-millisecond results.<ref>{{cite web|url=http://forum.flightgear.org/viewtopic.php?f=30&t=29259|title=Nasal: systime() ??!?|author=Necolatis|date=Apr 2nd, 2016}}</ref> This is due to the underlying {{func link|GetSystemTimeAsFileTime()|link=https://msdn.microsoft.com/en-us/library/windows/desktop/ms724397(v=vs.85).aspx}} API call, which depends on hardware availability of suitable high resolution timers. See also [https://msdn.microsoft.com/en-us/library/windows/desktop/dn553408(v=vs.85).aspx Acquiring high-resolution time stamps]}}
|example1 = print("Unix time: ", systime()); # prints Unix time
|example2 = var myFunc = func(){
for(var i = 0; i <= 10; i += 1){
print("Interation #", i);
}
}
var t = systime(); # record time
myFunc(); # run function
var t2 = systime(); # record new time
print("myFunc() took ", t2 - t, " seconds"); # print result
}}

===thisfunc()===
{{Nasal doc
|syntax = thisfunc();
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns the function from which this function is called. This allows a function to reliably and safely call itself from within a closure.
|example1 = var stringify_vec = func(input){
if (typeof(input) == "scalar"){
return sprintf("%s", input);
} elsif (typeof(input) == "vector") {
if (size(input) == 0) return "[]";
var this = thisfunc();
var buffer = "[";
for(var i = 0; i < size(input); i += 1){
buffer ~= this(input[i]);
if (i == size(input) - 1) {
buffer ~= "]";
} else {
buffer ~= ", ";
}
}
return buffer;
} else {
die("stringify_vec(): Error! Invalid input. Must be a vector or scalar");
}
}

var test_vec = ["a", "b", "c", [1, 2, 3], "d"];
debug.dump(stringify_vec(test_vec)); # prints "[a, b, c, [1, 2, 3], d]"
test_vec = [];
debug.dump(stringify_vec(test_vec)); # prints "[]"
test_vec = {};
debug.dump(stringify_vec(test_vec)); # will throw an error
}}

===tileIndex() ===
{{Nasal doc
|syntax = tileIndex();
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1720|t=Source}}
|text = Returns the index of the tile at the aircraft's current position as a string. This corresponds to the name of the STG file of the tile. For example, at [[KSFO]], this would be <code>942050</code>, corresponding to <tt>''[[$FG_SCENERY]]/Terrain/w130n30/w123n3/942050.stg''</tt>.
|example1 = print(tileIndex()); # print index
}}

=== tilePath()===
{{Nasal doc
|syntax = tilePath();
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1712|t=Source}}
|text = Returns the base path of the tile at the aircraft's current position as a string. For example, at KSFO, this would be <code>w130n30/w123n3</code>, corresponding to <tt>''[[$FG_SCENERY]]/Terrain/w130n30/w123n3''</tt>.
|example1 = print(tilePath()); # print path
}}

=== values()===
{{Nasal doc
|syntax = values(hash);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns a vector containing the values of the given hash.
|param1 = hash
|param1text = Mandatory hash to get the values of.
|example1 = var hash = {
"a": 1,
"b": 2,
"c": 3
};

foreach(var val; values(hash)){
print(val);
}
|example2text = The below example does exactly the same thing as the above example, but does not use <code>values()</code>:
|example2 = var hash = {
"a": 1,
"b": 2,
"c": 3
};

foreach(var key; keys(hash)){
print(hash[key]);
<nowiki>}</nowiki>
}}

==Extension functions new in FG 2020.1 ==
The following functions have been added to the nasal core library and will be released with FlightGear version 2020.1.
Before the release they are available in the development branch "next".

===isfunc()===
Returns 1 if type or argument is a function, otherwise 0.

===isghost()===
Returns 1 if type or argument is a ghost, otherwise 0.

=== ishash()===
Returns 1 if type or argument is a hash, otherwise 0.

===isint()===
{{Nasal doc
|syntax = isint(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if argument has a numeric value and x == floor(x), e.g. integer.
}}

===isnum()===
{{Nasal doc
|syntax = isnum(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if typeof(x) is "scalar" and x has a numeric value otherwise 0.
}}

===isscalar()===
{{Nasal doc
|syntax = isscalar(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if type or argument is a scalar (string or numeric), otherwise (vector, hash, func, ...) it returns 0. This is useful to check if a variable can be converted to string e.g. when useing the string concat operator "~".
|example1 = var a = "foo";
var b=42;
if (isscalar(a) and isscalar(b)) print(a~b);
if (isstr(a)) print("a is a string");
if (isint(b)) print("b is an integer");
# if (isscalar(a))... is equivalent to if (typeof(a) == "scalar")...
}}

===isstr()===
Returns 1 if type or argument is a string, otherwise 0.

===isvec()===
Returns 1 if type or argument is a vector, otherwise 0.

===vecindex()===
{{Nasal doc
|syntax = vecindex(vector, value);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns the index of value or nil, if value is not found in vector.
|example1=
var myvector = ["apple", "bananna", "coconut"];
# to check if a vector contains a certain value compare vecindex to nil
if (vecindex(myvector, "apple") != nil) {
print("found apple");
}
# WARNING: this will not work as desired because index is 0
if (vecindex(myvector, "apple")) {
print("found apple");
<nowiki>}</nowiki>

}}

==Extension functions new in "dev" version ==
The following functions have been added to the nasal core library curernty on "dev" version.

===member()===
{{Nasal doc
|syntax = member(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=796|t=Source}}
|text = The function searches for a key in the given hash, including the <code>parents</code>. If the key is found, its value is returned; otherwise, it returns <code>nil</code>.
|param1 = hash
|param1text = The hash in which the key is searched.
|param2 = key
|param2text = Key as a string whose value we want to return.
|example1 =
var Hash = {
key: 12,
};

member(Hash, 'key'); # return 12
member(Hash, 'missing'); # return nil
|example2 = # member() also includes parents

var Base = {
key: 'text',
};

var Child = {
parents: [Base],
};

member(Child, 'key'); # return 'text'
member(Child, 'missing'); # return nil
}}

===has_member()===
{{Nasal doc
|syntax = has_member(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=811|t=Source}}
|text = The function searches for a key in the given hash, including the <code>parents</code>. If the key is found, <code>true</code> is returned, otherwise <code>false</code>.
|param1 = hash
|param1text = The hash in which the key is searched.
|param2 = key
|param2text = Key as a string.
|example1 =
var Hash = {
key: 12,
};

member(Hash, 'key'); # return true
member(Hash, 'missing'); # return false
|example2 = # has_member() also includes parents

var Base = {
key: 'text',
};

var Child = {
parents: [Base],
};

member(Child, 'key'); # return true
member(Child, 'missing'); # return false
}}

==Variables==
Various global constants (technically variables) are provided for use in converting between different units. They are all found in {{fgdata file|Nasal/globals.nas|text=$FG_ROOT/Nasal/globals.nas}}.

===D2R===
{{Nasal doc
|syntax = var radians = degrees * D2R;
|text = Converts an angle from degrees to radians when multiplied by the angle in degrees. Equal to <code>π / 180</code>.
}}
===FPS2KT===
{{Nasal doc
|syntax = var knots = feet_per_second * FPS2KT;
|text = Converts a velocity from feet per second to knots when multiplied by the velocity in feet per second. Approximately equal to 0.5925.
}}
===FT2M===
{{Nasal doc
|syntax = var metres = feet * FT2M;
|text = Converts a length from feet to metres when multiplied by the length in feet. Equal to 0.3048.
}}
===GAL2L ===
{{Nasal doc
|syntax = var litres = gallons * GAL2L;
|text = Converts a volume from US liquid gallons to litres when multiplied by the volume in gallons. Approximately equal to 3.7854.
}}
===IN2M===
{{Nasal doc
|syntax = var metres = inches * IN2M;
|text = Converts a length from inches to metres when multiplied by the length in inches. Equal to 0.0254.
}}
===KG2LB===
{{Nasal doc
|syntax = var pounds = kilograms * KG2LB;
|text = Converts a mass from kilograms to pounds when multiplied by the mass in kilograms. Approximately equal to 2.2046.
}}
===KT2FPS===
{{Nasal doc
|syntax = var feet_per_second = knots * KT2FPS;
|text = Converts a velocity from knots to feet per second when multiplied by the velocity in knots. Approximately equal to 1.6878.
}}
===KT2MPS===
{{Nasal doc
|syntax = var metres_per_second = knots * KT2MPS;
|text = Converts a velocity from knots to metres per second when multiplied by the velocity in knots. Approximately equal to 0.5144.
}}
===L2GAL===
{{Nasal doc
|syntax = var gallons = litres * L2GAL;
|text = Converts a volume from litres to US liquid gallons when multiplied by the volume in litres. Approximately equal to 0.2642.
}}
===LB2KG===
{{Nasal doc
|syntax = var kilograms = pounds * LB2KG;
|text = Converts a mass from pounds to kilograms when multiplied by the mass in pounds. Approximately equal to 0.4536.
}}
===M2FT ===
{{Nasal doc
|syntax = var feet = metres * M2FT;
|text = Converts a length from metres to feet when multiplied by the length in metres. Approximately equal to 3.2808.
}}
===M2IN===
{{Nasal doc
|syntax = var inches = metres * M2IN;
|text = Converts a length from metres to inches when multiplied by the length in metres. Approximately equal to 39.3701.
}}
===M2NM ===
{{Nasal doc
|syntax = var nautical_miles = metres * M2NM;
|text = Converts a length from metres to nautical miles when multiplied by the length in metres. Approximately equal to 0.00054.
}}
===MPS2KT ===
{{Nasal doc
|syntax = var knots = metres_per_second * MPS2KT;
|text = Converts a velocity from metres per second to knots when multiplied by the velocity in metres per second. Approximately equal to 1.9438.
}}
===NM2M ===
{{Nasal doc
|syntax = var metres = nautical_miles * NM2M;
|text = Converts a length from nautical miles to metres when multiplied by the length in nautical miles. Equal to 1,852.
}}
===R2D===
{{Nasal doc
|syntax = var degrees = radians * R2D;
|text = Converts an angle from radians to degrees when multiplied by the angle in radians. Equal to <code>180 / π</code>.
}}

{{Appendix}}

{{Nasal namespaces}}

Nasal library

2026-01-16T19:35:42Z

PlayeRom:

{{Nasal Navigation|nocat=1}}
This page documents the global '''library functions and variables''' of FlightGear's built-in scripting language, [[Nasal]]. This includes ''[[#Core library functions|core library functions]]'', which were included in Nasal before its integration into FlightGear, the ''[[#Extension functions|extension functions]]'', which have been subsequently added, and are specifically designed for FlightGear, and the ''[[#variables|global variables]]'', which are conversion variables, added with extension functions, for converting between units. The relevant folders in [[Git]] are:
* {{flightgear file|src/Scripting}}
* {{simgear file|simgear/nasal}}

All these functions and variables are in the global namespace, that is, they are directly accessible (e.g., one can call <syntaxhighlight lang="nasal" inline>magvar()</syntaxhighlight> instead of <syntaxhighlight lang="nasal" inline>namespace.magvar()</syntaxhighlight>). However, if a namespace must be used, <code>globals</code> is the correct namespace, but using it is not recommended. For a more complete explanation, see [[Nasal Namespaces in-depth]].

{{tip|Copy & paste the examples into your [[Nasal Console]] and execute them to see what they do.|width=70%}}

== Core library functions ==
This is the list of the basic '''core library functions.''' Most of these functions were part of the original Nasal library (before its integration in to FlightGear), while some have been added or changed over time. See also:
* http://plausible.org/nasal/lib.html ([http://web.archive.org/web/20101010094553/http://plausible.org/nasal/lib.html archive])
* {{simgear file|simgear/nasal/lib.c}} ([http://sourceforge.net/p/flightgear/simgear/ci/next/log/?path=/simgear/nasal/lib.c history])

=== append() ===
{{Nasal doc
|syntax = append(vector, element[, element[, ...]]);
|source = {{simgear file|simgear/nasal/lib.c|l=45|t=Source}}
|text = This function appends, or adds, the given element(s) to the end of the vector given in the first argument. Returns the vector operated on.
|param1 = vector
|param1text = The vector to which the arguments will be appended.
|param2 = element
|param2text = An element to be added to the vector.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector
append(vector, 4); # Append the number 4 to the end of the vector
debug.dump(vector); # Print the contents of the vector
|example2 =
var vector = [1, 2, 3]; # Initialize the vector
append(vector, 4, 5, 6); # Append the numbers 4, 5, and 6 to the end of the vector
debug.dump(vector); # Print the contents of the vector
}}

=== bind() ===
{{Nasal doc
|syntax = bind(function, locals[, outer_scope]);
|source = {{simgear file|simgear/nasal/lib.c|l=638|t=Source}}
|text = This creates a new function object. A function in Nasal is three things: the actual code, a hash/namespace of local variables available to the function namespace, and the closure object of that namespace. These correspond to the three arguments respectively.
|param1 = function
|param1text = Function to evaluate.
|param2 = locals
|param2text = Hash containing values that will become the namespace (first closure) for the function.
|param3 = outer_scope
|param3text = Optional function which is bound to the next closure. This can be bound to yet another, making a linked list.
|example1 = # This is a namespace/hash with a single member, named "key," which is initialized to 12
var Namespace = {
key: 12
};

# This is different namespace/hash containing a function
# dividing a variable "key" (which is unavailable/nil in this namespace) by 2
var AnotherNamespace = {
ret: func {
key /= 2;
}
};

# To see that key is not available, try to call AnotherNamespace.ret() first
call(AnotherNamespace.ret, [], nil, nil, var errors = []);
if(size(errors)){
print("Key could not be divided/resolved!");
debug.printerror(errors);
}

# Associate the AnotherNamespace.ret() function with the first namespace
# so that "key" is now available
var function = bind(AnotherNamespace.ret, Namespace);

# Invoke the new function
function();

# Print out the value of Namespace.key
# It was changed to 12 from 6 by AnotherNamespace.ret()
print(Namespace.key);
}}

=== call() ===
{{Nasal doc
|syntax = call(func[, args[, me[, locals[, error]]]);
|source = {{simgear file|simgear/nasal/lib.c|l=376|t=Source}}
|text = Calls the given function with the given arguments and returns the result. This function is very useful as it allows much more control over function calls and catches any errors or {{func link|die()}} calls that would normally trigger run-time errors cancelling execution of the script otherwise.
|param1 = func
|param1text = Function to execute.
|param2 = args
|param2text = Vector containing arguments to give to the called function.
|param3 = me
|param3text = <code>'''me'''</code> reference for the function call (i.e., for method calls). If given, this will override any <code>'''me'''</code> value existing in the namespace (locals argument).
|param4 = locals
|param4text = A hash with key/value pairs that will be available to the called function, typically used as the namespace for the function to be called.
|param5 = error
|param5text = A vector to append errors to. If the called function generates an error, the error, place, and line will be written to this. These errors can be printed using {{func link|printerror()|debug}}.
|example1 =
# prints "Called from call()"
call(func {
print("Called from call()");
});
|example2 =
# prints "a = 1 : b = 2
call(func(a, b){
print("a = ", a, " : b = ", b);
},
[1, 2]
);
|example3 =
var Hash = {
new: func {
var m = { parents: [Hash] };

m.el1 = "string1";
m.el2 = "string2";

return m;
}
};

# prints "me.el1 = string1", then "me.el2 = string2" on the next line
call(func(a, b){
print("me.el", a, " = ", me["el" ~ a]);
print("me.el", b, " = ", me["el" ~ b]);
},
[1, 2],
Hash.new()
);
|example4 =
# prints the value of math.pi
call(func {
print(pi);
}, nil, nil,
math
);
|example5 =
call(func {
print(math.ip); # math.ip doesn't exist
}, nil, nil, nil,
var errs = []
);
debug.printerror(errs); # The error is caught and printed using debug.printerror()
}}

=== caller() ===
{{Nasal doc
|syntax = caller([level]);
|source = {{simgear file|simgear/nasal/lib.c|l=540|t=Source}}
|text = Returns a vector containing a record from the current call stack. The level numbering starts from the currently executing function (level 0). Level 1 (the default) is the caller of the current function, and so on.

The result is a four-element vector containing '''[0]''' a hash of local variables, '''[1]''' the function object, '''[2]''' the full source file name (incl. path) and '''[3]''' the line number.
|param1 = level
|param1text = Optional integer specifying the stack level to return a result from. Defaults to 1 (i.e. the caller of the currently executing function).
|example1 =
var myFunction = func(a, b) {
debug.dump(caller(0)[0]); # prints a hash of local variables, including arguments a and b
return 2 * 2;
};

print("2 x 2 = ", myFunction(2, 2));
|example2 =
var get_arg_value = func() {
print("Argument to myFunc = ", caller(1)[0]['a']); # print the value of myFunc's single argument, using caller()
};

var myFunc = func(a) {
get_arg_value();
};

myFunc(3);
|example3text = This is a real example taken from {{fgdata file|Nasal/canvas/MapStructure.nas}}. Function <code>r()</code> (above the TODOs) returns a hash with the key/value pairs as per its arguments. For example, something like this is returned: <code>{ name: "<name>", vis: true, zindex: nil }</code>.
|example3 =
var MapStructure_selfTest = func() {
var temp = {};
temp.dlg = canvas.Window.new([600, 400], "dialog");
temp.canvas = temp.dlg.createCanvas().setColorBackground(1, 1, 1, 0.5);
temp.root = temp.canvas.createGroup();

var testMap = temp.root.createChild("map");
testMap.setController("Aircraft position");
testMap.setRange(25); # TODO: implement zooming/panning via mouse/wheel here, for lack of buttons :-/
testMap.setTranslation(
temp.canvas.get("view[0]") / 2,
temp.canvas.get("view[1]") / 2,
);

var r = func(name, vis = true, zindex = nil) {
return caller(0)[0];
}

# TODO: we'll need some z-indexing here, right now it's just random
# TODO: use foreach/keys to show all layers in this case by traversing SymbolLayer.registry directly ?
# maybe encode implicit z-indexing for each lcontroller ctor call ? - i.e. preferred above/below order ?
var types = [
r('TFC', false),
r('APT'),
r('DME'),
r('VOR'),
r('NDB'),
r('FIX', false),
r('RTE'),
r('WPT'),
r('FLT'),
r('WXR'),
r('APS'),
];

foreach (var type; types) {
testMap.addLayer(
factory: canvas.SymbolLayer,
type_arg: type.name,
visible: type.vis,
priority: type.zindex,
);
}
}; # MapStructure_selfTest
}}

=== chr() ===
{{Nasal doc
|syntax = chr(code);
|source = {{simgear file|simgear/nasal/lib.c|l=240|t=Source}}
|text = Returns a character as per the single argument. Extended ASCII is supported (see http://www.asciitable.com/ for a list of supported characters), although this may vary between different systems. For a list of the most commonly used characters, see the {{wikipedia|ASCII#ASCII printable code chart|ASCII printable code chart}} ('''Dec''' column). The following table lists supported control characters, along with their equivalent control characters in Nasal strings. {{Note|In Nasal, only strings enclosed with double-quotes (<code>"string"</code>) supports control chracters. Strings in single quotes (<code>'string'</code>) do not.}}
{{{!}} class="wikitable"
! Code !! Name !! Equivalent to
{{!-}}
{{!}} 10 {{!!}} {{Wikipedia|Newline}} {{!!}} <code>\n</code>
{{!-}}
{{!}} 9 {{!!}} {{Wikipedia|Tab key#Tab characters|Horizontal tab}} {{!!}} <code>\t</code>
{{!-}}
{{!}} 13 {{!!}} {{Wikipedia|Carriage return}} {{!!}} <code>\r</code>
{{!}}}
|param1 = code
|param1text = Integer character code for the desired glyph.
|example1 = print("Code 65 = ", chr(65)); # prints "Code 65 = A"
|example2text = This example displays all of the characters in a list, in the format <code>Code '''n''' = >'''char'''<</code>, '''n''' being the index, and '''char''' being the character.
|example2 =
for(var i = 0; i <= 255; i += 1){
print("Code ", i, " = >", chr(i), "<");
}
}}

=== closure() ===
{{Nasal doc
|syntax = closure(func[, level]);
|source = {{simgear file|simgear/nasal/lib.c|l=557|t=Source}}
|text = Returns the hash table containing the lexical namespace of the given function. The level numbering start with level 0 being the namespace of '''func'''.
|param1 = func
|param1text = Function to evaluate.
|param2 = level
|param2text = Optional integer specifying the scope level. Defaults to 0 (the namespace of '''func''').
|example1 =
var get_math_e = func {
return e; # return the value of math.e
}

var myFunction = bind(get_math_e, math); # bind get_math_e to the math namespace, so that math.e is immediately available to get_math_e
debug.dump(closure(myFunction)); # print the hash of the namespace "get_math_e"

print(myFunction());
}}

=== cmp() ===
{{Nasal doc
|syntax = cmp(a, b);
|source = {{simgear file|simgear/nasal/lib.c|l=169|t=Source}}
|text = Compares two strings, returning -1 if '''a''' is less than '''b''', 0 if they are identical and 1 if '''a''' is greater than '''b'''.
|param1 = a
|param1text = First string argument for comparison.
|param2 = b
|param2text = Second string argument for comparison.
|example1 = print(cmp("1", "two")); # prints -1
|example2 = print(cmp("string", "string")); # prints 0
|example3 = print(cmp("one", "2")); # prints 1
|example4 = print(cmp("string1", "string2")); # prints -1
}}

=== compile() ===
{{Nasal doc
|syntax = compile(code[, filename]);
|source = {{simgear file|simgear/nasal/lib.c|l=349|t=Source}}
|text = Compiles the specified code string and returns a function object bound to the current lexical context. If there is an error, the function dies, with the argument to {{func link|die()}} being '''filename'''.
|param1 = code
|param1text = String containing Nasal code to be compiled.
|param2 = filename
|param2text = Optional string used for error messages/logging. Defaults to <code><compile></code>
|example1 =
var myCode = 'print("hello");';
var helloFunc = compile(myCode, "myCode");
helloFunc();
|example2text = <code>compile</code> is very convenient to support Nasal loaded from other files. For instance, [[PropertyList XML files]] (such as GUI dialogs) may contain embedded Nasal sections that need to be parsed, processed and compiled. For an example of how to do this, save the below XML code as <tt>''[[$FG_ROOT]]/gui/dialogs/test.xml''</tt>.
<syntaxhighlight lang="xml">
<?xml version="1.0"?>

<PropertyList>

<nasal><![CDATA[
print("You have FlightGear v", getprop("/sim/version/flightgear"));
]]></nasal>

</PropertyList>
</syntaxhighlight>
Now, start FlightGear and execute this code in the [[Nasal Console]].
|example2 =
# Build the path
var FGRoot = getprop("/sim/fg-root");
var filename = "/gui/dialogs/test.xml";
var path = FGRoot ~ filename;

var blob = io.read_properties(path);
var script = blob.getValues().nasal; # Get the nasal string

# Compile the script. We're passing the filename here for better runtime diagnostics
var code = call(func {
compile(script, filename);
}, nil, nil, var compilation_errors = []);

if(size(compilation_errors)){
die("Error compiling code in: " ~ filename);
}

# Invoke the compiled script, equivalent to code();
# We're using call() here to detect errors:
call(code, [], nil, nil, var runtime_errors = []);

if(size(runtime_errors)){
die("Error calling code compiled loaded from: " ~ filename);
}
|example3text = The <code>compile()</code> function also allows you to parse a JSON string into a hash. Simplest example:
|example3 =
var jsonFunc = compile('{"version":"1.2.0","author":{"name":"John"} }');
var json = jsonFunc(); # return hash
logprint(LOG_ALERT, json["version"]); # print "1.2.0"
logprint(LOG_ALERT, json["author"]["name"]); # print "John"
}}

=== contains() ===
{{Nasal doc
|syntax = contains(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=249|t=Source}}
|text = Returns 1 (True) if the hash contains the specified key, or 0 (False) if not.
|param1 = hash
|param1text = The hash to search in.
|param2 = key
|param2text = The scalar to be searched for, contained as a key in the hash.
|example1 =
# Initialize a hash
var hash = {
element: "value"
};
print(contains(hash, "element") ? "Yes" : "No"); # This will print "Yes"
print(contains(hash, "element2") ? "Yes" : "No"); # This will print "No"
}}

===contains()===
{{Requires commit|desc=Vector support|details=see {{Merge-request|project=fgdata|id=305}}|commit=ee39abbd3b70c9b6d5e3a1c4ccedddaac1a92b11|repo=Simgear}}
{{Nasal doc
|syntax = contains(vector, item);
|source = {{simgear file|simgear/nasal/lib.c|l=249|t=Source}}
|text = Returns 1 (True) if the vector contains the specified item, or 0 (False) if not.
|param1 = vector
|param1text = The vector to search in.
|param2 = item
|param2text = The object to be searched for in the vector.
|example1 =
# Initialize a vector
var vec = ["element", "foo"];
print(contains(vec, "element") ? "Yes" : "No"); # This will print "Yes"
print(contains(vec, "element2") ? "Yes" : "No"); # This will print "No"
}}

===delete() ===
{{Nasal doc
|syntax = delete(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=118|t=Source}}
|text = Deletes the key from the hash if it exists. Operationally, this is NOT identical to setting the hash value specified by the key to <code>'''nil'''</code> as the key will stay in the hash (at least for a while). This variant potentially frees storage by deleting the reference to the key and by shrinking the hash. Returns the hash that has been operated on.
|param1 = hash
|param1text = The hash from which to delete the key.
|param2 = key
|param2text = The scalar to be deleted, contained as a key in the hash.
|example1 =
# Initialize the hash
var hash = {
element1: "value1",
element2: "value2"
};
delete(hash, "element1"); # Delete element1
debug.dump(hash); # prints the hash, which is now minus element1
}}

===die()===
{{Nasal doc
|syntax = die(error);
|source = {{simgear file|simgear/nasal/lib.c|l=417|t=Source}}
|text = Terminates execution and unwinds the stack. The place and the line will be added to the '''error'''. This invokes the same internal exception handler used for internal runtime errors. Use this to signal fatal errors, or to implement exception handling. The error thrown (including internal runtime errors) can be caught with {{func link|call()}}.
|param1 = error
|param1text = String describing the error.
:{{inote|This parameter is technically optional, but it is highly recommended to use it.}}
|example1 =
print("Will print");
die("Don't go any further!");
print("Won't print"); # Will not be printed because die() stops the process
}}

=== find()===
{{Nasal doc
|syntax = find(needle, haystack);
|source = {{simgear file|simgear/nasal/lib.c|l=586|t=Source}}
|text = Finds and returns the index of the first occurrence of the string '''needle''' in the string '''haystack''', or -1 if no such occurrence was found.
|param1 = needle
|param1text = String to search for.
|param2 = haystack
|param2text = String to search in.
|example1 = print(find("c", "abcdef")); # prints 2
|example2 = print(find("x", "abcdef")); # prints -1
|example3 = print(find("cd", "abcdef")); # prints 2
}}

===ghosttype()===
{{Nasal doc
|syntax = ghosttype(ghost);
|source = {{simgear file|simgear/nasal/lib.c|l=336|t=Source}}
|text = Returns a string containing either a descriptive name of a ghost (a raw C/C++ object), or a unique id (the pointer to the C/C++ <code>naGhostType</code> instance) if no name has been set. Ghost is an acronym that stands for '''G'''arbage-collected '''H'''andle to '''O'''ut'''S'''ide '''T'''hingy.
|param1 = ghost
|param1text = Ghost to return a description for.
|example1 = print(ghosttype(airportinfo())); # prints "airport"
}}

===id()===
{{Nasal doc
|syntax = id(object);
|source = {{simgear file|simgear/nasal/lib.c|l=706|t=Source}}
|text = Returns a string containing information on the type and ID of the object provided in the single argument. The information is returned in the form of <code>'''<type>''':'''<id>'''</code>, where '''<type>''' is the type of object, and '''<id>''' is the ID.
|param1 = object
|param1text = Can be either of a string, a vector, a hash, a code, a function, or a ghost.
|example1 = print(id("A")); # prints "str:000000001624A590"
}}

===int() ===
{{Nasal doc
|syntax = int(number);
|source = {{simgear file|simgear/nasal/lib.c|l=125|t=Source}}
|text = Returns the integer part of the numeric value of the single argument, or <code>'''nil'''</code> if none exists.
|param1 = number
|param1text = Number or string with just a number in it to return an integer from.
|example1 = print(int(23)); # prints "23"
|example2 = print(int(23.123)); # prints "23"
|example3 = debug.dump(int("string")); # prints "nil"
}}

===keys()===
{{Nasal doc
|syntax = keys(hash);
|source = {{simgear file|simgear/nasal/lib.c|l=36|t=Source}}
|text = Returns a vector containing the list of keys found in the single hash argument.
|param1 = hash
|param1text = The hash to return the keys from.
|example1 =
# Initialize a hash
var hash = {
element1: "value",
element2: "value"
};
debug.dump(keys(hash)); # print the vector
}}

===left()===
{{Nasal doc
|syntax = left(string, length);
|source = {{simgear file|simgear/nasal/lib.c|l=214|t=Source}}
|version = 2.12
|commit = {{simgear commit|bd7163|t=commit}}
|text = Returns a substring of '''string''', starting from the left.
|param1 = string
|param1text = String to return part of.
|param2 = length
|param2text = Integer specifying the length of the substring to return.
|example1 = print(left("string", 2)); # prints "st"
}}

=== num()===
{{Nasal doc
|syntax = num(number);
|source = {{simgear file|simgear/nasal/lib.c|l=149|t=Source}}
|text = Returns the numerical value of the single string argument, or <code>'''nil'''</code> if none exists.
|param1 = number
|param1text = String with just a number in it to return a number from.
|example1 = print(num("23")); # prints "23"
|example2 = print(num("23.123")); # prints "23.123"
|example3 = debug.dump(num("string")); # prints "nil"
}}

===pop()===
{{Nasal doc
|syntax = pop(vector);
|source = {{simgear file|simgear/nasal/lib.c|l=85|t=Source}}
|text = Removes and returns the last element of the single vector argument, or <code>'''nil'''</code> if the vector is empty.
|param1 = vector
|param1text = Vector to remove an element from.
|example1 =
var vector = [1, 2, 3];
pop(vector);
debug.dump(vector); # prints "[1, 2]"
|example2 =
var vector = [1, 2, 3];
debug.dump(pop(vector)); # prints "3"
|example3 =
var vector = [];
debug.dump(pop(vector)); # prints "nil"
}}

=== range() ===
{{Nasal doc
|syntax = range([start, ]stop[, step]);
|source = {{simgear file|simgear/nasal/lib.c|l=756|t=Source}}
|text = Creates a vector of numbers starting from <code>start</code> (default 0) up to but not including <code>stop</code>, incremented by <code>step</code> (default 1). Note: To specify <code>step</code>, you must also provide <code>start</code>; otherwise the second argument is interpreted as <code>stop</code>.
|param1 = start
|param1text = Optional. The starting number of the sequence. Defaults to 0 if omitted. Required if you want to specify <code>step</code>.
|param2 = stop
|param2text = Required. The number at which to stop the sequence (not included).
|param3 = step
|param3text = Optional. The increment between each number in the sequence. Defaults to 1. Only valid if <code>start</code> is also specified.
|example1 =
var vec = range(5); # Creates a vector [0, 1, 2, 3, 4]
var vec = range(2, 5); # Creates a vector [2, 3, 4]
var vec = range(0, 10, 2); # Creates a vector [0, 2, 4, 6, 8]
var vec = range(0, 0); # Creates an empty vector []
var vec = range(0, 1); # Creates a vector [0]
}}

=== remove() ===
{{Nasal doc
|syntax = remove(vector, value);
|source = {{simgear file|simgear/nasal/lib.c|l=53|t=Source}}
|text = Removes all elements equal to the given value from a vector and returns the modified vector.
|param1 = vector
|param1text = The vector from which elements are to be removed.
|param2 = value
|param2text = A value to remove from the vector.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector.
remove(vector, 2); # Remove the value 2 from the vector.
debug.dump(vector); # Print the contents of the vector: "[1, 3]".
|example2 =
var vector = ["text", "text", "text"]; # Initialize the vector.
remove(vector, "text"); # Remove the value "text" from the vector.
debug.dump(vector); # Print the contents of the vector: "[]".
}}

=== removeat() ===
{{Nasal doc
|syntax = removeat(vector, index);
|source = {{simgear file|simgear/nasal/lib.c|l=72|t=Source}}
|text = Removes the element at the specified index from the vector and returns it.
|param1 = vector
|param1text = The vector from which the element will be removed.
|param2 = index
|param2text = Index of the item to be deleted.
|example1 =
var vector = [1, 2, 3]; # Initialize the vector.
removeat(vector, 0); # Remove the index 0 from the vector.
debug.dump(vector); # Print the contents of the vector: "[2, 3]".
}}

===right()===
{{Nasal doc
|syntax = right(string, length);
|source = {{simgear file|simgear/nasal/lib.c|l=226|t=Source}}
|version = 2.12
|commit = {{simgear commit|bd7163|t=commit}}
|text = Returns a substring of '''string''', starting from the right.
|param1 = string
|param1text = String to return part of.
|param2 = length
|param2text = Integer specifying the length of the substring to return.
|example1 = print(right("string", 2)); # prints "ng"
}}

=== setsize()===
{{Nasal doc
|syntax = setsize(vector, size);
|source = {{simgear file|simgear/nasal/lib.c|l=91|t=Source}}
|text = Sets the size of a vector. The first argument specifies a vector, the second a number representing the desired size of that vector. If the vector is currently larger than the specified size, it is truncated. If it is smaller, it is padded with <code>'''nil'''</code> entries. Returns the vector operated upon.
|param1 = vector
|param1text = The vector to be operated on.
|param2 = size
|param2text = The desired size of the vector in number of entries.
|example1 =
var vector = [1, 2, 3]; # Initialize a vector
setsize(vector, 4);
debug.dump(vector); # print the vector "[1, 2, 3, nil]"
|example2 =
var vector = [1, 2, 3]; # Initialize a vector
setsize(vector, 2);
debug.dump(vector); # print the vector "[1, 2]"
}}

===size()===
{{Nasal doc
|syntax = size(object);
|source = {{simgear file|simgear/nasal/lib.c|l=26|t=Source}}
|text = Returns the size of the single argument. For strings, this is the length in bytes. For vectors, this is the number of elements. For hashes, it is the number of key/value pairs. If the argument is <code>'''nil'''</code> or a number, this error will be thrown: <code>object has no size()</code>.
|param1 = object
|param1text = Object to find the size of. Must be a string, a vector or a hash.
|example1 =
var string = "string";
print(size(string)); # prints "6"
|example2 =
var vector = [1, 2, 3];
print(size(vector)); # prints "3"
|example3 =
var hash = {
element1: "value1",
element2: "value2",
element3: "value3"
};
print(size(hash)); # prints "3"
}}

=== sort()===
{{Nasal doc
|syntax = sort(vector, function);
|source = {{simgear file|simgear/nasal/lib.c|l=678|t=Source}}
|text = Returns a vector containing the elements in the input '''vector''' sorted in according to the rule given by '''function'''. Implemented with the ANSI C {{func link|qsort()|link=http://www.cplusplus.com/reference/cstdlib/qsort/}}, <code>sort()</code> is stable. This means that if the rules in the first example are used, equal elements in the output vector will appear in the same relative order as they do in the input. It is run in a loop, so '''function''' is run several times.
|param1 = vector
|param1text = Input vector to sort.
|param2 = function
|param2text = Function according to which the elements will be sorted by. It should take two arguments and should return one of 1, 0, or -1.
{{{!}} class="wikitable"
! Return value !! Meaning
{{!-}}
{{!}} less than 0 {{!!}} first argument should go before second argument
{{!-}}
{{!}} 0 {{!!}} first argument equals second argument
{{!-}}
{{!}} greater than 0 {{!!}} first argument should go after second argument
{{!}}}

|example1text = This example sorts elements from smallest to greatest.
|example1 =
var sort_rules = func(a, b) {
if (a < b) {
return -1; # A should before b in the returned vector
} elsif (a == b) {
return 0; # A is equivalent to b
} else {
return 1; # A should after b in the returned vector
}
}
debug.dump(sort([3, 2, 5, 6, 4, 1], sort_rules)); # prints "[1, 2, 3, 4, 5, 6]"
|example2text = This example sorts elements from greatest to smallest.
|example2 =
# Outputs the elements in reverse order (greatest to smallest)
var sort_rules = func(a, b) {
if (a < b) {
return 1; # -1 in the above example
} elsif (a == b) {
return 0;
} else {
return -1; # 1 in the above example
}
}
debug.dump(sort([3, 2, 5, 6, 4, 1], sort_rules)); # prints "[6, 5, 4, 3, 2, 1]"
|example3text = This example sorts a vector of strings (runways for example) from smallest to greatest.
|example3 =
var runways = ["09R", "27R", "26L", "09L", "15"];
var rwy = sort(runways, func(a, b) cmp(a, b));
debug.dump(rwy); # prints ['09L', '09R', '15', '26L', '27R']
}}

=== split()===
{{Nasal doc
|syntax = split(delimiter, string);
|source = {{simgear file|simgear/nasal/lib.c|l=596|t=Source}}
|text = Splits the input string into a vector of substrings bounded by occurrences of the delimiter substring. See [[Nasal_library/string#string.join(sep,list)|string.join()]].
|param1 = delimiter
|param1text = String that will split the substrings in the returned vector.
|param2 = string
|param2text = String to split up.
|example1 = debug.dump(split("cd", "abcdef")); # prints "['ab', 'ef']"
|example2 = debug.dump(split(".", "3.2.0")); # prints "[3, 2, 0]"
|example3 = debug.dump(split("/", "path/to/file")); # prints "['path', 'to', 'file']"
}}

===sprintf()===
{{Nasal doc
|syntax = <nowiki>sprintf(format[, arg[, arg, [...]]]);</nowiki>
|source = {{simgear file|simgear/nasal/lib.c|l=491|t=Source}}
|text = Creates and returns a string formatted using ANSI C {{func link|vsnprintf()|link=http://en.cppreference.com/w/c/io/vfprintf}} <ref>
{{Cite web
|url = http://sourceforge.net/p/flightgear/simgear/ci/next/tree/simgear/nasal/lib.c#l308
|title = fgdata/simgear/simgear/nasal/lib.c, line 308
|accessdate = October 2015
}}
</ref>. Below is a table of supported format specifiers.
{{{!}} class="wikitable" width="75%"
{{!}}+ %[flags][width][.precision]specifier
! colspan="2" {{!}} Flags
{{!-}}
! Flag !! Output
{{!-}}
{{!}} <code>+</code> {{!!}} Forces to precede the result with a plus or minus sign ('''+''' or '''-''') even for positive numbers. By default, only negative numbers are preceded with a '''-''' sign.
{{!-}}
{{!}} ''space'' {{!!}} Prefixes non-signed numbers with a space.
{{!-}}
{{!}} <code>-</code> {{!!}} Left-align the output of this placeholder (the default is to right-align the output) when the width option is specified.
{{!-}}
{{!}} <code>0</code> {{!!}} Use 0 instead of spaces to pad a field when the width option is specified.
{{!-}}
{{!}} <code>#</code> {{!!}} Used with <code>o</code>, <code>x</code> or <code>X</code> specifiers the value is preceded with <tt>0</tt>, <tt>0x</tt> or <tt>0X</tt> respectively for values different than zero. Used with <code>e</code>, <code>E</code> and <code>f</code>, it forces the written output to contain a decimal point even if no digits would follow. By default, if no digits follow, no decimal point is written. Used with <code>g</code> or <code>G</code> the result is the same as with <code>e</code> or <code>E</code> but trailing zeros are not removed.
{{!-}}
! colspan="2" {{!}} Width
{{!-}}
{{!}} colspan="2" {{!}} Integer specifying the minimum number of characters to be returned. This includes the decimal point and decimal fraction as well as + or - signs.
{{!-}}
! colspan="2" {{!}} Precision
{{!-}}
{{!}} colspan="2" {{!}} Integer preceded by a dot specifying the number of decimal places to be written.
{{!-}}
! colspan="2" {{!}} Specifiers
{{!-}}
! Specifier !! Output
{{!-}}
{{!}} <code>d</code>, <code>i</code> {{!!}} Signed decimal number.
{{!-}}
{{!}} <code>s</code> {{!!}} A string
{{!-}}
{{!}} <code>%</code> {{!!}} Percent (%) character.
{{!-}}
{{!}} <code>c</code> {{!!}} A single character assigned to a character code, the code given in an integer argument. See http://www.asciitable.com/ for a list of supported characters and their codes.
{{!-}}
{{!}} <code>o</code> {{!!}} Unsigned integer as an octal number.
{{!-}}
{{!}} <code>u</code> {{!!}} Unsigned decimal integer.
{{!-}}
{{!}} <code>x</code>, <code>X</code> {{!!}} Unsigned integer as a hexadecimal number. If <code>x</code> is used, any letters in the number are lowercase, while <code>X</code> gives uppercase.
{{!-}}
{{!}} <code>e</code>, <code>E</code> {{!!}} Double value in scientific notation (i.e., ''[-]ddd.ddd'''e'''[+/-]ddd''), with an exponent being denoted by <tt>e</tt> or <tt>E</tt> depending on whether an upper or lowercase is used respectively.
{{!-}}
{{!}} <code>f</code> {{!!}} Floating-point number, in fixed decimal notation, by default with 6 decimal places.
{{!-}}
{{!}} <code>F</code> {{!!}} Appears to be available<ref>
{{Cite web
|url = http://sourceforge.net/p/flightgear/simgear/ci/next/tree/simgear/nasal/lib.c#l389
|title = fgdata/simgear/simgear/nasal/lib.c, line 389
|accessdate = October 2015
}}
</ref>, but doesn't work.
{{!-}}
{{!}} <code>g</code>, <code>G</code> {{!!}} Double in either normal or exponential notation, whichever is more appropriate for its magnitude. <code>g</code> uses lower-case letters, <code>G</code> uses upper-case letters. This type differs slightly from fixed-point notation in that insignificant zeroes to the right of the decimal point are not included. Also, the decimal point is not included on whole numbers.
{{!}}}

|param1 = format
|param1text = String specifying the format. Can be used with or without a format specifiers. See below for examples.
|param2 = arg
|param2text = Argument specifying a value to replace a format placeholder (such as <code>%d</code>) in the format string. Not required if there are no format specifiers.

|example1 = print(sprintf("%i", 54)); # prints "54"
|example2 = print(sprintf("Pi = %+.10f", math.pi)); # prints "Pi = +3.1415926536"
|example3 =
print(sprintf("%6d", 23)); # prints " 23"
print(sprintf("%06d", 23)); # prints "000023"
|example4 =
var FGVer = getprop("/sim/version/flightgear");
print(sprintf("You have FlightGear v%s", FGVer)); # prints "You have FlightGear v<your version>"
|example5 =
print(sprintf("Hexadecimal 100000 = %X", 100000)); # prints "Hexadecimal 100000 = 186A0"
print(sprintf("Hexadecimal 100000 = %x", 100000)); # prints "Hexadecimal 100000 = 186a0"
|example6 = print(sprintf("Code 65 is %c", 65)); # prints "Code 65 is A"
|example7 =
print(sprintf("%e", 54)); # prints "5.400000e+001"
print(sprintf("%E", 54)); # prints "5.400000E+001"
|example8 = print(sprintf("%o", 54)); # prints "66"
|example9 = print(sprintf("50%% of 100 is %i", 100 / 2)); # prints "50% of 100 is 50"
|example10 =
print(sprintf("%.2f", 1.4)); # prints "1.40"
print(sprintf("%.1f", 1.4)); # prints "1.4"
print(sprintf("% 4.1f", 1.4)); # prints " 1.4"
print(sprintf("%04.1f", 1.4)); # prints "01.4"
print(sprintf("% 6.1f", 1.4)); # prints " 1.4"
print(sprintf("%06.1f", 1.4)); # prints "0001.4"
}}

===str()===
{{Nasal doc
|syntax = str(value);
|source = {{simgear file|simgear/nasal/lib.c|l=186|t=Source}}
|text = Convert given value (scalar) to string. If <code>value</code> is a number, it will be converted to a string. If <code>value</code> is a string, the same string will be returned. If <code>value</code> is not a scalar (hash, vector, nil), <code>nil</code> will be returned.
|param1 = value
|param1text = The value to convert to string.
|example1 =
var result = str(true); # result is a string "1"
var result = str(false); # result is a string "0"
var result = str(12); # result is a string "12"
var result = str(12.5); # result is a string "12.5"
var result = str(-12.5); # result is a string "-12.5"
var result = str("12.5"); # result is a string "12.5"
var result = str([1, 2]); # result is a nil
var result = str({ x: 0 }); # result is a nil
var result = str(nil); # result is a nil
}}

===streq()===
{{Nasal doc
|syntax = streq(a, b);
|source = {{simgear file|simgear/nasal/lib.c|l=164|t=Source}}
|text = Tests the string values of the two arguments for equality. This function is needed because the <code>'''=='''</code> operator (see [[Nasal_Operators#Equality|Nasal Operators]]) tests for numeric equality first. If either or both the arguments are not strings, 0 (False) will be returned. Returns either 0 (False) or 1 (True). {{Note|This function is rarely required in typical code.}}
|param1 = a
|param1text = First argument for testing equality.
|param2 = b
|param2text = Second argument for testing equality.
|example1 = print(streq("0", "0")); # prints "1" (True)
|example2 =
print(0 == 0.0); # prints "1" (True)
print(streq("0", "0.0")); # prints "0" (False)
}}

===substr()===
{{Nasal doc
|syntax = substr(string, start [, length]);
|source = {{simgear file|simgear/nasal/lib.c|l=194|t=Source}}
|text = Similar the {{func link|subvec()}}, but operates on strings. Computes and returns a substring. The first argument specifies a string, the second is the index of the start of a substring, the optional third argument specifies a length (the default is to return the rest of the string from the start).
|param1 = string
|param1text = String to return a substring from.
|param2 = start
|param2text = Integer specifying the start of a substring. Negative values specify a position from the end of the string.
|param3 = length
|param3text = Optional argument specifying the length of the substring. Defaults to the end of the string.
|example1 = print(substr("abcde", 1, 3)); # prints "bcd"
|example2 = print(substr("abcde", 1)); # prints "bcde"
|example3 = print(substr("abcde", 2, 1)); # prints "c"
|example4 = print(substr("abcde", -2)); # prints "de"
|example5 = print(substr("abcde", -3, 2)); # prints "cd"
}}

===subvec()===
{{Nasal doc
|syntax = subvec(vector, start[, length]);
|source = {{simgear file|simgear/nasal/lib.c|l=98|t=Source}}
|text = Returns a sub-range of a vector. The first argument specifies a vector, the second a starting index, and the optional third argument indicates a length (the default is to the end of the vector).
|param1 = vector
|param1text = The vector to take the sub-vector from.
|param2 = start
|param2text = The starting point of the sub-vector within the given vector.
|param3 = length
|param3text = Optional argument specifying the length of the sub-vector, from the starting point.
'''Notes:'''
* Omitting the ''vector'' and ''start'' arguments is not an error (possibly it should be) but the return value is ''nil''.
* A negative ''start'' argument ''is'' an error. This seems wrong. Perhaps the language designer could comment.
* A value of ''start'' greater than ''size(vector)'' causes an error. A value equal to ''size(vector)'' returns an empty vector.
* If the value of ''length'' is greater than ''size(vector) - start'' then it is ignored. That is, all elements from ''start'' to the end of ''vector'' are returned. If ''length'' is zero then an empty vector is returned. A negative value of ''length'' causes an error.
|example1 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 0)); # prints "[1, 2, 3]"
|example2 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 1)); # prints "[2, 3]"
|example3 =
var vector = [1, 2, 3];
debug.dump(subvec(vector, 1, 1)); # prints "[2]"
}}

=== typeof()===
{{Nasal doc
|syntax = typeof(object);
|source = {{simgear file|simgear/nasal/lib.c|l=287|t=Source}}
|text = Returns a string indicating the whether the object is <code>'''nil'''</code>, a scalar (number or string), a vector, a hash, a function, or a ghost.
|param1 = object
|param1text = Object to return the type of.
|example1 =
var object = nil;
print(typeof(object)); # prints "nil"
|example2 =
var object = "Hello world!";
print(typeof(object)); # prints "scalar"
|example3 =
var object = math.pi;
print(typeof(object)); # prints "scalar"
|example4 =
var object = [1, 2, 3];
print(typeof(object)); # prints "vector"
|example5 =
var object = {};
print(typeof(object)); # prints "hash"
|example6 =
var object = func {};
print(typeof(object)); # prints "func"
|example7 =
var object = airportinfo();
print(typeof(object)); # prints "ghost"
}}



==Extension functions==
The '''extension functions''' are global functions that have been added to Nasal since its integration into FlightGear. Unlike the core library functions, they are generally specifically designed to interact directly with FlightGear. Extension functions come from three source files:
*{{flightgear file|src/Scripting/NasalPositioned.cxx}}
*{{flightgear file|src/Scripting/NasalSys.cxx}}
*{{fgdata file|Nasal/globals.nas}}

===abort()===
{{Nasal doc
|syntax = abort();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=565|t=Source}}
|text = This function is a wrapper for the C++ {{func link|abort()|link=http://www.cplusplus.com/reference/cstdlib/abort/}} function. It simply aborts FlightGear with an error, which varies depending on the operating system. This function should not really be used; instead, please use the "exit" [[Fgcommands|fgcommand]], which will exit FlightGear more gracefully (see example below).
|example1text = This example will immediately stop FlightGear with an error, such as "FlightGear has stopped working."
|example1 = abort();
|example2text = For exiting FlightGear in a better way, please use the following code:
|example2 = fgcommand("exit");
}}

=== abs() ===
{{Nasal doc
|syntax = abs(number);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = This simple function returns the {{wikipedia|absolute value|noicon=1}} of the provided number.
|param1 = number
|param1text = This argument is required and should be a number.
|example1 = print(abs(1)); # prints "1"
|example2 = print(abs(-1)); # prints "1"
}}

===aircraftToCart() ===
This new function in FG 2017.2.1 takes coordinates in aircraft structural coordinate system, and translate them into geocentric coordinates.
Example for (5,6,7):
<syntaxhighlight lang="nasal">
var pos = aircraftToCart({x: -5, y: 6, z: -7});
var coord = geo.Coord.new();
coord.set_xyz(pos.x, pos.y, pos.z);
</syntaxhighlight>
Notice: x and z is inverted sign on purpose.
if you want lat. lon, alt from that, just call: (degrees and meters)

<syntaxhighlight lang="nasal">
coord.lat()
coord.lon()
coord.alt()
</syntaxhighlight>

===addcommand() ===
{{Nasal doc
|syntax = addcommand(name, code);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=659|t=Source}}
|version = 2.12
|commit = {{flightgear commit|7b663c|t=commit}}
|text = {{see also|Howto:Add new fgcommands to FlightGear}}

This function enables the addition of a new custom [[fgcommands|fgcommand]] to FlightGear from within Nasal. An fgcommand created using this method can be used in exactly the same way as the built-in fgcommands. Also, an fgcommand created via this method will always return True or 1, like all other fgcommands.
|param1 = name
|param1text = This will become the name of the new fgcommand. Must be a string.
|param2 = code
|param2text = The code that will be executed when the fgcommand is run. Must be a function.
|example1text = This example adds a new fgcommand and then runs it. Although it executes a simple {{func link|print()}} statement, any valid Nasal code can be used.
|example1 = addcommand("myFGCmd", func(node) {
print("fgcommand 'myFGCmd' has been run.");
props.dump( node );
});
fgcommand("myFGCmd", props.Node.new({foo:1, bar:2}) );
|example2text = This example demonstrates how parameters are defined in a new fgcommand.
|example2 = addcommand("myFGCmd", func(node){
print(node.getNode("number").getValue()); # prints the value of "number," which is 12
});
fgcommand("myFGCmd", props.Node.new({"number": 12}));
}}

===airportinfo()===
{{Nasal doc
|syntax = airportinfo();
airportinfo(type);
airportinfo(id);
airportinfo(lat, lon[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1024|t=Source}}
|text = Function for retrieval of airport, heliport, or seaplane base information. It returns a Nasal ghost; however, its structure is like that of a Nasal hash. The following information is returned:
* '''parents''': A vector containing a hash of various functions to access information about the runway. These functions are:
** '''findBestRunwayForPos()''' return runway as ghost by given geo position, e.g. <code>var rwy = airportinfo().findBestRunwayForPos(geo.aircraft_position());</code>.
** '''runway()''' return runway as ghost by runway ID, e.g. <code>var rwy = airportinfo().runway("18R");</code>.
** '''runwaysWithoutReciprocals()''' return vector of runways as ghost.
** '''helipad()''' return helipad as ghost by helipad ID, e.g. <code>var heli = airportinfo().helipad("H19");</code>.
** '''tower()''' return hash with <code>lat</code>, <code>lon</code>, <code>elevation</code> fields.
** '''comms()''' return vector of hashes, each hash with <code>frequency</code> and <code>ident</code> fields.
** '''sids()''' return vector of strings with SID IDs.
** '''stars()''' return vector of strings with STAR IDs.
** '''getApproachList()''' return vector of string with approaches.
** '''parking()''' return vector of hashes, each hash with <code>lat</code>, <code>lon</code>, <code>elevation</code>, <code>name</code> fields.
** '''getSid()''' return SID as ghost, e.g. <code>var sid = airportinfo().getSid("SA1A");</code>.
** '''getStar()''' return STAR as ghost, e.g. <code>var star = airportinfo().getStar("KEILA1");</code>.
** '''getIAP()''' return IAP as ghost, e.g. <code>var iap = airportinfo().getIAP("ILS02");</code>.
** '''getApproach()''' return approach as ghost, e.g. <code>var approach = airportinfo().getApproach("ILS02");</code>.
** '''tostring()''' just return string "an airport ICAO".
** See also {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1902}}.
* '''lon''': Longitude of the location.
* '''lat''': Latitude of the location.
* '''has_metar''': True or false depending whether the airport has a [[METAR]] code defined for it.
* '''elevation''': Elevation of the location in metres.
* '''id''': ICAO code of the airport (or ID of the seaplane base/heliport).
* '''name''': Name of the airport/heliport/seaplane base.
* '''runways'''
** '''<runway name>'''
*** '''id''': Name of runway.
*** '''lat''': Latitude of the runway.
*** '''lon''': Longitude of the runway.
*** '''heading''': True heading of the runway.
*** '''length''': Length of the runway in metres.
*** '''width''': Width of the runway in metres.
*** '''surface''': Runway surface type.
*** '''threshold''': Length of the runway's {{wikipedia|displaced threshold}} in metres. Will return 0 if there is none.
*** '''stopway''': Length of the runway's stopway (the area before the threshold) in metres. Will return 0 if there is none.
*** '''reciprocal''': <code>runway</code> ghost of the reciprocal runway.
*** '''ils_frequency_mhz''': ILS frequency in megahertz.
*** '''ils''': <code>navaid</code> ghost of the ILS transmitter.
* '''helipads'''
** '''<helipad name>'''
*** '''id''': Name of helipad.
*** '''lat''': Latitude of the helipad.
*** '''lon''': Longitude of the helipad.
*** '''heading''': True heading of the helipad.
*** '''length''': Length of the helipad in metres.
*** '''width''': Width of the helipad in metres.
*** '''surface''': Helipad surface type.
* '''taxiways'''
** '''<taxiway name>'''
*** '''id''': Name of taxiway.
*** '''lat''': Latitude of the taxiway.
*** '''lon''': Longitude of the taxiway.
*** '''heading''': Heading of the taxiway.
*** '''length''': Length of the taxiway in metres.
*** '''width''': Width of the taxiway in metres.
*** '''surface''': Taxiway surface type.

Information is extracted in the same way as accessing members of a Nasal hash. For example:
<syntaxhighlight lang="nasal">
# prints to lengths of the runways of the nearest airport in feet and metres
var info = airportinfo();
print("-- Lengths of the runways at ", info.name, " (", info.id, ") --");
foreach(var rwy; keys(info.runways)){
print(rwy, ": ", math.round(info.runways[rwy].length * M2FT), " ft (", info.runways[rwy].length, " m)");
}
</syntaxhighlight>

Note that searches for locations that are a long way away (e.g., the nearest seaplane base to the middle of the Sahara) may cause FlightGear to pause for an amount of time.
|param1 = id
|param1text = The {{wikipedia|International Civil Aviation Organization airport code|ICAO code|noicon=1}} of an airport to retrieve information about.
|param2 = type
|param2text = When this argument is used, the function will return the closest airport of a certain type. Can be one of "heliport," "seaport," or "airport" (default).
: {{inote|Running this function without any parameters is equivalent to this:
: <syntaxhighlight lang="nasal">
airportinfo("airport");
</syntaxhighlight>
}}
|param3 = lat ''and'' lon
|param3text = When these parameters are used, the function will return information on the nearest airport, heliport or seaplane base (depending on the '''type''' parameter) to those coordinates.
|example1 = var info = airportinfo();
print("Nearest airport: ", info.name, " (", info.id, ")"); # prints the name and ICAO code of the nearest airport
|example2 = var info = airportinfo("heliport");
print("Elevation of the nearest heliport: ", math.round(info.elevation * M2FT), " ft"); # prints the elevation and name of the nearest heliport
|example3 = var info = airportinfo("KSQL");
print("-- Runways of ", info.name, " (", info.id, "): --");
foreach(var rwy; keys(info.runways)) {
print(rwy); # prints the runways of KSQL
}
|example4 = var info = airportinfo(37.81909385, -122.4722484);
print("Coordinates of the nearest airport: ", info.lat, ", ", info.lon); # print the name and ICAO of the nearest airport to the Golden Gate Bridge
|example5 = var info = airportinfo(37.81909385, -122.4722484, "seaport");
print("Nearest seaplane base: ", info.name, " (", info.id, ")"); # print the name and ID of the nearest seaplane base to the Golden Gate Bridge
|example6text = This example prints the all information from an <code>airportinfo()</code> call.
|example6 = var info = airportinfo("KSFO");
print(info.name);
print(info.id);
print(info.lat);
print(info.lon);
print(info.has_metar);
print(info.elevation);
foreach(var rwy; keys(info.runways)){
print("-- ", rwy, " --");
print(info.runways[rwy].lat);
print(info.runways[rwy].lon);
print(info.runways[rwy].length);
print(info.runways[rwy].width);
print(info.runways[rwy].heading);
print(info.runways[rwy].stopway);
print(info.runways[rwy].threshold);
<nowiki>}</nowiki>
}}

===airwaysRoute() ===
{{Nasal doc
|syntax = airwaysRoute(start, end[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1933|t=Source}}
|text = {{see also|Nasal Flightplan}}
This function returns a vector containing waypoints between two given waypoints. The returned waypoints are ghosts, but can be accessed in the same way as a Nasal hash. See [[Nasal Flightplan]] for more information.
|param1 = start
|param1text = Start waypoint, in the form of a waypoint ghost, such as that provided by {{func link|flightplan()}}.
|param2 = end
|param2text = Same as above.
|param3 = type
|param3text = Instructs the function to compute a high level route (when set to "highlevel"), or a low level route (when set to "lowlevel"). Defaults to "highlevel."
|example1text = In the [[route manager]] dialog, add two waypoints to the flightplan, ideally ones that are far apart (tip: use the [[Map]] for this). Then run this code in your Nasal Console.
|example1 = var fp = flightplan();
var start = fp.getWP(0);
var end = fp.getWP(fp.getPlanSize() - 1);
var rt = airwaysRoute(start, end);
foreach(var wp; rt){
print(wp.wp_name); # print the waypoints in the computed route
}
|example2text = Exactly the same as above, but computes a low level path.
|example2 = var fp = flightplan();
var start = fp.getWP(0);
var end = fp.getWP(fp.getPlanSize() - 1);
var rt = airwaysRoute(start, end, "lowlevel");
foreach(var wp; rt){
print(wp.wp_name); # print the waypoints in the computed route
<nowiki>}</nowiki>
}}

===airway()===

{{Nasal doc
|syntax = airway(ident [, pos]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2644|t=Source}}
|text = {{see also|Nasal Flightplan}}
This function returns a ghost containing an airway of a specified id.
|param1 = ident
|param1text = a Positioned ghost (leg, navaid, airport) and so on, passed to the search function.
|param2 = pos
}}

===assert()===
{{Nasal doc
|syntax = assert(condition[, message]);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|version = 3.2
|commit = {{fgdata commit|8b16a7|t=commit}}
|text = Returns either true if the condition evaluates as true, or aborts with a {{func link|die()}} call, which can be customised.
|param1 = condition
|param1text = Condition to evaluate.
|param2 = message
|param2text = Optional message that will be used in any {{func link|die()}} call. Defaults to "assertion failed!"
|example1 = var a = 1;
var b = 2;
print(assert(a < b)); # prints "1" (true)
|example2 = var a = 1;
var b = 2;
assert(a > b, 'a is not greater than b'); # aborts with a custom error message
}}

===carttogeod()===
{{Nasal doc
|syntax = carttogeod(x, y, z);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=945|t=Source}}
|text = Converts {{wikipedia|ECEF|Earth-centered, Earth-fixed}} coordinates (x, y and z) to {{wikipedia|geodetic coordinates}} (latitude, longitude, and altitude). A vector is returned containing latitude and longitude, both in degrees, and altitude, which is returned in metres above the equatorial radius of Earth as defined by the {{wikipedia|WGS 84}} (6,378,137 metres).<ref>{{simgear file|simgear/math/sg_geodesy.hxx|l=43}}</ref>
|param1 = x
|param1text = Mandatory x-axis value, in metres.
|param2 = y
|param2text = Mandatory y-axis value, in metres.
|param3 = z
|param3text = Mandatory z-axis value, in metres.
|example1 = var (lat, lon, alt) = carttogeod(6378137, 0, 0); # point is the intersection of the prime meridian and equator.
print("Latitude: ", lat); # prints lat, lon and alt, which are all zero, see above
print("Longitude: ", lon);
print("Altitude: ", alt);
}}

===cmdarg()===
{{Nasal doc
|private = _cmdarg()
|syntax = cmdarg();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=513|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = <code>cmdarg()</code> returns the property root of certain types of XML files. These could be nodes in the [[Property Tree]], or temporary and/or non-public nodes outside the Property tree.
It is used by Nasal scripts embedded in XML files. It returns a <code>props.Node</code> object (see {{fgdata file|Nasal/props.nas}}), and you can use all of its methods on the returned value. <code>cmdarg()</code> should only be used in four types/places of XML files:
* Bindings: This is needed so that the value of a joystick's axis can be accessed internally.
* Dialogs: This will return the root of the dialog in the Property Tree. This is useful for dialogs that are created/modified procedurally (e.g. for populating/changing widgets while loading the dialog).
* Embedded Canvases: The Nasal code behind [[Canvas]] windows [[Howto:Adding a canvas to a GUI dialog|embedded in PUI dialogs]] can use it to accessing the root directory of their Canvas.
* Animation XML files: If the animation XML file is used in an AI/MP model, <code>cmdarg()</code> will return the root of the AI model in the <code>/ai/models/</code> directory. Examples: <code>/ai/models/aircraft[3]/</code>, <code>/ai/models/multiplayer[1]/</code>

You should not use <code>cmdarg()</code> in places other than those stated above. Although it won't cause an error, it will return the value of the last legitimate <code>cmdarg()</code> call.

Also, you should not delay <code>cmdarg()</code> using {{func link|maketimer()}}, {{func link|settimer()}} or {{func link|setlistener()}}, because it will return an unrelated property.
|example1 = fgcommand("dialog-show", {"dialog-name": "cmdarg-demo"});
|example1text = <br>This example demonstrates the usage of <code>cmdarg()</code> in a binding. Save the below XML snippet as <tt>[[$FG_ROOT]]/gui/dialogs/cmdarg-demo.xml</tt>. Then run the Nasal snippet below in your [[Nasal Console]]. Upon clicking {{button|Close}}, a message will be printed sowing the root of the binding in the Property Tree.
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>cmdarg-demo</name>
<layout>vbox</layout>

<text>
<label>Click "Close" to activate the demonstration (a message in the console).</label>
</text>

<button>
<legend>Close</legend>
<binding>
<command>nasal</command>
<script>print("Button binding root: '" ~ cmdarg().getPath() ~ "'");</script>
</binding>
<binding>
<command>dialog-close</command>
</binding>
</button>

</PropertyList>
</syntaxhighlight>
|example2text = This example demonstrates the usage of <code>cmdarg()</code> in Nasal code within dialogs. Open <tt>[[$FG_ROOT]]/gui/dialogs/cmdarg-demo.xml</tt> from the previous example, copy & paste the code below, and save it. Then run the same Nasal snippet as the previous example in your Nasal Console. If you click {{button|Click me!}}, the button's label will change to "I've been changed!"
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>cmdarg-demo</name>
<layout>vbox</layout>

<text>
<label>Click "Click me!" to activate the demonstration (the button's label will change).</label>
</text>

<button>
<legend>Click me!</legend>
<binding>
<command>nasal</command>
<script>change_label();</script>
</binding>
</button>

<button>
<legend>Close</legend>
<binding>
<command>dialog-close</command>
</binding>
</button>

<nasal>
<open><![CDATA[
var dlg_root = cmdarg();
var dlg_name = {"dialog-name": "cmdarg-demo"};
var change_label = func {
dlg_root.getNode("button[0]/legend").setValue("I've been changed!");
fgcommand("dialog-close", dlg_name);
fgcommand("dialog-show", dlg_name);
}
]]></open>
</nasal>

</PropertyList>
</syntaxhighlight>
|example3text = For an example of <code>cmdarg()</code> used with Canvas, please see [[Howto:Adding a canvas to a GUI dialog#FGPlot|Howto:Adding a canvas to a GUI dialog]].
}}

===courseAndDistance()===
{{Nasal doc
|syntax = courseAndDistance(to);
courseAndDistance(from, to);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1668|t=Source}}
|text = Returns a vector containing the course from one point to another and the distance between them in nautical miles. The course is the initial bearing (see [http://www.movable-type.co.uk/scripts/latlong.html#bearing here]), and is in the range 0–360. Both arguments can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object with geodetic coordinates (cartesian coordinates will not be accepted)
|param1 = from
|param1text = Optional parameter defining the from where the function should calculate its results. If the function is given one argument ('''to'''), the aircraft's current position will be used. As well as the argument types as defined above, this argument can be two numbers separated with a comma, as if the function is taking three arguments. See example 5 below.
|param2 = to
|param2text = Like the first parameter, but defines the second point.
|example1text = This example demonstrates the usage of the function with the <code>airport</code> ghost type.
|example1 = var from = airportinfo("KSFO");
var to = airportinfo("KSQL");
var (course, dist) = courseAndDistance(from, to);
print(course); # prints course from KSFO to KSQL
print(dist); # prints distance in nm from KSFO to KSQL
|example2text = This example demonstrates the usage of the function with hashes containing ''lat'' and ''lon''.
|example2 = var from = {lat: 0, lon: 0};
var to = {lat: 1, lon: 1};
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example3text = This example demonstrates usage of a geo.Coord object.
|example3 = var from = geo.Coord.new().set_latlon(0, 0);
var to = geo.Coord.new().set_latlon(1, 1);
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example4text = This example demonstrates usage of differing parameter types.
|example4 = var from = airportinfo("KSFO");
var to = geo.Coord.new().set_latlon(0, 0);
var (course, dist) = courseAndDistance(from, to);
print(course);
print(dist);
|example5text = The same as above, but the other way round.
|example5 = var to = {lat: 1, lon: 1};
var (course, dist) = courseAndDistance(0, 0, to);
print(course);
print(dist);
|example6text = Usage of just one parameter.
|example6 = var dest = airportinfo("KSQL");
var (course, dist) = courseAndDistance(dest);
print("Turn to heading ", math.round(course), ". You have ", sprintf("%.2f", dist), " nm to go");
}}

===createFlightplan()===
{{Nasal doc
|syntax = createFlightplan(path);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2331|t=Source}}
|text = Creates an empty flightplan object. It accepts one argument, ''path'' passed an absolute path to a .fgfp / .gpx file, it will populate the flightplan with waypoints from the file.
|param1 = path
|param1text = Optional parameter defining the file from which a flightplan will be populated.
|example1 =
var path = getprop("/sim/fg-home") ~ "/Export/test.fgfp";
var flightplan = createFlightplan(path);
debug.dump(flightplan);
}}

===createDiscontinuity()===
{{Nasal doc
|syntax = createDiscontinuity();
|text = Returns a <code>waypoint</code> ghost object. A route discontinuity is inserted by an {{abbr|FMS|Flight Management System}} when it is unsure how to connect two waypoints.
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2045|t=Source}}
|version = 2016.1
|commit = {{flightgear commit|caead6|t=commit}}
}}
===createViaTo()===
{{Nasal doc
|syntax = createViaTo(airway, waypoint);
|text = Returns a <code>waypoint</code> ghost object. It represents a route "via '''airway''' to '''waypoint'''".
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=2009|t=Source}}
|version = 2016.1
|commit = {{flightgear commit|caead6|t=commit}}
|param1 = airway
|param1text = The name of an airway.
|param2 = waypoint
|param2text = Must be in the airway and one of:
* The name of a waypoint.
* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, or <code>fix</code> ghost object.
}}
===createWP()===
{{Nasal doc
|syntax = createWP(pos, name[, flag]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1964|t=Source}}
|text = Creates a new waypoint ghost object.
|param1 = pos
|param1text = Dictates the position of the new waypoint. It can be one of the following:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. See example 4 below.
|param2 = name
|param2text = String that will become the name of the new waypoint.
|param3 = flag
|param3text = Optional string that will tell FlightGear what type of waypoint it is. Must be one of "sid," "star," "approach," "missed," or "pseudo."
|example1text = Creates a waypoint directly in front and 1 km away and appends it to the flight plan.
|example1 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example2 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP({lat: pos.lat(), lon: pos.lon()}, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example3 = var apt = airportinfo();
var wp = createWP(apt, "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example4 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos.lat(), pos.lon(), "NEWWP");
var fp = flightplan();
fp.appendWP(wp);
|example5text = Creates a new waypoint and adds it to the flight plan. Waypoints of the type "pseudo" are then removed from the flight plan, including the new waypoint. The {{func link|print()}} statements show this.
|example5 = var pos = geo.aircraft_position().apply_course_distance(getprop("/orientation/heading-deg"), 1000);
var wp = createWP(pos, "NEWWP", "pseudo");
var fp = flightplan();
fp.appendWP(wp);
print(fp.getPlanSize());
fp.clearWPType("pseudo");
print(fp.getPlanSize());
}}

===createWPFrom()===
{{Nasal doc
|syntax = createWPFrom(object[, flag]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1989|t=Source}}
|text = Creates a new waypoint object from another object.
|param1 = object
|param1text = A ghost object. Must be a ghost type that is one of "airport," "navaid," "runway," or "fix."
|param2 = flag
|param2text = Optional string that will tell FlightGear what type of waypoint it is. Must be one of "sid," "star," "approach," "missed," or "pseudo."
|example1text = Creates a new waypoint and appends it to the flight plan.
|example1 = var apt = airportinfo("KSFO");
var wp = createWPFrom(apt);
var fp = flightplan();
fp.appendWP(wp);
|example2text = Creates a new waypoint and appends it to the flight plan. This way point is then removed; the {{func link|print()}} statements prove this.
|example2 = var apt = airportinfo("KSFO");
var wp = createWPFrom(apt, "pseudo");
print(wp.wp_name);
var fp = flightplan();
fp.appendWP(wp);
print(fp.getPlanSize());
fp.clearWPType("pseudo");
print(fp.getPlanSize());
}}

===defined()===
{{Nasal doc
|syntax = defined(symbol);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns 1 (true) or 0 (false) depending on whether a variable exists.
|param1 = symbol
|param1text = A string that will be what the function searches for.
|example1 = var number = 12;
var check_exist = func {
print("Variable 'number' ", defined("number") == 1 ? "exists" : "does not exist"); # 'number' does exist
print("Variable 'number2' ", defined("number2") == 1 ? "exists" : "does not exist"); # 'number2' does not exist
}
check_exist();
}}

===directory()===
{{Nasal doc
|syntax = directory(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=572|t=Source}}
|text = Returns a vector containing a list of the folders and files in a given file path or <code>'''nil'''</code> if the path doesn't exist. Hidden folders and files are not added to the vector.
{{inote|The first two elements of the vector will be <code>'.'</code> and <code>'..'</code>. These are for navigating back up the file tree, but have no use in Nasal. They can be safely removed from the vector.}}
|param1 = path
|param1text = Absolute file path.
|example1text = Gets the folders and files in [[$FG_ROOT]], and then removes the extra first two elements (see note above).
|example1 = var dir = directory(getprop("/sim/fg-root")); # get directory
dir = subvec(dir, 2); # strips off the first two elements
debug.dump(dir); # dump the vector
}}

===fgcommand()===
{{Nasal doc
|syntax = fgcommand(cmd[, args]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=456|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = Runs an fgcommand. See also {{readme file|commands}} and [[Bindings]] for more information. See {{flightgear file|src/Main/fg_commands.cxx|l=1425}} for the full list of fgcommands. Note that fgcommands generated by {{func link|addcommand()}} can also be run using this function. Also, the full list of fgcommands depends on the version of FlightGear you have. Returns 1 (true) if the fgcommand succeeded or 0 (false) if it failed.
|param1 = cmd
|param1text = String that is the name of the command that is to be run.
|param2 = args
|param2text = If the fgcommand takes arguments, they are inputted using this argument. Can either be a <code>props.Node</code> object, or a hash (see examples below).
|example1 = fgcommand("null"); # does nothing
|example2 = var args = props.Node.new({'script': 'print("Running fgcommand");'});
if (fgcommand("nasal", args)) { # prints "Running fgcommand" and then one of these print statements
print("Fgcommand succeeded");
} else {
print("Fgcommand encountered a problem");
}
|example3 = var args = { 'dialog-name': 'about' };
fgcommand("dialog-show", args); # shows the 'about' dialog
}}

===findAirportsByICAO() ===
{{Nasal doc
|syntax = findAirportsByICAO(search[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1096|t=Source}}
|text = Returns a vector containing <code>airport</code> ghost objects which are (by default) airports whose ICAO code matches the search string. The results are sorted by range from closest to furthest.
|param1 = search
|param1text = Search string for the function. Can either be a partial or a full ICAO code.
:{{icaution|The more matches there are for the given code, the longer the function will take. Passing just one character (e.g., "K"), might make FlightGear hang for a certain amount of time.}}
|param2 = type
|param2text = This will narrow the search to airports of a certain type. By default, only airports are searched for. May be one of "airport," "heliport," or "seaport."
|example1 = var apts = findAirportsByICAO("KSF"); # finds all airports matching "KSF"
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")"); # prints them
}
|example2 = var apts = findAirportsByICAO("SP0", "seaport"); # finds all seaplane bases matching "SP0"
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")"); # prints them
}
|example3 = var apt = findAirportsByICAO("XBET"); # one way to check if an airport does exist"
if (size(apt) == 0) {
print("Airport does not exist"); # this one will be printed
} else {
print("Airport does exist");
<nowiki>}</nowiki>
}}

===findAirportsWithinRange()===
{{Nasal doc
|syntax = findAirportsWithinRange([pos, ]range[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1066|t=Source}}
|text = Returns a vector of <code>airport</code> ghost object which are (by default) airports that are within a given range of a given position, or the aircraft's current position. The results are sorted by range from closest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findAirportsWithinRange(lat, lon, range, type);</code>.
|param2 = range
|param2text = Mandatory number giving the range in nautical miles within which to search for airports/heliports/seaplane bases.only airports are searched for.
|param3 = type
|param3text = This will narrow the search to airports of a certain type. By default, only airports are searched for. May be one of "airport," "heliport," or "seaport."
|example1text = Searches for airports within 10 nm of [[KSFO]].
|example1 = var pos = airportinfo("KSFO");
var apts = findAirportsWithinRange(pos, 10);
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
}
|example2text = Searches for seaplane bases within 15 nm of [[KSFO]].
|example2 = var pos = airportinfo("KSFO");
var apts = findAirportsWithinRange(pos, 15, "seaport");
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
}
|example3text = Searches for airports within 10 nm of your current position.
|example3 = var apts = findAirportsWithinRange(10);
foreach(var apt; apts){
print(apt.name, " (", apt.id, ")");
<nowiki>}</nowiki>
}}

===findCommByFrequencyMHz()===
findCommByFrequencyMHz([pos, ]freq[, type]);
[[sourceforge:p/flightgear/flightgear/ci/next/tree/src/Scripting/NasalPositioned.cxx#l1547|source]]

Returns a <code>comm</code> ghost object for a station matching a given frequency. If there is more than one station with that frequency, the nearest station is returned.

'''pos'''

: Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findCommByFrequencyMHz(lat, lon, freq, type);</code>.
; freq
: Frequency, in megahertz, of the station to search for.
; type
: This will narrow the search to station of a certain type. Defaults to "all." For the full list of accepted type arguments, see flightgear/src/Navaids/positioned.cxx (line 160)
'''Example'''
var com = findCommByFrequencyMHz(123.6);
print("ID: ", com.id); # prints info about the comm station
print("Name: ", com.name);
print("Latitude: ", com.lat);
print("Longitude: ", com.lon);
print("Type: ", com.type);
print("Frequency: ", sprintf("%.3f", com.frequency), " Mhz");

=== findFixesByID() ===
{{Nasal doc
|syntax = findFixesByID([pos, ]id);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1627|t=Source}}
|text = Returns a vector containing <code>fix</code> ghost objects matching a given ID, sorted by range from a certain position.
{{inote|Fixes are (usually) also known as waypoints.}}
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findFixesByID(lat, lon, id);</code>.
|param2 = id
|param2text = Full or partial ID of the fix to search for.
:{{inote|1=Inputting a partial ID does not work correctly (see [http://forum.flightgear.org/viewtopic.php?f=30&t=28129 here]). It is best to just input a full ID.}}
|example1 = var fixes = findFixesByID("POGIC");
foreach(var fix; fixes){
print(fix.id, " - lat: ", fix.lat, " {{!}} lon: ", fix.lon); # prints information about POGIC
}
|example2 = var fix = findFixesByID("ZUNAP");
fix = fix[0];
var (course, dist) = courseAndDistance(fix);
print("Turn to heading ", math.round(course), ". You have ", sprintf("%.2f", dist), " nm to go to reach ", fixes[0].id);
}}

===findNavaidByFrequencyMHz()===
{{Nasal doc
|syntax = findNavaidByFrequencyMHz([pos, ]freq[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1547|t=Source}}
|text = Returns a <code>navaid</code> ghost object for a navaid matching a given frequency. If there is more than one navaid with that frequency, the nearest station is returned.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidByFrequencyMHz(lat, lon, freq, type);</code>.
|param2 = freq
|param2text = Frequency, in megahertz, of the navaid to search for.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaid = findNavaidByFrequencyMHz(109.55);
print("ID: ", navaid.id); # prints info about the navaid
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 100), " Mhz");
print("Range: ", navaid.range_nm, " nm");
if(navaid.course) print("Course: ", navaid.course);
}}

=== findNavaidsByFrequencyMHz()===
{{Nasal doc
|syntax = findNavaidsByFrequencyMHz([pos, ]freq[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1572|t=Source}}
|text = Returns a vector conatining <code>navaid</code> ghost objects for navaids that match a given frequency, sorted from nearest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsByFrequencyMHz(lat, lon, freq, type);</code>.
|param2 = freq
|param2text = Frequency, in megahertz, of the navaid to search for.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaids = findNavaidsByFrequencyMHz(109.55);
foreach(var navaid; navaids){
print("--");
print("ID: ", navaid.id); # prints info about the navaid
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 100), " Mhz");
print("Range: ", navaid.range_nm, " nm");
if(navaid.course) print("Course: ", navaid.course);
print("--");
<nowiki>}</nowiki>
}}

===findNavaidsByID()===
{{Nasal doc
|syntax = findNavaidsByID([pos, ]id[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1600|t=Source}}
|text = Returns a vector containing <code>navaid</code> ghost objects matching a given ID, sorted by range from a certain position.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsByID(lat, lon, id, type);</code>.
|param2 = id
|param2text = Full or partial ID of the fix to search for.
:{{inote|1=Inputting a partial ID does not work correctly (see [http://forum.flightgear.org/viewtopic.php?f=30&t=28129 here]). It is best to just input a full ID.}}
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1 = var navaid = findNavaidsByID("MXW");
navaid = navaid[0];
print("ID: ", navaid.id); # prints info about 'MXW' (a VOR station)
print("Name: ", navaid.name);
print("Latitude: ", navaid.lat);
print("Longitude: ", navaid.lon);
print("Elevation (AMSL): ", navaid.elevation, " m");
print("Type: ", navaid.type);
print("Frequency: ", sprintf("%.3f", navaid.frequency / 1000), " Mhz");
print("Range: ", navaid.range_nm, " nm");
}}

===findNavaidsWithinRange()===
{{Nasal doc
|syntax = findNavaidsWithinRange([pos, ]range[, type]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1518|t=Source}}
|text = Returns a vector of <code>navaid</code> ghost objects which are within a given range of a given position (by default the aircraft's current position). The results are sorted from closest to furthest.
|param1 = pos
|param1text = Optional position to search around. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost type
:* A hash with ''lat'' and ''lon'' members
:* A geo.Coord object
:* Two numbers separated by a comma, as if the function is taking three arguments. Example: <code>findNavaidsWithinRange(lat, lon, range, type);</code>.
|param2 = range
|param2text = Mandatory number giving the range in nautical miles within which to search for navaids.
|param3 = type
|param3text = This will narrow the search to navaids of a certain type. Defaults to "all." For the full list of accepted type arguments, see {{flightgear file|src/Navaids/positioned.cxx|l=127}}.
|example1text = Searches for navaids within 10 nm of [[KSFO]].
|example1 = var pos = airportinfo("KSFO");
var navs = findNavaidsWithinRange(pos, 10);
foreach(var nav; navs){
print(nav.name, " (ID: ", nav.id, ")");
}
|example2text = Searches for navaids within 10 nm of your current position.
|example2 = var navs = findNavaidsWithinRange(10);
foreach(var nav; navs){
print(nav.name, " (ID: ", nav.id, ")");
<nowiki>}</nowiki>
}}

===finddata()===
{{Nasal doc
|syntax = finddata(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=603|t=Source}}
|text = Takes a relative path and tries to return an absolute one. It works by appending the relative path to some paths and testing to see if they exist. As of FlightGear v3.7, these paths are the TerraSync directory (tested first) and [[$FG_ROOT]].
|param1 = path
|param1text = A relative path as a string.
|example1 = var path = finddata("Aircraft/Generic");
print(path); # prints the absolute path to $FG_ROOT/Aircraft/Generic
|example2 = var path = finddata("Airports");
print(path); # prints the absolute path to <TerraSync dir>/Airports
|example3 = var path = finddata("preferences.xml");
print(path); # prints the absolute path to $FG_ROOT/preferences.xml
}}

===flightplan()===
{{Nasal doc
|syntax = flightplan([path]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1738|t=Source}}
|text = {{see also|Nasal Flightplan}}
Returns a flight plan object, either one for the current flight plan, or one loaded from a given path.
|param1 = path
|param1text = Optional path to flight plan XML file.
|example1text = Gets the active flight plan and gets the ID of the current waypoint. Note that this example requires a flight plan to be set in the [[Route Manager]] first.
|example1 = var fp = flightplan();
print(fp.getWP(fp.current).id);
|example2text = Creates a new flight plan from an XML file and prints the IDs of the waypoints. Note that this example requires a flight plan to have been created and saved as <tt>''[[$FG_HOME]]/fp-demo.xml''</tt>.
|example2 = var path = getprop('/sim/fg-home') ~ '/fp-demo.xml';
var fp = flightplan(path);
for(var i = 0; i < fp.getPlanSize(); i += 1){
print(fp.getWP(i).id);
<nowiki>}</nowiki>
}}

===geodinfo()===
{{Nasal doc
|syntax = geodinfo(lat, lon[, max_alt]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=981|t=Source}}
|text = Returns a vector containing two entries or <code>'''nil'''</code> if no information could be obtained because the terrain tile wasn't loaded. The first entry in the vector is the elevation (in meters) for the given point, and the second is a hash with information about the assigned material (as defined in <tt>''[[$FG_ROOT]]/Materials''</tt>), or <code>'''nil'''</code> if there was no material information available (for example, because there is an untextured building at that location). The structure of the hash is as follows (see also {{readme file|materials}}):
* '''light_coverage:''' The coverage of a single point of light in m<sup>2</sup>.
* '''bumpiness:''' Normalized bumpiness factor for the material.
* '''load_resistance:''' The amount of pressure in N/m<sup>2</sup> the material can withstand without deformation.
* '''solid:''' 1 (true) or false (0) depending on whether the material is solid or not.
* '''names:''' Vector of scenery types (usually generated by [[TerraGear]]) that will use this material.
* '''friction_factor:''' Normalized friction factor of the material.
* '''rolling_friction:''' The rolling friction coefficient of the material.

Note that this function is a ''very'' CPU-intensive operation, particularly in FlightGear v2.4 and earlier. It is advised to use this function as little as possible.
|param1 = lat
|param1text = Latitude, inputted as a number.
|param2 = lon
|param2text = Longitude, inputted as a number.
|param3 = max_alt
|param3text = The altitude, in metres, from which the function will begin searching for the height of the terrain. Defaults to 10,000 metres. If the terrain is higher than this argument specifies, <code>'''nil'''</code> will be returned.
|example1text = Dumps information about ground underneath the aircraft.
|example1 = var pos = geo.aircraft_position();
var info = geodinfo(pos.lat(), pos.lon());
debug.dump(info);
|example2text = Prints whether the ground underneath the aircraft is solid or is water.
|example2 = var pos = geo.aircraft_position();
var info = geodinfo(pos.lat(), pos.lon());
if (info != nil and info[1] != nil) {
print("The ground underneath the aircraft is ", info[1].solid == 1 ? "solid." : "water.");
<nowiki>}</nowiki>
}}

=== geodtocart() ===
{{Nasal doc
|syntax = geodtocart(lat, lon, alt);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=962|t=Source}}
|text = Converts {{wikipedia|geodetic coordinates}} (latitude, longitude, and altitude) to {{wikipedia|ECEF|Earth-centered, Earth-fixed}} coordinates (x, y and z). A vector is returned containing x, y, and z in metres. The equatorial radius of earth used is that defined by the {{wikipedia|WGS 84}} (6,378,137 metres). All argument are mandatory.
|param1 = lat
|param1text = Latitude, in degrees.
|param2 = lon
|param2text = Longitude, in degrees.
|param3 = alt
|param3text = Altitude, in metres.
|example1 = var (x, y, z) = geodtocart(0, 0, 0); # point is the intersection of the prime meridian and equator.
print("x: ", x); # prints "x: 6378137"
print("y: ", y); # prints "y: 0"
print("z: ", z); # prints "y: 0"
}}

=== get_cart_ground_intersection()===
Introduced in 2017.2.1, see [[Terrain Detection]].

===getprop()===
{{Nasal doc
|syntax = <nowiki>getprop(path[, path[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=345|t=Source}}
|text = Returns the value of a node in the [[Property Tree]] or <code>'''nil'''</code> if the node does not exist or the value is not a number (NaN).
|param1 = path
|param1text = There needs to be at least one argument, but there is no limit to the maximum amount of arguments that can be given. The arguments will be concatenated together to form a property tree path. The arguments must be strings, but in FlightGear v3.2 onwards, there is also support (added by {{flightgear commit|34ed79}}) for numeric arguments as indices. See example 2 below.
|example1 = print("You have FlightGear v", getprop("/sim/version/flightgear")); # prints FlightGear version
|example2text = Note that the example below will only work in FlightGear 3.2 and above.
|example2 = for(var i = 0; i < 8; i += 1){
print("View #", i + 1, " is named ", getprop("/sim/view", i, "name"));
}
|example3text = Same as above, but is supported by all versions of FlightGear.
|example3 = for(var i = 0; i < 8; i += 1){
print("View #", i + 1, " is named ", getprop("/sim/view[" ~ i ~ "]/name"));
<nowiki>}</nowiki>
}}
==== See also====
{{note| If you have to read/write the same property multiple times (e.g. in an update loop), it is more efficient to use a node object:
To get a Node rather than its value, use <code>props.globals.getNode()</code> - see [[Nasal_library/props]]. }}

===greatCircleMove()===
{{Nasal doc
|syntax = greatCircleMove([pos, ]course, dist);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1681|t=Source}}
|text = Calculates a new set of geodetic coordinates using inputs of course and distance, either from the aircraft's current position (by default) or from another set of coordinates. Returns a hash containing two members, ''lat'' and ''lon'' (latitude and longitude respectively).
|param1 = pos
|param1text = Optional position to calculate from. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost object.
:* A hash with ''lat'' and ''lon'' members
:* A <code>geo.Coord</code> object
:* A lat/lon pair, that is, a pair of numbers (latitude followed by longitude) separated by a comma: <code>greatCircleMove(lat,lon, ...)</code>.
|param2 = course
|param2text = Course to new set of coordinates, in degrees (in the range 0–360).
|param3 = dist
|param3text = Distance in nautical miles to the new set of coordinates.
|example1 = var pos = greatCircleMove(0,0, 0, 1);
debug.dump(pos); # print hash with coordinates
|example2 = var fix = findFixesByID("POGIC");
fix = fix[0];
var pos = greatCircleMove(fix, 45, 10);
debug.dump(pos); # print hash with coordinates
}}

===interpolate()===
{{Nasal doc
|private = _interpolate()
|syntax = <nowiki>interpolate(prop, value1, time1[, value2, time2[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=522|t=Part 1}} {{!}} {{fgdata file|Nasal/globals.nas|t=Part 2}}
|text = Linearly interpolates a node in the property tree to a given value in a specified time. The value/time pairs will be run one after the other in the order that they are passed to the function. Note that the interpolation will continue even when the simulation is paused.
|param1 = prop
|param1text = String or <code>props.Node</code> object that indicates a node in the property tree to be used.
|param2 = value''n''
|param2text = Target value to change the property to in the set amount of time. This should be a number.
|param3 = time''n''
|param3text = Time in seconds, that will be taken for the interpolation.
|example1text = Paste the code below into the Nasal Console and execute. Then, open the Property Browser and look for the property. Finally, run the code again, and watch the value of the property change.
|example1 = setprop("/test", 0); # (re-)set property
interpolate("/test",
50, 5, # interpolate to 50 in 5 seconds
10, 2, # interpolate to 10 in 2 seconds
0, 5); # interpolate to 0 in 5 seconds
|example2 = # Apply the left brake at 20% per second
var prop = "controls/gear/brake-left";
var dist = 1 - getprop(prop);
if (dist == 1) {
interpolate(prop, 1, dist / 0.2);
<nowiki>}</nowiki>
}}

===isa()===
{{Nasal doc
|syntax = isa(object, class);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Checks if an object is an instance of, or inherits from, a second object (or class), returning 1 (true) if it is and 0 (false) if otherwise.
|param1 = object
|param1text = Object to check.
|param2 = class
|param2text = Class/object to check that '''object''' inherits from or is an instance of.
|example1 = var coord = geo.Coord.new();
if(isa(coord, geo.Coord)){
print("Variable 'coord' is an instance of class 'geo.Coord'"); # this one will be printed
} else {
print("Variable 'coord' is not an instance of class 'geo.Coord'");
}
|example2 = var coord = geo.Coord.new();
if(isa(coord, props.Node)){
print("Variable 'coord' is an instance of class 'props.Node'");
} else {
print("Variable 'coord' is not an instance of class 'props.Node'"); # this one will be printed
}
|example3text = The example below demonstrates checking of inheritance.
|example3 = var Const = {
constant: 2,
getConst: func {
return me.constant;
}
};

var Add = {
new: func {
return { parents: [Add, Const] };
},

addToConst: func(a){
return a * me.getConst();
}
};

var m = Add.new();
print(m.addToConst(4));

if(isa(m, Add)) print("Variable 'm' is an instance of class 'Add'"); # will be printed
if(isa(m, Const)) print("Variable 'm' is an instance of class 'Const'"); # will also be printed
}}

===logprint()===
{{Nasal doc
|syntax = <nowiki>logprint(priority[, msg[, msg[, ...]]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=431|t=Source}}
|text = Concatenates a message and logs it with a given priority level. Unlike {{func link|print()}} and {{func link|printlog()}}, message outputted by this function will be logged in your <code>[[Commonly used debugging tools#fgfs.log|fgfs.log]]</code> file as coming from the Nasal file itself rather than from {{flightgear file|src/Scripting/NasalSys.cxx}}.
|param1 = priority
|param1text = Number specifying the priority level of the outputted message:
:{{{!}} class="wikitable"
! Number !! Debug type
{{!-}}
{{!}} 1 {{!!}} Bulk
{{!-}}
{{!}} 2 {{!!}} Debug
{{!-}}
{{!}} 3 {{!!}} Info
{{!-}}
{{!}} 4 {{!!}} Warn
{{!-}}
{{!}} 5 {{!!}} Alert
{{!}}}
|param2 = msg
|param2text = The message. There is no limit to the arguments you give give. They will be concatenated together before logging.
|example1 = # logs the value of pi to three decimal places with log level 3
logprint(3, "pi = ", sprintf("%.3f", math.pi));
|example2 = logprint(5, "Alert! This is an important message!");
}}
{{note|
The following constants have been added to the development branch of FlightGear ("next") and will be releases with FG 2020.1 so you won't have to remember the numbers anymore:

LOG_BULK, LOG_WARN, LOG_DEBUG, LOG_INFO, LOG_ALERT, DEV_WARN, DEV_ALERT }}

===magvar() ===
{{Nasal doc
|syntax = magvar([pos]);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1642|t=Source}}
|text = Returns the {{wikipedia|magnetic variation}} at a given set of coordinates. The table below gives the magnetic model used depending on the version of FlightGear.
{{{!}} class="wikitable"
! FlightGear versions !! Model !! Reference date
{{!-}}
{{!}} 3.6 and above {{!!}} {{wikipedia|World Magnetic Model}} (WMM) 2015 {{!!}} 1 January 2015
{{!-}}
{{!}} 0.9.11-pre1 to 3.4 {{!!}} WMM 2005 {{!!}} 1 January 2005
{{!-}}
{{!}} 0.7.3 to 0.9.10 {{!!}} WMM 2000 {{!!}} 1 January 2000
{{!}}}
|param1 = pos
|param1text = Optional position to calculate from. If not given, the aircraft's current position will be used. Can be one of:
:* An <code>airport</code>, <code>navaid</code>, <code>runway</code>, <code>taxiway</code>, <code>fix</code>, or <code>waypoint</code> ghost object.
:* A hash with ''lat'' and ''lon'' members
:* A <code>geo.Coord</code> object
:* A lat/lon pair, that is, a pair of numbers (latitude followed by longitude) separated by a comma: <code>magvar(lat,lon)</code>.
|example1 = print(magvar(0, 0)); # prints the magnetic variation at 0, 0
}}

===maketimer() ===
{{Nasal doc
|syntax = maketimer(interval[, self], function);
|source = ''Implemented using the {{API Link|flightgear|class|TimerObj}} class.''<br>{{flightgear file|src/Scripting/NasalSys.cxx|l=90|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=533|t=Part 2}}
|version = 2.12
|commit = {{flightgear commit|ab939f|t=commit}}
|text = Returns a timer object containing the following methods and members:
* '''start()''': Starts the timer.
* '''stop()''': Stops the timer.
* '''restart(interval)''': Restarts the timer with the given interval.
* '''singleShot''': Bool showing whether the timer is only to be run once, or continuously until told to stop. Can be both set and read from (see examples).
* '''isRunning''': Read-only bool telling whether the timer is currently running.
* '''simulatedTime''': (FG 2017.1+; {{flightgear commit|0af316|t=commit}}) Bool telling whether the timer is using simulated time (which accounts for pause, etc.). Defaults to false (use real time). Can be both read and set. This cannot be changed while the timer is running.
Unlike {{func link|settimer()}}, which it replaces, <code>maketimer()</code> provides more control over the timer. In addition, it can help reduce memory usage.
|param1 = interval
|param1text = Interval in seconds for the timer.
|param2 = self
|param2text = Optional parameter specifying what any <code>'''me'''</code> references in the function being called will refer to.
|param3 = function
|param3text = Function to be called at the given interval.
|example1 = var timer = maketimer(1, func(){
print("Hello, World!"); # print "Hello, World!" once every second (call timer.stop() to stop it)
});
timer.start();
|example2 = var timer = maketimer(1, math, func(){
print(me.math); # 'me' reference is the 'math' namespace
});
timer.singleShot = 1; # timer will only be run once
timer.start();
|example3 = var timer = maketimer(1, func(){
print("Hello, World!"); # print "Hello, World!" once every second (call timer.stop() to stop it)
});
timer.start();
print(timer.isRunning); # prints 1
|example4text = In the example below, "Hello, World!" will be printed after one second the first time, and after two seconds thereafter.
|example4 = var update = func(){
print("Hello, World!");
timer.restart(2); # restarts the timer with a two second interval
}

var timer = maketimer(1, update);
timer.singleShot = 1;
timer.start();
}}

===maketimestamp()===
{{Nasal doc
|syntax = maketimestamp()
|source = ''Implemented using the {{API Link|flightgear|class|TimeStampObj}} class.''<br>{{flightgear file|src/Scripting/NasalSys.cxx|l=214|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=589|t=Part 2}}
|version = 2019.2
|commit = {{flightgear commit|7db06300|t=commit}}
|text = Returns a time stamp object to allow high resolution timing of Nasal operations. When created the timer will automatically be stamped. The object has the following methods:
* '''stamp()''': Resets the timing operation. Call this first.
* '''elapsedMSec()''': returns number of milliseconds elapsed since stamp() called. Resolution may vary depending on platform but is usually at least millisecond accuracy.
* '''elapsedUSec()''': returns number of microseconds elapsed since stamp() called. Resolution may vary depending on platform but is usually at least millisecond accuracy.
|
|example1text = In the example below the number of milliseconds elapsed will be printed.
|example1 = var timestamp = maketimestamp();
timestamp.stamp();
print(timestamp.elapsedMSec(), "ms elapsed");
print(timestamp.elapsedMSec(), "ms elapsed");
}}

===md5()===
{{Nasal doc
|syntax = md5(string);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=758|t=Source}}
|version = 3.2
|commit = {{flightgear commit|cfbf9e|t=commit}}
|text = Returns a the {{wikipedia|MD5}} hash (as a string) of the inputted string.
|param1 = string
|param1text = String the generate the hash of. Mandatory.
|example1text = The below code should output <code>65a8e27d8879283831b664bd8b7f0ad4</code>.
|example1 = print(md5("Hello, World!"));
}}

===navinfo()===
{{Nasal doc
|syntax = navinfo(lat, lon, type, id);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1453|t=Source}}
|text = Returns vector <code>navaid</code> ghost objects matching the given '''type''' and '''id''' or <code>'''nil'''</code> on error.
|param1 = lat ''and'' lon
|param1text = If given, the returned navaids will be put into order of ascending distance from the location.
|param2 = type
|param2text = Narrows the search to the given type. Must be one of "any," "fix," "vor," "ndb," "ils," "dme," or "tacan." Defaults to the equivalent of "any."
|param3 = id
|param3text = ID to search for. Note that, although all the parameters are technically optional, this parameter must be given, otherwise an empty vector will be returned.
|example1 = navinfo("vor"); # returns all VORs
|example2 = navinfo("HAM"); # return all navaids whose names start with "HAM"
|example3 = navinfo("vor", "HAM"); # return all VORs whose names start with "HAM"
|example4 = navinfo(34,48,"vor","HAM"); # return all VORs whose names start with "HAM" and sorted by distance relative to 34°, 48°
}}

===parse_markdown()===
{{Nasal doc
|syntax = parse_markdown(markdown);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=745|t=Part 1}} {{!}} {{simgear file|simgear/misc/SimpleMarkdown.cxx|t=Part 2}}
|version = 3.2
|text = Parses a string containing {{wikipedia|Markdown}} and returns the result as a string. As of FlightGear 2016.1, it is just a simple parser, and does the following:
* It strips whitespace from the beginning of the string.
* It supports [http://daringfireball.net/projects/markdown/syntax#p paragraphs and line breaks].
* It collapses whitespace.
* It converts unordered [http://daringfireball.net/projects/markdown/syntax#list lists] to use a bullet character (•). Note that the bullet character is implemented in hexadecimal UTF-8 character bytes (<code>E2 80 A2</code>), as so may not work properly when the being displayed in an encoding other than UTF-8.
|param1 = markdown
|param1text = String containing Markdown to be parsed.
|example1text =
Save the below code as <tt>''[[$FG_ROOT]]/gui/dialogs/test.xml''</tt>, then run the Nasal code below it to open the dialog. To change the markdown to be parsed, simply change the code in the highlighted section, save it, and reload the GUI (<tt>Debug > Reload GUI</tt>).
<syntaxhighlight lang="xml" highlight="41-50">
<?xml version="1.0" encoding="UTF-8"?>

<PropertyList>

<name>test</name>
<layout>vbox</layout>

<group>
<layout>hbox</layout>

<empty>
<stretch>true</stretch>
</empty>

<text>
<label>parse_markdown() test dialog</label>
</text>

<empty>
<stretch>true</stretch>
</empty>

<button>
<legend></legend>
<pref-width>16</pref-width>
<pref-height>16</pref-height>
<binding>
<command>dialog-close</command>
</binding>
</button>

</group>

<canvas>
<name>Canvas plot</name>
<stretch>true</stretch>
<pref-width>400</pref-width>
<pref-height>300</pref-height>
<nasal>
<load><![CDATA[
var text = 'Items:
* apples
* oranges
* pears

Some text.
Some more items:
* apples
* oranges
* pears';

var parsed = parse_markdown(text);

var root_canvas = canvas.get(cmdarg());
root_canvas.setColorBackground(255, 255, 255);
var root = root_canvas.createGroup();

var text_dis = root.createChild("text")
.setText(parsed)
.setTranslation(5, 5)
.setFont("LiberationFonts\LiberationSans-Regular.ttf")
.setFontSize(15)
.setColor(0, 0, 0)
.setDrawMode(canvas.Text.TEXT)
.setAlignment("left-top");
]]></load>
</nasal>
</canvas>

</PropertyList>
</syntaxhighlight>
|example1 = fgcommand("dialog-show", {"dialog-name": "test"});
|example2text = The example below parses Markdown and outputs it in a HTML document. The parsed text is placed in <syntaxhighlight lang="xml" inline><pre></pre></syntaxhighlight> tags. To change the Markdown to be parsed, simply edit the variable <tt>markdown</tt> at the top of the code.
|example2 = <nowiki>var markdown = 'Items:
* apples
* oranges
* pears

Some text.
Some more items:
* apples
* oranges
* pears';

var parsed = parse_markdown(markdown);

debug.dump(parsed);

var path = string.normpath(getprop("/sim/fg-home") ~ '/Export/parse_markdown()-test.html');

var file = io.open(path, "w");

var html = "<!DOCTYPE html>\n\n<html>\n\n<head>\n\t<meta charset=\"UTF-8\">\n\t<title>parse_markdown() test generated by Nasal</title>\n</head>\n\n<body>\n\t<pre>" ~ parsed ~ "</pre>\n</body>\n\n</html>";

io.write(file, html);
io.close(file);
print("Done, file ready for viewing (" ~ path ~ ")");</nowiki>
}}

===parsexml()===
{{Nasal doc
|syntax = <nowiki>parsexml(path[, start[, end[, data[, pro_ins]]]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=710|t=Source}}
|text = This function is an interface into the built-in [http://expat.sourceforge.net/ Expat XML parser]. The absolute path to the file is returned as string, or <code>'''nil'''</code> is returned on error.
|param1 = path
|param1text = Mandatory absolute path to the XML file to be parsed.
|param2 = start
|param2text = Optional callback function that will be called for every starting tag. The function should take two argument: the tag name and a hash containing attributes.
|param3 = end
|param3text = Optional callback function that will be called for every ending tag. The function should take one argument: the tag name.
|param4 = data
|param4text = Optional callback function that will be called for every piece of data within a set of tags. The function should take one argument: the data as a string.
|param5 = pro_ins
|param5text = Optional callback function that will be called for every {{wikipedia|Processing Instruction|processing instruction}}. The function should take two argument: the target and the data string.
|example1text = Save the below XML code in <tt>''[[$FG_HOME]]/Export/demo.xml''</tt>. Then, execute the Nasal code below in the Nasal Console. The XML will be parsed and each bit of the code will be printed.
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<?xml-stylesheet type="text/xsl" href="style.xsl"?>

<foo>
<blah type="string"><![CDATA[ <sender>John Smith</sender> ]]></blah>
<blah2 type="string">Orange & lemons</blah2>
</foo>
</syntaxhighlight>
|example1 = var start = func(name, attr){
print("Starting tag: '", name, "'");
foreach(var a; keys(attr)){
print("\twith attribute ", a, '="', attr[a], '"');
}
}

var end = func(name){
print("Ending tag: '", name, "'");
}

var data = func(data){
print("Data = '", data, "'");
}

var pro_instr = func(target, data){
print("Processing instruction: target = '", target, "', data = '", data, "'");
}

parsexml(getprop("/sim/fg-home") ~ '/Export/demo.xml', start, end, data, pro_instr);
}}

===print()===
{{Note|As of 07/2020, we are in the process of slowly deprecating and removing Nasal print() (in fgdata) where possible in favor of log [[#logprint()]] which takes a priority level.

This is part of the goal that we achieve zero output at log-level at alert, and everything shown at ‘warn; is really a warning, not just information.<ref>https://sourceforge.net/p/flightgear/mailman/message/37042224/</ref>}}

{{Nasal doc
|syntax = <nowiki>print(data[, data[, ...]]);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=415|t=Source}}
|text = Concatenates its arguments and then prints it to the terminal and the [[Commonly used debugging tools#fgfs.log|log]]. Note that a newline is automatically added.
|param1 = data
|param1text = Data to print. Only strings and numbers can be printed; other data types will not be. There many be any number of arguments; they will just be concatenated together.
|example1 = print("Just", " a ", "test"); # prints "Just a test"
|example2 = print("pi = ", math.pi); # prints "pi = 3.141592..."
}}

=== printf() ===
{{Nasal doc
|syntax = <nowiki>printf(format[, arg[, arg, [...]]]);</nowiki>
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Creates and prints a formatted string. For a description of its arguments, see {{func link|sprintf()}} (it is, in fact, implemented using <code>sprintf()</code>).
|example1 = printf("In hexadecimal, 100000 = %X", 186A0); # prints "In hexadecimal, 100000 = 186A0"
}}

===printlog()===
{{caution|This function is deprecated and doesn't work. Please use the new one {{func link|logprint()}}.}}
{{Nasal doc
|syntax = <nowiki>printlog(level, data[, data[, ...]]);</nowiki>
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Prints the given message with the given log level. If the log level is higher or equal to <code>/sim/logging/priority</code>, it is printed.
|param1 = level
|param1text = Mandatory log level as a string. Must be one of "none," "bulk," "debug," "info," "warn," or "alert." Note that "none" will mean that the message will never be printed.
|param2 = data
|param2text = Data to be printed. Only strings and numbers will be printed; others will not be. There may be any number of arguments; they will just be concatenated together.
|example1 = printlog("alert", "This is an alert"); # message will be printed
|example2 = printlog("info", "Just informing you about something"); # message will be printed only if log level is set to "info" or less
}}

===rand()===
{{Nasal doc
|syntax = rand();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=554|t=Source}}
|text = Returns a random floating point number between 0 (inclusive) and 1 (exclusive). It takes no arguments.
|example1 = print(rand()); # prints random number
}}

===registerFlightPlanDelegate()===
{{Nasal doc
|syntax = registerFlightPlanDelegate(init_func);
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1879|t=Source}}
|text = Registers a flight plan delegate. See <tt>''{{fgdata file|Nasal/route_manager.nas|t=$FG_ROOT/Nasal/route_manager.nas}}''</tt> for examples.
|param1 = init_func
|param1text = Initialization function which will be called during FlightGear's startup.
}}
===removecommand()===
{{Nasal doc
|syntax = removecommand(cmd);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=668|t=Source}}
|text = Removes the given fgcommand. Returns <code>'''nil'''</code>.
{{caution|This will remove '''any''' [[fgcommands|fgcommand]], even those implemented in C++, so use with caution!}}
|param1 = cmd
|param1text = String specifying the name of the command to remove.
|example1 = addcommand("hello", func(){
print("Hello");
});
fgcommand("hello"); # "Hello" will be printed
removecommand("hello"); # removes it
}}

===removelistener()===
{{Nasal doc
|syntax = removelistener(id);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=1384|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=506|t=Part 2}}
|text = Removes and deactivates the given listener and returns the number of listeners left or <code>'''nil'''</code> on error.
{{note|It is good practice to remove listeners when they are not required anymore. This prevents the listeners reducing FlightGear's run performance.}}
|param1 = id
|param1text = ID of listener as returned by {{func link|setlistener()}}.
|example1 = var ls = setlistener("/sim/test", func(){
print("Property '/sim/test' has been changed");
});
setprop("/sim/test", "blah"); # trigger listener
var rem = removelistener(ls); # remove listener
print("There are ", rem, " listeners remaining");
}}

===resolvepath()===
{{Nasal doc
|syntax = resolvepath(path);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=604|t=Source}}
|text = Takes a relative path as a string and uses [[SimGear]]'s path-resolving framework to return an absolute path as a string. If the path could not be resolved, an empty string is returned. See [[Resolving Paths]] for a detailed description of the algorithm. This function can also be used to check if a file exists.
|param1 = path
|param1text = Relative path to be completed.
|example1 = print(resolvepath("Nasal/globals.nas")); # prints the equivalent of $FG_ROOT/Nasal/globals.nas
|example2 = print(resolvepath("blah")); # prints nothing; could not be resolved
|example3 = var file_path = resolvepath("Aircraft/SenecaII/some-file");
if (file_path != ""){
gui.popupTip("some-file found", 2);
} else {
gui.popupTip("some-file not found", 2);
<nowiki>}</nowiki>
}}

===setlistener()===
{{Nasal doc
|syntax = <nowiki>setlistener(node, code[, init[, type]]);</nowiki>
|private = _setlistener()
|source = {{flightgear file|src/Scripting/Nasal|l=499|t=Part 1}} {{!}} {{flightgear file|src/Scripting/Nasal|l=1350|t=Part 2}}<br>''Listener implemented using the {{API Link|flightgear|class|FGNasalListener}} class.''
|text = Creates a listener which will be triggered when the given property is changed (depending on the '''type'''). A unique integer ID is returned; this can later be used as the argument to {{func link|removelistener()}}.
{{note|Listeners are known to be a source of resource leaks. To avoid this, please take measures such as:
* Using {{func link|removelistener()}} when they are not needed any more.
* Using a single initialization listener.
* Avoiding tying listeners to properties that are rapidly updated (e.g., many times per frame).
}}
|param1 = node
|param1text = Mandatory string or <code>props.Node</code> object pointing to a property in the [[Property Tree]].
|param2 = code
|param2text = Mandatory callback function to execute when the listener is triggered. The function can take up to four arguments in the following order:
* '''changed''': a <code>props.Node</code> object pointing to the changed node.
* '''listen''': a <code>props.Node</code> object pointing to the listened-to node. Note that this argument maybe different depending on the '''type'''.
* '''mode''': an integer telling how the listener was triggered. 0 means that the value was changed. 1 means that a child property was added. -1 means that a child property was removed.
* '''is_child''': boolean telling whether '''changed''' is a child property of the listened-to '''node''' or not. 1 (true) if it is, 0 (false) otherwise.
|param3 = init
|param3text = If set to 1 (true), the listener will additionally be triggered when it is created. This argument is optional and defaults to 0 (false).
|param4 = type
|param4text = Integer specifying the listener's behavior. 0 means that the listener will only trigger when the property is changed. 1 means that the trigger will always be triggered when the property is written to. 2 will mean that the listener will be triggered even if child properties are modified. This argument is optional and defaults to 1.
|example1 = var prop = props.globals.initNode("/sim/test", "", "STRING"); # create property
var id = setlistener("/sim/test", func(n){ # create listener
print("Value: ", n.getValue());
});
setprop("/sim/test", "blah"); # trigger listener
removelistener(id); # remove listener
prop.remove(); # remove property
}}

===setprop()===
{{Nasal doc
|syntax = <nowiki>setprop(path[, path[, ...]], value);</nowiki>
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=385|t=Source}}
|text = Sets the value of a property in the [[Property Tree]]. If the property does not exist, it will be created. Returns 1 (true) on success or 0 (false) if there was an error.
{{note|If you want to remove a property, you will have to use one of the <code>props</code> helpers:
<syntaxhighlight lang="nasal">
props.globals.getNode("foo/bar").remove(); # take out the complete node
props.globals.getNode("foo").removeChild("bar"); # take out a certain child node
</syntaxhighlight>
}}
|param1 = path
|param1text = There needs to be at least one '''path''' argument, but there is no limit to the maximum amount that can be given. They will be concatenated together to form a property tree path. The arguments must be strings, but in FlightGear v3.2 onwards, there also is support (added by {{flightgear commit|34ed79}}) for numeric arguments as indices. See example 2 below.
|param2 = value
|param2text = Value to write to the given property. Must be either a string or a number.
|example1 = setprop("/sim/demo", "This is a demo");
|example2text = Note that the example below will only work in FlightGear 3.2 and above.
|example2 = for(var i = 0; i < 3; i += 1){
setprop("/sim/demo", i, "Demo #" ~ i));
}
|example3text = Same as above, but is supported by all versions of FlightGear.
|example3 = for(var i = 0; i < 3; i += 1){
setprop("/sim/demo[" ~ i ~ "]", "Demo #" ~ i));
<nowiki>}</nowiki>
}}
====See also====
{{note| If you have to read/write the same property multiple times (e.g. in an update loop), it is more efficient to use a node object:
To get a Node rather than its value, use <code>props.globals.getNode()</code> - see [[Nasal_library/props]]. }}

===settimer() ===
{{Nasal doc
|syntax = settimer(function, delta[, realtime]);
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=499|t=Part 1}} {{!}} {{flightgear file|src/Scripting/NasalSys.cxx|l=1286|t=Part 2}}
|text = Runs the given function a specified amount of seconds after the current time. Returns <code>'''nil'''</code>.
{{note|Improper use of <code>settimer()</code> may cause resource leaks. It is also highly recommended that the newer {{func link|maketimer()}} should be used instead of this function.}}
|param1 = function
|param1text = Mandatory function that will be called. It may be necessary to enclose code in an anonymous function (see example).
|param2 = delta
|param2text = Mandatory amount of time in seconds after which the function will be called.
|param3 = realtime
|param3text = If 1 (true), "real time" will be used instead of "simulation time." Defaults to 0 (false). Note that if "simulation time" is used, the timer will not run while FlightGear is paused.
|example1 = var myFunc = func(){
print("Hello");
}

settimer(myFunc, 2); # runs myFunc after 2 seconds
|example2 = var sqr = func(a){
return a * a;
}

settimer(func(){
print(sqr(2)); # will print 4 after 2 seconds
}, 2);
}}

===srand() ===
{{Nasal doc
|syntax = srand();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=559|t=Source}}
|text = Makes the pseudorandom number generator (see {{func link|rand()}}) generate a new {{wikipedia|random seed|noicon=1}} based on time. Returns 0.
}}
===systime()===
{{Nasal doc
|syntax = systime();
|source = {{flightgear file|src/Scripting/NasalSys.cxx|l=770|t=Source}}
|text = Returns the {{wikipedia|Unix time}} (seconds since since 00:00:00 UTC, 1/1/1970) as a floating point number with high resolution. This function is useful for benchmarking purposes (see example 2).
{{note|1=High resolution timers under Windows can produce inaccurate or fixed sub-millisecond results.<ref>{{cite web|url=http://forum.flightgear.org/viewtopic.php?f=30&t=29259|title=Nasal: systime() ??!?|author=Necolatis|date=Apr 2nd, 2016}}</ref> This is due to the underlying {{func link|GetSystemTimeAsFileTime()|link=https://msdn.microsoft.com/en-us/library/windows/desktop/ms724397(v=vs.85).aspx}} API call, which depends on hardware availability of suitable high resolution timers. See also [https://msdn.microsoft.com/en-us/library/windows/desktop/dn553408(v=vs.85).aspx Acquiring high-resolution time stamps]}}
|example1 = print("Unix time: ", systime()); # prints Unix time
|example2 = var myFunc = func(){
for(var i = 0; i <= 10; i += 1){
print("Interation #", i);
}
}
var t = systime(); # record time
myFunc(); # run function
var t2 = systime(); # record new time
print("myFunc() took ", t2 - t, " seconds"); # print result
}}

===thisfunc()===
{{Nasal doc
|syntax = thisfunc();
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns the function from which this function is called. This allows a function to reliably and safely call itself from within a closure.
|example1 = var stringify_vec = func(input){
if (typeof(input) == "scalar"){
return sprintf("%s", input);
} elsif (typeof(input) == "vector") {
if (size(input) == 0) return "[]";
var this = thisfunc();
var buffer = "[";
for(var i = 0; i < size(input); i += 1){
buffer ~= this(input[i]);
if (i == size(input) - 1) {
buffer ~= "]";
} else {
buffer ~= ", ";
}
}
return buffer;
} else {
die("stringify_vec(): Error! Invalid input. Must be a vector or scalar");
}
}

var test_vec = ["a", "b", "c", [1, 2, 3], "d"];
debug.dump(stringify_vec(test_vec)); # prints "[a, b, c, [1, 2, 3], d]"
test_vec = [];
debug.dump(stringify_vec(test_vec)); # prints "[]"
test_vec = {};
debug.dump(stringify_vec(test_vec)); # will throw an error
}}

===tileIndex() ===
{{Nasal doc
|syntax = tileIndex();
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1720|t=Source}}
|text = Returns the index of the tile at the aircraft's current position as a string. This corresponds to the name of the STG file of the tile. For example, at [[KSFO]], this would be <code>942050</code>, corresponding to <tt>''[[$FG_SCENERY]]/Terrain/w130n30/w123n3/942050.stg''</tt>.
|example1 = print(tileIndex()); # print index
}}

=== tilePath()===
{{Nasal doc
|syntax = tilePath();
|source = {{flightgear file|src/Scripting/NasalPositioned.cxx|l=1712|t=Source}}
|text = Returns the base path of the tile at the aircraft's current position as a string. For example, at KSFO, this would be <code>w130n30/w123n3</code>, corresponding to <tt>''[[$FG_SCENERY]]/Terrain/w130n30/w123n3''</tt>.
|example1 = print(tilePath()); # print path
}}

=== values()===
{{Nasal doc
|syntax = values(hash);
|source = {{fgdata file|Nasal/globals.nas|t=Source}}
|text = Returns a vector containing the values of the given hash.
|param1 = hash
|param1text = Mandatory hash to get the values of.
|example1 = var hash = {
"a": 1,
"b": 2,
"c": 3
};

foreach(var val; values(hash)){
print(val);
}
|example2text = The below example does exactly the same thing as the above example, but does not use <code>values()</code>:
|example2 = var hash = {
"a": 1,
"b": 2,
"c": 3
};

foreach(var key; keys(hash)){
print(hash[key]);
<nowiki>}</nowiki>
}}

==Extension functions new in FG 2020.1 ==
The following functions have been added to the nasal core library and will be released with FlightGear version 2020.1.
Before the release they are available in the development branch "next".

===isfunc()===
Returns 1 if type or argument is a function, otherwise 0.

===isghost()===
Returns 1 if type or argument is a ghost, otherwise 0.

=== ishash()===
Returns 1 if type or argument is a hash, otherwise 0.

===isint()===
{{Nasal doc
|syntax = isint(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if argument has a numeric value and x == floor(x), e.g. integer.
}}

===isnum()===
{{Nasal doc
|syntax = isnum(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if typeof(x) is "scalar" and x has a numeric value otherwise 0.
}}

===isscalar()===
{{Nasal doc
|syntax = isscalar(x);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns 1 if type or argument is a scalar (string or numeric), otherwise (vector, hash, func, ...) it returns 0. This is useful to check if a variable can be converted to string e.g. when useing the string concat operator "~".
|example1 = var a = "foo";
var b=42;
if (isscalar(a) and isscalar(b)) print(a~b);
if (isstr(a)) print("a is a string");
if (isint(b)) print("b is an integer");
# if (isscalar(a))... is equivalent to if (typeof(a) == "scalar")...
}}

===isstr()===
Returns 1 if type or argument is a string, otherwise 0.

===isvec()===
Returns 1 if type or argument is a vector, otherwise 0.

===vecindex()===
{{Nasal doc
|syntax = vecindex(vector, value);
|source = {{simgear file|simgear/nasal/lib.c|t=Source}}
|text = Returns the index of value or nil, if value is not found in vector.
|example1=
var myvector = ["apple", "bananna", "coconut"];
# to check if a vector contains a certain value compare vecindex to nil
if (vecindex(myvector, "apple") != nil) {
print("found apple");
}
# WARNING: this will not work as desired because index is 0
if (vecindex(myvector, "apple")) {
print("found apple");
<nowiki>}</nowiki>

}}

==Extension functions new in "dev" version ==
The following functions have been added to the nasal core library curernty on "dev" version.

===member()===
{{Nasal doc
|syntax = member(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=796|t=Source}}
|text = The function searches for a key in the given hash, including the <code>parents</code>. If the key is found, its value is returned; otherwise, it returns <code>nil</code>.
|param1 = hash
|param1text = The hash in which the key is searched.
|param2 = key
|param2text = Key as a string whose value we want to return.
|example1 =
var Hash = {
key: 12,
};

member(Hash, 'key'); # return 12
member(Hash, 'missing'); # return nil
|example2 = # member() also includes parents

var Base = {
key: 'text',
};

var Child = {
parents: [Base],
};

member(Child, 'key'); # return 'text'
member(Child, 'missing'); # return nil
}}

===has_member()===
{{Nasal doc
|syntax = has_member(hash, key);
|source = {{simgear file|simgear/nasal/lib.c|l=811|t=Source}}
|text = The function searches for a key in the given hash, including the <code>parents</code>. If the key is found, <code>trur</code> is returned; otherwise <code>false</code>.
|param1 = hash
|param1text = The hash in which the key is searched.
|param2 = key
|param2text = Key as a string.
|example1 =
var Hash = {
key: 12,
};

member(Hash, 'key'); # return true
member(Hash, 'missing'); # return false
|example2 = # has_member() also includes parents

var Base = {
key: 'text',
};

var Child = {
parents: [Base],
};

member(Child, 'key'); # return true
member(Child, 'missing'); # return false
}}

==Variables==
Various global constants (technically variables) are provided for use in converting between different units. They are all found in {{fgdata file|Nasal/globals.nas|text=$FG_ROOT/Nasal/globals.nas}}.

===D2R===
{{Nasal doc
|syntax = var radians = degrees * D2R;
|text = Converts an angle from degrees to radians when multiplied by the angle in degrees. Equal to <code>π / 180</code>.
}}
===FPS2KT===
{{Nasal doc
|syntax = var knots = feet_per_second * FPS2KT;
|text = Converts a velocity from feet per second to knots when multiplied by the velocity in feet per second. Approximately equal to 0.5925.
}}
===FT2M===
{{Nasal doc
|syntax = var metres = feet * FT2M;
|text = Converts a length from feet to metres when multiplied by the length in feet. Equal to 0.3048.
}}
===GAL2L ===
{{Nasal doc
|syntax = var litres = gallons * GAL2L;
|text = Converts a volume from US liquid gallons to litres when multiplied by the volume in gallons. Approximately equal to 3.7854.
}}
===IN2M===
{{Nasal doc
|syntax = var metres = inches * IN2M;
|text = Converts a length from inches to metres when multiplied by the length in inches. Equal to 0.0254.
}}
===KG2LB===
{{Nasal doc
|syntax = var pounds = kilograms * KG2LB;
|text = Converts a mass from kilograms to pounds when multiplied by the mass in kilograms. Approximately equal to 2.2046.
}}
===KT2FPS===
{{Nasal doc
|syntax = var feet_per_second = knots * KT2FPS;
|text = Converts a velocity from knots to feet per second when multiplied by the velocity in knots. Approximately equal to 1.6878.
}}
===KT2MPS===
{{Nasal doc
|syntax = var metres_per_second = knots * KT2MPS;
|text = Converts a velocity from knots to metres per second when multiplied by the velocity in knots. Approximately equal to 0.5144.
}}
===L2GAL===
{{Nasal doc
|syntax = var gallons = litres * L2GAL;
|text = Converts a volume from litres to US liquid gallons when multiplied by the volume in litres. Approximately equal to 0.2642.
}}
===LB2KG===
{{Nasal doc
|syntax = var kilograms = pounds * LB2KG;
|text = Converts a mass from pounds to kilograms when multiplied by the mass in pounds. Approximately equal to 0.4536.
}}
===M2FT ===
{{Nasal doc
|syntax = var feet = metres * M2FT;
|text = Converts a length from metres to feet when multiplied by the length in metres. Approximately equal to 3.2808.
}}
===M2IN===
{{Nasal doc
|syntax = var inches = metres * M2IN;
|text = Converts a length from metres to inches when multiplied by the length in metres. Approximately equal to 39.3701.
}}
===M2NM ===
{{Nasal doc
|syntax = var nautical_miles = metres * M2NM;
|text = Converts a length from metres to nautical miles when multiplied by the length in metres. Approximately equal to 0.00054.
}}
===MPS2KT ===
{{Nasal doc
|syntax = var knots = metres_per_second * MPS2KT;
|text = Converts a velocity from metres per second to knots when multiplied by the velocity in metres per second. Approximately equal to 1.9438.
}}
===NM2M ===
{{Nasal doc
|syntax = var metres = nautical_miles * NM2M;
|text = Converts a length from nautical miles to metres when multiplied by the length in nautical miles. Equal to 1,852.
}}
===R2D===
{{Nasal doc
|syntax = var degrees = radians * R2D;
|text = Converts an angle from radians to degrees when multiplied by the angle in radians. Equal to <code>180 / π</code>.
}}

{{Appendix}}

{{Nasal namespaces}}

FlightGear Newsletter November 2025

2025-12-11T22:41:32Z

PlayeRom: /* Multiplayer events */

{{User:Skybike/Template:Newsletter-header-translate|2025-11}}
{{TOC_right|limit=2}}

''We would like to emphasize that the monthly newsletter cannot live without the contributions of FlightGear users and developers. Everyone with a wiki account (free to register) is welcome to contribute to the newsletter. If you know about any FlightGear related news or projects such as for example updated scenery or aircraft, please do feel invited to add such news to the newsletter.''

''The new Visual Editor makes editing the wiki as simple as using a Word-processor, and even easier than using the forum as you don't even need to know the syntax for a url. Just hit the 'edit' link and start.''

== Development news ==



== Related Software tools and projects ==
=== Julia photoscenery generator GUI ===
==== Photoscenery-GUI ====

[[File:Photoscenery-GUI-20251113-202721.jpg|thumb|Photoscenery-GUI Beta]]

Adriano Bassignana has begun writing the manual for the Photoscenery GUI, which has been published at the following link:
https://wiki.flightgear.org/Julia_photoscenery_generator_GUI
The manual currently contains the essential information for correct installation.

New features in the latest version include:

The tool, which already managed the rational downloading of tiles in various resolutions, now includes additional features accessible via its web interface to increase operational utility. The program's initialization has been modified to enable faster startup.

A new functionality has been introduced to read airports and radio navigation aids from files updated weekly—the same data sources used by FlightGear itself. This resolves the previous issue of airport misalignment between the tool and the simulator.

Route management has been improved. When loading a route for display on the map, the system now simultaneously loads data on local scenery to prevent unnecessary downloads. For users with a fast internet connection, real-time image downloading is possible. A fast, low-resolution preload feature also provides a valid overview of the surrounding area's coverage.

The interface allows users to view radio navigation aids and airports, along with their key information.

The [create route] mode enables users to generate a flight path by clicking on map points, airports, and navigation aids. Created routes can be saved and later imported into FlightGear for use.

Many other features will be documented on the Wiki in the future.

https://github.com/abassign/Photoscenery-GUI.git

For more information, see the discussion on the FG Forum: https://forum.flightgear.org/viewtopic.php?f=5&t=39066&start=390

=== Framework for Canvas Add-on ===

Roman Ludwicki (PlayeRom on the forum) created a [https://github.com/PlayeRom/flightgear-addon-framework Framework] for creating add-ons based on Canvas dialog boxes. After creating numerous add-ons, he realized he needed to separate the common code base. This led to the creation of a separate Framework project that could be attached to any add-on. The framework includes the following features:

# Automatic recognition and loading of add-on Nasal files into the appropriate namespaces (with an exclusion list if necessary).
# Ability to add a menu for restarting add-on Nasal files without having to change repository files.
# Ability to define keys for the multi-key command to restart add-on Nasal files without having to change repository files.
# A mechanism for checking whether there is a new version of your add-on to inform users about it.
# Base classes for Canvas windows that are created and destroyed on demand (Transient dialog), as well as created once during simulator startup (Persistent dialog).
# Ability to create Nasal unit tests and run them using multi-key command.

An example project using the Framework is the [https://github.com/PlayeRom/flightgear-addon-canvas-skeleton Canvas Skeleton] project, which can be used as a basis for creating a new add-on.

You can also see how his other add-ons are written, all based on the Framework (main branches):
# [https://github.com/PlayeRom/flightgear-addon-aerotow-everywhere Aerotow Everywhere]
# [https://github.com/PlayeRom/flightgear-addon-logbook Logbook]
# [https://github.com/PlayeRom/flightgear-addon-which-runway Which Runway]
# [https://github.com/PlayeRom/flightgear-addon-nasal-namespace-browser Nasal Namespace Browser]
# [https://github.com/PlayeRom/flightgear-addon-menu-aggregator Add-on Menu Aggregator]

=== Add-ons Menu Aggregator ===

Roman Ludwicki has created a new "[https://github.com/PlayeRom/flightgear-addon-menu-aggregator Add-ons Menu Aggregator]" add-on. The "Add-ons Menu Aggregator" add-on solves the problem of increasing menu clutter in FlightGear, which occurs after installing multiple add-ons. Each add-on can add its own items to the main menu, causing it to become very large and, at low resolutions, extend beyond the screen. This makes it difficult for users to find functions related to specific add-ons, and the menu itself becomes unreadable.

The "Add-ons Menu Aggregator" automatically aggregates menu entries from all installed add-ons and places them into one common menu item – "Add-ons." Each add-on receives its own submenu here, containing its original items while maintaining full functionality and layout.

{{#ev:youtube|gNH3MBpRxjo|480px||Add-ons Menu Aggregator - Polish audio}}

== In the hangar ==






=== Aircraft reviews ===
==== Laminar 13 Hang Glider for FlightGear ====
==== Flight Test & Personal Tweaks by Vons ====

Having recently become interested in gliding and soaring in FG, I thought I'd go a (simpler) step further and merely strap a wing to myself (or me to a wing). That of course was also a good opportunity to harmonize further a few of the control inputs on the Laminar 13 for my rig/setup, as well as (subtly) to modify some of the weight shifts, drag and lift values, etc. Representative clip below for those who enjoy hang gliders, both real ones and in the world of FG.

{{#ev:youtube|tHQqhl3Sf5w|||Flight Test & Tweaks Laminar 13 Hang Glider for FlightGear|frame}}

If you're interested in seeing the flight test results and accessing the tweaks, visit the forum page at: https://forum.flightgear.org/viewtopic.php?f=19&t=42893&start=45#p436600

== Scenery corner ==




















== Community news ==









== Multiplayer events ==


=== Finished events ===
==== Independence Day Event 2025 ====
To celebrate Poland's Independence Day, the Polish Discord channel organized an Air Show with several performances. Clips are included in the video:

{{#ev:youtube|ekiLpbSXAmU|480px||Independence Day Event 2025}}






== Screenshot of the Month ==

If you want to participate in the screenshot contest, you can submit your candidate to the {{forum link|title=this|f=88|t=}}. Be sure to see the first post for participation rules. For purposes of convenience and organization, at the end of the month or after 20 entries have been submitted, a new forum topic will be started containing all shots in an easy-to-view layout. The voting will then take place there.

{{Appendix}}



[[Category:FlightGear Newsletter|2025 11]]

Howto:Add aerotow hitch to an AI-aircraft

2025-12-09T13:18:19Z

PlayeRom:

For the visualization of the tow rope, it is advantageous if a hitch position is defined for the AI tow plane.

To set the hitch position for the AI aircraft, add the following code to the top of the <tt>{aircraft}-ai.xml</tt> file:

<syntaxhighlight lang="xml">

<?xml version="1.0"?>
<PropertyList>

<nasal>
<load>
var acNode = cmdarg(); # "/ai/models/aircraft"
acNode.getNode("sim/hitches/aerotow/local-pos-x", true).setValue(x); # forward
acNode.getNode("sim/hitches/aerotow/local-pos-y", true).setValue(y); # left
acNode.getNode("sim/hitches/aerotow/local-pos-z", true).setValue(z); # up
</load>
<unload>
acNode.getNode("sim/hitches").remove();
</unload>
</nasal>



</PropertyList>

</syntaxhighlight>

In place of x, y, z, enter appropriate values for the hitch position.
Coordinate system: x forward, y to the left, and z up. The units are meters.

That's it! The tow rope ends at the defined position.

== Related content ==
* [[Soaring]]
* [[Improving Glider Realism]]
* [[Howto:Setup winch and aerotowing for JSBSim-aircraft]]

[[Category:Howto]]
[[Category:Aircraft enhancement]]

FlightGear Newsletter December 2025

2025-12-09T11:35:54Z

PlayeRom:

FlightGear Newsletter November 2025

2025-12-09T11:35:35Z

PlayeRom:

{{User:Skybike/Template:Newsletter-header-translate|2025-11}}
{{TOC_right|limit=2}}

''We would like to emphasize that the monthly newsletter cannot live without the contributions of FlightGear users and developers. Everyone with a wiki account (free to register) is welcome to contribute to the newsletter. If you know about any FlightGear related news or projects such as for example updated scenery or aircraft, please do feel invited to add such news to the newsletter.''

''The new Visual Editor makes editing the wiki as simple as using a Word-processor, and even easier than using the forum as you don't even need to know the syntax for a url. Just hit the 'edit' link and start.''

== Development news ==



== Related Software tools and projects ==
=== Julia photoscenery generator GUI ===
==== Photoscenery-GUI ====

[[File:Photoscenery-GUI-20251113-202721.jpg|thumb|Photoscenery-GUI Beta]]

Adriano Bassignana has begun writing the manual for the Photoscenery GUI, which has been published at the following link:
https://wiki.flightgear.org/Julia_photoscenery_generator_GUI
The manual currently contains the essential information for correct installation.

New features in the latest version include:

The tool, which already managed the rational downloading of tiles in various resolutions, now includes additional features accessible via its web interface to increase operational utility. The program's initialization has been modified to enable faster startup.

A new functionality has been introduced to read airports and radio navigation aids from files updated weekly—the same data sources used by FlightGear itself. This resolves the previous issue of airport misalignment between the tool and the simulator.

Route management has been improved. When loading a route for display on the map, the system now simultaneously loads data on local scenery to prevent unnecessary downloads. For users with a fast internet connection, real-time image downloading is possible. A fast, low-resolution preload feature also provides a valid overview of the surrounding area's coverage.

The interface allows users to view radio navigation aids and airports, along with their key information.

The [create route] mode enables users to generate a flight path by clicking on map points, airports, and navigation aids. Created routes can be saved and later imported into FlightGear for use.

Many other features will be documented on the Wiki in the future.

https://github.com/abassign/Photoscenery-GUI.git

For more information, see the discussion on the FG Forum: https://forum.flightgear.org/viewtopic.php?f=5&t=39066&start=390

=== Framework for Canvas Add-on ===

Roman Ludwicki (PlayeRom on the forum) created a [https://github.com/PlayeRom/flightgear-addon-framework Framework] for creating add-ons based on Canvas dialog boxes. After creating numerous add-ons, he realized he needed to separate the common code base. This led to the creation of a separate Framework project that could be attached to any add-on. The framework includes the following features:

# Automatic recognition and loading of add-on Nasal files into the appropriate namespaces (with an exclusion list if necessary).
# Ability to add a menu for restarting add-on Nasal files without having to change repository files.
# Ability to define keys for the multi-key command to restart add-on Nasal files without having to change repository files.
# A mechanism for checking whether there is a new version of your add-on to inform users about it.
# Base classes for Canvas windows that are created and destroyed on demand (Transient dialog), as well as created once during simulator startup (Persistent dialog).
# Ability to create Nasal unit tests and run them using multi-key command.

An example project using the Framework is the [https://github.com/PlayeRom/flightgear-addon-canvas-skeleton Canvas Skeleton] project, which can be used as a basis for creating a new add-on.

You can also see how his other add-ons are written, all based on the Framework (main branches):
# [https://github.com/PlayeRom/flightgear-addon-aerotow-everywhere Aerotow Everywhere]
# [https://github.com/PlayeRom/flightgear-addon-logbook Logbook]
# [https://github.com/PlayeRom/flightgear-addon-which-runway Which Runway]
# [https://github.com/PlayeRom/flightgear-addon-nasal-namespace-browser Nasal Namespace Browser]
# [https://github.com/PlayeRom/flightgear-addon-menu-aggregator Add-on Menu Aggregator]

=== Add-ons Menu Aggregator ===

Roman Ludwicki has created a new "[https://github.com/PlayeRom/flightgear-addon-menu-aggregator Add-ons Menu Aggregator]" add-on. The "Add-ons Menu Aggregator" add-on solves the problem of increasing menu clutter in FlightGear, which occurs after installing multiple add-ons. Each add-on can add its own items to the main menu, causing it to become very large and, at low resolutions, extend beyond the screen. This makes it difficult for users to find functions related to specific add-ons, and the menu itself becomes unreadable.

The "Add-ons Menu Aggregator" automatically aggregates menu entries from all installed add-ons and places them into one common menu item – "Add-ons." Each add-on receives its own submenu here, containing its original items while maintaining full functionality and layout.

{{#ev:youtube|gNH3MBpRxjo|480px||Add-ons Menu Aggregator - Polish audio}}

== In the hangar ==









== Scenery corner ==




















== Community news ==









== Multiplayer events ==









== Screenshot of the Month ==

If you want to participate in the screenshot contest, you can submit your candidate to the {{forum link|title=this|f=88|t=}}. Be sure to see the first post for participation rules. For purposes of convenience and organization, at the end of the month or after 20 entries have been submitted, a new forum topic will be started containing all shots in an easy-to-view layout. The voting will then take place there.

{{Appendix}}

[[Category:Changes after 2024.1]]
[[Category:FlightGear Newsletter|2025 05]]

FlightGear Newsletter October 2025

2025-12-09T11:35:21Z

PlayeRom:

FlightGear Newsletter September 2025

2025-12-09T11:35:05Z

PlayeRom:

FlightGear Newsletter August 2025

2025-12-09T11:34:52Z

PlayeRom:

FlightGear Newsletter July 2025

2025-12-09T11:34:36Z

PlayeRom:

FlightGear Newsletter June 2025

2025-12-09T11:34:21Z

PlayeRom:

FlightGear Newsletter October 2025

2025-12-09T11:28:18Z

PlayeRom: /* Development news */

FlightGear Newsletter November 2025

2025-12-09T11:16:56Z

PlayeRom: /* Add-ons Menu Aggregator */

{{User:Skybike/Template:Newsletter-header-translate|2025-05}}
{{TOC_right|limit=2}}

''We would like to emphasize that the monthly newsletter cannot live without the contributions of FlightGear users and developers. Everyone with a wiki account (free to register) is welcome to contribute to the newsletter. If you know about any FlightGear related news or projects such as for example updated scenery or aircraft, please do feel invited to add such news to the newsletter.''

''The new Visual Editor makes editing the wiki as simple as using a Word-processor, and even easier than using the forum as you don't even need to know the syntax for a url. Just hit the 'edit' link and start.''

== Development news ==



== Related Software tools and projects ==
=== Julia photoscenery generator GUI ===
==== Photoscenery-GUI ====

[[File:Photoscenery-GUI-20251113-202721.jpg|thumb|Photoscenery-GUI Beta]]

Adriano Bassignana has begun writing the manual for the Photoscenery GUI, which has been published at the following link:
https://wiki.flightgear.org/Julia_photoscenery_generator_GUI
The manual currently contains the essential information for correct installation.

New features in the latest version include:

The tool, which already managed the rational downloading of tiles in various resolutions, now includes additional features accessible via its web interface to increase operational utility. The program's initialization has been modified to enable faster startup.

A new functionality has been introduced to read airports and radio navigation aids from files updated weekly—the same data sources used by FlightGear itself. This resolves the previous issue of airport misalignment between the tool and the simulator.

Route management has been improved. When loading a route for display on the map, the system now simultaneously loads data on local scenery to prevent unnecessary downloads. For users with a fast internet connection, real-time image downloading is possible. A fast, low-resolution preload feature also provides a valid overview of the surrounding area's coverage.

The interface allows users to view radio navigation aids and airports, along with their key information.

The [create route] mode enables users to generate a flight path by clicking on map points, airports, and navigation aids. Created routes can be saved and later imported into FlightGear for use.

Many other features will be documented on the Wiki in the future.

https://github.com/abassign/Photoscenery-GUI.git

For more information, see the discussion on the FG Forum: https://forum.flightgear.org/viewtopic.php?f=5&t=39066&start=390

=== Framework for Canvas Add-on ===

Roman Ludwicki (PlayeRom on the forum) created a [https://github.com/PlayeRom/flightgear-addon-framework Framework] for creating add-ons based on Canvas dialog boxes. After creating numerous add-ons, he realized he needed to separate the common code base. This led to the creation of a separate Framework project that could be attached to any add-on. The framework includes the following features:

# Automatic recognition and loading of add-on Nasal files into the appropriate namespaces (with an exclusion list if necessary).
# Ability to add a menu for restarting add-on Nasal files without having to change repository files.
# Ability to define keys for the multi-key command to restart add-on Nasal files without having to change repository files.
# A mechanism for checking whether there is a new version of your add-on to inform users about it.
# Base classes for Canvas windows that are created and destroyed on demand (Transient dialog), as well as created once during simulator startup (Persistent dialog).
# Ability to create Nasal unit tests and run them using multi-key command.

An example project using the Framework is the [https://github.com/PlayeRom/flightgear-addon-canvas-skeleton Canvas Skeleton] project, which can be used as a basis for creating a new add-on.

You can also see how his other add-ons are written, all based on the Framework (main branches):
# [https://github.com/PlayeRom/flightgear-addon-aerotow-everywhere Aerotow Everywhere]
# [https://github.com/PlayeRom/flightgear-addon-logbook Logbook]
# [https://github.com/PlayeRom/flightgear-addon-which-runway Which Runway]
# [https://github.com/PlayeRom/flightgear-addon-nasal-namespace-browser Nasal Namespace Browser]
# [https://github.com/PlayeRom/flightgear-addon-menu-aggregator Add-on Menu Aggregator]

=== Add-ons Menu Aggregator ===

Roman Ludwicki has created a new "[https://github.com/PlayeRom/flightgear-addon-menu-aggregator Add-ons Menu Aggregator]" add-on. The "Add-ons Menu Aggregator" add-on solves the problem of increasing menu clutter in FlightGear, which occurs after installing multiple add-ons. Each add-on can add its own items to the main menu, causing it to become very large and, at low resolutions, extend beyond the screen. This makes it difficult for users to find functions related to specific add-ons, and the menu itself becomes unreadable.

The "Add-ons Menu Aggregator" automatically aggregates menu entries from all installed add-ons and places them into one common menu item – "Add-ons." Each add-on receives its own submenu here, containing its original items while maintaining full functionality and layout.

{{#ev:youtube|gNH3MBpRxjo|480px||Add-ons Menu Aggregator - Polish audio}}

== In the hangar ==









== Scenery corner ==




















== Community news ==









== Multiplayer events ==









== Screenshot of the Month ==

If you want to participate in the screenshot contest, you can submit your candidate to the {{forum link|title=this|f=88|t=}}. Be sure to see the first post for participation rules. For purposes of convenience and organization, at the end of the month or after 20 entries have been submitted, a new forum topic will be started containing all shots in an easy-to-view layout. The voting will then take place there.

{{Appendix}}

[[Category:Changes after 2024.1]]
[[Category:FlightGear Newsletter|2025 05]]

FlightGear Newsletter November 2025

2025-12-09T11:14:10Z

PlayeRom: /* Related Software tools and projects */

{{User:Skybike/Template:Newsletter-header-translate|2025-05}}
{{TOC_right|limit=2}}

''We would like to emphasize that the monthly newsletter cannot live without the contributions of FlightGear users and developers. Everyone with a wiki account (free to register) is welcome to contribute to the newsletter. If you know about any FlightGear related news or projects such as for example updated scenery or aircraft, please do feel invited to add such news to the newsletter.''

''The new Visual Editor makes editing the wiki as simple as using a Word-processor, and even easier than using the forum as you don't even need to know the syntax for a url. Just hit the 'edit' link and start.''

== Development news ==



== Related Software tools and projects ==
=== Julia photoscenery generator GUI ===
==== Photoscenery-GUI ====

[[File:Photoscenery-GUI-20251113-202721.jpg|thumb|Photoscenery-GUI Beta]]

Adriano Bassignana has begun writing the manual for the Photoscenery GUI, which has been published at the following link:
https://wiki.flightgear.org/Julia_photoscenery_generator_GUI
The manual currently contains the essential information for correct installation.

New features in the latest version include:

The tool, which already managed the rational downloading of tiles in various resolutions, now includes additional features accessible via its web interface to increase operational utility. The program's initialization has been modified to enable faster startup.

A new functionality has been introduced to read airports and radio navigation aids from files updated weekly—the same data sources used by FlightGear itself. This resolves the previous issue of airport misalignment between the tool and the simulator.

Route management has been improved. When loading a route for display on the map, the system now simultaneously loads data on local scenery to prevent unnecessary downloads. For users with a fast internet connection, real-time image downloading is possible. A fast, low-resolution preload feature also provides a valid overview of the surrounding area's coverage.

The interface allows users to view radio navigation aids and airports, along with their key information.

The [create route] mode enables users to generate a flight path by clicking on map points, airports, and navigation aids. Created routes can be saved and later imported into FlightGear for use.

Many other features will be documented on the Wiki in the future.

https://github.com/abassign/Photoscenery-GUI.git

For more information, see the discussion on the FG Forum: https://forum.flightgear.org/viewtopic.php?f=5&t=39066&start=390

=== Framework for Canvas Add-on ===

Roman Ludwicki (PlayeRom on the forum) created a [https://github.com/PlayeRom/flightgear-addon-framework Framework] for creating add-ons based on Canvas dialog boxes. After creating numerous add-ons, he realized he needed to separate the common code base. This led to the creation of a separate Framework project that could be attached to any add-on. The framework includes the following features:

# Automatic recognition and loading of add-on Nasal files into the appropriate namespaces (with an exclusion list if necessary).
# Ability to add a menu for restarting add-on Nasal files without having to change repository files.
# Ability to define keys for the multi-key command to restart add-on Nasal files without having to change repository files.
# A mechanism for checking whether there is a new version of your add-on to inform users about it.
# Base classes for Canvas windows that are created and destroyed on demand (Transient dialog), as well as created once during simulator startup (Persistent dialog).
# Ability to create Nasal unit tests and run them using multi-key command.

An example project using the Framework is the [https://github.com/PlayeRom/flightgear-addon-canvas-skeleton Canvas Skeleton] project, which can be used as a basis for creating a new add-on.

You can also see how his other add-ons are written, all based on the Framework (main branches):
# [https://github.com/PlayeRom/flightgear-addon-aerotow-everywhere Aerotow Everywhere]
# [https://github.com/PlayeRom/flightgear-addon-logbook Logbook]
# [https://github.com/PlayeRom/flightgear-addon-which-runway Which Runway]
# [https://github.com/PlayeRom/flightgear-addon-nasal-namespace-browser Nasal Namespace Browser]
# [https://github.com/PlayeRom/flightgear-addon-menu-aggregator Add-on Menu Aggregator]

=== Add-ons Menu Aggregator ===

Roman Ludwicki has created a new "[https://github.com/PlayeRom/flightgear-addon-menu-aggregator Add-ons Menu Aggregator]" add-on. The "Add-ons Menu Aggregator" add-on solves the problem of increasing menu clutter in FlightGear, which occurs after installing multiple add-ons. Each add-on can add its own items to the main menu, causing it to become very large and, at low resolutions, extend beyond the screen. This makes it difficult for users to find functions related to specific add-ons, and the menu itself becomes unreadable.

The "Add-ons Menu Aggregator" automatically aggregates menu entries from all installed add-ons and places them into one common menu item – "Add-ons." Each add-on receives its own submenu here, containing its original items while maintaining full functionality and layout.

== In the hangar ==









== Scenery corner ==




















== Community news ==









== Multiplayer events ==









== Screenshot of the Month ==

If you want to participate in the screenshot contest, you can submit your candidate to the {{forum link|title=this|f=88|t=}}. Be sure to see the first post for participation rules. For purposes of convenience and organization, at the end of the month or after 20 entries have been submitted, a new forum topic will be started containing all shots in an easy-to-view layout. The voting will then take place there.

{{Appendix}}

[[Category:Changes after 2024.1]]
[[Category:FlightGear Newsletter|2025 05]]

FlightGear Newsletter September 2025

2025-12-09T11:09:50Z

PlayeRom: /* Related Software tools and projects */

FlightGear Newsletter

2025-12-09T11:03:02Z

PlayeRom:

[[File:magagazine.png|right]]

The '''FlightGear Newsletter''' is intended to provide a collection of the latest developments from the worldwide [[FlightGear]] community. With so much development ongoing, it's almost impossible for anyone to keep up. The newsletter was started in July 2009, and is presented on a monthly basis. It is a collaborative effort that is created, edited and distributed via the [[FlightGear Wiki]], and all FlightGear users, contributors and developers are invited to contribute.

=== Archive ===
<div class="noresize">
{| class="prettytable"
! align="left" | 2025
! align="left" | 2024
! align="left" | 2023
! align="left" | 2022
! align="left" | 2021
! align="left" | 2020
! align="left" | 2019
! align="left" | 2018
! align="left" | 2017
! align="left" | 2016
! align="left" | 2015
! align="left" | 2014
! align="left" | 2013
! align="left" | 2012
! align="left" | 2011
! align="left" | 2010
! align="left" | 2009
|-
| valign="top" |
* [[FlightGear Newsletter January 2025|January]]
* [[FlightGear Newsletter February 2025|February]]
* [[FlightGear Newsletter March 2025|March]]
* [[FlightGear Newsletter April 2025|April]]
* [[FlightGear Newsletter May 2025|May]]
* [[FlightGear Newsletter June 2025|June]]
* [[FlightGear Newsletter July 2025|July]]
* [[FlightGear Newsletter August 2025|August]]
* [[FlightGear Newsletter September 2025|September]]
* [[FlightGear Newsletter October 2025|October]]
* [[FlightGear Newsletter November 2025|November]]
* [[FlightGear Newsletter December 2025|December]]
| valign="top" |
* [[FlightGear Newsletter January 2024|January]]
* [[FlightGear Newsletter February 2024|February]]
* [[FlightGear Newsletter March 2024|March]]
* [[FlightGear Newsletter April 2024|April]]
* [[FlightGear Newsletter May 2024|May]]
* [[FlightGear Newsletter June 2024|June]]
* [[FlightGear Newsletter July 2024|July]]
* [[FlightGear Newsletter August 2024|August]]
* [[FlightGear Newsletter September 2024|September]]
* [[FlightGear Newsletter October 2024|October]]
* [[FlightGear Newsletter November 2024|November]]
* [[FlightGear Newsletter December 2024|December]]
| valign="top" |
* [[FlightGear Newsletter January 2023|January]]
* [[FlightGear Newsletter February 2023|February]]
* [[FlightGear Newsletter March 2023|March]]
* [[FlightGear Newsletter April 2023|April]]
* [[FlightGear Newsletter May 2023|May]]
* [[FlightGear Newsletter June 2023|June]]
* [[FlightGear Newsletter July 2023|July]]
* [[FlightGear Newsletter August 2023|August]]
* [[FlightGear Newsletter September 2023|September]]
* [[FlightGear Newsletter October 2023|October]]
* [[FlightGear Newsletter November 2023|November]]
* [[FlightGear Newsletter December 2023|December]]
| valign="top" |
* [[FlightGear Newsletter January 2022|January]]
* [[FlightGear Newsletter February 2022|February]]
* [[FlightGear Newsletter March 2022|March]]
* [[FlightGear Newsletter April 2022|April]]
* [[FlightGear Newsletter May 2022|May]]
* June
* [[FlightGear Newsletter July 2022|July]]
* [[FlightGear Newsletter August 2022|August]]
* [[FlightGear Newsletter September 2022|September]]
* [[FlightGear Newsletter November 2022|November]]
* [[FlightGear Newsletter December 2022|December]]
| valign="top" |
* [[FlightGear Newsletter January 2021|January]]
* [[FlightGear Newsletter February 2021|February]]
* [[FlightGear Newsletter March 2021|March]]
* [[FlightGear Newsletter April 2021|April]]
* [[FlightGear Newsletter May 2021|May]]
* [[FlightGear Newsletter June 2021|June]]
* [[FlightGear Newsletter July 2021|July]]
* [[FlightGear Newsletter August 2021|August]]
* [[FlightGear Newsletter September 2021|September]]
* [[FlightGear Newsletter October 2021|October]]
* [[FlightGear Newsletter November 2021|November]]
* [[FlightGear Newsletter December 2021|December]]
| valign="top" |
* [[FlightGear Newsletter January 2020|January]]
* [[FlightGear Newsletter February 2020|February]]
* [[FlightGear Newsletter March 2020|March]]
* [[FlightGear Newsletter April 2020|April]]
* [[FlightGear Newsletter May 2020|May]]
* [[FlightGear Newsletter June 2020|June]]
* [[FlightGear Newsletter July 2020|July]]
* [[FlightGear Newsletter August 2020|August]]
* [[FlightGear Newsletter September 2020|September]]
* [[FlightGear Newsletter October 2020|October]]
* [[FlightGear Newsletter November 2020|November]]
* [[FlightGear Newsletter December 2020|December]]
| valign="top" |
* [[FlightGear Newsletter January 2019|January]]
* [[FlightGear Newsletter February 2019|February]]
* [[FlightGear Newsletter March 2019|March]]
* [[FlightGear Newsletter April 2019|April]]
* [[FlightGear Newsletter May 2019|May]]
* [[FlightGear Newsletter June 2019|June]]
* [[FlightGear Newsletter July 2019|July]]
* [[FlightGear Newsletter August 2019|August]]
* [[FlightGear Newsletter September 2019|September]]
* [[FlightGear Newsletter October 2019|October]]
* [[FlightGear Newsletter November 2019|November]]
| valign="top" |
* [[FlightGear Newsletter January 2018|January]]
* [[FlightGear Newsletter February 2018|February]]
* [[FlightGear Newsletter March 2018|March]]
* [[FlightGear Newsletter April 2018|April]]
* [[FlightGear Newsletter May 2018|May]]
* [[FlightGear Newsletter June 2018|June]]
* [[FlightGear Newsletter July 2018|July]]
* [[FlightGear Newsletter August 2018|August]]
* [[FlightGear Newsletter September 2018|September]]
* [[FlightGear Newsletter October 2018|October]]
* [[FlightGear Newsletter November 2018|November]]
* [[FlightGear Newsletter December 2018|December]]
| valign="top" |
* [[FlightGear Newsletter January 2017|January]]
* [[FlightGear Newsletter February 2017|February]]
* [[FlightGear Newsletter March 2017|March]]
* [[FlightGear Newsletter April 2017|April]]
* [[FlightGear Newsletter May 2017|May]]
* [[FlightGear Newsletter June 2017|June]]
* [[FlightGear Newsletter July 2017|July]]
* [[FlightGear Newsletter August 2017|August]]
* [[FlightGear Newsletter September 2017|September]]
* [[FlightGear Newsletter October 2017|October]]
* [[FlightGear Newsletter November 2017|November]]
* [[FlightGear Newsletter December 2017|December]]
| valign="top" |
* [[FlightGear Newsletter January 2016|January]]
* [[FlightGear Newsletter February 2016|February]]
* [[FlightGear Newsletter March 2016|March]]
* [[FlightGear Newsletter April 2016|April]]
* [[FlightGear Newsletter May 2016|May]]
* [[FlightGear Newsletter June 2016|June]]
* [[FlightGear Newsletter July 2016|July]]
* [[FlightGear Newsletter August 2016|August]]
* [[FlightGear Newsletter September 2016|September]]
* [[FlightGear Newsletter October 2016|October]]
* [[FlightGear Newsletter November 2016|November]]
* [[FlightGear Newsletter December 2016|December]]
| valign="top" |
* [[FlightGear Newsletter January 2015|January]]
* [[FlightGear Newsletter February 2015|February]]
* [[FlightGear Newsletter March 2015|March]]
* [[FlightGear Newsletter April 2015|April]]
* [[FlightGear Newsletter May 2015|May]]
* [[FlightGear Newsletter June 2015|June]]
* [[FlightGear Newsletter July 2015|July]]
* [[FlightGear Newsletter August 2015|August]]
* [[FlightGear Newsletter September 2015|September]]
* [[FlightGear Newsletter October 2015|October]]
* [[FlightGear Newsletter November 2015|November]]
* [[FlightGear Newsletter December 2015|December]]
| valign="top" |
* [[FlightGear Newsletter January 2014|January]]
* [[FlightGear Newsletter February 2014|February]]
* [[FlightGear Newsletter March 2014|March]]
* [[FlightGear Newsletter April 2014|April]]
* [[FlightGear Newsletter May 2014|May]]
* [[FlightGear Newsletter June 2014|June]]
* [[FlightGear Newsletter July 2014|July]]
* [[FlightGear Newsletter August 2014|August]]
* [[FlightGear Newsletter September 2014|September]]
* [[FlightGear Newsletter October 2014|October]]
* [[FlightGear Newsletter November 2014|November]]
* [[FlightGear Newsletter December 2014|December]]
| valign="top" |
* [[FlightGear Newsletter January 2013|January]]
* [[FlightGear Newsletter February 2013|February]]
* [[FlightGear Newsletter March 2013|March]]
* [[FlightGear Newsletter April 2013|April]]
* [[FlightGear Newsletter May 2013|May]]
* [[FlightGear Newsletter June 2013|June]]
* [[FlightGear Newsletter July 2013|July]]
* [[FlightGear Newsletter August 2013|August]]
* [[FlightGear Newsletter September 2013|September]]
* [[FlightGear Newsletter October 2013|October]]
* [[FlightGear Newsletter November 2013|November]]
* [[FlightGear Newsletter December 2013|December]]
| valign="top" |
* [[FlightGear Newsletter January 2012|January]]
* [[FlightGear Newsletter February 2012|February]]
* [[FlightGear Newsletter March 2012|March]]
* [[FlightGear Newsletter April 2012|April]]
* [[FlightGear Newsletter May 2012|May]]
* [[FlightGear Newsletter June 2012|June]]
* [[FlightGear Newsletter July 2012|July]]
* [[FlightGear Newsletter August 2012|August]]
* [[FlightGear Newsletter September 2012|September]]
* [[FlightGear Newsletter October 2012|October]]
* [[FlightGear Newsletter November 2012|November]]
* [[FlightGear Newsletter December 2012|December]]
| valign="top" |
* [[FlightGear Newsletter January 2011|January]]
* [[FlightGear Newsletter February 2011|February]]
* [[FlightGear Newsletter March 2011|March]]
* [[FlightGear Newsletter April 2011|April]]
* [[FlightGear Newsletter May 2011|May]]
* [[FlightGear Newsletter June 2011|June]]
* [[FlightGear Newsletter July 2011|July]]
* [[FlightGear Newsletter August 2011|August]]
* [[FlightGear Newsletter September 2011|September]]
* [[FlightGear Newsletter October 2011|October]]
* [[FlightGear Newsletter November 2011|November]]
* [[FlightGear Newsletter December 2011|December]]
| valign="top" |
* [[FlightGear Newsletter January 2010|January]]
* [[FlightGear Newsletter February 2010|February]]
* [[FlightGear Newsletter March 2010|March]]
* [[FlightGear Newsletter April 2010|April]]
* [[FlightGear Newsletter May 2010|May]]
* [[FlightGear Newsletter June 2010|June]]
* [[FlightGear Newsletter July 2010|July]]
* [[FlightGear Newsletter August 2010|August]]
* [[FlightGear Newsletter September 2010|September]]
* [[FlightGear Newsletter October 2010|October]]
* [[FlightGear Newsletter November 2010|November]]
* [[FlightGear Newsletter December 2010|December]]
| valign="top" |
* [[FlightGear Newsletter July 2009|July]]
* [[FlightGear Newsletter August 2009|August]]
* [[FlightGear Newsletter September 2009|September]]
* [[FlightGear Newsletter October 2009|October]]
* [[FlightGear Newsletter November 2009|November]]
* [[FlightGear Newsletter December 2009|December]]
|}
</div>

Some newsletter editions have been translated in other languages:
* [[File:De.gif|16px|link=:De:FlightGear Newsletter]] [[:De:FlightGear Newsletter|Deutsch]]
* [[File:Es.gif|16px|link=:Es:FlightGear Newsletter]] [[:Es:FlightGear Newsletter|Español]]
* [[File:Fr.gif|16px|link=:Fr:FlightGear Newsletter]] [[:Fr:FlightGear Newsletter|Français]]

=== You are invited to contribute! ===
We would like to emphasize that the monthly newsletter can not live without the contributions of FlightGear users and developers. The FlightGear Newsletter is a community-driven newsletter, which means that it is created and edited by people like ''you''. You don't need to be a long-time FlightGear user (or even a developer) to contribute to the newsletter.

In fact, helping write the monthly FlightGear newsletter is an excellent way for getting started contributing to the FlightGear community very quickly and very easily.

Even if you don't have to add anything yourself, just reviewing and improving additions by others is also highly appreciated, as are efforts to help translate newsletters or add screen shots (e.g. taken from the forum or mailing lists) to the newsletter. Screen shots can be uploaded at [[Special:Upload]].

Everyone with a wiki account (free to [[Special:UserLogin|register]]) can edit the newsletter and every contribution is welcome. So if you know about any FlightGear related projects such as for example updated scenery or aircraft, please do feel invited to add such news to the newsletter.

A simple template providing a basic structure for each upcoming newsletter can be taken from [[Talk:Next newsletter]]. This template can be copied/pasted into each new newsletter to help users getting started providing contents.

The draft for the upcoming newsletter can always be found at [[Next newsletter]].

If English is not your native language, please don't be concerned about contributing to the newsletter, you can always easily ask fellow FlightGear users to review or proof-read your changes. Also, one of the easiest ways to get started is simply copying/pasting text from forum or mailing list discussions, such as announcements (e.g., new aircraft, new scenery, etc.).

Another neat option to get started is adding links to FlightGear-related YouTube videos. For this, we have a dedicated section in each newsletter: "[[FlightGear Newsletter {{#time: F Y | last month }}#FlightGear on YouTube|FlightGear on YouTube]]."

If you want to embed a video, please see {{mediawiki|Extension:EmbedVideo#Usage}}

If you are looking for other ways to get involved, please see [[Volunteer]].

[[Category:FlightGear Newsletter| ]]
[[Category:Community|Newsletter]]
[[Category:Lists|Newsletter]]

[[de:FlightGear Newsletter]]
[[es:FlightGear Newsletter]]
[[fr:FlightGear Newsletter]]