FlightGear Launch Control: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
No edit summary
m (+-link: AI traffic → AI Traffic)
(47 intermediate revisions by 19 users not shown)
Line 1: Line 1:
'''Fgrun''' is a graphical front end for [[FlightGear]],  distributed and developed separately at http://sourceforge.net/projects/fgrun. However, it was included in officially distributed binaries for FlightGear, even though it is not technically a part the FlightGear program, like several other frontends (see also [[FlightGear related projects]]). Fgrun allows one to choose options more easily than with the command line. (see also [[FlightGear 1.0 aircraft names for command line]])
{{Infobox Software
| title                  = FlightGear Launch Control
| image                  = Fgrun-page2.jpg
| alt                    = The second (aircraft selection) page of FGRun.
| developedby            = Bernie Bright, Frederic Bouvier
| initialrelease        = 0.3.2 (October 24, 2003)
| latestrelease          = 2016.3.1 (September 6, 2016)
| writtenin              = C++
| os                    = All 32-bit MS Windows<br>All POSIX (Linux/BSD/UNIX-like)
| developmentstatus      = Discontinued (2002-2016)
| license                = [[GNU General Public License]]
| website                = {{fgrun source|full=1}}
}}
'''FlightGear Launch Control''' ('''FGRun''') is a graphical frontend for [[FlightGear]]. It was included in officially distributed binaries for FlightGear until 2016, when it was superseded by the [[FlightGear Qt launcher|Qt launcher]]. FGRun allows one to choose options more easily than with the [[Command Line Parameters|command line]].


The application has two main parts : a wizard to choose common options, and an advanced section where all options are available for advanced users.
The application has two main parts:  
* a wizard to choose common options
* an advanced section where all options are available for advanced users.


Options choosen are automatically saved in a file and are reused the next time fgrun is restarted.
Options chosen are automatically saved in a file and are reused the next time FGRun is started.


For information on compiling this software see [[Building FlightGear Launch Control]].
== The wizard ==
The wizard appears to the user when FGRun is started. The first time, when no path are set, the first page is shown, otherwise, it jumps directly to the second page, but the first one is still accessible by hitting the "Prev" button.


=== Navigation bar ===
The bottom of the wizard shows six buttons. From left to right:
* '''Defaults''' : in case of emergency, clear all options and restore initial path set at installation.
* '''Load''' : Load a set of options previously saved.
* '''Save as...''' : Save the current set of options to a file.
* '''Prev''' : go to previous page of the wizard.
* '''Next''' : go to next page of the wizard. This button is replaced by the '''Run''' button in the last page, to start FlightGear.
* '''Quit''' : end the wizard ( and terrasync if it was started by fgrun ).


== The Wizard ==
The wizard appears to the user when fgrun is started. The first time, when no path are set, the first page is shown, otherwise, it jumps directly to the second page, but the first one is still accessible by hitting the "Prev" button.
[[Image:fgrun-page1.jpg|thumb|300px]]
=== Page One - Paths ===
=== Page One - Paths ===
In the first page, the paths needed by fgrun are recalled and can be set. If fgrun was installed with a binary package, either under Windows or Linux, these paths are normally initialized by the installation procedure.
[[File:fgrun-page1.jpg|thumb]]
In the first page, the paths needed by FGRun are recalled and can be set. If FGRun was installed with a binary package, either under Windows or Linux, these paths are normally initialized by the installation procedure.


The 'Executable' box is the full path to the FlightGear program. One can choose it directly using the file selection dialog that pops up when the folder button is hit.
* '''Executable''': the full path to the FlightGear program (<tt>fgfs</tt> or <tt>fgfs.exe</tt> on Windows). One can choose it directly using the file selection dialog that pops up when the folder button is hit.
* '''[[$FG ROOT|FG_ROOT]]''': the full path to the FlightGear base package (<tt>data/</tt> directory). If this path is wrong, no [[aircraft]] would be displayed and FlightGear won't run.
* '''[[$FG_AIRCRAFT|FG_AIRCRAFT]]''': can link to external aircraft packages. Leave empty when all your aircraft are installed in <tt>[[$FG_ROOT]]/Aircraft</tt>.
* '''[[FG SCENERY]]''': the paths to [[scenery]] folders. These folders usually have a 'Terrain', and optionally a 'Objects' , subfolders. You can add a new path with the 'Add...' button. Priorities among folders are managed with the up and down arrows; the top most folder having the highest priority. If there is no scenery for a location in the top folder, FlightGear will look in the next folder etc.
* '''Airports Cache''': the location of the file that stores the [[:Category:Airports|airport]] ids found in the scenery. You should not need to change this one. It is faster to access that file than to scan scenery directories to build the airport list. It is possible to delete that file if things go wrong. That will force a new scan when the third page will be shown.


