Update version to 1.2.0

Add possibility to set thermal with configuration of its parameters.

CHANGELOG.md

@@ -0,0 +1,16 @@
+# CHANGELOG
+
+## v.1.2.0
+
+- Add possibility to change the flight plan of AI tow plane.
+
+## v.1.1.0
+
+- Fix AI aircraft going underground during take-off due to uneven runway elevations.
+- Possibility to add thermal with configuration of its parameters.
+
+## v.1.0.0
+
+- Possibility to call a towing aircraft at any airport
+- One defined route for the towing aircraft
+- 3 types of tow airplanes

README.md

@@ -2,10 +2,10 @@
 
 This is an add-on designed to include an AI aircraft that will be able to tow a glider. The main idea is to be able to do this at any airport where you start with your glider.
 
-## Instalation
+## Installation
 
 This add-on creates a flight plan in real-time based on the airport you are at. Unfortunately this causes a problem which you will have to solve manually by following the instructions below.
-Namely, the flight plan for AI aircraft, by default, must be stored in the `$FG_ROOT/AI/FlightPlanes/` directory. But for security reasons, Nasal scripts cannot save files to that directory, but can save e.g. to `$FG_HOME/Export/`. Therefore, the run-time created flight plan will just be saved to `$FG_HOME/Export/Addons/org.flightgear.addons.Aerotow/AI/FlightPlanes/`. The problem is that FlightGear does not know that it is supposed to look for the flight plan file in this location as well, so you have to tell it manually by using the `--data` command line option.
+Namely, the flight plan for AI aircraft, by default, must be stored in the `$FG_ROOT/AI/FlightPlans/` directory. But for security reasons, Nasal scripts cannot save files to that directory, but can save e.g. to `$FG_HOME/Export/`. Therefore, the run-time created flight plan will just be saved to `$FG_HOME/Export/Addons/org.flightgear.addons.Aerotow/AI/FlightPlans/`. The problem is that FlightGear does not know that it is supposed to look for the flight plan file in this location as well, so you have to tell it manually by using the `--data` command line option.
 
 `$FG_HOME` is the FlightGear home path. It differs depending on the operating system.
 Under Linux/macOS `$FG_HOME` is `/home/{username}/.fgfs/`.
@@ -24,26 +24,92 @@ Start FlightGear at any airport with your aircraft as a glider, such as ASK 21.
 
 From the top menu, select `Aerotow Everywhere` -> `Call for Piper J3 Cub aircraft`, `Robin DR400` or `Cessna 182` (yes, you can choose from many aircrafts). The AI aircraft will appear to your right and align to the centreline of the runway in front of you. At this time you should hook up to the aircraft, most often by pressing the `Ctrl-o` key (check help of your glider). The AI aircraft will begin to accelerate and take off.
 
-## How does the AI tow aircraft fly?
+## How does the AI tow aircraft fly by default?
 
-The tow plane always takes off in front of your runway and flies along the runway for 5 km, then turns back and flies downwind for 6 km, then turns back again and flies another 6 km. During this flight it is constantly gaining altitude. Then when it has completed the entire set route it simply turns right 90 degrees and flies at a constant altitude.
+The tow plane always takes off in front of your runway and flies along the runway for 5 km, then turns back and flies downwind for 6 km, then turns back again and flies another 6 km. During this flight it is constantly gaining altitude. Then when it has completed the entire set route it turns to unknown direction and flies at a constant altitude.
 
-You can disconnect from the aircraft at any time, most often by pressing the `o` key.
+You can disconnect from the aircraft at any time, most often by pressing the `o` key (check help of your glider).
+
+```
+Default route
+^ - airport with heading direction to north
+1 - 1st waypoint
+2 - 2nd waypoint, etc.
+
+    2 . . 1   7
+    .     .   .
+    .     .   .
+    3     .   .
+    .     .   .
+    .     .   .
+    .     .   .
+    .     .   .
+    .     .   .
+    .     .   .
+    .     ^   6
+    .         .
+    .         .
+    4 . . . . 5
+```
 
 ## Menu of add-on
 
-This add-on add a new item to main menu named "Aerotow Everywhere" with following items:
+This add-on add a new item to main menu named `Aerotow Everywhere` with following items:
 
-1. `Call for Piper J3 Cub aircraft` - load AI tow sceneraio with Piper J3 Cub. Possible altitude to reach ~3,600 ft.
-2. `Call for Robin DR400 aircraft` - load AI tow sceneraio with Robin DR400. This aircraft has better performance and can take you to over 4,500 ft.
-3. `Call for Cessna 182 aircraft` - load AI tow sceneraio with Cessna 182. This aircraft has little bit better performance than Robin.
-4. `Disable tow aircraft` - unload AI tow sceneraio.
-5. `Help` - display help dialog.
-6. `About` - display about dialog with add-on information.
+1. `Aerotow Route` - display the dialog for change aerotow route.
+2. `Call for Piper J3 Cub aircraft` - load AI tow sceneraio with Piper J3 Cub.
+3. `Call for Robin DR400 aircraft` - load AI tow sceneraio with Robin DR400. This aircraft has better performance and can take you higher then Piper Cub.
+4. `Call for Cessna 182 aircraft` - load AI tow sceneraio with Cessna 182. This aircraft has little bit better performance than Robin.
+5. `Disable tow aircraft` - unload AI tow sceneraio.
+6. `Add thermal` - display the dialog for configuring and adding thermal.
+7. `Help` - display help dialog.
+8. `About` - display about dialog with add-on information.
+
+## Aerotow Route
+
+You can change the AI aircraft's default route, for this go to menu `Aerotow Everywhere` -> `Aerotow Route`.
+
+### Aerotow aircraft
+
+On the top of the "Aerotow Route" dialog you have selector to change aircraft type. It's only for calculate performance and display how the altitude will change.
+
+### Route
+
+Next you have initial heading, distance and altitude change. "Initial heading" depend of the runway where you are located. The aircraft will always take-off along the runway, a distance of 100 m, where it will gain 20 ft in altitude above the terrain. These parameters you cannot change unless you change the airport/runway.
+
+Next you can see a table with fields where you can change values. Each row represents a single waypoint of flight plan of AI aircraft. For each waypoint you have following columns:
+
+1. `Heading change (deg)` - information on how the heading of the aircraft should change in relation to the previous one. A value of `0` means no change, so continue with the same heading. And e.g. `-90` means a left turn of 90 degrees, `60` means a right turn of 60 degrees, etc.
+2. `Distance (m)` - distance in meters from the previous waypoint to the present one.
+3. `Alt change (AGL ft)` - information on how much the altitude on this leg of the route will increase (in feet above ground.) This information depend of selected airplane.
+
+If you enter a value less than or equal to `0` for `Distance (m)` field this means that here the route is end and the next rows will not be included to the flight plan.
+
+You have a maximum of 10 waypoints to use, hope that's enough.
+
+On the below of the dialog you can see a total amount of distance (in meters) and total altitude in feet above ground level.
+
+### Buttons
+
+1. `OK` - close the route dialog.
+2. `Default` - set default waypoints (your changes will be lost.)
+
+## Adding thermals
+
+An additional feature of this add-on is the possibility of placing the thermals just in front of the glider. To do this, go to menu `Aerotow Everywhere` -> `Add thermal` where you can configure the following parameters:
+
+1. `Distance` - the distance in metres at which the thermals will be placed in front of the gliders.
+2. `Strength` - thermal strength in feet per second.
+3. `Diameter` - diameter of thermal in feet.
+4. `Height` - height of thermal in feet above mean sea level.
+
+Click `Add thermal` button for add the thermal.
+
+Many thanks to the FG forum user "wlbragg" for proposing and presenting a solution to this feature.
 
 ## Limitations
 
