%% %% getstart.tex -- Flight Gear documentation: Installation and Getting Started %% Chapter file %% %% Written by Michael Basler, started September 1998. %% %% Copyright (C) 1999 Michael Basler (pmb@knUUt.de) %% %% %% This program is free software; you can redistribute it and/or %% modify it under the terms of the GNU General Public License as %% published by the Free Software Foundation; either version 2 of the %% License, or (at your option) any later version. %% %% This program is distributed in the hope that it will be useful, but %% WITHOUT ANY WARRANTY; without even the implied warranty of %% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU %% General Public License for more details. %% %% You should have received a copy of the GNU General Public License %% along with this program; if not, write to the Free Software %% Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. %% %% $Id: getstart.tex,v 0.12 1999/03/07 michael %% (Log is kept at end of this file) %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \chapter{Landing: Some further thoughts before leaving the plane\label{landing}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \markboth{\thechapter.\hspace*{1mm} LANDING}{\thesection\hspace*{1mm} THOSE, WHO DID THE WORK} \section{Those, who did the work} Did you enjoy the flight? In case you did, don't forget those who devoted hundreds of hours to that project. All of this work is done on a voluntary basis within spare time, thus bare with the \Index{programmers} in case something does not work the way you want it to. Instead, sit down and write them a kind (!) letter proposing what to change. Alternatively, you can subscribe to the \FlightGear \Index{mailing lists} and contribute your thoughts there. Instructions to do so can be found under \web{http://www.flightgear.org/mail.html}. Essentially there are two lists, one of which being mainly for the developers and the other one for users. \noindent These are the people who did the job (This information was essentially taken from the file \texttt{Thanks} accompanying the code): \medskip \noindent Raul Alonzo\index{Alonzo, Raul} (\mail{amil@las.es})\\ Author of Ssystem and moon texture. \medskip \noindent Michele America\index{America, Michele} (\mail{nomimarketing@mail.telepac.pt})\\ Contributed to the \Index{HUD} code. \medskip \noindent Steve Baker\index{Baker, Steve} (\mail{sjbaker@hti.com})\\ Author of \Index{PUI} (a graphical interface written entirely on top of \Index{OpenGL}/\-\Index{GLUT}). Author of the basic \Index{audio library} used in \FlightGear. An immense amount of coaching and tutelage, both on the subjects of flight simulation and \Index{OpenGL}. It has been his comments and thoughts that have prompted the implementation of most of the more sophisticated features of \FlightGear{\hspace{-2mm}}. \medskip \noindent Michael Basler\index{Basler, Michael} (\mail{pmb@knUUt.de})\\ Coauthor of Installation and Getting Started (together with Bernhard Buckel). \medskip \noindent John S. Berndt\index{Berndt, John, S.} (\mail{jsb@hal-pc.org})\\ Working on a complete C++rewrite/reimplimentation of the core FDM. Initially he is using X15 data to test his code, but once things are all in place we should be able to simulator arbitrary aircraft. \medskip \noindent Paul Bleisch\index{Bleisch, Paul} (\mail{pbleisch@acm.org})\\ Paul redid the debug system so that it would be much more flexible, so it could be easily disabled for production system, and so that messages for certain subsystems could be selectively enabled. Also contributed a first stab at a config file/command line parsing system. \medskip \noindent Jim Brennan\index{Brennan, Jim} (\mail{jjb@foothill.net})\\ Provided a big chunk of online space to store USA scenery for Flight Gear. \medskip \noindent Bernie Bright\index{Bright, Bernie} (\mail{bbright@c031.aone.net.au})\\ Many C++ style, usage, and implementation improvements, STL portability and much, much more. \medskip \noindent Bernhard H. Buckel\index{Buckel, Bernhard H.} (\mail{buckel@wmad95.mathematik.uni-wuerzburg.de})\\ Contributed the README.Linux. Coauthor of Installation and Getting Started (together with Michael Basler). \medskip \noindent Gene Buckle\index{Buckle, Gene} (\mail{geneb@nwlink.com})\\ Gene has done a lot of work getting \FlightGear to compile with the \Index{MSVC}++ compiler. Numerous hints on detailed improvements. \medskip \noindent Didier Chauveau\index{Chauveau, Didier} (\mail{chauveau@math.univ-mlv.fr})\\ Provided some initial code to parse the 30 arcsec DEM files found at: \web{http://edcwww.cr.usgs.gov/landdaac/gtopo30/gtopo30.html}. \medskip \noindent Jean-Francois Doue\index{Doue, Jean-Francois}\\ Vector 2D, 3D, 4D and Matrix 3D and 4D inlined C++ classes. (Based on Graphics Gems IV ed. Paul S. Heckbert) \href{http://www.animats.com/simpleppp/ftp/public_html/topics/developers.html}{http://www.animats.com/simpleppp/ftp/public\_html/topics/developers.html}. \medskip \noindent Francine Evans\index{Evans, Francine} (\mail{evans@cs.sunysb.edu}) \href{http://www.cs.sunysb.edu/~evans/stripe.html}{http://www.cs.sunysb.edu/\~{}evans/stripe.html} \noindent Wrote the GPL'd tri-striper. \medskip \noindent Oscar Everitt\index{Everitt, Oscar} (\mail{bigoc@premier.net})\\ Created single engine piston engine sounds as part of an F4U package for \Index{FS98}. They are pretty cool and Oscar was happy to contribute them to our little project. \medskip \noindent Jean-loup Gailly\index{Gailly, Jean-loup} and Mark Adler\index{Adler, Mark} (\mail{zlib@quest.jpl.nasa.gov})\\ Authors of the \Index{zlib library}. Used for on-the-fly compression and decompression routines, \web{http://www.cdrom.com/pub/infozip/zlib/}. \medskip \noindent Thomas Gellekum\index{Gellekum, Thomas} (\mail{tg@ihf.rwth-aachen.de})\\ Changes and updates for compiling on \Index{FreeBSD}. \medskip \noindent Jeff Goeke-Smith\index{Goeke-Smith, Jeff} (\mail{jgoeke@voyager.net})\\ Contributed our first \Index{autopilot} (Heading Hold). Better autoconf check for external timezone/daylight variables. \medskip \noindent Michael I. Gold\index{Gold, Michael, I.} (\mail{gold@puck.asd.sgi.com})\\ Patiently answered questions on \Index{OpenGL}. \medskip \noindent Charlie Hotchkiss\index{Hotchkiss, Charlie} (\mail{chotchkiss@namg.us.anritsu.com})\\ Worked on improving and enhancing the \Index{HUD} code. Lots of code style tips and code tweaks\ldots \medskip \noindent Bruce Jackson\index{Jackson, Bruce} (NASA) (\mail{e.b.jackson@larc.nasa.gov}) \web{http://agcbwww.larc.nasa.gov/People/ebj.html} \noindent Developed the \Index{LaRCsim} code under funding by NASA which we use to provide the flight model. Bruce has patiently answered many, many questions. \medskip \noindent Tom Knienieder\index{Knienieder, Tom} (\mail{knienieder@ms.netwing.at})\\ Ported Steve Bakers's audio library\index{audio library} to Win32. \medskip \noindent Reto Koradi\index{Koradi, Reto} (\mail{kor@mol.biol.ethz.ch}) \href{\web{http://www.mol.biol.ethz.ch/~kor}}{\web{http://www.mol.biol.ethz.ch/\~{}kor}} \noindent Helped with setting up \Index{fog effects}. \medskip \noindent Bob Kuehne\index{Kuehne, Bob} (\mail{rpk@sgi.com})\\ Redid the Makefile system so it is simpler and more robust. \medskip \noindent Vasily Lewis\index{Lewis, Vasily} (\mail{vlewis@woodsoup.org}) \web{http://www.woodsoup.org} \noindent Provided computing resources and services so that the Flight Gear project could have real home. This includes web services, ftp services, shell accounts, email lists, dns services, etc. \medskip \noindent Eric Mitchell\index{Mitchell, Eric} (\mail{mitchell@mars.ark.com})\\ Contributed some topnotch scenery \Index{textures}. \medskip \noindent Anders Morken\index{Morken, Anders} (\mail{amrken@online.no})\\ Maintains the European mirror of the \FlightGear web pages. \medskip \noindent Alan Murta\index{Murta, Alan} (\mail{amurta@cs.man.ac.uk}) \web{http://www.cs.man.ac.uk/aig/staff/alan/software/} \noindent Created the Generic Polygon Clipping library. \medskip \noindent Curt Olson\index{Olson, Curt} (\mail{curt@flightgear.org})\\ Primary organization of the project. First implementation and modifications based on \Index{LaRCsim}. Besides putting together all the pieces provided by others mainly concentrating on the \Index{scenery engine} as well as the graphics stuff. \medskip \noindent Friedemann Reinhard\index{Reinhard, Friedemann} (\mail{mpt218@faupt212.physik.uni-erlangen.de})\\ Development of textured instrument \Index{panel}. \medskip \noindent Petter Reinholdtsen\index{Reinholdtsen, Petter} (\mail{pere@games.no})\\ Incorporated the Gnu automake/autoconf system (with libtool). This should streamline and standardize the build process for all UNIX-like platforms. It should have little effect on IDE type environments since they don't use the UNIX make system. \medskip \noindent William Riley\index{Riley, William} (\mail{riley@technologist.com})\\ Contributed code to add ''brakes''. \medskip \noindent Paul Schlyter\index{Schlyter, Paul} (\mail{pausch@saaf.se})\\ Provided Durk Talsma with all the information he needed to write the astro code. \medskip \noindent Chris Schoeneman\index{Schoenemann, Chris} (\mail{crs@millpond.engr.sgi.com})\\ Contributed ideas on audio support. \medskip \noindent Jonathan R Shewchuk\index{Shewchuk, Jonathan} (\mail{Jonathan\_R\_Shewchuk@ux4.sp.cs.cmu.edu})\\ Author of the Triangle\index{triangle program} program. Triangle is used to calculate the Delauney triangulation of our irregular terrain. \medskip \noindent Gordan Sikic\index{Sikic, Gordan} (\mail{gsikic@public.srce.hr})\\ Contributed a \Index{Cherokee flight model} for \Index{LaRCsim}. Currently is not working and needs to be debugged. Use configure \texttt{-$\!$-with-flight-model=cherokee} to build the cherokee instead of the \Index{Navion}. \medskip \noindent Michael Smith\index{Smith, Michael} (\mail{msmith99@flash.net})\\ Contributed cockpit graphics, 3d models, logos, and other images. Project Bonanza \web{http://members.xoom.com/ConceptSim/index.html}. \medskip \noindent \Index{U.\,S. Geological Survey} \web{http://edcwww.cr.usgs.gov/doc/edchome/ndcdb/ndcdb.html} \noindent Provided geographic data used by this project. \medskip \noindent Durk Talsma\index{Talsma, Durk} (\mail{pn\_talsma@macmail.psy.uva.nl})\\ Accurate Sun, Moon, and Planets. Sun changes color based on position in sky. Moon has correct phase and blends well into the sky. Planets are correctly positioned and have proper magnitude. \medskip \noindent Gary R. Van Sickle\index{van Sickle, Gary R.} (\mail{tiberius@braemarinc.com})\\ Contributed some initial \Index{GameGLUT} support and other fixes. \medskip \noindent Norman Vine\index{Vine, Norman} (\mail{nhv@laserplot.com})\\ Many performance optimizations throughout the code. Many contributions and much advice for the scenery generation section. Lots of Windows related contributions. \medskip \noindent Carmelo Volpe\index{Volpe, Carmelo} (\mail{carmelo.volpe@csb.ki.se})\\ Porting \FlightGear to the \Index{Metro Works} development environment (PC/Mac). \medskip \noindent Robert Allan Zeh\index{Zeh, Allan} (\mail{raz@cmg.FCNBD.COM})\\ Helped tremendously in figuring out the \Index{Cygnus} Win32 compiler and how to link with .dll's. Without him the first run-able Win32 version of \FlightGear would have been impossible. \section{What remains to be done} At first: If you read (and, maybe, followed) this guide until this point you may probably agree that \FlightGear\hspace{-2mm}, even in its present state, is not at all for the birds. It is already a flight simulator which has a flight model, a plane, terrain scenery, texturing and simple controls. Despite, \FlightGear needs -- and gets -- further development. Except internal tweakings, there are several fields where \FlightGear needs basics improvement and development. A first direction is adding \Index{airports}, streets, rivers and all that bringing the Scenery to real life. Second, the \Index{panel} (being disabled by default at present) needs further improvement including more working gauges. Besides, there should be support for adding more \Index{planes} and for implementing corresponding flight models differing from the basic \Index{Navion}. Another major task is further implementation of the \Index{menu system}, which at its present state basically does nothing. Another direction concerns \Index{audio support}. While the audio library itself is essentially complete there is a need for more sounds to play and for code to drive it. There are already people working in all of these directions. But if you're a programmer and think you can contribute, you are invited to do so. \subsection*{Achnowledgements} Obviously this document could not have been written without all those contributors mentioned above making \FlightGear a reality. Beyond this we would like to say special thanks to Curt Olson,\index{Olson, Curt} whose numerous scattered Readmes, Thanks, Webpages, and personal eMails were of special help to us and were freely exploited in the making of this booklet. Further, we would like to thank Kai Troester\index{Troester, Kai} for donating the solution of some of his compile problems to our Chapter \ref{missed}. In addition, we would like to thank Steve Baker\index{Baker, Steve} for a careful reading and for numerous hints on the first draft of this guide. In addition we gained from hints given to Newcomers on the Mailing lists, notably from those given by Norman Vine \index{Vine, Norman}, to name only one. %% Revision 0.00 1998/09/08 michael %% Initial revision for version 0.53. %% Revision 0.01 1998/09/20 michael %% several extensions and corrections %% revision 0.10 1998/10/01 michael %% final proofreading for release %% revision 0.11 1998/11/01 michael %% corrections on audio library, getting started %% revision 0.12 1999/03/07 michael %% Updated Credits