The 'FG_ROOT' field is the full path to the FlightGear Base Package. It isn't the value of the $FG_ROOT ( or %FG_ROOT% under Windows ) environment variable. If this path is wrong, no [[Aircraft]] would be displayed and FlightGear won't run.
'''Hint''': If things go wrong and FlightGear cannot start anymore, and you want to start over with a bare installation, remove or rename the file named 'fgrun.prefs' located in the parent directory of the airport cache file. You will have to reenter path by hand, but the silly options you could have entered will be deleted.
<br style="clear:both"/>


The 'FG_SCENERY' list is the path list to [[scenery]] folders. These folders usually have a 'Terrain', and optionally a 'Objects' , subfolders. One add a new path with the 'Add...' button. Priorities among folders are managed with the up and down arrows.
=== Page two - Aircraft Selection ===
[[File:fgrun-page2.jpg|thumb]]
The second page, usually the first page seen by users when starting fgrun, is the aircraft selection page. It shows the list of aircraft found in <tt>[[$FG ROOT]]/Aircraft</tt> and all <tt>FG_AIRCRAFT</tt> directories, and the model of the selected aircraft.
<br style="clear:both"/>


The 'Airports Cache' field shows the location of the file that stores the airport ids found in the scenery. It is faster to access that file than to scan scenery directories to build the [[airport]] list. It is possible to delete that file if things go wrong. That will force a new scan when the third page will be shown.
=== Page three - Airport Selection ===
[[File:fgrun-page3.jpg|thumb]]
The third page is the Airport and Runway selection box. It only shows the content of the Airport Cache file, that should be the reflect of the content of the scenery folders. If a new scenery has been installed and doesn't show up, or an old scenery has been deleted and airport are still there, click on the 'Refresh' button to rescan the scenery directories. The scan occurs the first time or when the Airport Cache has been deleted.


: '''Hint'''
The airport's list doesn't seem to appear (or ever worse, it disappears) when the refresh button is pressed. To (re)build this list execute the following line once the FlightGear-data is installed:
:If things goes wrong and FlightGear can't start anymore, and you want to start over with a bare installation, remove or rename the file named 'fgrun.prefs' located in the parent directory of the airport cache file. You will have to reenter path by hand, but the silly options you could have entered will be deleted.


[[Image:fgrun-page2.jpg|thumb|300px]]
zcat /usr/share/FlightGear/Airports/metar.dat.gz > \${HOME}/.fltk/flightgear.org/fgrun/airports.txt
=== Page Two - Aircraft Selection ===
<br style="clear:both"/>
The second page, usually the first page seen by users when starting fgrun, is the aircraft selection page. It shows the list of aircrafts found in FG_ROOT/Aircraft and the model of the selected aircraft, spinning.
 
[[Image:fgrun-page3.jpg|thumb|300px]]
=== Page Three - Airport Selection ===
The third page is the Airport and Runway selection box. It only shows the content of the Airport Cache file, that should be the reflect of the content of the scenery folders. If a new scenery has been installed and doesn't show up, or an old scenery has been deleted and airport are still there, click on the 'Refresh' button to rescan the scenery directories. The scan occurs the first time or when the Airport Cache has been deleted.


[[Image:fgrun-page4.jpg|thumb|300px]]
=== Page four - Options and Run ===
=== Page Four - Options and Run ===
[[File:fgrun-page4.jpg|thumb]]
The last page shows common options without the need to go to the Advanced section.
The last page shows common options without the need to go to the Advanced section.


