652
edits
(→For GNU/Linux users: - corrected path for copy-pasters) |
m (→For GNU/Linux users: Add HelpLines for common Errors) |
||
(12 intermediate revisions by 9 users not shown) | |||
Line 8: | Line 8: | ||
| writtenin = C++ (Qt) | | writtenin = C++ (Qt) | ||
| os = Windows, Linux, Mac OS X | | os = Windows, Linux, Mac OS X | ||
| website = | | website = https://sourceforge.net/p/flightgear/fgscenery/terrageargui/ci/master/tree/ | ||
}} | }} | ||
The '''GUI''' tool for '''[[TerraGear]]''' allows people to create [[scenery]] for [[FlightGear]] without using commandlines. | The '''GUI''' tool for '''[[TerraGear]]''' allows people to create [[scenery]] for [[FlightGear]] without using commandlines. | ||
== Obtaining the GUI == | == Obtaining the GUI == | ||
You can either build the GUI [ | You can either build the GUI [https://sourceforge.net/p/flightgear/fgscenery/terrageargui/ci/master/tree/ 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 a recent version of [[TerraGear]] as well. | Please note that: | ||
* you need to download/compile a recent version of [[TerraGear]] as well; | |||
* for Windows users, you'll need to add three DLLs to you TerraGear GUI root directory: | |||
** msvcp71.dll (see [[TerraGear_Installation_for_Windows]] to know how to get it) | |||
** mscvr71.dll (see [[TerraGear_Installation_for_Windows]] to know how to get it) | |||
** gdal12.dll (this can be retrieved from ftp://ftp.ihg.uni-duisburg.de/FlightGear/Win32/terragear-cs-Win32-20101002.zip ) | |||
==== For GNU/Linux users ==== | ==== For GNU/Linux users ==== | ||
# Grab the sources and store it where you want:<br/><pre>git clone git:// | # Grab the sources and store it where you want:<br/><pre>git clone git://git.code.sf.net/p/flightgear/fgscenery/terrageargui</pre> | ||
# Then go in the source:<br/><pre>cd terrageargui</pre> | # Then go in the source:<br/><pre>cd terrageargui</pre> | ||
# Create a build dir:<br/><pre>mkdir build && cd build</pre> | # Create a build dir:<br/><pre>mkdir build && cd build</pre> | ||
# Now build it:<br/><pre>qmake .. | # Now build it:<br/><pre>qmake .. </pre> or<pre>qmake-qt4 ..</pre> then<pre>make</pre> | ||
# You can now start it with:<br/><pre>./bin/TerraGUI</pre> | :::<sub>In case of ERRORS You may have to add the following via SYNAPTIC:</sub> | ||
:::*<sub>for "/usr/lib/i386-linux-gnu/qt4/bin/uic: Command not found" add: libqt4-dev-bin</sub> | |||
:::*<sub>for "QtGui/QApplication: No such file or directory" add: qt4-dev-tools</sub> | |||
<br /> | |||
# You can now start it with:<br/><pre>"./bin/TerraGUI" or "./build/TerraGUI"</pre> | |||
You're done! | You're done! | ||
Line 75: | Line 84: | ||
You can do two things now: | You can do two things now: | ||
*'''Already-made airports:''' use FlightGear's <tt>apt.dat.gz</tt> file, which is usually in <tt>[[$FG ROOT]]/Airports/</tt>. | *'''Already-made airports:''' use FlightGear's <tt>apt.dat.gz</tt> file, which is usually in <tt>[[$FG ROOT]]/Airports/</tt>. | ||
*'''Home-made airports:''' if you created an airport in | *'''Home-made airports:''' if you created an airport in [[WorldEditor]], use the .dat file that you exported. | ||
Use the button to browse to the .dat file of your choice | Use the button to browse to the .dat file of your choice. | ||
* '''All airports in area''' generates all the airports within the boundaries as set on the start tab. | * '''All airports in area''' generates all the airports within the boundaries as set on the start tab. | ||
Line 90: | Line 99: | ||
Line width is only used on line-data (like roads, rivers and railroads). If you leave the line width fields empty, a default width of 10 meters is used. | Line width is only used on line-data (like roads, rivers and railroads). If you leave the line width fields empty, a default width of 10 meters is used. | ||
===== Example ===== | |||
{| class="wikitable" | |||
|- | |||
! Shapefile !! Material !! Line width (in meters) | |||
|- | |||
| osm_canal || Canal || 12 | |||
|- | |||
| osm_motorway || Road-Motorway || 12 | |||
|- | |||
| osm_primary || Road-Primary || 10 | |||
|- | |||
| osm_rail || Railroad || 5 | |||
|- | |||
| osm_river || Canal || 8 | |||
|- | |||
| osm_secondary || Road-Secondary || 8 | |||
|- | |||
| osm_stream || Stream || 3 | |||
|- | |||
| osm_tertiary || Road-Tertiary || 6 | |||
|- | |||
| osm_trunk || Road-Trunk || 18 | |||
|} | |||
=== Construct === | === Construct === | ||
Line 103: | Line 137: | ||
== GUI development == | == GUI development == | ||
The current source code can be retrieved [ | The current source code can be retrieved [https://sourceforge.net/p/flightgear/fgscenery/terrageargui/ci/master/tree/ from SourceForge]. | ||
Feel free to add feature requests and/or bug reports to this page. Anyone interested in helping is invited to contact Gijs at the forum. | Feel free to add feature requests and/or bug reports to this page. Anyone interested in helping is invited to contact Gijs at the forum. | ||
=== Requested features === | === Requested features === | ||
* Multi-threading, so the GUI doesn't freeze when running a process. | Also see [[TerraGear scenery build server]] | ||
[[File:TerraGear-GUI-Remote-Mode.png|thumb|Prototyping a remote mode for [[TerraGear]] as part of [[TerraGear GUI]]]] | |||
* Multi-threading, so the GUI doesn't freeze when running a process [http://forum.flightgear.org/viewtopic.php?f=5&t=25688&p=235873&hilit=#p235623] | |||
* Support a new "Setup" page where people can decide if TerraGear is installed locally or remotely {{Not done}} | |||
* Add a command handler abstraction so that commands can be easily run over SSH [http://doc.qt.digia.com/qtcreator-extending/utils-sshconnection.html] {{Not done}} | |||
* File retrieval would ideally be wrapped via SFTP {{Not done}} | |||
== External link == | == External link == | ||
* [http:// | * [http://forum.flightgear.org/viewtopic.php?f=5&t=7485 Forum topic] | ||
[[Category:Scenery enhancement]] | [[Category:Scenery enhancement]] | ||
[[Category: | [[Category:TerraGear]] |
edits