docs-mini/FlightGear-FAQ.html

   1 <html lang="en">
   2   <!-- $Id$ -->
   3   <head>
   4     <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
   5     <title>FlightGear FAQ</title>
   6     <style type="text/css">
   7         .indent { margin-left: 2em; margin-right: 1em; }
   8       </style>
   9   </head>
  10   <body>
  11
  12     <h1 align="center">FlightGear FAQ</h1>
  13     <p align="center">
  14       <small>Cameron Moore<br>
  15         <a href="mailto:cameron@unbeatenpath.net?subject=FlightGear%20FAQ">cameron@unbeatenpath.net</a>
  16       </small>
  17     </p>
  18     <hr noshade>
  19
  20
  21     <h2>Introduction</h2>
  22       <p>Welcome to the FlightGear FAQ.  Here you will find the answers to
  23       some questions that are frequently asked on our mailing lists.  If
  24       you have a question that is not answered here, feel free to ask
  25       us on our mailing lists.  Enjoy</p>
  26
  27   <hr noshade>
  28     <h2>
  29       <a name="toc">Table of Contents</a>
  30     </h2>
  31     <h4>1 -
  32     <a href="#1">The FAQ</a>
  33     </h4>
  34     <div class="indent">1.1 -
  35       <a href="#1.1">Where can I get the latest version of this FAQ?</a>
  36     </div>
  37     <div class="indent">1.2 -
  38       <a href="#1.2">Who do I contact if I have comments about this FAQ?</a>
  39     </div>
  40     <div class="indent">1.3 -
  41       <a href="#1.3">How old is this document?</a>
  42     </div>
  43     <div class="indent">1.4 -
  44       <a href="#1.4">What other important documentation should I read?</a>
  45     </div>
  46     <br>
  47     <h4>2 -
  48     <a href="#2">Distribution</a>
  49     </h4>
  50     <div class="indent">2.1 -
  51       <a href="#2.1">Where can I get FlightGear?</a>
  52     </div>
  53     <div class="indent">2.2 -
  54       <a href="#2.2">What is the password for the FTP server?</a>
  55     </div>
  56     <div class="indent">2.3 -
  57       <a href="#2.3">Why won't the FTP server let me in with the right login info?</a>
  58     </div>
  59     <div class="indent">2.4 -
  60       <a href="#2.4">Where can I find the latest development source code?</a>
  61     </div>
  62     <div class="indent">2.5 -
  63       <a href="#2.5">What is SimGear, and why do I need it?</a>
  64     </div>
  65     <div class="indent">2.6 -
  66       <a href="#2.6">Where can I fly and where do I get the scenery?</a>
  67     </div>
  68     <div class="indent">2.7 -
  69       <a href="#2.7">Where can I get different 3D models for my plane?</a>
  70     </div>
  71     <div class="indent">2.8 -
  72       <a href="#2.8">How current is the data in FlightGear compared to the real world?</a>
  73     </div>
  74     <div class="indent">2.9 -
  75       <a href="#2.9">Where is the moving map?</a>
  76     </div>
  77     <div class="indent">2.10 -
  78       <a href="#2.10">Why don't you charge money for this?</a>
  79     </div>
  80     <br>
  81     <h4>3 -
  82     <a href="#3">Compiling</a>
  83     </h4>
  84     <div class="indent">3.1 -
  85       <a href="#3.1">Why won't FlightGear compile?</a>
  86     </div>
  87     <div class="indent">3.2 -
  88       <a href="#3.2">I'm using RedHat 7, and ...?</a>
  89     </div>
  90     <br>
  91     <h4>4 -
  92     <a href="#4">Configuring</a>
  93     </h4>
  94     <div class="indent">4.1 -
  95       <a href="#4.1">How do I install new scenery?</a>
  96     </div>
  97     <div class="indent">4.2 -
  98       <a href="#4.2">How do I setup my joystick(s)?</a>
  99     </div>
 100     <div class="indent">4.3 -
 101       <a href="#4.3">What format should my personal .fgfsrc file be in?</a>
 102     </div>
 103     <br>
 104     <h4>5 -
 105     <a href="#5">Running</a>
 106     </h4>
 107     <div class="indent">5.1 -
 108       <a href="#5.1">Why do I get an error loading libmk4.so.0?</a>
 109     </div>
 110     <div class="indent">5.2 -
 111       <a href="#5.2">Why do I get "ssgInit called without a valid OpenGL context"?</a>
 112     </div>
 113     <div class="indent">5.3 -
 114       <a href="#5.3">What happened to the panel, keyboard, etc?</a>
 115     </div>
 116     <div class="indent">5.4 -
 117       <a href="#5.4">Why doesn't audio work properly under Irix?</a>
 118     </div>
 119     <div class="indent">5.5 -
 120       <a href="#5.5">Why is FlightGear so slow?</a>
 121     </div>
 122     <div class="indent">5.6 -
 123       <a href="#5.6">Why is my SGI machine so slow?</a>
 124     </div>
 125     <div class="indent">5.7 -
 126       <a href="#5.7">How do I see the frame rate?</a>
 127     </div>
 128     <div class="indent">5.8 -
 129       <a href="#5.8">Stuck upside down after "crash"?</a>
 130     </div>
 131     <div class="indent">5.9 -
 132       <a href="#5.9">Why does FlightGear die on startup saying "time zone reading failed"?</a>
 133     </div>
 134     <br>
 135     <h4>6 -
 136     <a href="#6">Hacking</a>
 137     </h4>
 138     <div class="indent">6.1 -
 139       <a href="#6.1">What language is FlightGear written in?</a>
 140     </div>
 141     <div class="indent">6.2 -
 142       <a href="#6.2">How do I design a flight dynamics model for a new aircraft?</a>
 143     </div>
 144     <div class="indent">6.3 -
 145       <a href="#6.3">How do I import planes from Microsoft Flight Simulator?</a>
 146     </div>
 147     <div class="indent">6.4 -
 148       <a href="#6.4">How do I import BGL scenery from Microsoft Flight Simulator?</a>
 149     </div>
 150     <div class="indent">6.5 -
 151       <a href="#6.5">How do I design or modify a panel?</a>
 152     </div>
 153     <div class="indent">6.6 -
 154       <a href="#6.6">How do I place objects, like buildings, into FlightGear?</a>
 155     </div>
 156     <div class="indent">6.7 -
 157       <a href="#6.7">Where can I learn 3D programming and how do I get involved?</a>
 158     </div>
 159     <div class="indent">6.8 -
 160       <a href="#6.8">How do I add an airport?</a>
 161     </div>
 162     <div class="indent">6.9 -
 163       <a href="#6.9">How do I generate my own scenery?</a>
 164     </div>
 165     <br>
 166     <h4>7 -
 167     <a href="#7">Flying</a>
 168     </h4>
 169     <div class="indent">7.1 -
 170       <a href="#7.1">Where can I learn about instrument flying and navigation?</a>
 171     </div>
 172     <div class="indent">7.2 -
 173       <a href="#7.2">What is the difference between Aileron and Rudder?</a>
 174     </div>
 175     <div class="indent">7.3 -
 176       <a href="#7.3">Is there support for multi-player flying?</a>
 177     </div>
 178     <div class="indent">7.4 -
 179       <a href="#7.4">Is there support for any military scenarios like dog fighting or bomb dropping?</a>
 180     </div>
 181     <br>
 182     <h4>8 -
 183     <a href="#8">FlightGear v0.7.6</a>
 184     </h4>
 185     <div class="indent">8.1 -
 186       <a href="#8.1">Why do I get an error in viewer.cxx about `exit' being undeclared?</a>
 187     </div>
 188     <br>
 189
 190
 191     <hr>
 192     <h2>
 193       <a name="1">1 -
 194     The FAQ</a>
 195     </h2>
 196         <b>
 197       <a name="1.1">1.1 -
 198     <u>Where can I get the latest version of this FAQ?</u>
 199       </a>
 200     </b>
 201         <div class="indent">
 202           <p>
 203           <a href="http://flightgear.org/Docs/FlightGear-FAQ.html">http://flightgear.org/Docs/FlightGear-FAQ.html</a>
 204           </p>
 205         </div>
 206
 207         <b>
 208       <a name="1.2">1.2 -
 209     <u>Who do I contact if I have comments about this FAQ?</u>
 210       </a>
 211     </b>
 212         <div class="indent">
 213           <p>First contact the author.  If you get no response, send your
 214           comments to the FlightGear-Users mailing list.</p>
 215         </div>
 216
 217         <b>
 218       <a name="1.3">1.3 -
 219     <u>How old is this document?</u>
 220       </a>
 221     </b>
 222         <div class="indent">
 223           <p>See the <i>About This Document</i> section at the end of the FAQ.</p>
 224         </div>
 225
 226         <b>
 227       <a name="1.4">1.4 -
 228     <u>What other important documentation should I read?</u>
 229       </a>
 230     </b>
 231         <div class="indent">
 232           <p>Most FlightGear documentation is linked to from
 233           <a href="http://flightgear.org/Docs/">http://flightgear.org/Docs/</a>.
 234           Definitely check out the <i>FlightGear Installation and Getting
 235           Started</i> document available from the aforementioned location.</p>
 236           <p>Also see the <code>FlightGear/docs-mini/</code> directory in the
 237           source distribution for various other helpful documents.</p>
 238         </div>
 239
 240
 241     <hr>
 242     <h2>
 243       <a name="2">2 -
 244     Distribution</a>
 245     </h2>
 246         <b>
 247       <a name="2.1">2.1 -
 248     <u>Where can I get FlightGear?</u>
 249       </a>
 250     </b>
 251         <div class="indent">
 252           <p>The official download page is
 253           <a href="http://flightgear.org/Downloads/">http://flightgear.org/Downloads/</a>.
 254           Source code is our primary form of distribution, but precompiled
 255           binaries are available for Windows and SGI IRIX.</p>
 256           <p>Alternatively, FlightGear is packaged for Linux by SuSE, Debian
 257           (sid), and Mandrake (Cooker) and can be directly installed through
 258           those distributions.</p>
 259         </div>
 260
 261         <b>
 262       <a name="2.2">2.2 -
 263     <u>What is the password for the FTP server?</u>
 264       </a>
 265     </b>
 266         <div class="indent">
 267           <p>The FTP server uses standard anonymous login procedures.  Login
 268           with the username "anonymous" and use your email address as the
 269           password.  Most FTP clients and web browsers will do this
 270           automatically for you.</p>
 271         </div>
 272
 273         <b>
 274       <a name="2.3">2.3 -
 275     <u>Why won't the FTP server let me in with the right login info?</u>
 276       </a>
 277     </b>
 278         <div class="indent">
 279           <p>This generally means that the server is at it's capacity.  You
 280           should receive a message saying such, but your FTP client may be
 281           hiding it from you.  Your options are to keep trying until a slot
 282           opens up or try connecting to one of our <i>FTP</i> mirrors listed at
 283           <a href="http://flightgear.org/mirrors.html">http://flightgear.org/mirrors.html</a>.</p>
 284         </div>
 285
 286         <b>
 287       <a name="2.4">2.4 -
 288     <u>Where can I find the latest development source code?</u>
 289       </a>
 290     </b>
 291         <div class="indent">
 292           <p>The latest development code is available for everyone through our
 293           CVS repository.  See
 294           <a href="http://flightgear.org/cvsResources/">http://flightgear.org/cvsResources/</a> for details.
 295           </p>
 296           <p>Otherwise, you can get relatively up-to-date snapshots of the
 297           development tree at
 298           <a href="ftp://flightgear.sourceforge.net/pub/flightgear/Devel/Snapshots/">ftp://flightgear.sourceforge.net/pub/flightgear/Devel/Snapshots/</a>.
 299           </p>
 300         </div>
 301
 302         <b>
 303       <a name="2.5">2.5 -
 304     <u>What is SimGear, and why do I need it?</u>
 305       </a>
 306     </b>
 307         <div class="indent">
 308           <p>SimGear is a library of supporting code.  SimGear is only needed
 309           if you plan on compiling FlightGear -- it is not needed to run
 310           precompiled binaries.  For more information see
 311           <a href="http://www.simgear.org/">http://www.simgear.org/</a>.</p>
 312         </div>
 313
 314         <b>
 315       <a name="2.6">2.6 -
 316     <u>Where can I fly and where do I get the scenery?</u>
 317       </a>
 318     </b>
 319         <div class="indent">
 320           <p>While the base package only comes with scenery for the San Francisco
 321           Bay area, you can currently fly just about anywhere in the world.
 322           See the <i>"Additional Scenery"</i> section of
 323           <a href="http://flightgear.org/Downloads/">http://flightgear.org/Downloads/</a>
 324           for more information or go directly to our graphical downloader at
 325           <a href="http://flightgear.org/Downloads/world-scenery.html">http://flightgear.org/Downloads/world-scenery.html</a>.
 326           </p>
 327           <p>Also visit our <i>"Places to Fly"</i> section of the website
 328           (<a href="http://flightgear.org/Places/">http://flightgear.org/Places/</a>)
 329           for some help navigating to some awesome locations.</p>
 330         </div>
 331
 332         <b>
 333       <a name="2.7">2.7 -
 334     <u>Where can I get different 3D models for my plane?</u>
 335       </a>
 336     </b>
 337         <div class="indent">
 338           <p>While we are working toward building our own 3D models, we have
 339           been given permission by several people to convert their models (which
 340           where originally intended for use with <i>Microsoft Flight
 341           Simulator</i>) to use with FlightGear.  See Wolfram's Hangar
 342           (<a href="http://home.t-online.de/home/Wolfram.Kuss/">http://home.t-online.de/home/Wolfram.Kuss/</a>)
 343           for a list of what we currently have available as well as
 344           information on how to convert models yourself.</p>
 345         </div>
 346
 347         <b>
 348       <a name="2.8">2.8 -
 349     <u>How current is the data in FlightGear compared to the real world?</u>
 350       </a>
 351     </b>
 352         <div class="indent">
 353           <p>We use the same navaid and airport dataset that <i>X-Plane</i> uses.  The
 354           current dataset can be found in the <code>$FGROOT/Navaids/</code> and
 355           <code>$FGROOT/Airports/</code> directories.  If you have updates or
 356           corrections to the dataset, see
 357           <a href="http://flightgear.org/Docs/AirNav/AptNavFAQ.FlightGear.html">http://flightgear.org/Docs/AirNav/AptNavFAQ.FlightGear.html</a>
 358           for instructions on contacting the database maintainer.</p>
 359         </div>
 360
 361         <b>
 362       <a name="2.9">2.9 -
 363     <u>Where is the moving map?</u>
 364       </a>
 365     </b>
 366         <div class="indent">
 367           <p>A popular moving map display is avaliable under a separate
 368           project called <i>Atlas</i>.  See
 369           <a href="http://atlas.sf.net/">http://atlas.sf.net/</a>.</p>
 370         </div>
 371
 372         <b>
 373       <a name="2.10">2.10 -
 374     <u>Why don't you charge money for this?</u>
 375       </a>
 376     </b>
 377         <div class="indent">
 378           <p>We could do that, since the initial download is about 25
 379           megabytes.  Especially for people who have to pay per-minute charges
 380           for internet access, buying a CD is a convenient and possibly
 381           cheaper option.  Although we offer that service (see the website), we
 382           encourage other groups to redistribute it for their users, especially
 383           within an operating system distribution which makes installation even
 384           faster and easier for new users.</p>
 385         </div>
 386
 387
 388     <hr>
 389     <h2>
 390       <a name="3">3 -
 391     Compiling</a>
 392     </h2>
 393         <b>
 394       <a name="3.1">3.1 -
 395     <u>Why won't FlightGear compile?</u>
 396       </a>
 397     </b>
 398         <div class="indent">
 399           <p>Well, that depends.  First make sure you are using the appropriate
 400           versions of FlightGear, SimGear, plib, zlib, and metakit.  If any of
 401           the packages are out of sync with the others, compilation may fail.</p>
 402           <p>The FlightGear <i>Downloads</i> page
 403           (<a href="http://flightgear.org/Downloads/">http://flightgear.org/Downloads/</a>)
 404           should tell you what versions you need if you are trying to compile
 405           the latest stable release.  If you are using a development snapshot,
 406           make sure all three packages are up-to-date.</p>
 407           <p>Also ensure that you have some implementation of OpenGL with glut
 408           support with the appropriate header files.  Linux users with nVidia
 409           cards should make sure you have the latest drivers from nVidia.  Other
 410           Linux users make sure you have Mesa3D
 411           (<a href="http://mesa3d.org/">http://mesa3d.org/</a>)
 412           and your X server installed correctly.  Windows users see
 413           <a href="http://www.x-plane.com/SYSREQ/v5ibm.html">http://www.x-plane.com/SYSREQ/v5ibm.html</a>,
 414           and Mac users see
 415           <a href="http://www.x-plane.com/SYSREQ/v5mac.html">http://www.x-plane.com/SYSREQ/v5mac.html</a>.
 416           </p>
 417           <p>If your problems persist, subscribe to our FlightGear-Users mailing
 418           list and let us know what problem you're having.  See
 419           <a href="http://flightgear.org/mail.html">http://flightgear.org/mail.html</a> for help with this.
 420           </p>
 421         </div>
 422
 423         <b>
 424       <a name="3.2">3.2 -
 425     <u>I'm using RedHat 7, and ...?</u>
 426       </a>
 427     </b>
 428         <div class="indent">
 429           <p>Update your gcc packages.  See
 430           <a href="http://redhat.com/errata/">http://redhat.com/errata/</a>
 431           to fix it and
 432           <a href="http://www.gnu.org/software/gcc/gcc-2.96.html">http://www.gnu.org/software/gcc/gcc-2.96.html</a>
 433           for an explanation why.</p>
 434         </div>
 435
 436
 437     <hr>
 438     <h2>
 439       <a name="4">4 -
 440     Configuring</a>
 441     </h2>
 442         <b>
 443       <a name="4.1">4.1 -
 444     <u>How do I install new scenery?</u>
 445       </a>
 446     </b>
 447         <div class="indent">
 448           <p>The scenery archive files (ie. w100n30.tar.gz) should be untarred
 449           into the <code>Scenery/</code> directory in your
 450           <code>$FG_ROOT</code>.</p>
 451         </div>
 452
 453         <b>
 454       <a name="4.2">4.2 -
 455     <u>How do I setup my joystick(s)?</u>
 456       </a>
 457     </b>
 458         <div class="indent">
 459           <p>FlightGear should come with a helpful program called <i>`fgjs`</i>
 460           that can help configure your joystick.  Run <i>`fgjs`</i> and then
 461           copy the dot file it created into your home directory or add its
 462           contents to your existing rc file.</p>
 463           <p>Also, see the README.Joystick file located in the
 464           <code>FlightGear/docs-mini/</code> directory of the source
 465           distribution.  This document is mirrored at
 466           <a href="http://rockfish.net/fg/README.Joystick">http://rockfish.net/fg/README.Joystick</a>.
 467           </p>
 468         </div>
 469
 470         <b>
 471       <a name="4.3">4.3 -
 472     <u>What format should my personal .fgfsrc file be in?</u>
 473       </a>
 474     </b>
 475         <div class="indent">
 476           <p>Your <code>.fgfsrc</code> file should simply be a list of
 477           command-line options with one option per line.  The file is <b>not</b>
 478           an XML file.</p>
 479           <p>If you would rather use an XML configuration file, you can add
 480           something like the following in your <code>.fgfsrc</code>
 481       </p>
 482           <p>
 483         <code>--config=/path/to/my/config.xml</code>
 484       </p>
 485           <p>Almost every option corresponds to a property, so you can choose
 486           to use whichever method best suits your needs.</p>
 487         </div>
 488
 489
 490     <hr>
 491     <h2>
 492       <a name="5">5 -
 493     Running</a>
 494     </h2>
 495         <b>
 496       <a name="5.1">5.1 -
 497     <u>Why do I get an error loading libmk4.so.0?</u>
 498       </a>
 499     </b>
 500         <div class="indent">
 501           <p>With the default installation, libmk4.so.0 is installed into
 502           <code>/usr/local/lib</code>.  You need to ensure that that path is
 503           listed in <code>/etc/ld.so.conf</code>, then run <i>`ldconfig`</i>as
 504           root.</p>
 505         </div>
 506
 507         <b>
 508       <a name="5.2">5.2 -
 509     <u>Why do I get "ssgInit called without a valid OpenGL context"?</u>
 510       </a>
 511     </b>
 512         <div class="indent">
 513           <p>In short, your GL libraries are broken.  So far only Red Hat 7.x
 514           users have experienced this (see
 515           <a href="http://www.redhat.com/bugzilla/show_bug.cgi?id=18867">http://www.redhat.com/bugzilla/show_bug.cgi?id=18867</a>).
 516           The only solutions are possibly complicated ones: you can either
 517           change distributions (most of us prefer Debian) or upgrade/downgrade
 518           your Mesa libs.</p>
 519           <p>
 520         <i>
 521           <u>Why do some other GL applications work though?</u>
 522         </i>  Well,
 523           Steve Baker (Mr. PLIB) has explained this on the plib-users list
 524           (<a href="http://www.geocrawler.com/lists/3/SourceForge/1867/0/6470648/">http://www.geocrawler.com/lists/3/SourceForge/1867/0/6470648/</a>).
 525           </p>
 526         </div>
 527
 528         <b>
 529       <a name="5.3">5.3 -
 530     <u>What happened to the panel, keyboard, etc?</u>
 531       </a>
 532     </b>
 533         <div class="indent">
 534           <p>The problem is almost certainly that your base package is out of
 535           sync with FlightGear.  Many configurable parts of FlightGear are
 536           defined in XML files contained in the base package.</p>
 537         </div>
 538
 539         <b>
 540       <a name="5.4">5.4 -
 541     <u>Why doesn't audio work properly under Irix?</u>
 542       </a>
 543     </b>
 544         <div class="indent">
 545           <p>FlightGear (as of June 2001) uses the Portable Libraries (PLIB)
 546           for playing audio. The audio queue implementation of PLIB is far from
 547           optimal (in fact it's just wrong).  This seems to work on other
 548           platforms quite well, but Irix expects things to be programmed
 549           properly.</p>
 550           <p>There has been discussion about using OpenAL
 551           (<a href="http://www.openal.org/">http://www.openal.org/</a>)
 552           for the next release of both PLIB and FlightGear.  Tests show that
 553           the OpenAL audio implementation does the job right, meaning that
 554           these audio problems should be gone by then. In the mean time it is
 555           best to disable audio on Irix completely (by adding --disable-sound
 556           either on the command line or to your <code>$HOME/.fgfsrc</code>
 557           file).</p>
 558         </div>
 559
 560         <b>
 561       <a name="5.5">5.5 -
 562     <u>Why is FlightGear so slow?</u>
 563       </a>
 564     </b>
 565         <div class="indent">
 566           <p>FlightGear supports hardware acceleration, but it seems not to be
 567           activated.  Make sure you have OpenGL libraries installed and
 568           configured properly and make sure you have the latest drivers for your
 569           video card.</p>
 570           <p>
 571         <b>Linux users</b>:  If you are an nVidia user, follow their
 572           directions on getting your card working.  For most other users, make
 573           sure Mesa is installed property and ensure that you have the
 574           appropriate kernel device drivers for your card.  Most people (and
 575           distributions) use modules for their video card device drivers; run
 576           <i>`lsmod`</i> as root to see what modules are loaded.  You should also
 577           make sure that you are loading the appropriate modules in your
 578           XF86Config and that your video device section is correct.  Now try
 579           running an OpenGL application (other than FlightGear) to see how it
 580           performs.  You can try the <i>gears</i> demo from Mesa or something
 581           like <i>Quake3</i>.</p>
 582         </div>
 583
 584         <b>
 585       <a name="5.6">5.6 -
 586     <u>Why is my SGI machine so slow?</u>
 587       </a>
 588     </b>
 589         <div class="indent">
 590           <p>First of all, one of the most common mistakes on SGI hardware is to
 591           forget to specify --fog-fastest. On most SGI machines the EXP2 shading
 592           model isn't hardware supported resulting in frame rates below 1 frame
 593           per second (fps).</p>
 594           <p>FlightGear makes extensive use of the OpenGL z-buffer feature,which
 595           on most older SGI hardware is only supported in software. This means
 596           that the CPU has to do all the z-buffer calculations in addition to the
 597           other tasks FlightGear involves (flight dynamics, scenery tracking,
 598           pushing commands into the graphics queue, etc).  The following features
 599           are software rendered on low-end SGI machines (like Indy and
 600           Indigo):</p>
 601           <ul>
 602             <li>stencil and accumulation buffer</li>
 603             <li>depth queuing and depth buffering</li>
 604             <li>fogging, lighting, clipping and transforms</li>
 605             <li>texturing</li>
 606           </ul>
 607           <p>This means that running FlightGear with the following options may not
 608           even get the desired result:</p>
 609           <p>
 610         <code>./runfgfs --fog-disable --shading-flat --disable-skyblend \</code>
 611         <br>
 612           <code>--disable-textures --disable-clouds --disable-sound \</code>
 613         <br>
 614           <code>--disable-panel --enable-hud --disable-anti-alias-hud</code>
 615       </p>
 616           <p>I could even imagine that adding --enable-wireframe doesn't work on
 617           these machines (I would be happy to be proven wrong though).</p>
 618           <p>On a machine like O2 the following options give an acceptable
 619           result:</p>
 620           <code>./runfgfs --fog-fastest --disable-sound</code>
 621           <p>Since I don't have access to other SGI hardware I can't tell which
 622           options would be appropriate for your situation.</p>
 623         </div>
 624
 625         <b>
 626       <a name="5.7">5.7 -
 627     <u>How do I see the frame rate?</u>
 628       </a>
 629     </b>
 630         <div class="indent">
 631           <p>There are two ways.  One way is to hide the panel without the HUD
 632           showing.  To hide the panel, use <i>Shift+P</i>; To make the HUD
 633           disappear, use <i>H</i>.  The second way is to use the alternative
 634           HUD by <i>Shift+I</i> (Use <i>I</i> to switch back).</p>
 635         </div>
 636
 637         <b>
 638       <a name="5.8">5.8 -
 639     <u>Stuck upside down after "crash"?</u>
 640       </a>
 641     </b>
 642         <div class="indent">
 643           <p>In his infinite wisdom the FlightGear Grand Master decided that
 644           planes were to valuable to allow them to be destroyed by novice pilots
 645           who seemed to crash a lot.  The fact that nobody has bothered to model
 646           crashes may have something to do with it too.  :-)</p>
 647           <p>The result of this as you have noticed is that with a little
 648           practice an ingenuity you can trim the ship to fly inverted along the
 649           ground.</p>
 650           <p>The quick answer is to hit Ctrl+U (with the default key bindings)
 651           to warp the plane up 1000ft.</p>
 652           <p>For the stubborn people out there:  The trick to learn is to roll
 653           back to normal (non inverted) do this by nursing the elevator to get
 654           to about 500 feet or so and use the ailerons to snap roll 180*.
 655           This is all good avionics except for the plane not destroying
 656           itself.  Remember the controls work in reverse when you are inverted
 657           and keep that airspeed up!!!</p>
 658         </div>
 659
 660         <b>
 661       <a name="5.9">5.9 -
 662     <u>Why does FlightGear die on startup saying "time zone reading failed"?</u>
 663       </a>
 664     </b>
 665         <div class="indent">
 666           <p>This is probably caused by a line-ending problem in the timezone
 667           files.  Win32 users can resolve the problem by downloading a DOS to
 668           UNIX conversion utility available at
 669           <a href="http://www.nottingham.ac.uk/~eazdluf/d2u.zip">http://www.nottingham.ac.uk/~eazdluf/d2u.zip</a>.
 670           Run as `<i>d2u *.tab</i>` from within the timezone directory to fix
 671           your timezone files.</p>
 672         </div>
 673
 674
 675     <hr>
 676     <h2>
 677       <a name="6">6 -
 678     Hacking</a>
 679     </h2>
 680         <b>
 681       <a name="6.1">6.1 -
 682     <u>What language is FlightGear written in?</u>
 683       </a>
 684     </b>
 685         <div class="indent">
 686           <p>Mostly C++ with some supporting C code that's primary contained
 687           within SimGear.</p>
 688         </div>
 689
 690         <b>
 691       <a name="6.2">6.2 -
 692     <u>How do I design a flight dynamics model for a new aircraft?</u>
 693       </a>
 694     </b>
 695         <div class="indent">
 696           <p>To define an aircraft for FlightGear's primary FDM (JSBSIM),
 697           see <a href="http://jsbsim.sf.net/">http://jsbsim.sf.net/</a>.</p>
 698           <p>If you want a simpler FDM to work with, try your hand at YASim,
 699           an alternative FDM.  For an guide on creating a YASim aircraft,
 700           look in the FlightGear base package for
 701           <code>Aircraft-yasim/README.yasim</code>.</p>
 702         </div>
 703
 704         <b>
 705       <a name="6.3">6.3 -
 706     <u>How do I import planes from Microsoft Flight Simulator?</u>
 707       </a>
 708     </b>
 709         <div class="indent">
 710           <p>You can import the 3D model and textures, but the flight dynamics
 711           (the .AIR file) must be completely redone for FlightGear.  See
 712           <a href="http://home.t-online.de/home/Wolfram.Kuss/">http://home.t-online.de/home/Wolfram.Kuss/</a>
 713           for help importing .MDL files and textures.</p>
 714           <p>If you wish to import a model made with gmax, you will need to
 715           convert it to .MDL format using <i>Microsoft's MakeMDL SDK</i> which
 716           is available at
 717           <a href="http://zone.msn.com/flightsim/FS02DevDeskSDK08.asp">http://zone.msn.com/flightsim/FS02DevDeskSDK08.asp</a>.
 718           </p>
 719         </div>
 720
 721         <b>
 722       <a name="6.4">6.4 -
 723     <u>How do I import BGL scenery from Microsoft Flight Simulator?</u>
 724       </a>
 725     </b>
 726         <div class="indent">
 727           <p>See
 728           <a href="http://chiangt.virtualave.net/BGL/bgl_index.html">http://chiangt.virtualave.net/BGL/bgl_index.html</a>.
 729           </p>
 730         </div>
 731
 732         <b>
 733       <a name="6.5">6.5 -
 734     <u>How do I design or modify a panel?</u>
 735       </a>
 736     </b>
 737         <div class="indent">
 738           <p>See the README.xmlpanel file located in the
 739           <code>FlightGear/docs-mini/</code> directory of the source
 740           distribution.  This document is mirrored at
 741           <a href="http://rockfish.net/fg/README.xmlpanel">http://rockfish.net/fg/README.xmlpanel</a>.
 742           </p>
 743         </div>
 744
 745         <b>
 746       <a name="6.6">6.6 -
 747     <u>How do I place objects, like buildings, into FlightGear?</u>
 748       </a>
 749     </b>
 750         <div class="indent">
 751           <p>First, ensure that you have v0.7.7 or later, the scenery files
 752           where you plan to place the object, the actual model, and the
 753           longitude and latitude where you plan to place the object.</p>
 754           <p>Now get the altitude for your point.  If you don't want to
 755           calculate this yourself, start FlightGear at your location and take
 756           note of the altitude.  Here's an example command:</p>
 757           <p>
 758         <code>fgfs --lat=45.50 --lon=-75.73 2&gt;&amp;1 | tee fgfs.log</code>
 759       </p>
 760           <p>The altitude is probably in feet, so divide the starting altitude
 761           by 3.28.</p>
 762           <p>Search the output log file for the first occurrence of the string
 763           "Loading tile" and take note of the filename.  In the above example,
 764           the output line looks like:</p>
 765           <p>
 766         <code>Loading tile /usr/local/Scenery/w080n40/w076n45/1712601</code>
 767       </p>
 768           <p>Copy a 3D model in a format that Plib understands to the same
 769           directory as the tile file.  Edit the text file in that directory
 770           consisting of the tile name with the extension ".stg".  The file will
 771           already exist if there is an airport on the tile; otherwise, you can
 772           create it from scratch.  In our example, the filename is:</p>
 773           <p>
 774         <code>/usr/local/Scenery/w080n40/w076n45/1712601.stg</code>
 775       </p>
 776           <p>At the end of the file, add a new entry for your object,
 777           consisting of the word "OBJECT_STATIC" followed by the model name,
 778           the longitude in degrees, the latitude in degrees, the altitude in
 779           meters, and the heading in degrees.  In our example the line looks
 780           like:</p>
 781           <p>
 782         <code>OBJECT_STATIC Towerax.ac -75.73 45.40 60 0</code>
 783       </p>
 784           <p>Save the changes to the .stg file, restart FlightGear, and
 785           enjoy.</p>
 786           <p>NOTE: The above information was taken from the following mailing
 787           list post:
 788           <a href="http://www.geocrawler.com/archives/3/11854/2001/6/0/5991409/">http://www.geocrawler.com/archives/3/11854/2001/6/0/5991409/</a>.
 789           See that page if this one doesn't make sense.</p>
 790           <p>An alternative approach using PPE is described at
 791           <a href="http://mail.flightgear.org/pipermail/flightgear-devel/2001-December/002239.html">http://mail.flightgear.org/pipermail/flightgear-devel/2001-December/002239.html</a>
 792           by Norman Vine.</p>
 793         </div>
 794
 795         <b>
 796       <a name="6.7">6.7 -
 797     <u>Where can I learn 3D programming and how do I get involved?</u>
 798       </a>
 799     </b>
 800         <div class="indent">
 801           <p>Contributing to the 2D panel doesn't require any coding at all,
 802           just a minimal knowledge of XML syntax (i.e. five minutes' worth)
 803           and good skills with drawing and/or paint programs.  Every instrument
 804           on the current panel, with the partial exception of the magnetic
 805           compass, is defined entirely in XML with no custom C++  code.  If
 806           you want to get started, take a look at John Check's excellent intro
 807           (<a href="http://rockfish.net/fg/README.xmlpanel">http://rockfish.net/fg/README.xmlpanel</a>).
 808           </p>
 809           <p>Likewise, if you want to create a 3D cockpit for FlightGear, or to
 810           create buildings, external aircraft models, etc., your help is
 811           *desperately* needed.  The only rule is to go easy on the triangles
 812           -- a model with 50,000 triangles probably won't be usable in
 813           FlightGear, and one with 5,000 triangles, only marginally.  If you
 814           can design a nice 3D cockpit interior for a Cessna 172 (for example)
 815           in a 3D design program such as ac3D or ppe, we have coders who will
 816           be happy to add the support code in the C++.</p>
 817           <p>If, on the other hand, you really want to get your hands dirty
 818           with C++ coding, you'll have to buy a good OpenGL book eventually.
 819           However, FlightGear uses a high-level library, plib, that hides most
 820           of the details of OpenGL.  To get started with 3D C++ coding, you
 821           can take a look at the plib documentation and learn only as much
 822           OpenGL as you need, when you need it.</p>
 823         </div>
 824
 825         <b>
 826       <a name="6.8">6.8 -
 827     <u>How do I add an airport?</u>
 828       </a>
 829     </b>
 830         <div class="indent">
 831           <p>You can add your airport to the
 832           <code>$FGROOT/Airports/default.apt.gz</code> file, but to get the
 833           airport to show up visually, you will have to rebuild the scenery
 834           around the airport.  The format of the default.apt file is
 835           documented at
 836           <a href="http://flightgear.org/Docs/AirNav/AptNavFAQ.FlightGear.html">http://flightgear.org/Docs/AirNav/AptNavFAQ.FlightGear.html</a>.</p>
 837         </div>
 838
 839         <b>
 840       <a name="6.9">6.9 -
 841     <u>How do I generate my own scenery?</u>
 842       </a>
 843     </b>
 844         <div class="indent">
 845           <p>Yes, though it can be a difficult task.  FlightGear's scenery
 846           generation is handled by a sister project, TerraGear.  For more
 847           details, see
 848           <a href="http://terragear.org/">http://terragear.org/</a>.</p>
 849         </div>
 850
 851
 852     <hr>
 853     <h2>
 854       <a name="7">7 -
 855     Flying</a>
 856     </h2>
 857         <b>
 858       <a name="7.1">7.1 -
 859     <u>Where can I learn about instrument flying and navigation?</u>
 860       </a>
 861     </b>
 862         <div class="indent">
 863           <p>
 864           <a href="http://www.navfltsm.addr.com/">http://www.navfltsm.addr.com/</a>
 865           is a very good site for learning techniques for navigation.  Also see
 866           <a href="http://www.monmouth.com/~jsd/how/">http://www.monmouth.com/~jsd/how/</a>.
 867           </p>
 868         </div>
 869
 870         <b>
 871       <a name="7.2">7.2 -
 872     <u>What is the difference between Aileron and Rudder?</u>
 873       </a>
 874     </b>
 875         <div class="indent">
 876           <p>There is a bit of info on aileron vs. rudder here:
 877           <a href="http://www.monmouth.com/~jsd/how/">http://www.monmouth.com/~jsd/how/</a>.
 878           </p>
 879         </div>
 880
 881         <b>
 882       <a name="7.3">7.3 -
 883     <u>Is there support for multi-player flying?</u>
 884       </a>
 885     </b>
 886         <div class="indent">
 887           <p>We have an initial stab at this that is incomplete and only seems
 888           to work under Linux.  We'd love to find someone to pick up the
 889           slack here and develop this further.  Specifically, plib now has
 890           some low level networking support for mult-player games.  It would
 891           also be nice to develop support for the DIS protocol.</p>
 892         </div>
 893
 894         <b>
 895       <a name="7.4">7.4 -
 896     <u>Is there support for any military scenarios like dog fighting or bomb dropping?</u>
 897       </a>
 898     </b>
 899         <div class="indent">
 900           <p>No, not at this time.  Most of our developers are primarily
 901           interested and focused on civilian aviation.  We aren't explicitly
 902           excluding these features -- we just haven't had anyone who seriously
 903           wanted to develop these areas.</p>
 904         </div>
 905
 906
 907     <hr>
 908     <h2>
 909       <a name="8">8 -
 910     FlightGear v0.7.6</a>
 911     </h2>
 912         <b>
 913       <a name="8.1">8.1 -
 914     <u>Why do I get an error in viewer.cxx about `exit' being undeclared?</u>
 915       </a>
 916     </b>
 917         <div class="indent">
 918           <p>This error cropped up after the release of v0.7.6.  To fix the
 919           problem, add "<code>#include &lt;stdlib.h&gt;</code>" to the top of viewer.cxx.</p>
 920         </div>
 921
 922
 923
 924 <hr noshade>
 925     <a name="about">
 926       <h2>About This Document</h2>
 927     </a>
 928     <b>FlightGear FAQ</b>
 929     <br>$Revision$<br>$Date$<br>
 930     <p>
 931       <small>
 932         This document generated from XML using
 933         <a href="http://gingerall.com/charlie/ga/xml/p_sab.xml">Sablotron</a>.
 934       </small>
 935     </p>
 936     <address>Cameron Moore<br>cameron@unbeatenpath.net<br>
 937     </address>
 938   </body>
 939   <!-- vim: set ts=2 et nowrap: -->
 940 </html>