Line 42: Line 66:
: Usually, people new to FlightGear should stick there and experience a simple flight before going to the advanced section. This way, it will be easier to diagnose problem if, by accident, FlightGear would not start or run. Often problems come from incoherent options choosen, and there is no fool guard beyond this limit. If FG doen't run anyway, it will be time to look at the hardware setup.
: Usually, people new to FlightGear should stick there and experience a simple flight before going to the advanced section. This way, it will be easier to diagnose problem if, by accident, FlightGear would not start or run. Often problems come from incoherent options choosen, and there is no fool guard beyond this limit. If FG doen't run anyway, it will be time to look at the hardware setup.


The command line is helpful to people wanting to diagnose a problem. Last released fgrun for Windows doesn't allow copy / paste due to a problem in fltk. The next one will allow that.
The command line is helpful to people wanting to diagnose a problem.


The 'Run' button starts FlightGear with the options shown in the command line box.
The 'Run' button starts FlightGear with the options shown in the command line box.
<br style="clear:both"/>


== Advanced Options ==
== Advanced Options ==
[[Image:fgrun-wiki-a01.jpg|thumb|300px]]
The advanced options dialog can be opened through clicking the 'Advanced' button on the last (fourth) page of the launcher.
===General===
 
=== General ===
[[File:fgrun-wiki-a01.jpg|thumb|General]]
* '''FG_SCENERY:''' Where's your [[scenery]] saved on your computer?
* '''FG_SCENERY:''' Where's your [[scenery]] saved on your computer?
* '''Control:''' Wich controller do you use?
* '''Control:''' Which controller do you use?
* '''Airport:''' Your start [[airport]].
* '''Airport:''' Your start airport.
* '''Runway:''' Start runway of your airport (see above).
* '''Runway:''' Start runway of your airport (see above).
* '''Aircraft:''' Your flying vehicle/[[aircraft]].
* '''Aircraft:''' Your flying vehicle/[[aircraft]].
* '''Language:''' The language of FlightGear.
* '''Language:''' The language of FlightGear.
<br style="clear:both"/>


[[Image:fgrun-wiki-a02.jpg|thumb|300px]]
=== Features ===
===Features===
[[File:fgrun-wiki-a02.jpg|thumb|Features]]
* '''Game Mode:''' The full screen game mode.
* '''Game Mode:''' The full screen game mode.
* '''Random Objects:''' Enable random [[scenery]] objects.
* '''Random Objects:''' Enable random [[scenery]] objects.
* '''Sound:''' Enable sound effects like engine sounds.
* '''Sound:''' Enable sound effects like engine sounds.
* '''HUD:''' Enable Heads Up Display (HUD).
* '''HUD:''' Enable Heads Up Display (HUD).
* '''AI Traffic:''' Enable [[AI traffic]].
* '''AI Traffic:''' Enable [[AI Traffic]].
<br style="clear:both"/>


[[Image:fgrun-wiki-a03.jpg|thumb|300px]]
=== Flight Model ===
===Flight Model===
[[File:fgrun-wiki-a03.jpg|thumb|Flight Model]]
<br style="clear:both"/>


[[Image:fgrun-wiki-a04.jpg|thumb|300px]]
=== Freeze ===
===Freeze===
[[File:fgrun-wiki-a04.jpg|thumb|Freeze]]
* '''Freeze:''' Start paused'.
* '''Freeze:''' Start paused'.
<br style="clear:both"/>


[[Image:fgrun-wiki-a05.jpg|thumb|300px]]
=== Initial Position ===
===Initial Posititon===
[[File:fgrun-wiki-a05.jpg|thumb|Initial Position]]
* '''Longitude:''' What's your longitude?
* '''Longitude:''' What's your longitude?
* '''Latitude:''' What's your latitude?
* '''Latitude:''' What's your latitude?
* '''Altitude:''' What's your altitude?
* '''Altitude:''' What's your altitude?
* '''Heading:''' The aircraft heading (yaw) angle.
* '''Heading:''' The aircraft heading degrees magnetic.
* '''Airspeed:''' Your airspeed in knots.
* '''Airspeed:''' Your airspeed in knots.
<br style="clear:both"/>