-1. This add-on doesn't check if there are any obstacles in the AI aircraft's path, e.g. terrain, buildings, power lines, etc. Keep this in mind when choosing an airport.
+1. This add-on doesn't check if there are any obstacles in the AI aircraft's path, e.g. terrain, buildings, power lines, etc. Keep this in mind when choosing an airport or planning your route.
 2. Minimum FlightGear version: 2020.4.0 (dev/nightly). Because only nightly version is able to search for flight plans in additional FGData folders added by `--data` command line option.
 
 ## Troubleshotting

addon-config.xml

@@ -27,15 +27,39 @@
             <org.flightgear.addons.Aerotow>
                 <addon-devel>
                     <ai-model type="string">Cub</ai-model>
+                    <add-thermal>
+                        <distance-m type="int">300</distance-m>
+                        <distance-nm type="double">0.16</distance-nm>
+                        <strength-fps type="double">16.0</strength-fps>
+                        <strength-mps type="double">4.88</strength-mps>
+                        <diameter-ft type="int">4000</diameter-ft>
+                        <diameter-m type="int">1219</diameter-m>
+                        <height-msl type="int">9000</height-msl>
+                        <height-msl-m type="int">2742</height-msl-m>
+                    </add-thermal>
+                    <route>
+                        <ai-model>Piper J3 Cub</ai-model>
+                        <init-wpt>
+                            <heading-change type="double">0</heading-change>
+                            <distance-m type="double">0</distance-m>
+                            <alt-change-agl-ft type="double">0</alt-change-agl-ft>
+                        </init-wpt>
+                        <total>
+                            <distance>0</distance>
+                            <alt>0</alt>
+                        </total>
+                    </route>
                     <help-text type="string">=== How to start? ===
 
 From the top menu, select "Aerotow Everywhere" -> "Call for Piper J3 Cub aircraft", "Robin DR400" or "Cessna 182" (yes, you can choose from many aircrafts).
 The tow aircraft will appear to your right and align to the centreline of the runway in front of you. At this time you should hook up to the aircraft, most often by `Ctrl-o` key (check help of your glider). The aircraft will begin to accelerate and take off.
 
-The tow plane always takes off in front of your runway and flies along the runway for 5 km, then turns back and flies downwind for 6 km, then turns back again and flies another 6 km. During this flight it is constantly gaining altitude. Then when it has completed the entire set route it simply turns right 90 degrees and flies at a constant altitude.
+By default, the tow plane always takes off in front of your runway and flies along the runway for 5 km, then turns back and flies downwind for 6 km, then turns back again and flies another 6 km. During this flight it is constantly gaining altitude. Then when it has completed the entire set route it simply turns right 90 degrees and flies at a constant altitude.
 
 You can disconnect from the aircraft at any time, most often by pressing the `o` key.
 
+Before start you can change route of AI aircraft by menu "Aerotow Everywhere" -> "Aerotow Route".
+
 === Troubleshotting ===
 
 1. When I select "Aerotow Everywhere" -> "Call for Piper J3 Cub aircraft", "Robin DR400" or "Cessna 182" from menu, I see "Let's fly!" message but nothing happened. The tow plane does not appear.

addon-main.nas

