Hi fellow wiki editors!

To help newly registered users get more familiar with the wiki (and maybe older users too) there is now a {{Welcome to the wiki}} template. Have a look at it and feel free to add it to new users discussion pages (and perhaps your own).

I have tried to keep the template short, but meaningful. /Johan G

Difference between revisions of "Howto:Install scenery"

From FlightGear wiki
Jump to: navigation, search
(Lunix - A samll Typo in the Headline!)
m
Line 1: Line 1:
 
{{WIP}}
 
{{WIP}}
  
You can download the official [[World Scenery]] terrain from the [http://www.flightgear.org/Downloads/scenery-1.0.1.html FlightGear website]. Alternatively, custom scenery is available for certain specific areas. They are distributed separately due to their license, or because their level of detail it is not suitable for low-end machines. See [[Suggested Airports/Scenery]] for a list of custom scenery projects.
+
You can download the official [[World Scenery]] terrain from the [http://www.flightgear.org/Downloads/scenery-1.0.1.html FlightGear website]. Alternatively, custom scenery is available for certain specific areas. They are distributed separately due to their license, or because their level of detail is not suitable for low-end machines. See [[Suggested Airports/Scenery]] for a list of custom scenery projects.
  
There is also a 4 DVD set available for download via [http://www.torrentbox.com/download/59050/FlightGear_4_DVD_Disk-set.torrent BitTorent], which can be a higher performance option for those wanting to download the entire world.
+
There is also a 4 DVD set available for download via [http://www.torrentbox.com/download/59050/FlightGear_4_DVD_Disk-set.torrent BitTorent], which can be a higher performance option for those wanting to download the entire world. And, last but not least, it can be purchased as 3 DVD set from the [http://www.flightgear.org/dvd/ official FlightGear website].
  
 
You can optionally use a GUI installer, called [[FlightGear Admin Wizard|FGAdmin]], to (un)install scenery.
 
You can optionally use a GUI installer, called [[FlightGear Admin Wizard|FGAdmin]], to (un)install scenery.
  
=== Linux ===
+
 
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.
+
=== GNU/Linux ===
 +
 
 +
If you are under a 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
 
  cd [[$FG_ROOT]]/Scenery
  tar -xvzf 'input_file.tgz'
+
  tar -xvzf input_file.tgz
  
 
or
 
or
Line 17: Line 19:
 
  tar -xvzf 'input_file.tgz' -C [[$FG_ROOT]]/Scenery
 
  tar -xvzf 'input_file.tgz' -C [[$FG_ROOT]]/Scenery
  
In the above two examples 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)
+
In the above two examples 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).
 +
 
  
 
=== Windows ===
 
=== Windows ===
Simply unpack the downloaded scenery to your [[$FG_ROOT]]/Scenery directory, using software like [http://www.winzip.com/ Winzip] or [http://www.7-zip.org 7-zip].
+
 
 +
Simply unpack the downloaded scenery into your [[$FG_ROOT]]/Scenery directory, using software like [http://www.winzip.com/ Winzip] or [http://www.7-zip.org 7-zip].
 +
 
  
 
==Technical==
 
==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.
 
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.
  
Line 33: Line 39:
 
*On POSIX Clients<br>set FG_SCENERY="$FOOBAR/Scenery" + FG_SCENERY
 
*On POSIX Clients<br>set FG_SCENERY="$FOOBAR/Scenery" + FG_SCENERY
 
*On Windows (FGRun)<br>Go back to the first page of fgrun, and add the $FOOBAR/Scenery folder to the list.
 
*On Windows (FGRun)<br>Go back to the first page of fgrun, and add the $FOOBAR/Scenery folder to the list.
 +
  
 
=== Terrain ===
 
=== Terrain ===
 +
 
The Scenery directory will show the following (scenery is shown for completeness and for easy reference to above):
 
The Scenery directory will show the following (scenery is shown for completeness and for easy reference to above):
  
Line 58: Line 66:
  
 
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.
 
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.
 +
  
 
=== Objects ===
 
=== Objects ===
 +
 
Objects and models can be found at the [http://scenemodels.flightgear.org/ FlightGear Scenery Objects Database].
 
Objects and models can be found at the [http://scenemodels.flightgear.org/ FlightGear Scenery Objects Database].
  
Line 74: Line 84:
  
 
Any objects should be installed under the <tt>Scenery/Objects</tt> directory.
 
Any objects should be installed under the <tt>Scenery/Objects</tt> directory.
 +
  
 
==Downloading from mirrors==
 
==Downloading from mirrors==
 +
 
A list of mirrors can be found [http://www.flightgear.org/mirrors.html#ftp here].
 
A list of mirrors can be found [http://www.flightgear.org/mirrors.html#ftp here].
  
Line 84: Line 96:
 
# Find the co-ordinates (often at the top or right and side, marked with a small globe)
 
# 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.
 
#* 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==
[[TerraSync]] is a very useful utility that automatically downloads needed FlightGear scenery while the simulator is running.  
+
 
 +
[[TerraSync]] is a very useful utility that automatically downloads needed FlightGear scenery and keeps it up to date while the simulator is running.  
 +
 
  
 
==Related content==
 
==Related content==
 +
 
* [[FlightGear Admin Wizard|FGAdmin]]
 
* [[FlightGear Admin Wizard|FGAdmin]]
 
* [[Installing Aircraft]]
 
* [[Installing Aircraft]]
 
* [[Scenery FAQ]]
 
* [[Scenery FAQ]]
 +
  
 
[[Category:Scenery]]
 
[[Category:Scenery]]

Revision as of 15:59, 13 October 2009

WIP.png Work in progress
This article or section will be worked on in the upcoming hours or days.
See history for the latest developments.

You can download the official World Scenery terrain from the FlightGear website. Alternatively, custom scenery is available for certain specific areas. They are distributed separately due to their license, or because their level of detail is not suitable for low-end machines. See Suggested Airports/Scenery for a list of custom scenery projects.

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. And, last but not least, it can be purchased as 3 DVD set from the official FlightGear website.

You can optionally use a GUI installer, called FGAdmin, to (un)install scenery.


GNU/Linux

If you are under a 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 examples 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).


Windows

Simply unpack the downloaded scenery into your $FG_ROOT/Scenery directory, using software like Winzip or 7-zip.


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.


Terrain

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.


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 more frequently updated than the terrain, 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.


Downloading from mirrors

A list of mirrors can be found here.

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 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:

  1. Go to the Wikipedia page for the airport in question (for example, PHNL for Honolulu)
  2. 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 and keeps it up to date while the simulator is running.


Related content