[[Image:fgrun-wiki-a06.jpg|thumb|300px]]
=== Rendering ===
===Rendering===
[[File:fgrun-wiki-a06.jpg|thumb|Rendering]]
* '''Clouds:''' Are there any clouds up in the air?
* '''Clouds:''' Are there any clouds up in the air?
* '''3D Clouds:''' Are the clouds 3D?
* '''3D Clouds:''' Are the clouds 3D?
* '''Full Screen:''' Want to play on full screen?
* '''Full Screen:''' Want to play on full screen?
* '''Wireframe:''' Do you wanna see only the wires of the [[scenery]] and the [[aircraft]]s?
* '''Wireframe:''' Do you wanna see only the wires of the [[scenery]] and the [[aircraft]]?
* '''Visibility:''' Visibility distance in meters or miles.
* '''Visibility:''' Visibility distance in meters or miles.
* '''Bpp:''' Color depth in Bits per pixel.
* '''Bpp:''' Color depth in Bits per pixel.
* '''FOV:''' Field of View angle.
* '''FOV:''' Field of View angle.
* '''Materials file:''' The materials XML file (default materials.xml, can be changed to materials-dds.xml for DDS scenery textures).
<br style="clear:both"/>


[[Image:fgrun-wiki-a07.jpg|thumb|300px]]
=== Time ===
===Time===
[[File:fgrun-wiki-a07.jpg|thumb|Time]]
* '''Time match local:''' Synchronisize simulation time with local time.
* '''Time match local:''' Synchronize simulation time with the computers hardware clock (your own location).
* '''Time match real:''' Synchronize simulation time with time at chosen airport - you can use the entry box to the left of the radio button to set an additional time offset.  Use this to correct for additonal time zone differences.  The resulting time is displayed as UTC in the Environment => Time Settings dialog in FlightGear even if it is not UTC.
* '''Time of day:''' What's the time of the day?  
* '''Time of day:''' What's the time of the day?  
<br style="clear:both"/>


[[Image:fgrun-wiki-a08.jpg|thumb|300px]]
=== Network ===
===Network===
[[File:fgrun-wiki-a08.jpg|thumb|Network]]
* '''Callsign:''' your callsign for the network. This is used to recognize other pilots and for tracking your flights.
* '''Callsign:''' your callsign for the network. This is used to recognize other pilots and for tracking your flights.


'''See:''' [[Multiplayer Howto]]
'''See:''' [[Multiplayer Howto]]
<br style="clear:both"/>


[[Image:fgrun-wiki-a09.jpg|thumb|300px]]
=== Input/Output ===
===Input/Output===
[[File:fgrun-wiki-a09.jpg|thumb|Input/Output]]
<br style="clear:both"/>


[[Image:fgrun-wiki-a10.jpg|thumb|300px]]
=== Avionics ===
===Avionics===
[[File:fgrun-wiki-a10.jpg|thumb|Avionics]]
<br style="clear:both"/>


[[Image:fgrun-wiki-a11.jpg|thumb|300px]]
=== Properties ===
===Properties===
[[File:fgrun-wiki-a11.jpg|thumb|Properties]]
This is where you could edit or add new parameters. It's same as configuring the Command Line.
This is where you could edit or add new property commands. It's same as configuring the [[command line]] with <tt>--prop:...</tt>.
<br style="clear:both"/>


'''See:''' [[Command Line Parameters]]
=== Debugging ===
[[File:fgrun-wiki-a12.jpg|thumb|Debugging]]
* '''Log Level:''' The lower the log level, the less errors you'll see. A higher log level can increase the loading time extremely.
* '''Trace Read Properties:'''
* '''Trace Write Properties:'''
<br style="clear:both"/>


[[Image:fgrun-wiki-a12.jpg|thumb|300px]]
=== Environment ===
=== Dubugging ===
[[File:fgrun-wiki-a13.jpg|thumb|Environment]]
<br style="clear:both"/>


[[Image:fgrun-wiki-a13.jpg|thumb|300px]]
=== Weather ===
=== Environment ===  
[[File:fgrun-wiki-a14.jpg|thumb|Weather]]
 
[[Image:fgrun-wiki-a14.jpg|thumb|300px]]
=== Weather ===
* '''Wind Direction:''' Direction of the wind.
* '''Wind Direction:''' Direction of the wind.
* '''Heading:''' Directon wind is coming from.
* '''Heading:''' Directon wind is coming from.
* '''Speed:''' Wind speed in knots (kts).
* '''Speed:''' Wind speed in knots (kts).
<br style="clear:both"/>


