Howto:Install scenery: Difference between revisions

: Basically the same as the world scenery. In addition it also contains the latest scenery objects added to the [[Scenery Objects Database|scenery objects database]] by fellow FlightGear users.

# Click on '''Select Scenery Source...''' to select the directory containing the scenery .tgz files.

# Click on '''Select Install Destination...''' to select the directory where you want to install the scenery.

#* On GNU/Linux, it should be a directory outside <tt>[[$FG_ROOT]]</tt> (see [[#Technical]] for an explanation).

#* On Windows, it should be a directory you can read from/write to. If you use FlightGear 3.2 and above, the default path ('''C:\Users\''your user name''\Documents\FlightGear\Custom Scenery''') is perfectly fine.

#* On Macintosh systems, the path should be '''/Applications/FlightGear.app/Contents/Resources/data/Scenery'''.

# In the left pane, check the scenery tiles you want to install and click on '''Install Selected Files''' to install the scenery.

In the above two examples, it is supposed that <tt>SceneryDirectory</tt> is set to a directory, outside <tt>[[$FG_ROOT]]</tt> (see [[#Technical]] for the reasoning behind this). Additionally, <tt>input_file.tgz</tt> 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).

Simply unpack the downloaded scenery into a directory of choice, outside the <tt>[[$FG_ROOT]]</tt> directory (see [[#Technical]] for the reasoning behind this), using software like [http://www.winzip.com/ Winzip] or [http://www.7-zip.org 7-zip]. Once done, append this directory to [[$FG_SCENERY]]. When using the [[FlightGear Wizard]], you can do so on the first page (previous from aircraft selection). Do not forget to press the "Refresh" button on the airport selection page, when using the wizard.

{{note|More recent Windows versions (e.g. XP, Vista, Win7) tinkering a lot with user rights on access level. Therefore it is a bad idea to install and run FlightGear (scenery) to and from <tt>C:\Program Files</tt>. Find another drive/folder where you, as logged in user, have all neccesary right to read, write and execute the files you installed. Additionally there's a space / blank in folder's name which could cause weird behaviour. Using <tt>C:\FlightGear</tt> is a nice option.}}

Unpack the tgz file either by double-clicking it and moving the resulting wXXXnXXX folder to the Scenery folder described in the next line, or on the command line:

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 <tt>[[$FG ROOT]]/Scenery</tt>.

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, <tt>$FOOBAR/Scenery</tt>.

In this directory, create two subdirectories: /Objects and /Terrain. You should untar individual files into the /Terrain folder.

*: <tt>set FG_SCENERY="$FOOBAR/Scenery" + FG_SCENERY</tt>

* On Windows (FGRun)

*: Go back to the first page of fgrun, and add the <tt>$FOOBAR/Scenery</tt> folder to the list.

* Via a commandline option

*: <tt>--fg-scenery="$FOOBAR/Scenery"</tt>

=== Terrain ===

<tt>

</tt>

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

<tt>

</tt>

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 [http://scenemodels.flightgear.org/ 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]].

<tt>

</tt>

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

=== Models ===

Replaces the former <tt>[[$FG_ROOT]]/Models</tt>; stores all the shared objects.

<tt>

</tt>

=== Airports ===

The directory tree might look somewhat overwhelming, but it simply follows the <tt>Airports/[I]/[C]/[A]/</tt> code (see [[ICAO-code]]).

<tt>

</tt>