<!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 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’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/ 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"> --install</span><span class="pcrr7t---109"> 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/ 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’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>’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>