[[Image:fgrun-wiki-a15.jpg|thumb|300px]]
=== Clouds ===
=== Clouds ===
[[File:fgrun-wiki-a15.jpg|thumb|Clouds]]
* '''Elevation:''' How high (in feet) are the clouds?
* '''Elevation:''' How high (in feet) are the clouds?
* '''Thickness:''' How thick (in feet) are the clouds?
* '''Thickness:''' How thick (in feet) are the clouds?
<br style="clear:both"/>
== Related content ==
* [[FGo!]], a simple GUI front-end for FlightGear written in Python
* [[JFlightWizard]], another graphical frontend
== External link ==
* {{fgrun source|text=FGRun git repository}}
[[Category:FGRun| ]]
[[Category:FlightGear front ends]]
[[Category:GPL software]]


[[Category:Software]]
[[de:FlightGear Launch Control]]
[[Category:GPL]]
[[fr:FlightGear Launch Control]]
[[nl:FlightGear Launch Control]]

Revision as of 21:25, 21 November 2019

FlightGear Launch Control
The second (aircraft selection) page of FGRun.
The second (aircraft selection) page of FGRun.
Developed by Bernie Bright, Frederic Bouvier
Initial release 0.3.2 (October 24, 2003)
Latest release 2016.3.1 (September 6, 2016)
Written in C++
OS All 32-bit MS Windows
All POSIX (Linux/BSD/UNIX-like)
Development status Discontinued (2002-2016)
License GNU General Public License
Website

FlightGear Launch Control (FGRun) is a graphical frontend for FlightGear. It was included in officially distributed binaries for FlightGear until 2016, when it was superseded by the Qt launcher. FGRun allows one to choose options more easily than with the command line.

The application has two main parts:

  • a wizard to choose common options
  • an advanced section where all options are available for advanced users.

Options chosen are automatically saved in a file and are reused the next time FGRun is started.

The wizard

The wizard appears to the user when FGRun is started. The first time, when no path are set, the first page is shown, otherwise, it jumps directly to the second page, but the first one is still accessible by hitting the "Prev" button.

Navigation bar

The bottom of the wizard shows six buttons. From left to right:

  • Defaults : in case of emergency, clear all options and restore initial path set at installation.
  • Load : Load a set of options previously saved.
  • Save as... : Save the current set of options to a file.
  • Prev : go to previous page of the wizard.
  • Next : go to next page of the wizard. This button is replaced by the Run button in the last page, to start FlightGear.
  • Quit : end the wizard ( and terrasync if it was started by fgrun ).

Page One - Paths

Fgrun-page1.jpg

In the first page, the paths needed by FGRun are recalled and can be set. If FGRun was installed with a binary package, either under Windows or Linux, these paths are normally initialized by the installation procedure.

  • Executable: the full path to the FlightGear program (fgfs or fgfs.exe on Windows). One can choose it directly using the file selection dialog that pops up when the folder button is hit.
  • FG_ROOT: the full path to the FlightGear base package (data/ directory). If this path is wrong, no aircraft would be displayed and FlightGear won't run.
  • FG_AIRCRAFT: can link to external aircraft packages. Leave empty when all your aircraft are installed in $FG_ROOT/Aircraft.
  • FG SCENERY: the paths to scenery folders. These folders usually have a 'Terrain', and optionally a 'Objects' , subfolders. You can add a new path with the 'Add...' button. Priorities among folders are managed with the up and down arrows; the top most folder having the highest priority. If there is no scenery for a location in the top folder, FlightGear will look in the next folder etc.
  • Airports Cache: the location of the file that stores the airport ids found in the scenery. You should not need to change this one. It is faster to access that file than to scan scenery directories to build the airport list. It is possible to delete that file if things go wrong. That will force a new scan when the third page will be shown.

Hint: If things go wrong and FlightGear cannot start anymore, and you want to start over with a bare installation, remove or rename the file named 'fgrun.prefs' located in the parent directory of the airport cache file. You will have to reenter path by hand, but the silly options you could have entered will be deleted.

Page two - Aircraft Selection

Fgrun-page2.jpg

