TerraSync: Difference between revisions

To see the terrain below your [[aircraft]], you have to install the respective [[scenery]]. This can happen by downloading certain bits of scenery before flying as described in the article [[Howto: Install scenery|installing scenery]].  

The master repository for TerraSync, i.e. the online resource from which TerraSync downloads its files, is synchronized with the [http://scenemodels.flightgear.org/ FlightGear Scenery Database] once a day. So when using TerraSync, you will always have  

# the latest [[File Formats#.2A.stg|.stg-files]], which tell FlightGear where to place an object  

# the latest '''static''' models for objects. (Static models define unique objects that exist in one place only, such as famous buildings or landmarks.)  

As of March 2011, TerraSync also downloads '''shared''' models (generic models used more than once in different places, each can represent many different objects, like generic houses or ships), at least when it first runs. It does not, however, install the shared models, and until they are installed in the right place, you won't see any objects that are based on them. You will need to copy all the files from the Models directory inside your TerraSync directory to <code>[[$FG_ROOT]]/Models</code>, replacing the files that are already there. If for some reason you suspect your models are not up-to-date, you can also manually download the newest [http://scenemodels.flightgear.org/download/SharedModels.tgz '''shared''' models archive] from the [http://scenemodels.flightgear.org/ FlightGear Scenery Database]. Unpack it to <code>[[$FG_ROOT]]/Models</code>.

It is recommended to use a separate scenery directory for TerraSync (i.e. do not run have it store its downloaded files in your main scenery directory) because network interruptions may upset the synchronization protocol and garble what is stored there. If/when that happens the easiest solution is to delete the affected subdirectory and let terrasync download it again (see [[Howto:_Animated_jetways#Usage]].

  <code>% fgfs --atlas=socket,out,1,localhost,5500,udp --fg-scenery="[[$FG_ROOT]]/Scenery/:$HOME/fgfsScenery"</code>

=== Start TerraSync from [[FGRun]] in FlightGear 1.9.1 ===

# Make sure you are in the first screen where you can set up directories. To get there, start fgrun.exe. You'll first be in the Aircraft selection screen, then hit "Back". You are now here:<br/>[[File:TerraSync 1.png]]

# Select the destination folder for all files downloaded by terrasync. Usually the folder <code>[[$FG_ROOT]]\terrasync</code> already exists and you only have to add it to the list (as in the above example). Insure that it is positioned '''above''' your standard scenery folder (here that is <code>FlightGear191\scenery</code>) and all other directories over which the terrasync folder is supposed to have priority. When two directories contain information for the same region, FlightGear will take the information from the directory higher in the list. On Linux make sure the directory does not only to have a T, but also is the topmost folder.

# For TerraSync to know where to deposit the downloaded files, you have to tell the program which folder is the destination folder. In the above example, it is the 3^rd in the list.

# Finally, go to the last screen. There you have to activate TerraSync as in the following screenshot. Now TerraSync should work.<br />[[File:TerraSync 2.png]]

== Troubleshooting ==

Airports/L ... failed:

Can't move 'C:\FlightGear\terrasync\Airports\L\E\.svn\tmp\entries' to 'C:\FlightGear\terrasync\Airports\L\E\.svn\entries': The file or directory is corrupted and unreadable.

and possibly the following popup appears:

you can probably fix the error by upgrading to Windows 7 Home Premium Service Pack 1.

* [[Howto: Install scenery]]