@@ -21,11 +21,15 @@ var unload = func(addon) {
     #
     # Other resources should be freed by adding the corresponding code here,
     # e.g. myCanvas.del();
+
+    aerotow.uninit();
+    thermal.uninit();
 }
 
 var main = func(addon) {
     print("Aerotow Everywhere add-on initialized from path ", addon.basePath);
 
+    # Create $FG_HOME/Export/Addons/org.flightgear.addons.Aerotow directory
     addon.createStorageDir();
 
     # Create /AI/FlightPlans/ directory in $FG_HOME/Export/Addons/org.flightgear.addons.Aerotow/
@@ -36,17 +40,19 @@ var main = func(addon) {
 
     loadExtraNasalFiles(addon);
 
-    setlistener("/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/ai-model", func(n) {
-        aerotow.startAerotow();
-    });
+    aerotow.init();
+    thermal.init();
 }
 
+#
+# Load extra Nasal files in main add-on directory
+#
 var loadExtraNasalFiles = func (addon) {
-    foreach (var scriptName; ["aerotow", "messages"]) {
+    foreach (var scriptName; ["aerotow", "messages", "thermal"]) {
         var fileName = addon.basePath ~ "/" ~ scriptName ~ ".nas";
 
-        print("Loading Aerotown Add-on module ", fileName);
-
-        io.load_nasal(fileName, scriptName);
+        if (io.load_nasal(fileName, scriptName)) {
+            print("Aerotown Add-on module \"", scriptName, "\" loaded OK");
+        }
     }
 }

addon-menubar-items.xml

@@ -29,6 +29,13 @@
             <label>Aerotow Everywhere</label>
             <enabled type="bool">true</enabled>
 
+            <item>
+                <label>Aerotow Route</label>
+                <binding>
+                    <command>dialog-show</command>
+                    <dialog-name>route-aerotow</dialog-name>
+                </binding>
+            </item>
             <item>
                 <label>Call for Piper J3 Cub aircraft</label>
                 <binding>
@@ -53,10 +60,6 @@
                     <value type="string">c182</value>
                 </binding>
             </item>
-            <item>
-                <label>------------------</label>
-                <enabled>false</enabled>
-            </item>
             <item>
                 <label>Disable tow aircraft</label>
                 <binding>
@@ -65,7 +68,18 @@
                 </binding>
             </item>
             <item>
-                <label>------------------</label>
+                <label>---------------------</label>
+                <enabled>false</enabled>
+            </item>
+            <item>
+                <label>Add thermal</label>
+                <binding>
+                    <command>dialog-show</command>
+                    <dialog-name>add-thermal</dialog-name>
+                </binding>
+            </item>
+            <item>
+                <label>---------------------</label>
                 <enabled>false</enabled>
             </item>
             <item>

addon-metadata.xml

@@ -21,7 +21,7 @@
     <addon>
         <identifier type="string">org.flightgear.addons.Aerotow</identifier>
         <name type="string">Aerotow Everywhere</name>
-        <version type="string">1.0.0</version>
+        <version type="string">1.2.0</version>
 
         <authors>
             <author>
@@ -81,7 +81,7 @@
             </home-page>
 
             <download type="string">
-                https://github.com/PlayeRom/flightgear-addon-aerotow-everywhere
+                https://github.com/PlayeRom/flightgear-addon-aerotow-everywhere/releases/latest
             </download>
 
             <support type="string">
@@ -97,6 +97,7 @@
             <tag type="string">aerotow</tag>
             <tag type="string">AI</tag>
             <tag type="string">scenario</tag>
+            <tag type="string">thermal</tag>
         </tags>
     </addon>
 </PropertyList>

aerotow.nas

@@ -12,14 +12,17 @@
 #
 # Constants
 #
-var addon = addons.getAddon("org.flightgear.addons.Aerotow");
+var ADDON = addons.getAddon("org.flightgear.addons.Aerotow");
+var ADDON_NODE_PATH = ADDON.node.getPath();
 var FILENAME_SCENARIO = "aerotown-addon.xml";
 var FILENAME_FLIGHTPLAN = "aerotown-addon-flightplan.xml";
-var PATH_SCENARIO = addon.storagePath ~ "/" ~ FILENAME_SCENARIO;
-var PATH_FLIGHTPLAN = addon.storagePath ~ "/AI/FlightPlans/" ~ FILENAME_FLIGHTPLAN;
+var PATH_SCENARIO = ADDON.storagePath ~ "/" ~ FILENAME_SCENARIO;
+var PATH_FLIGHTPLAN = ADDON.storagePath ~ "/AI/FlightPlans/" ~ FILENAME_FLIGHTPLAN;
 var SCENARIO_ID = "aerotow_addon";
 var SCENARIO_NAME = "Aerotow Add-on";
 var SCENARIO_DESC = "This scenario starts the towing plane at the airport where the pilot with the glider is located. Use Ctrl-o to hook the plane.";
+var MAX_ROUTE_WAYPOINT = 10;
+var DISTANCE_DETERMINANT = 1000; # meters
 
 #
 # Global variables
@@ -30,6 +33,76 @@ var g_fpFileHandler = nil; # Handler for wrire flight plan to file
 var g_coord = nil; # Coordinates for flight plan
 var g_heading = nil; # AI plane heading
 var g_altitude = nil; # AI plane altitude
+var g_towListeners = [];
+
+#
+# Initialize thermal module
+#
+var init = func () {
+    # Listener for ai-model property triggered when the user select a tow aircraft from add-on menu
+    append(g_towListeners, setlistener(ADDON_NODE_PATH ~ "/addon-devel/ai-model", func () {
+        startAerotow();
+    }));
+
+    append(g_towListeners, setlistener("/sim/presets/longitude-deg", func () {
+        # User change airport/runway
+        initialFlightPlan();
+    }));
+
+    initialFlightPlan();
+
+    # Set listener for aerotow combo box value in route dialog for recalculate altitude change
+    append(g_towListeners, setlistener(ADDON_NODE_PATH ~ "/addon-devel/route/ai-model", func () {
+        calculateAltChangeAndTotals();
+    }));
+
+    # Set listeners for distance fields for calculate altitude change
+    for (var i = 0; i < MAX_ROUTE_WAYPOINT; i = i + 1) {
+        append(g_towListeners, setlistener(ADDON_NODE_PATH ~ "/addon-devel/route/wpt[" ~ i ~ "]/distance-m", func (node) {
+            calculateAltChangeAndTotals();
+        }));
+    }
+}
+
+#
+# Calculate total distance and altitude and put in to property tree
+#
+var calculateAltChangeAndTotals = func () {
+    var totalDistance = 0.0;
+    var totalAlt = 0.0;
+    var isEnd = 0;
+
+    var isRouteMode = 1;
+    var perf = getAircraftPerformance(isRouteMode);
+
+    for (var i = 0; i < MAX_ROUTE_WAYPOINT; i = i + 1) {
+        var distance = getprop(ADDON_NODE_PATH ~ "/addon-devel/route/wpt[" ~ i ~ "]/distance-m");
+        var altChange = getAltChange(perf.vs, distance);
+        setprop(ADDON_NODE_PATH ~ "/addon-devel/route/wpt[" ~ i ~ "]/alt-change-agl-ft", altChange);
+
+        if (!isEnd) {
+            if (distance > 0.0) {
+                totalDistance = totalDistance + distance;
+                totalAlt = totalAlt + altChange;
+            }
+            else {
+                isEnd = 1;
+            }
+        }
+    }
+
+    setprop(ADDON_NODE_PATH ~ "/addon-devel/route/total/distance", totalDistance);
+    setprop(ADDON_NODE_PATH ~ "/addon-devel/route/total/alt", totalAlt);
+}
+
+#
+# Uninitialize thermal module
+#
+var uninit = func () {
+    foreach (var listener; g_towListeners) {
+        removelistener(listener);
+    }
+}
 
 #
 # Main function to prepare AI scenario and run it.
@@ -149,10 +222,126 @@ var isScenarioAdded = func () {
 }
 
 #
-# Return name of selected aircraft. Possible values: "Cub", "DR400", "c182".
+# Return name of selected aircraft. Possible values depend of isRouteMode: "Cub", "DR400", "c182".
 #
-var getSelectedAircraft = func () {
-    return getprop("/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/ai-model") or "Cub";
+# isRouteMode - use 1 to get the plane for the "Aerotow Route" dialog, use 0 (default) for call the airplane for towing
+#
+var getSelectedAircraft = func (isRouteMode = 0) {
+    if (isRouteMode) {
+        return getprop(ADDON_NODE_PATH ~ "/addon-devel/route/ai-model") or "Piper J3 Cub";
+    }
+
+    return getprop(ADDON_NODE_PATH ~ "/addon-devel/ai-model") or "Cub";
+}
+
+#
+# Get airport an runway hash where the glider is located.
+#
+# Return hash with "airport" and "runway", otherwise nil.
+#
+var getAirportAndRunway = func () {
+    var icao = getprop("/sim/airport/closest-airport-id");
+    if (icao == nil) {
+        messages.displayError("Airport code cannot be obtained.");
+        return nil;
+    }
+
+    var runwayName = getprop("/sim/atc/runway");
+    if (runwayName == nil) {
+        messages.displayError("Runway name cannot be obtained.");
+        return nil;
+    }
+
+    var airport = airportinfo(icao);
+
+    if (!contains(airport.runways, runwayName)) {
+        messages.displayError("The " ~ icao ~" airport does not have runway " ~ runwayName);
+        return nil;
+    }
+
+    var runway = airport.runways[runwayName];
+
+    var minRwyLength = getMinRunwayLength();
+    if (runway.length < minRwyLength) {
+        messages.displayError(
+            "This runway is too short. Please choose a longer one than " ~ minRwyLength ~ " m "
+            ~ "(" ~ math.round(minRwyLength * globals.M2FT) ~ " ft)."
+        );
+        return nil;
+    }
+
+    return {
+        "airport": airport,
+        "runway": runway,
+    };
+}
+
+#
+# Initialize flight plan and set it to property tree
+#
+# Return 1 on successful, otherwise 0.
+#
+var initialFlightPlan = func () {
+    var location = getAirportAndRunway();
+    if (location == nil) {
+        return 0;
+    }
+
+    var perf = getAircraftPerformance();
+
+    initAircraftVariable(location.airport, location.runway, 0);
+
+    # inittial readonly waypoint
+    setprop(ADDON_NODE_PATH ~ "/addon-devel/route/init-wpt/heading-change", g_heading);
+    setprop(ADDON_NODE_PATH ~ "/addon-devel/route/init-wpt/distance-m", 100);
+    setprop(ADDON_NODE_PATH ~ "/addon-devel/route/init-wpt/alt-change-agl-ft", perf.vs / 10);
+
+    # in air
+    var wptData = [
+        {"hdgChange": 0,   "dist": 5000, "altChange": perf.vs * 5},
+        {"hdgChange": -90, "dist": 1000, "altChange": perf.vs},
+        {"hdgChange": -90, "dist": 1000, "altChange": perf.vs},
+        {"hdgChange": 0,   "dist": 5000, "altChange": perf.vs * 5},
+        {"hdgChange": -90, "dist": 1500, "altChange": perf.vs * 1.5},
+        {"hdgChange": -90, "dist": 1000, "altChange": perf.vs},
+        {"hdgChange": 0,   "dist": 5000, "altChange": perf.vs * 5},
+        {"hdgChange": 0,   "dist": 0,    "altChange": 0},
+        {"hdgChange": 0,   "dist": 0,    "altChange": 0},
+        {"hdgChange": 0,   "dist": 0,    "altChange": 0},
+    ];
+
+    # Default route
+    # ^ - airport with heading direction to north
+    # 1 - 1st waypoint
+    # 2 - 2nd waypoint, etc.
+    #
+    #     2 . . 1   7
+    #     .     .   .
+    #     .     .   .
+    #     3     .   .
+    #     .     .   .
+    #     .     .   .
+    #     .     .   .
+    #     .     .   .
+    #     .     .   .
+    #     .     .   .
+    #     .     ^   6
+    #     .         .
+    #     .         .
+    #     4 . . . . 5
+
+    var index = 0;
+    foreach (var wpt; wptData) {
+        setprop(ADDON_NODE_PATH ~ "/addon-devel/route/wpt[" ~ index ~ "]/heading-change",    wpt.hdgChange);
+        setprop(ADDON_NODE_PATH ~ "/addon-devel/route/wpt[" ~ index ~ "]/distance-m",        wpt.dist);
+        setprop(ADDON_NODE_PATH ~ "/addon-devel/route/wpt[" ~ index ~ "]/alt-change-agl-ft", wpt.altChange);
+
+        index = index + 1;
+    }
+
+    calculateAltChangeAndTotals();
+
+    return 1;
 }
 
 #
@@ -164,27 +353,8 @@ var getSelectedAircraft = func () {
 var generateFlightPlanXml = func () {
     g_wptCount = 0;
 
-    var icao = getprop("/sim/airport/closest-airport-id");
-    if (icao == nil) {
-        messages.displayError("Airport code cannot be obtained.");
-        return 0;
-    }
-
-    var runwayName = getprop("/sim/atc/runway");
-    if (runwayName == nil) {
-        messages.displayError("Runway name cannot be obtained.");
-        return 0;
-    }
-
-    var airport = airportinfo(icao);
-    var runway = airport.runways[runwayName];
-
-    var minRwyLength = getMinRunwayLength();
-    if (runway.length < minRwyLength) {
-        messages.displayError(
-            "This runway is too short. Please choose a longer one than " ~ minRwyLength ~ " m "
-            ~ "(" ~ math.round(minRwyLength * M2FT) ~ " ft)."
-        );
+    var location = getAirportAndRunway();
+    if (location == nil) {
         return 0;
     }
 
@@ -199,16 +369,16 @@ var generateFlightPlanXml = func () {
 
     var perf = getAircraftPerformance();
 
-    initAircraftVariable(airport, runway, 1);
+    initAircraftVariable(location.airport, location.runway, 1);
 
     # Start at 2 o'clock from the glider...
     # Inital ktas must be >= 1.0
     addWptGround({"hdgChange": 60, "dist": 25}, {"altChange": 0, "ktas": 5});
 
     # Reset coord and heading
-    initAircraftVariable(airport, runway, 0);
+    initAircraftVariable(location.airport, location.runway, 0);
 
-    var gliderOffsetM = getGliderOffsetFromRunwayThreshold(runway);
+    var gliderOffsetM = getGliderOffsetFromRunwayThreshold(location.runway);
 
     # ... and line up with the runway
     addWptGround({"hdgChange": 0, "dist": 30 + gliderOffsetM}, {"altChange": 0, "ktas": 2.5});
@@ -229,32 +399,27 @@ var generateFlightPlanXml = func () {
     addWptGround({"hdgChange": 0, "dist": 10 * perf.rolling}, {"altChange": 0, "ktas": perf.speed});
 
     # Takeof
-    addWptAir({"hdgChange": 0,   "dist": 100 * perf.rolling}, {"altChange": 3, "ktas": perf.speed * 1.05});
+    addWptAir({"hdgChange": 0,   "dist": 100 * perf.rolling}, {"elevationPlus": 3, "ktas": perf.speed * 1.05});
     addWptAir({"hdgChange": 0,   "dist": 100}, {"altChange": perf.vs / 10, "ktas": perf.speed * 1.025});
 
-    # Circle around airport
-    addWptAir({"hdgChange": 0,   "dist": 500},  {"altChange": perf.vs / 1.5, "ktas": perf.speed});
-    addWptAir({"hdgChange": 0,   "dist": 500},  {"altChange": perf.vs / 1.7, "ktas": perf.speed});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.025});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.05});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.075});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.1});
-    addWptAir({"hdgChange": -90, "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.125}); # crosswind leg
-    addWptAir({"hdgChange": -90, "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.15}); # downwind leg
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.175});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.2});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.225});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.25});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.275});
-    addWptAir({"hdgChange": -90, "dist": 500},  {"altChange": perf.vs / 2,   "ktas": perf.speed * 1.25}); # base leg
-    addWptAir({"hdgChange": 0,   "dist": 500},  {"altChange": perf.vs / 2,   "ktas": perf.speed * 1.275});
-    addWptAir({"hdgChange": 0,   "dist": 500},  {"altChange": perf.vs / 2,   "ktas": perf.speed * 1.3});
-    addWptAir({"hdgChange": -90, "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.3}); # final leg
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.325});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.35});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.375});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.4});
-    addWptAir({"hdgChange": 0,   "dist": 1000}, {"altChange": perf.vs,       "ktas": perf.speed * 1.425});
+    var speedInc = 1.0;
+    foreach (var wptNode; props.globals.getNode(ADDON_NODE_PATH ~ "/addon-devel/route").getChildren("wpt")) {
+        var dist = wptNode.getChild("distance-m").getValue();
+        if (dist <= 0.0) {
+            break;
+        }
+
+        var hdgChange = wptNode.getChild("heading-change").getValue();
+        var altChange = getAltChange(perf.vs, dist);
+
+        speedInc = speedInc + ((dist / DISTANCE_DETERMINANT) * 0.025);
+        var ktas = perf.speed * speedInc;
+        if (ktas > perf.speedLimit) {
+            ktas = perf.speedLimit;
+        }
+
+        addWptAir({"hdgChange": hdgChange, "dist": dist}, {"altChange": altChange, "ktas": ktas});
+    }
 
     addWptEnd();
 
