## FGExtend
-----------
Release 2020.06.04
Author: Xavier De Goër
Contact: FGExtend@flightgear.fr 

Licence : freeware
This software is provided "As is" - No warranty, aso...

Known issue:
The full path to the installation folder MUST NOT include SPACE.

IMPORTANT:FGExtend WILL WORK ONLY IF FLIGHTGEAR IS LAUNCHED WITH OPTION --telnet (see below).

*** IMPORTANT NOTE TO Windows10 USERS ***
Administrator's execution rights must be given to FGExtend, mumble, Git, Python and wget.
More details on http://windowsreport.com/createprocess-failed-code-740/

What's New in Version 2020.06.04
1) Use of the Python script allowing the download of the "Buildings" / "Pylons" / "Roads" sub-directories.
2) Resumption of the configuration dialog (better readability, Terrasync flexibility, abandonment of TerraGIT).
3) Optional request for confirmation before leaving the program.

What's new in version 2019.02.14
1) Display of the list of ATCs as a tree (the previous list mode remains available).
2) Introduction of a scene quality score of managed airports:
   0 - Not scored
   1 - No air park
   2 - Air park
   3 - Unrealistic buildings
   4 - Realistic buildings
   5 - Near true life realism
3) Possibility to find the list of airports managed in a given radius (in Nm):
   Enter the desired radius in the "Find" field, optionally followed by ";Q", where Q is the desired minimum scenery quality.

What's new in 2018.09.08 release
1) Bypassed FGFS memory leak related to "telnet" connections, the connections are now maintained as long as they do not fall by themselves, previously there were about 3 connections established and closed per second.

What's new in 2018.06.18 release
1) New button to switch 777 (and probably many other airrafts) transponder mode to ALT.

What's new in version 2017.12.10
1) Correction of 3 bugs regarding the "Terrasync" feature
2) Alarm added (warning in fgfs every 65 seconds) if the "Terrasync" function is supposed to be used (the folder declared in the configuration exists) but is disabled (checkbox).
3) Adding a blacklist in the configuration to not load / update some tiles.
4) Rename the FGExtend.py file to terra5.py (avoid launching it by mistake).
5) TerraGIT is no longer supported, as i'ts protocol is often modified.
6) Integrated Mac beta.2 version.

What's New in Version 2017.09.01
1) MySQL is no longer used, but I will keep the database up to date for users of previous versions.
2) Update local data automatically at startup, optionally in configuration.

New in 2017.08.20 release:
1) 2 lines of visualization of the connection status with Flightgear / Mumble.
2) Dep. And Dest. buttons To directly display the corresponding information.
3) FIR button to display FIR frequencies within range.

New in 2017.02.24 release:
1) New check box to allow to NOT update Airports and Models directories from Terrasync
(The problem does not arise with terraGIT, which does no more propose the update of these directories, as far as i can see).
Why?
When dynamically created jetways are used, static jetways (in the computer sense) must be removed,
both in $FGDATA and in $FGSCENERY (otherwise the dynamically created jetways will be positioned UPON those of the scenery,
Which is the worst effect).
2) Automatically saving your configuration to a .cfg file, which allows you to keep your settings even when using a newly updated FGExtend.dat.
The .dat file is loaded first, and if the .cfg file exists its contents will then overwrite the values ​​read in the .dat file

## Thanks to:
-------------
Daweed(AFR6938),
Theddy(U974),
BL99,
Claudy,
sorry if omission... 

## Features:
------------
Switching mumble rooms simply changing active COM frequency on FG.
Terrasync alternative based on TerraGIT(git) or terrasync(http).
ATCs based notepad.

THESE ARE INDEPENDENT ONE TO EACH OTHER, except that it is not possible to activate terraGIT/TerraSync feature if mumble one is not activated (due to program history).

## Windows package content:
---------------------------
 - FGExtend.exe (main executable)
 - FGExtend.dat (datafile containing ATCs).
 - FGExtend.py (used to download/upgrade terrasync tiles)
 - wget.exe (used to upgrade local ATCs database)
 - FGExtend.ico

## Linux package content:
------------------------
 - FGExtend (main exécutable).
 - FGExtend.dat(datafile containing configuration and ATCs).
 - FGExtend.py (used to download/upgrade terrasync tiles)
 - FGExtend.ico

## Prerequisites:
----------------
Mumble client must be installed on the computer running FGExtend(witch is not necessary this running FG if you don't use terraGit feature).
(http://www.mumble.com/)

Under Linux/MacOS wget must be installed
Under windows, it's supplied in the zip file (no installation required)

## Installation:
----------------
Uncompress downloaded archive according to your system in a folder of your choice.
In both cases, Python(3.xx) is assumed to be installed.

*** IMPORTANT NOTE TO Windows10 USERS ***
Administrator's execution rights must be given to FGExtend, mumble,Python and wget.
More details on http://windowsreport.com/createprocess-failed-code-740/

## Configuration:
-----------------
Launch FGExtend then click "Configure" button.
Set defaults values according to your system.
If FG is not running on the same computer than FGExtend, complete the "IP/URL" field with IP address of the computer running FG (ie: 192.168.xx.xx).

If you want to use TerraSync feature:
Check the according "Active" checkbox.
Complete "Directory" field (absolute full path), content MUST ends as "Scenery" (case sensitive).
Click "Initialize Directory" button.
Answer questions, if any.
Be patient, initial clonage is quit long (1 to 3H with standard ADSL).
Check "Show downloading progress in FG as Copilot messages" checkbox if you want to see downloading progress in FG (warning and error messages will be displayed regardless to this).
For windows users: If Python windows remains displayed, you can hide it checking "Hide git terminal window" checkbox. 
Click "OK".

If you don't use Mumble certificate, provide your mumble login/password for each server ("Edit" button under servers list on the main screen).

## Launching FG:
----------------
You have to launch FG with the following parameters:
--telnet=5401 (port number is alterable in FGExtend configuration), to allow FGExtend to retrieve some FG properties contents (position, headind, active COM frequency,...).
If you want use TerraSync feature, add your TerraSync directory to your scenery path (ie --fg-scenery="my custom sceneries folder":"my TerraSync folder":"other scenery folder").

## Miscellanous informations:
-----------------------------
Processed tiles are 1X1 degree.

FGExtend loads/update TerraSync tiles in the following order:
1)destination tile; if the destination is modified, download will restart according to new destination.
2)expected "previous" tile before destination according to the great circle between current position and destination.
3)7 remaining tiles around the destination one.
4)soon overflight tiles(according to heading, if there is enough time...).  
  If heading is altered 10 degrees or more, or if the current flying over tile is altered, the process will restart to avoid "lag" if the network is slow.

## Hints before your first flight using terraGIT/TerraSync feature:
-------------------------------------------------------------------
-Check "Show downloading progress in FG as Copilot messages" checkbox to get a feedback in FG.
-Start FG on your departure airport
-In route manager select a destination airport as close as possible to the departure one (but not the same, if so FG will crash).
-Destination tile download should start, then 8 tiles around.
-Wait until the end of downloads (no more messages in FG).
-Select your effective destination in the route manager (or mcdu), then take off...

## Notepad
----------
You can take notes ATC by ATC.
These notes are written in text files in the "notes" subdirectory of the FGExtend directory.

Personnal exemple(LEMD):
ALT 1998 *****
33L (322) ILS 109.9 AKOKI (22Nm)
ATIS 118.25 - 130.85

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------
Sorry if this english version of this file is not perfect, i'm french...
Any suggestion is welcome.








