1
0
Fork 0
fgdata/Docs/InstallGuide/html/getstartch3.html
2002-12-16 18:43:20 +00:00

239 lines
13 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html >
<head><title>3 Preflight: Installing FlightGear </title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="generator" content="TeX4ht (http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html)">
<!-- html,2,info,next,sections+ -->
<meta name="src" content="getstart.tex">
<meta name="date" content="2002-12-15 21:48:00">
<link rel="stylesheet" type="text/css" href="getstart.css">
</head><body
>
<div class="crosslinks"><p class="noindent">[<a
href="getstartpa2.html" >next</a>] [<a
href="getstartch2.html" >prev</a>] [<a
href="getstartch2.html#tailgetstartch2.html" >prev-tail</a>] [<a
href="#tailgetstartch3.html">tail</a>] [<a
href="getstartpa1.html#getstartch3.html" >up</a>] </p></div>
<h2 class="chapterHead"><span class="titlemark">Chapter&nbsp;3</span><br><a
href="getstart.html#QQ2-7-21" name="x7-210003">Preflight: Installing <span
class="ptmbi7t---109">FlightGear </span></a></h2>
<!--l. 33--><p class="noindent">You can skip this Section if you built <span
class="ptmbi7t---109">FlightGear </span>along the lines described in the
previous Chapter. If you did not and you&#8217;re jumping in here, your first step will consist in
installing the binaries. At present, there are pre-compiled binaries<a
name="dx7-21001"></a> available
for
<ul class="itemize1">
<li class="itemize">Windows (any flavor),
</li>
<li class="itemize">Macintosh OSX,
</li>
<li class="itemize">Linux,
</li>
<li class="itemize">SGI Irix.</li></ul>
<h3 class="sectionHead"><span class="titlemark">3.1</span> <a
href="getstart.html#QQ2-7-22" name="x7-220003.1">Installing the binary distribution on a Windows system</a></h3>
<a
name="dx7-22001"></a>
<!--l. 49--><p class="noindent">The following supposes you are on a Windows (95/98/Me/NT/2000/XP) <a
name="dx7-22002"></a>system.
Installing the binaries is quite simple. Go to
<!--l. 53--><p class="indent"> <a
href="ftp://www.flightgear.org/pub/flightgear/Win32/" >ftp://www.flightgear.org/pub/flightgear/Win32/</a>
<!--l. 56--><p class="noindent">and download the three files <span
class="pcrr7t---109">fgfs-base-X.X.X.zip</span>, <span
class="pcrr7t---109">fgfs-manual-X.X.X.zip</span>,
and <span
class="pcrr7t---109">fgfs-win32-bin-X.X.X.zip </span>from
<!--l. 60--><p class="indent"> <a
href="ftp://www.flightgear.org/pub/flightgear/Win32/" >ftp://www.flightgear.org/pub/flightgear/Win32/</a>
<!--l. 63--><p class="noindent">to a drive of your choice. Windows XP includes a program for unpacking *.zip files. If
you are working under an older version of Windows, we suggest getting Winzip from
<!--l. 67--><p class="indent"> <a
href="http://www.winzip.com/" >http://www.winzip.com/</a>.
<!--l. 70--><p class="noindent">For a free alternative, you may consider <span
class="pcrr7t---109">unzip </span>from Info-ZIP,
<!--l. 74--><p class="indent"> http://www.info-zip.org/pub/infozip/
<!--l. 77--><p class="noindent">Extract the files named above. If you choose drive <span
class="pcrr7t---109">c: </span>you should find a file
<span
class="pcrr7t---109">runfgfs.bat </span>under <span
class="pcrr7t---109">c:/Flightgear </span>now. Double-clicking it should invoke the
simulator.
<!--l. 82--><p class="indent"> In case of doubt about the correct directory structure, see the summary at the end of
chapter <a
href="getstartch2.html#x6-100002">2<!--tex4ht:ref: building--></a>.
<h3 class="sectionHead"><span class="titlemark">3.2</span> <a
href="getstart.html#QQ2-7-23" name="x7-230003.2">Installing the binary distribution on a Macintosh system</a></h3>
<a
name="dx7-23001"></a>
<!--l. 89--><p class="noindent">If your Macintosh<a
name="dx7-23002"></a> is running the conventional Mac OS 9<a
name="dx7-23003"></a> or earlier, there are versions up
to <span
class="ptmbi7t---109">FlightGear </span>0.7.6 available being provided courtesy Darrell Walisser)<a
name="dx7-23004"></a>. Download the
file <span class="obeylines-h"><span
class="pcrr7t---109">FlightGear_Installer_0.X.X.sit</span></span> from the corresponding subdirectory
under
<!--l. 93--><p class="indent"> <a
href="http://icdweb.cc.purdue.edu/~walisser/fg/" >http://icdweb.cc.purdue.edu/&nbsp;walisser/fg/</a>.
<!--l. 96--><p class="noindent">This file contains the program as well as the required base package files (scenery etc.).
For unpacking, use <span
class="pcrr7t---109">Stuffit Expander 5.0</span><a
name="dx7-23005"></a> or later.
<!--l. 100--><p class="indent"> The latest build available for Mac OS 9.x is 0.7.6, located in the same place.
The base package is part of the download for Mac OS 9.x, but not for Mac
OSX.
<!--l. 102--><p class="indent"> Alternatively, if you are running Mac OS X<a
name="dx7-23006"></a>, download <span
class="pcrr7t---109">fgfs-0.X.X.gz </span>from the
same site named above. The Mac OS X builds are in a gzip file in the same
directory. There is a Readme file in the directory to help people identify what to
download.
<!--l. 105--><p class="indent"> Mac OS X requires that you first download the base package. Then extract it
with
<!--l. 107--><p class="noindent"><span
class="pcrr7t---109">tar -zxvf fgfs-base-X.X.X.tar.gz</span>
<br class="newline"><span
class="pcrr7t---109">gunzip fgfs-X.X.X.-date.gz</span>
<!--l. 111--><p class="noindent">Note that there is no <span
class="pcrr7t---109">runfgfs </span>script for Mac OS X yet.
<h3 class="sectionHead"><span class="titlemark">3.3</span> <a
href="getstart.html#QQ2-7-24" name="x7-240003.3">Installing the binary distribution on a Debian Linux system</a></h3>
<a
name="dx7-24001"></a>
<!--l. 118--><p class="noindent">Download the file <span class="obeylines-h"><span
class="pcrr7t---109">flightgear_0.7.6-6_i386.deb</span></span> (being provided courtesy Ove
Kaaven)<a
name="dx7-24002"></a> from any of the Debian<a
name="dx7-24003"></a> mirror sites listed at
<!--l. 122--><p class="indent"> <a
href="http://packages.debian.org/unstable/games/flightgear.html" >http://packages.debian.org/unstable/games/flightgear.html</a>.
<!--l. 125--><p class="noindent">Like any Debian package, this can be installed via
<!--l. 129--><p class="indent"> <span class="obeylines-h"><span
class="pcrr7t---109">dpkg</span><span
class="pcrr7t---109">&nbsp;--install</span><span
class="pcrr7t---109">&nbsp;flightgear_0.7.6-6_i386.deb</span></span>.
<!--l. 132--><p class="noindent">After installation, you will find the directory <span
class="pcrr7t---109">/usr/local/Flightgear </span>containing
the script <span
class="pcrr7t---109">runfgfs </span>to start the program.
<h3 class="sectionHead"><span class="titlemark">3.4</span> <a
href="getstart.html#QQ2-7-25" name="x7-250003.4">Installing the binary distribution on a SGI IRIX system</a></h3>
<a
name="dx7-25001"></a>
<!--l. 141--><p class="noindent">If there are binaries available for SGI IRIX systems, download all the required files
(being provided courtesy Erik Hofman)<a
name="dx7-25002"></a> from
<!--l. 145--><p class="indent"> <a
href="http://www.a1.nl/~ehofman/fgfs/" >http://www.a1.nl/&nbsp;ehofman/fgfs/</a>
<!--l. 148--><p class="noindent">and install them. Now you can start <span
class="ptmbi7t---109">FlightGear </span>via running the script
<br class="newline"><span
class="pcrr7t---109">/opt/bin/fgfs</span>.
<h3 class="sectionHead"><span class="titlemark">3.5</span> <a
href="getstart.html#QQ2-7-26" name="x7-260003.5">Installing add-on scenery</a></h3>
<a
name="dx7-26001"></a>
<a
name="dx7-26002"></a>
<!--l. 156--><p class="noindent">There are two complete sets of scenery files with worldwide coverage available, now,
being based on different source data. One data set was created by Curt Olson<a
name="dx7-26003"></a> and can be
downloaded via a clickable map<a
name="dx7-26004"></a> from
<!--l. 159--><p class="indent"> <a
href="http://www.flightgear.org/Downloads/world-scenery.html" >http://www.flightgear.org/Downloads/world-scenery.html</a>
<!--l. 162--><p class="noindent">Moreover, Curt provides the complete set of US Scenery on CD-ROM<a
name="dx7-26005"></a> for those who
really would like to fly over all of the USA. For more detail, check the remarks on the
downloads page above.
<!--l. 167--><p class="indent"> An alternative data set was produced by William Riley<a
name="dx7-26006"></a> and is available from
<!--l. 170--><p class="indent"> <a
href="http://www.randdtechnologies.com/fgfs/newScenery/world-scenery.html" >http://www.randdtechnologies.com/fgfs/newScenery/world-scenery.html</a>
<!--l. 173--><p class="noindent">again using a <a
name="dx7-26007"></a>.
<!--l. 176--><p class="indent"> While the first data set is based on the USGS<a
name="dx7-26008"></a> data, the second one is based on the
so-called VMap0<a
name="dx7-26009"></a> data set. While there may be more differences to discover, the first
one has much better coast lines, while the latter sports world-wide coverage of
streets, rivers, lakes, and more. Scenery provided in the base package is based
on the second data set (though covering a small area around San Francisco,
only).
<!--l. 178--><p class="indent"> Installation of both data sets is identical. You have to unpack them under
<span
class="pcrr7t---109">/Flightgear/Scenery</span>. Do not de-compress the numbered scenery files like
958402.gz! This will be done by <span
class="ptmbi7t---109">FlightGear </span>on the fly.
<!--l. 180--><p class="indent"> As an example, consider installation of the scenery package w120n30 containing the
Grand Canyon Scenery.
<!--l. 183--><p class="indent"> After having installed the base package<a
name="dx7-26010"></a>, you should have ended up with the following
directory structure:
<!--l. 187--><p class="noindent"><span
class="pcrr7t---109">/usr/local/FlightGear/Scenery</span>
<!--l. 190--><p class="noindent"><span
class="pcrr7t---109">/usr/local/FlightGear/w130n30</span>
<!--l. 193--><p class="noindent"><span
class="pcrr7t---109">/usr/local/FlightGear/w130n30/w122n37</span>
<br class="newline"><span
class="pcrr7t---109">/usr/local/FlightGear/Scenery/w130n30/w123n37</span>
<!--l. 198--><p class="noindent">with the directories w122n37 and w123n37m, resp. containing numerous *.gz files.
Installation of the Grand Canyon scenery adds to this the directories
<!--l. 203--><p class="noindent"><span
class="pcrr7t---109">/usr/local/FlightGear/w120n30/w112n30</span>
<br class="newline"><span
class="pcrr7t---109">/usr/local/FlightGear/w120n30/w112n31</span>
<br class="newline"><span
class="pcrr7t---109">...</span>
<br class="newline"><span
class="pcrr7t---109">/usr/local/FlightGear/w120n30/w120n39</span>.
<!--l. 210--><p class="indent"> You can exploit the <span
class="pcrr7t---109">--fg-scenery=</span><span
class="ptmri7t---109">path </span>command line option, if you want to
install different scenery sets in parallel or want to have scenery sitting in another
place.
<h3 class="sectionHead"><span class="titlemark">3.6</span> <a
href="getstart.html#QQ2-7-27" name="x7-270003.6">Installing documentation</a></h3>
<a
name="dx7-27001"></a>
<!--l. 216--><p class="noindent">Most of the packages named above include the complete <span
class="ptmbi7t---109">FlightGear </span>documentation
including a .pdf version of this <span
class="ptmri7t---109">Installation and Getting Started </span>Guide intended for pretty
printing using Adobe&#8217;s Acrobat Reader being available from
<!--l. 221--><p class="indent"> <a
href="http://www.adobe.com/acrobat" >http://www.adobe.com/acrobat</a>
<!--l. 224--><p class="noindent">Moreover, if properly installed, the .html version can be accessed via <span
class="ptmbi7t---109">FlightGear</span>&#8217;s <span
class="pcrr7t---109">help</span>
menu entry.
<!--l. 228--><p class="indent"> Besides, the source code contains a directory <span
class="pcrr7t---109">docs-mini </span>containing numerous
ideas on and solutions to special problems. This is also a good place for further
reading.
<div class="crosslinks"><p class="noindent">[<a
href="getstartpa2.html" >next</a>] [<a
href="getstartch2.html" >prev</a>] [<a
href="getstartch2.html#tailgetstartch2.html" >prev-tail</a>] [<a
href="getstartch3.html" >front</a>] [<a
href="getstartpa1.html#getstartch3.html" >up</a>] </p></div><a
name="tailgetstartch3.html"></a>
</body></html>