TerraGear GUI: Difference between revisions

Jump to navigation Jump to search
Update to latest version
(Update)
(Update to latest version)
Line 1: Line 1:
{{Infobox Software
{{Infobox Software
| title                = TerraGear GUI
| title                = TerraGear GUI
| image                = TerraGearGUI.png
| image                = TerraGear GUI download San Francisco.png
| alt                  = The construction page
| alt                  = The download page with the San Francisco bay area selected.
| developedby          = Gijs de Rooy (original by Alex Park)
| developedby          = Gijs de Rooy (original by Alex Park)
| initialrelease        = March 24, 2009 (original)<br>March 27, 2010
| initialrelease        = March 24, 2009 (original)<br>March 27, 2010
Line 15: Line 15:
You can either build the GUI [http://gitorious.org/fgscenery/terrageargui/ from source], or download a pre-compiled build:
You can either build the GUI [http://gitorious.org/fgscenery/terrageargui/ from source], or download a pre-compiled build:
* [http://liveries.flightgear.org/terrageargui/ Windows builds]
* [http://liveries.flightgear.org/terrageargui/ Windows builds]
Please note that you need to download/compile [[TerraGear]] as well.
Please note that you need to download/compile a recent version of [[TerraGear]] as well.


==== For GNU/Linux users ====
==== For GNU/Linux users ====
Line 34: Line 34:
# Set your FlightGear's root ([[$FG_ROOT]]). This is used to retrieve the list of available terrain materials.
# Set your FlightGear's root ([[$FG_ROOT]]). This is used to retrieve the list of available terrain materials.


==== Downloading data ====
=== Download ===
Specify boundaries in the boxes on the left and select a source to download shapefiles for that area. Note that OpenStreetMap only includes line date (roads, rivers), so you'll need some polygon data for the actual terrain. Both [[World Custom Scenery Project|Custom Scenery]] and [[CORINE]] (only Europe) provide that. The GUI downloads and unpacks the package to your <tt>{project's directory}/data/</tt>.
Specify boundaries in the boxes on the left, or select an area on the map. Next select a source to download shapefiles for that area. Note that OpenStreetMap only includes line date (roads, rivers), so you'll need some polygon data for the actual terrain. Both [[World Custom Scenery Project|Custom Scenery]] and [[CORINE]] (only Europe) provide that. The GUI downloads and unpacks the package to your <tt>{project's directory}/data/</tt>.


Alternatively you can download shapefiles from [http://mapserver.flightgear.org/download.psp the mapserver by hand]. Unpack the downloaded file(s) to your <tt>{project's directory}/data/</tt>.
Alternatively you can download shapefiles from [http://mapserver.flightgear.org/download.psp the mapserver by hand]. Unpack the downloaded file(s) to your <tt>{project's directory}/data/</tt>.


===== Elevation =====
==== Elevation data ====
[[File:HGT tiles example.png|thumb|An example of HGT file tiles.]]
Elevation files are optional, but of course required to generate scenery with elevation offsets (even flat countries like the Netherlands need elevation data, since no country is completely at sealevel. Simply select a data source and then click the button to download the HGT files that span your specified area. The original source is usgs.gov, but a cleaned variant of the same data is available from fgx.ch (see [http://downloads.fgx.ch/geodata/data/srtm/README.txt the readme] for more information). The data will be saved in in <tt>{project's directory}/data/SRTM-3</tt>.  
Elevation files are optional, but of course required to generate scenery with elevation offsets (even flat countries like the Netherlands need elevation data, since no country is completely at sealevel. Simply select a data source and then click the button to download the HGT files that span your specified area. The original source is usgs.gov, but a cleaned variant of the same data is available from fgx.ch (see [http://downloads.fgx.ch/geodata/data/srtm/README.txt the readme] for more information). The data will be saved in in <tt>{project's directory}/data/SRTM-3</tt>.  


===== By hand =====
[[File:HGT tiles example.png|thumb|An example of HGT file tiles.]]
Downloading tiles by hand is somewhat tricky. If your scenery has a boundary of:
Downloading tiles by hand is somewhat tricky. If your scenery has a boundary of:
{| class="wikitable"
{| class="wikitable"
Line 65: Line 66:
# Click on the bottom left boundary wanted and report the displayed value in TerraGear GUI. (i.e: if Google Earth value is "W9_N42", report Minimum Latitude value "42" and Minimum Longitude value "-9")
# Click on the bottom left boundary wanted and report the displayed value in TerraGear GUI. (i.e: if Google Earth value is "W9_N42", report Minimum Latitude value "42" and Minimum Longitude value "-9")
# Click on the top right boundary wanted and report the displayed value in TerraGear GUI. (i.e: if Google Earth value is "E6_N45", report Maximum Latitude value "45" and Maximum Longitude value "6")
# Click on the top right boundary wanted and report the displayed value in TerraGear GUI. (i.e: if Google Earth value is "E6_N45", report Maximum Latitude value "45" and Maximum Longitude value "6")
{{note|You need to use a reasonable boundaries because mapserver.flightgear.org contains a limit.}}


=== Elevation ===
=== Elevation ===
Line 93: Line 92:


=== Construct ===
=== Construct ===
[[Image:TerraGearGUI.png|thumb|270px|The construction page.]]
'''Note: with recent TerraGear builds, it is required to add the used material-names to the default_priorities.txt file.'''
'''Note: with recent TerraGear builds, it is required to add the used material-names to the default_priorities.txt file.'''


The fgfs-construct tool brings all your gathered data together, throws it in a washing machine and spits it out the otherside in a format ready for use with FlightGear. Click the "Update list" button to populate the field with all decoded shapefiles. In the list you select all types that you'd like to include in your scenery.
The tg-construct tool brings all your gathered data together, throws it in a washing machine and spits it out the otherside in a format ready for use with FlightGear. Click the "Update list" button to populate the field with all decoded shapefiles. In the list you select all types that you'd like to include in your scenery.


After clicking the "Generate scenery" button, it may take a long time for TerraGear to finish. Depending on the size of the area you are creating the scenery for and the level of detail in your shapefiles. Simple and small sceneries will take a couple of minutes, where larger, more detailed areas can take over an hour! So trying new things on small areas first will save you a lot of time.
After clicking the "Generate scenery" button, it may take a long time for TerraGear to finish. Depending on the size of the area you are creating the scenery for and the level of detail in your shapefiles. Simple and small sceneries will take a couple of minutes, where larger, more detailed areas can take over an hour! So trying new things on small areas first will save you a lot of time.
Line 108: Line 108:


=== Requested features ===
=== Requested features ===
* Visual map for boundary selection.
* Multi-threading, so the GUI doesn't freeze when running a process.
* Multi-threading, so the GUI doesn't freeze when running a process.


Navigation menu