@@ -271,7 +436,7 @@ var generateFlightPlanXml = func () {
 #
 # Return hash with "vs", "speed", "rolling".
 #
-var getAircraftPerformance = func () {
+var getAircraftPerformance = func (isRouteMode = 0) {
     # Cub
     # Cruise Speed 61 kt
     # Max Speed 106 kt
@@ -290,55 +455,69 @@ var getAircraftPerformance = func () {
     # Stall speed 50 kt
     # Best climb: 924 ft/min
 
-    var aiModel = getSelectedAircraft();
-    if (aiModel == "DR400") {
+    var aiModel = getSelectedAircraft(isRouteMode);
+    if (aiModel == "DR400" or aiModel == "Robin DR400") {
         return {
-            "vs":      285, # ft per 1000 m
-            "speed":   70,
-            "rolling": 2,
+            "vs":         285, # ft per DISTANCE_DETERMINANT m
+            "speed":      70,
+            "speedLimit": 75,
+            "rolling":    2,
         };
     }
-    
-    if (aiModel == "c182") {
+
+    if (aiModel == "c182" or aiModel == "Cessna 182") {
         return {
-            "vs":      295, # ft per 1000 m
-            "speed":   75,
-            "rolling": 2.2,
+            "vs":         295, # ft per DISTANCE_DETERMINANT m
+            "speed":      75,
+            "speedLimit": 80,
+            "rolling":    2.2,
         };
     }
 
     # Cub
     return {
-        "vs":      200, # ft per 1000 m
-        "speed":   55,
-        "rolling": 1,
+        "vs":         200, # ft per DISTANCE_DETERMINANT m
+        "speed":      55,
+        "speedLimit": 60,
+        "rolling":    1,
     };
 }
 
+#
+# Return how much the altitide increases for a given vertical speed and distance
+#
+# vs - vertical speed for DISTANCE_DETERMINANT m
+# distance - distance in meters
+#
+var getAltChange = func (vs, distance) {
+    return vs * (distance / DISTANCE_DETERMINANT);
+}
+
 #
 # Initialize AI aircraft variable
 #
-# isGliderPos - Pass 1 for set AI aircraft's coordinates as glider position, 0 set coordinates as runway threshold.
 # airport - Object from airportinfo().
 # runway - Object of runway from which the glider start.
+# isGliderPos - Pass 1 for set AI aircraft's coordinates as glider position, 0 set coordinates as runway threshold.
 #
 var initAircraftVariable = func (airport, runway, isGliderPos = 1) {
     var gliderCoord = geo.aircraft_position();
 
     # Set coordinates as glider position or runway threshold
-    g_coord = isGliderPos 
+    g_coord = isGliderPos
         ? gliderCoord
         : geo.Coord.new().set_latlon(runway.lat, runway.lon);
 
     # Set airplane heading as runway heading
     g_heading = runway.heading;
 
-    # Set airplane altitude as airport elevation
-    g_altitude = gliderCoord.alt() * M2FT;
+    # Set AI airplane altitude as glider altitude (assumed it's on the ground).
+    # It is more accurate than airport.elevation.
+    g_altitude = gliderCoord.alt() * globals.M2FT;
 }
 
 #
-# Get distance from glider to runway threshold
+# Get distance from glider to runway threshold e.g. in case that the user taxi from the runway threshold
 #
 # runway - Object of runway from which the glider start
 # Return the distance in metres, of the glider's displacement from the runway threshold.
@@ -358,7 +537,7 @@ var getMinRunwayLength = func () {
     if (aiModel == "DR400") {
         return 470;
     }
-    
+
     if (aiModel == "c182") {
         return 508;
     }
@@ -397,25 +576,28 @@ var addWptAir = func (coordOffset, performance) {
 # sec - Number of seconds for wait
 #
 var addWptWait = func (sec) {
-    wrireWpt("WAIT", {"hdgChange": nil, "dist": nil}, {"altChange": nil, "ktas": nil}, nil, sec);
+    wrireWpt("WAIT", {}, {}, nil, sec);
 }
 
 #
 # Add "END" waypoint
 #
 var addWptEnd = func () {
-    wrireWpt("END", {"hdgChange": nil, "dist": nil}, {"altChange": nil, "ktas": nil});
+    wrireWpt("END", {}, {});
 }
 
 #
-# Write waipoint to flight plan file
+# Write waypoint to flight plan file
 #
 # name - The name of waypoint
 # coordOffset.hdgChange - How the aircraft's heading supposed to change?
 # coordOffset.dist - Distance in meters to calculate next waypoint coordinates
 # performance.altChange - How the aircraft's altitude is supposed to change?
+# performance.elevationPlus - Set aircraft altitude as current terrain elevation + given value in feets.
+#                             It's best to use for the first point in the air to avoid the plane collapsing into
+#                             the ground in a bumpy airport
 # performance.ktas - True air speed of AI plane at the waypoint
-# groundAir - Allowe value: "ground or "air". The "ground" means that AI plane is on the ground, "air" - in air
+# groundAir - Allowed value: "ground or "air". The "ground" means that AI plane is on the ground, "air" - in air
 # sec - Number of seconds for "WAIT" waypoint
 #
 var wrireWpt = func (
@@ -425,8 +607,8 @@ var wrireWpt = func (
     groundAir = nil,
     sec = nil
 ) {
-    var localCoord = nil;
-    if (coordOffset.hdgChange != nil and coordOffset.dist != nil) {
+    var coord = nil;
+    if (contains(coordOffset, "hdgChange") and contains(coordOffset, "dist")) {
         g_heading = g_heading + coordOffset.hdgChange;
         if (g_heading < 0) {
             g_heading = 360 + g_heading;
@@ -437,24 +619,29 @@ var wrireWpt = func (
         }
 
         g_coord.apply_course_distance(g_heading, coordOffset.dist);
-        localCoord = g_coord;
+        coord = g_coord;
     }
 
-    var localAlt = nil;
-    if (performance.altChange != nil) {
-        g_altitude = g_altitude + performance.altChange;
-        localAlt = g_altitude;
+    var alt = nil;
+    if (coord != nil and contains(performance, "elevationPlus")) {
+        var elevation = geo.elevation(coord.lat(), coord.lon());
+        if (elevation == nil) {
+            g_altitude = g_altitude + performance.elevationPlus;
+        }
+        else {
+            g_altitude = elevation * globals.M2FT + performance.elevationPlus;
+        }
+        alt = g_altitude;
     }
+    else if (contains(performance, "altChange")) {
+        g_altitude = g_altitude + performance.altChange;
+        alt = g_altitude;
+    }
+
+    var ktas = contains(performance, "ktas") ? performance.ktas : nil;
 
     name = name == nil ? g_wptCount : name;
-    var data = getWptString(
-        name,
-        localCoord,
-        localAlt,
-        performance.ktas,
-        groundAir,
-        sec
-    );
+    var data = getWptString(name, coord, alt, ktas, groundAir, sec);
 
     io.write(g_fpFileHandler, data);
 

gui/dialogs/about-aerotow.xml

@@ -45,7 +45,7 @@
     <hrule/>
 
     <text>
-        <label>Aerotow Everywhere version 1.0.0 - 13th August 2022</label>
+        <label>Aerotow Everywhere version 1.2.0 - 17th August 2022</label>
     </text>
 
     <text>

gui/dialogs/add-thermal.xml

@@ -0,0 +1,214 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+#
+# Aerotow Everywhere - Add-on for FlightGear
+#
+# Written and developer by Roman Ludwicki (PlayeRom, SP-ROM)
+#
+# Copyright (C) 2022 Roman Ludwicki
+#
+# Aerotow Everywhere is an Open Source project and it is licensed
+# under the GNU Public License v3 (GPLv3)
+#
+-->
+
+<!-- This file requires FlightGear version 2018.2 or newer -->
+
+<PropertyList>
+    <name>add-thermal</name>
+    <resizable>false</resizable>
+    <layout>vbox</layout>
+    <default-padding>3</default-padding>
+
+    <group>
+        <layout>hbox</layout>
+
+        <empty>
+            <stretch>1</stretch>
+        </empty>
+
+        <text>
+            <label>Add Thermal</label>
+        </text>
+
+        <empty>
+            <stretch>1</stretch>
+        </empty>
+
+        <button>
+            <pref-width>16</pref-width>
+            <pref-height>16</pref-height>
+            <legend></legend>
+            <keynum>27</keynum>
+            <border>2</border>
+            <binding>
+                <command>dialog-close</command>
+            </binding>
+        </button>
+    </group>
+
+    <hrule/>
+
+    <text>
+        <halign>left</halign>
+        <label>  This option allows the thermal to be placed at the distance  </label>
+    </text>
+    <text>
+        <halign>left</halign>
+        <label>  designated below in front of the glider along with other parameters.  </label>
+    </text>
+
+    <hrule/>
+
+    <group>
+        <layout>table</layout>
+
+        <text>
+            <row>0</row>
+            <col>0</col>
+            <halign>right</halign>
+            <label>  Distance in front of the glider</label>
+        </text>
+        <input>
+            <row>0</row>
+            <col>1</col>
+            <label>m</label>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/add-thermal/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>0</row>
+            <col>2</col>
+            <label>Dummy label</label>
+            <halign>left</halign>
+            <format>(%.2f nm)</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/add-thermal/distance-nm</property>
+        </text>
+
+        <text>
+            <row>1</row>
+            <col>0</col>
+            <halign>right</halign>
+            <label>Strength</label>
+        </text>
+        <input>
+            <row>1</row>
+            <col>1</col>
+            <label>ft/s</label>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/add-thermal/strength-fps</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>1</row>
+            <col>2</col>
+            <label>Dummy label</label>
+            <halign>left</halign>
+            <format>  (%.2f m/s)</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/add-thermal/strength-mps</property>
+        </text>
+
+        <text>
+            <row>2</row>
+            <col>0</col>
+            <halign>right</halign>
+            <label>Diameter</label>
+        </text>
+        <input>
+            <row>2</row>
+            <col>1</col>
+            <label>ft</label>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/add-thermal/diameter-ft</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>2</row>
+            <col>2</col>
+            <label>Dummy label</label>
+            <halign>left</halign>
+            <format>(%.f m)</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/add-thermal/diameter-m</property>
+        </text>
+
+        <text>
+            <row>3</row>
+            <col>0</col>
+            <halign>right</halign>
+            <label>Height MSL</label>
+        </text>
+        <input>
+            <row>3</row>
+            <col>1</col>
+            <label>ft</label>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/add-thermal/height-msl</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>3</row>
+            <col>2</col>
+            <label>Dummy label</label>
+            <halign>left</halign>
+            <format>(%.f m)</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/add-thermal/height-msl-m</property>
+        </text>
+    </group>
+
+    <hrule/>
+
+    <group>
+        <empty>
+            <stretch>true</stretch>
+        </empty>
+
+        <layout>hbox</layout>
+
+        <button>
+            <legend>Add thermal</legend>
+            <equal>true</equal>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+            <binding>
+                <command>nasal</command>
+                <script><![CDATA[thermal.add();]]></script>
+            </binding>
+            <binding>
+                <command>dialog-close</command>
+            </binding>
+        </button>
+
+        <button>
+            <legend>Cancel</legend>
+            <equal>true</equal>
+            <default>true</default>
+            <key>Esc</key>
+            <binding>
+                <command>dialog-close</command>
+            </binding>
+        </button>
+
+        <empty>
+            <stretch>true</stretch>
+        </empty>
+    </group>
+
+</PropertyList>

gui/dialogs/route-aerotow.xml

@@ -0,0 +1,528 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+#
+# Aerotow Everywhere - Add-on for FlightGear
+#
+# Written and developer by Roman Ludwicki (PlayeRom, SP-ROM)
+#
+# Copyright (C) 2022 Roman Ludwicki
+#
+# Aerotow Everywhere is an Open Source project and it is licensed
+# under the GNU Public License v3 (GPLv3)
+#
+-->
+
+<!-- This file requires FlightGear version 2018.2 or newer -->
+
+<PropertyList>
+    <name>route-aerotow</name>
+    <resizable>false</resizable>
+    <layout>vbox</layout>
+    <default-padding>3</default-padding>
+
+    <group>
+        <layout>hbox</layout>
+
+        <empty>
+            <stretch>1</stretch>
+        </empty>
+
+        <text>
+            <label>Aerotow Route</label>
+        </text>
+
+        <empty>
+            <stretch>1</stretch>
+        </empty>
+
+        <button>
+            <pref-width>16</pref-width>
+            <pref-height>16</pref-height>
+            <legend></legend>
+            <keynum>27</keynum>
+            <border>2</border>
+            <binding>
+                <command>dialog-close</command>
+            </binding>
+        </button>
+    </group>
+
+    <hrule/>
+
+    <text>
+        <halign>left</halign>
+        <label>  Here you can change the default flight path of the tow plane.  </label>
+    </text>
+    <text>
+        <halign>left</halign>
+        <label>  You cannot change the initial point, the AI plane always   </label>
+    </text>
+    <text>
+        <halign>left</halign>
+        <label>  takes-off in front of the runway you are on.  </label>
+    </text>
+    <text>
+        <halign>left</halign>
+        <label>  Set 0 for `Distance` for completing the flight plan.  </label>
+    </text>
+
+    <hrule/>
+
+    <group>
+        <layout>table</layout>
+
+        <text>
+            <row>0</row>
+            <col>0</col>
+            <halign>right</halign>
+            <label>Aerotow</label>
+        </text>
+
+        <combo>
+            <row>0</row>
+            <col>1</col>
+            <halign>left</halign>
+            <pref-width>150</pref-width>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/ai-model</property>
+            <value>Piper J3 Cub</value>
+            <value>Robin DR400</value>
+            <value>Cessna 182</value>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </combo>
+    </group>
+
+    <hrule/>
+
+    <group>
+        <layout>table</layout>
+
+        <text>
+            <row>0</row>
+            <col>0</col>
+            <halign>left</halign>
+            <label>Initial Heading (deg)</label>
+        </text>
+        <text>
+            <row>0</row>
+            <col>1</col>
+            <halign>left</halign>
+            <label>Distance (m)</label>
+        </text>
+        <text>
+            <row>0</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label>Alt change (AGL ft)</label>
+        </text>
+
+        <text>
+            <row>1</row>
+            <col>0</col>
+            <halign>left</halign>
+            <label></label>
+            <format>%.2f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/init-wpt/heading-change</property>
+        </text>
+        <text>
+            <row>1</row>
+            <col>1</col>
+            <halign>left</halign>
+            <label></label>
+            <format>%.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/init-wpt/distance-m</property>
+        </text>
+        <text>
+            <row>1</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/init-wpt/alt-change-agl-ft</property>
+        </text>
+
+        <text>
+            <row>2</row>
+            <col>0</col>
+            <halign>left</halign>
+            <label>Heading change (deg)</label>
+        </text>
+        <text>
+            <row>2</row>
+            <col>1</col>
+            <halign>left</halign>
+            <label>Distance (m)</label>
+        </text>
+        <text>
+            <row>2</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label>Alt change (AGL ft)</label>
+        </text>
+
+        <input>
+            <row>3</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[0]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>3</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[0]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>3</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[0]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>4</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[1]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>4</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[1]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>4</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[1]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>5</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[2]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>5</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[2]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>5</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[2]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>6</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[3]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>6</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[3]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>6</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[3]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>7</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[4]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>7</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[4]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>7</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[4]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>8</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[5]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>8</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[5]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>8</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[5]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>9</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[6]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>9</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[6]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>9</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[6]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>10</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[7]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>10</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[7]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>10</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[7]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>11</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[8]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>11</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[8]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>11</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[8]/alt-change-agl-ft</property>
+        </text>
+
+        <input>
+            <row>12</row>
+            <col>0</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[9]/heading-change</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <input>
+            <row>12</row>
+            <col>1</col>
+            <halign>left</halign>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[9]/distance-m</property>
+            <live>true</live>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+        </input>
+        <text>
+            <row>12</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/wpt[9]/alt-change-agl-ft</property>
+        </text>
+
+        <text>
+            <row>13</row>
+            <col>0</col>
+            <halign>right</halign>
+            <label>Total:</label>
+        </text>
+        <text>
+            <row>13</row>
+            <col>1</col>
+            <halign>left</halign>
+            <label></label>
+            <format>%.f m</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/total/distance</property>
+        </text>
+        <text>
+            <row>13</row>
+            <col>2</col>
+            <halign>left</halign>
+            <label></label>
+            <format>     %.f ft</format>
+            <live>true</live>
+            <property>/addons/by-id/org.flightgear.addons.Aerotow/addon-devel/route/total/alt</property>
+        </text>
+    </group>
+
+    <hrule/>
+
+    <group>
+        <empty>
+            <stretch>true</stretch>
+        </empty>
+
+        <layout>hbox</layout>
+
+        <button>
+            <legend>OK</legend>
+            <equal>true</equal>
+            <binding>
+                <command>dialog-apply</command>
+            </binding>
+            <binding>
+                <command>dialog-close</command>
+            </binding>
+        </button>
+
+        <button>
+            <legend>Default</legend>
+            <equal>true</equal>
+            <binding>
+                <command>nasal</command>
+                <script><![CDATA[aerotow.initialFlightPlan();]]></script>
+            </binding>
+        </button>
+
+        <empty>
+            <stretch>true</stretch>
+        </empty>
+    </group>
+
+</PropertyList>

messages.nas

@@ -34,20 +34,20 @@ var displayError = func (message) {
 # type - The type of message. It can take values as "ok" or "error".
 #
 var display = func (message, type) {
+    # Print to console
+    print("Aerotow Everywhere add-on: " ~ message);
+
     # Read the message by speech synthesizer
     props.globals.getNode("/sim/sound/voices/ai-plane").setValue(message);
 
-    # Display message on the screan
+    # Display message on the screen
     var durationInSec = int(size(message) / 12) + 3;
     var window = screen.window.new(nil, -40, 10, durationInSec);
     window.bg = [0.0, 0.0, 0.0, 0.40];
 
-    if (type == "error") {
-        window.fg = [1.0, 0.0, 0.0, 1];
-    }
-    else {
-        window.fg = [0.0, 1.0, 0.0, 1];
-    }
+    window.fg = type == "error"
+        ? [1.0, 0.0, 0.0, 1]
+        : [0.0, 1.0, 0.0, 1];
 
     window.align = "center";
     window.write(message);

thermal.nas

@@ -0,0 +1,90 @@
+#
+# Aerotow Everywhere - Add-on for FlightGear
+#
+# Written and developer by Roman Ludwicki (PlayeRom, SP-ROM)
+#
+# Copyright (C) 2022 Roman Ludwicki
+#
+# Aerotow Everywhere is an Open Source project and it is licensed
+# under the GNU Public License v3 (GPLv3)
+#
+
+#
+# Constants
+#
+var ADDON = addons.getAddon("org.flightgear.addons.Aerotow");
+var ADDON_NODE_PATH = ADDON.node.getPath();
+
+#
+# Variables
+#
+var g_thermalListeners = [];
+
+#
+# Initialize thermal module
+#
+var init = func () {
+    # Listener for calculate distance from meters to nautical miles.
+    append(g_thermalListeners, setlistener(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/distance-m", func (node) {
+        setprop(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/distance-nm", node.getValue() * globals.M2NM);
+    }));
+
+    # Listener for calculate strength from ft/s to m/s.
+    append(g_thermalListeners, setlistener(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/strength-fps", func (node) {
+        setprop(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/strength-mps", node.getValue() * globals.FPS2KT * globals.KT2MPS);
+    }));
+
+    # Listener for calculate diameter from ft to m.
+    append(g_thermalListeners, setlistener(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/diameter-ft", func (node) {
+        setprop(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/diameter-m", node.getValue() * globals.FT2M);
+    }));
+
+    # Listener for calculate height from ft to m.
+    append(g_thermalListeners, setlistener(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/height-msl", func (node) {
+        setprop(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/height-msl-m", node.getValue() * globals.FT2M);
+    }));
+}
+
+#
+# Uninitialize thermal module
+#
+var uninit = func () {
+    foreach (var listener; g_thermalListeners) {
+        removelistener(listener);
+    }
+}
+
+#
+# Add thermal 300 m before glider position.
+#
+# Return 1 on successful, otherwise 0.
+#
+var add = func () {
+    var heading = getprop("/orientation/heading-deg") or 0;
+    var distance = getprop(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/distance-m") or 300;
+
+    var position = geo.aircraft_position();
+    position.apply_course_distance(heading, distance);
+
+    # Get random layer from 1 to 4
+    var layer = int(rand() * 4) + 1;
+
+    var args = props.Node.new({
+        "type":         "thermal",
+        "model":        "Models/Weather/altocumulus_layer" ~ layer ~ ".xml",
+        "latitude":     position.lat(),
+        "longitude":    position.lon(),
+        "strength-fps": getprop(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/strength-fps") or 16.0,
+        "diameter-ft":  getprop(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/diameter-ft") or 4000,
+        "height-msl":   getprop(ADDON_NODE_PATH ~ "/addon-devel/add-thermal/height-msl") or 9000,
+        "search-order": "DATA_ONLY"
+    });
+
+    if (fgcommand("add-aiobject", args)) {
+        messages.displayOk("The thermal has been added");
+        return 1;
+    }
+
+    messages.displayError("Adding thermal failed");
+    return 0;
+}