Howto:Install scenery: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
(→‎Installing Scenery: details of structure archive of the tar and how to decompress it)
Line 111: Line 111:
= TerraSync =
= TerraSync =


TerraSync is a utility that automatically downloads needed FlightGear scenery while the simulator is running.  
TerraSync is a very useful utility that automatically downloads needed FlightGear scenery while the simulator is running.  


The master repository for terrasync (at least the SVN based) is automatically synchronized with the [http://scenemodels.flightgear.org/ FlightGear Scenery Objects Database] so you will always have the latest scenery objects. (Note however that you might need to install the SharedModels archive from that site if the set of shared scenery objects have changed since your version of FlightGear was released to see all objects.)
For more information, see the main entry [[TerraSync]].
 
It is recommended to use a separate scenery directory for TerraSync (that is do not run it on your main scenery directory) as network interruptions may upset the SVN synchronization protocol - if/when that happens the easiest solution is to delete the affected subdirectory and let terrasync download it again.
 
Usage example (for POSIX compliant [[command line]] shell):
 
Start terrasync:
 
<code>% nice terrasync -p 5500 -S -d /tmp/fgfsScenery</code>
 
The -S option tells terrasync to use the SVN protocol to fetch data. If you omit it terrasync will use the rsync program instead (which has to be installed on your system).
 
Start FlightGear:
 
<code>% fgfs --atlas=socket,out,1,localhost,5500,udp --fg-scenery=$FG_ROOT/Scenery/:/tmp/fgfsScenery</code>
 
The full documentation and source for TerraSync is located in the FlighGear source distribution (in <code>utils/TerraSync/</code>).
 
TODO: More info


=See also=
=See also=

Revision as of 19:44, 19 July 2009

Terrain

You can download World Scenery 1.0.1 terrain from the FlightGear site : http://www.flightgear.org/Downloads/scenery-1.0.1.html

To install the scenery just extract (uncompress) the tar.gz archive file in the $FG_ROOT/Scenery directory (under Win32, using a tool such as for example izArc or 7-Zip), preserving all directory structures in the file. The Scenery will be installed automatically. You can use fgadmin to uninstall added scenery.

There is also a 4 DVD set available for download via BitTorent, which can be a higher performance option for those wanting to download the entire world: http://www.torrentbox.com/download/59050/FlightGear_4_DVD_Disk-set.torrent

Installing Scenery

In your FG_ROOT directory you would find the following directories

./Translations
./Protocol
./Textures
./Timezone
./Airports
./gui
./Aircraft-uiuc
./Scenery
./Traffic
...

The Scenery directory will show the following:- (Scenery is shown for completeness and for easy reference to above)

 Scenery/
     Terrain/
         w130n30/
     Objects/
         w130n30/

If you download a scenery module called w90n40.tgz from [flightgear.org] and extract it in Scenery, the result will resemble something like the following:-

Scenery/
     Terrain/
         w09n40/
         w130n30/
     Objects/
         w09n40/
         w130n30/
Note that the directory structure is already present in the tar archive, starting from the Scenery directory. Note that you have to extract the tar archive in the Scenery directory, not in the FG_ROOT directory, because the Scenery directory is not present in the archive.
If you are under linux operation system and you are not using a graphical interface to extract the tar archive, you can use one of the two following set of commands in a shell terminal.
cd $FG_ROOT/Scenery
tar -xvzf 'input_file.tgz'

or

tar -xvzf 'input_file.tgz' -C $FG_ROOT/Scenery
In the above two example it is supposed that the variable FG_ROOT is set to the root of the data directory. If this is not set, you should substitute in the above examples the $FG_ROOT with the full pathname of this directory. In the above examples 'input_file.tgz' should be substituted with the filename of the archive to be extracted (the filename should be completed with the full pathname or any other valid method so that the shell could find the correct archive)

TODO : Windows decompression help.

Objects

Objects and models can be found at the FlightGear Scenery Objects Database These objects are included in each scenery release, but as the object database is frequently updated one may want to occasionally update the Object subdirectory from the FlightGear Scenery Objects Database between scenery releases. Another option is to download or update the scenery on-demand by using the terrasync program described below.

Objects are really part of the scenery and can be found in the Scenery directory under $FG_ROOT.

Scenery/
    Objects/
        w130n30/

Any objects should be installed under the Scenery/Objects directory.

Technical

Scenery for FlightGear is determined by looking at the environment variable $FG_SCENERY. Should the paths in $FG_SCENERY not be valid, FlightGear falls back to $FG_ROOT/scenery.

Mixing scenery types is almost universally a bad idea, and is unsupported. In this connection you should note that the scenery packaged with the base package/windows installer may not be the latest scenery.

For this reason it's probably better to extract scenery files you've downloaded into a new folder, which we'll call, for the sake of this exercise, $FOOBAR/Scenery In this directory, create two subdirectories . /Objects and /Terrain. You should untar individual files into the /Terrain folder.

Then you should set up $FG_SCENERY to use the new path: On POSIX Clients set FG_SCENERY="$FOOBAR/Scenery" + FG_SCENERY On Windows (fgrun) Go back to the first page of fgrun, and add the $FOOBAR/Scenery folder to the list.

Downloading From Mirrors

A list of mirrors can be found here: http://www.flightgear.org/mirrors.html#ftp
On most of the mirrors, the latest scenery can be found under "Scenery-1.0.0/"
Downloading from mirrors is often better than the official site, because mirrors are sometimes faster and have more user capacity. Use the graphical interface ( http://www.flightgear.org/Downloads/scenery-1.0.0.html ) and use the link locations to find the appropriate chunk.
Be careful about confusing N with S, and E with W!!
Here is how to find an airport's co-ordinates:

  • Go to the Wikipedia page for the airport in question (for example, PHNL for Honolulu)
  • Find the co-ordinates (often at the top or right and side, marked with a small globe)
  • e.g. PHNL is in 21 N 157 W. If it's in the western hemisphere, you should round it up... so you should find the block with W160N20 If the co-ords were 21 N 157 E, you would round it down.. meaning that this location would be E150N20.

TerraSync

TerraSync is a very useful utility that automatically downloads needed FlightGear scenery while the simulator is running.

For more information, see the main entry TerraSync.

See also