The second page, usually the first page seen by users when starting fgrun, is the aircraft selection page. It shows the list of aircraft found in $FG ROOT/Aircraft and all FG_AIRCRAFT directories, and the model of the selected aircraft.

Page three - Airport Selection

Fgrun-page3.jpg

The third page is the Airport and Runway selection box. It only shows the content of the Airport Cache file, that should be the reflect of the content of the scenery folders. If a new scenery has been installed and doesn't show up, or an old scenery has been deleted and airport are still there, click on the 'Refresh' button to rescan the scenery directories. The scan occurs the first time or when the Airport Cache has been deleted.

The airport's list doesn't seem to appear (or ever worse, it disappears) when the refresh button is pressed. To (re)build this list execute the following line once the FlightGear-data is installed:

zcat /usr/share/FlightGear/Airports/metar.dat.gz > \${HOME}/.fltk/flightgear.org/fgrun/airports.txt


Page four - Options and Run

Fgrun-page4.jpg

The last page shows common options without the need to go to the Advanced section.

Hint
Usually, people new to FlightGear should stick there and experience a simple flight before going to the advanced section. This way, it will be easier to diagnose problem if, by accident, FlightGear would not start or run. Often problems come from incoherent options choosen, and there is no fool guard beyond this limit. If FG doen't run anyway, it will be time to look at the hardware setup.

The command line is helpful to people wanting to diagnose a problem.

The 'Run' button starts FlightGear with the options shown in the command line box.

Advanced Options

The advanced options dialog can be opened through clicking the 'Advanced' button on the last (fourth) page of the launcher.

General

General
  • FG_SCENERY: Where's your scenery saved on your computer?
  • Control: Which controller do you use?
  • Airport: Your start airport.
  • Runway: Start runway of your airport (see above).
  • Aircraft: Your flying vehicle/aircraft.
  • Language: The language of FlightGear.


Features

Features
  • Game Mode: The full screen game mode.
  • Random Objects: Enable random scenery objects.
  • Sound: Enable sound effects like engine sounds.
  • HUD: Enable Heads Up Display (HUD).
  • AI Traffic: Enable AI Traffic.


Flight Model

Flight Model


Freeze

Freeze
  • Freeze: Start paused'.


Initial Position

Initial Position
  • Longitude: What's your longitude?
  • Latitude: What's your latitude?
  • Altitude: What's your altitude?
  • Heading: The aircraft heading degrees magnetic.
  • Airspeed: Your airspeed in knots.


Rendering

Rendering
  • Clouds: Are there any clouds up in the air?
  • 3D Clouds: Are the clouds 3D?
  • Full Screen: Want to play on full screen?
  • Wireframe: Do you wanna see only the wires of the scenery and the aircraft?
  • Visibility: Visibility distance in meters or miles.
  • Bpp: Color depth in Bits per pixel.
  • FOV: Field of View angle.
  • Materials file: The materials XML file (default materials.xml, can be changed to materials-dds.xml for DDS scenery textures).


Time

Time
  • Time match local: Synchronize simulation time with the computers hardware clock (your own location).
  • Time match real: Synchronize simulation time with time at chosen airport - you can use the entry box to the left of the radio button to set an additional time offset. Use this to correct for additonal time zone differences. The resulting time is displayed as UTC in the Environment => Time Settings dialog in FlightGear even if it is not UTC.
  • Time of day: What's the time of the day?


Network

Network
  • Callsign: your callsign for the network. This is used to recognize other pilots and for tracking your flights.

See: Multiplayer Howto

Input/Output

Input/Output


Avionics

Avionics


Properties

Properties

This is where you could edit or add new property commands. It's same as configuring the command line with --prop:....

Debugging

Debugging
  • Log Level: The lower the log level, the less errors you'll see. A higher log level can increase the loading time extremely.
  • Trace Read Properties:
  • Trace Write Properties:


Environment

Environment


Weather

Weather
  • Wind Direction: Direction of the wind.
  • Heading: Directon wind is coming from.
  • Speed: Wind speed in knots (kts).


Clouds

Clouds
  • Elevation: How high (in feet) are the clouds?
  • Thickness: How thick (in feet) are the clouds?


Related content

  • FGo!, a simple GUI front-end for FlightGear written in Python
  • JFlightWizard, another graphical frontend

External link