368 lines
14 KiB
TeX
368 lines
14 KiB
TeX
|
%%
|
||
|
|
%% 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
|
||
|
|
|
||
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||
|
|
\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
|