175 lines
7.9 KiB
TeX
175 lines
7.9 KiB
TeX
|
%%
|
||
|
|
%% getstart.tex -- Flight Gear documentation: Installation and Getting Started
|
||
|
|
%% Chapter file
|
||
|
|
%%
|
||
|
|
%% Written by Michael Basler, started September 1998.
|
||
|
|
%%
|
||
|
|
%% Copyright (C) 2002 Michael Basler (pmb@epost.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: preface.tex,v 0.6 2002/09/09 michael
|
||
|
|
%% (Log is kept at end of this file)
|
||
|
|
|
||
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||
|
|
\chapter*{Preface\label{preface}}
|
||
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
||
|
|
|
||
|
|
\FlightGear{} is a free Flight Simulator developed cooperatively over the Internet
|
||
|
|
by a group of Flight Simulation and Programming Enthusiasts. This ''Installation and Getting
|
||
|
|
Started'' is meant to give beginners a guide in getting \FlightGear{} up and running. It is not intended to provide complete documentation of all the features and add-ons of \FlightGear{} but, instead, focuses on those aspects necessary to get into the air.
|
||
|
|
|
||
|
|
This guide is split into two parts. The first part describes how to install the program while the second part details on how to actually fly with \FlightGear{}.
|
||
|
|
|
||
|
|
The chapters concentrate on the following aspects:
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
\textbf{Part I: Installation}
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
Chapter \ref{free}, \textit{Want to have a free flight? Take \FlightGear{}}, introduces
|
||
|
|
the concept, describes the system requirements, and classifies the different versions
|
||
|
|
available.
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
Chapter \ref{building}, \textit{Building the plane: Compiling the program},
|
||
|
|
explains how to build (compile and link) the simulator. Depending on your platform this
|
||
|
|
may or may not be required. Generally, there will be executable programs (binaries)
|
||
|
|
available for several platforms. Those on such systems who want to take off immediately,
|
||
|
|
without going through the potentially troublesome process of compiling, may skip this
|
||
|
|
Chapter.
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
In Chapter \ref{prefligh}, \textit{Preflight: Installing \FlightGear{}}, you will find
|
||
|
|
instructions for installing the binaries\index{binary distribution} in case you did not
|
||
|
|
build them yourself as specified in the previous Chapter. You will need to install
|
||
|
|
scenery, textures, and other support files collected in the \Index{base package}.
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
\textbf{Part II: Flying with \FlightGear{}}
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
The following Chapter \ref{takeoff}, \textit{Takeoff: How to start the
|
||
|
|
program}, describes how to actually start the installed program. It includes an overview on the numerous command line options as well as configuration files.
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
Chapter \ref{flight}, \textit{In-flight: All about instruments, keystrokes and menus},
|
||
|
|
describes how to operate the program, i.\,e. how to actually fly with
|
||
|
|
\FlightGear{}\hspace{-1mm}. This includes a (hopefully) complete list of pre-defined keyboard
|
||
|
|
commands, an overview on the menu entries, detailed descriptions on the instrument panel and
|
||
|
|
HUD (head up display), as well as hints on using the mouse functions.
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
In Appendix \ref{missed}, \textit{Missed approach: If anything refuses to work},
|
||
|
|
we try to help you work through some common problems faced when using \FlightGear{}.
|
||
|
|
\bigskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
The Appendix \ref{opengl}, \textit{OpenGL graphics drivers}, describes some special problems you may encounter in case your system lacks support for the OpenGL graphics API \Index{OpenGL} which \FlightGear{} is based on.
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
In the final Appendix \ref{landing}, \textit{Landing: Some further thoughts before leaving the plane}, we would like to give credit to those who deserve it, sketch an overview
|
||
|
|
on the development of \FlightGear and point out what remains to be done.
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
Accordingly, we suggest reading the Chapters as follows:
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
\begin{tabular}{ll}
|
||
|
|
\textbf{Installation} &\\
|
||
|
|
Users of binary distributions (notably under Windows): & \ref{prefligh}\\
|
||
|
|
Installation under Linux/UNIX: & \ref{building}, \ref{prefligh}\\
|
||
|
|
Installation under Macintosh: & \ref{prefligh}\\
|
||
|
|
\textbf{Operation} & \\
|
||
|
|
Program start (all users): & \ref{takeoff}\\
|
||
|
|
Keycodes, Panel, Mouse\ldots (all users): & \ref{flight}\\
|
||
|
|
\textbf{Troubleshooting} & \\
|
||
|
|
General issues: & \ref{missed}\\
|
||
|
|
Graphics problems: & \ref{opengl}\\
|
||
|
|
\textbf{Optionally} & \ref{free}, \ref{landing}
|
||
|
|
\end{tabular}
|
||
|
|
\bigskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
While this introductory guide is meant to be self contained, we strongly suggest having a look into further documentation, especially in case of trouble:
|
||
|
|
|
||
|
|
\begin{itemize}
|
||
|
|
\item For additional hints on troubleshooting and more, \textbf{please read the FAQ}\index{FAQ}
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
\web{http://www.flightgear.org/Docs/FlightGear-FAQ.html},
|
||
|
|
|
||
|
|
The FAQ contains a host of valuable information, especially on rapidly changing flaws and additional reading, thus we strongly suggest consulting it in conjunction with our guide.
|
||
|
|
|
||
|
|
|
||
|
|
\item A handy \textbf{leaflet}\index{leaflet} on operation for printout is available at
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
\web{http://www.flightgear.org/Docs/InstallGuide/FGShortRef.html},
|
||
|
|
\item Additional user documentation on special aspects is available within the base package under the directory \texttt{/FlightGear/Docs}.
|
||
|
|
\end{itemize}
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
Finally:
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
|
||
|
|
We know, most people hate reading manuals. If you are sure the graphics driver for your card supports \Index{OpenGL} (check documentation; for instance all \Index{NVIDIA} Windows and Linux drivers for \Index{TNT}/TNT2/\Index{Geforce}/Geforce2/Geforce3 do) and if you are using one of the following operating systems:
|
||
|
|
|
||
|
|
\begin{itemize}
|
||
|
|
\item \Index{Windows} 95/98/ME/NT/2000/XP,
|
||
|
|
\item \Index{Macintosh} Mac OSX
|
||
|
|
\item \Index{Linux}
|
||
|
|
\item \Index{SGI Irix}
|
||
|
|
\end{itemize}
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
you can possibly skip at least Part I of this manual and exploit the pre-compiled binaries\index{binaries!pre-compiled}. These as well as instructions on how to set them up, can be found at
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\web{http://www.flightgear.org/Downloads/}.
|
||
|
|
\medskip
|
||
|
|
|
||
|
|
\noindent
|
||
|
|
In case you are running \FlightGear{} on Linux, you may also be able to get binaries bundled with your distribution. Several vendors already include \FlightGear{} binaries into their distributions.
|
||
|
|
|
||
|
|
Just download them, install them according to the description and run them via the installed \texttt{runfgfs} script or the batch file \texttt{runfgfs.bat}, respectively.
|
||
|
|
|
||
|
|
There is no guarantee for this approach to work, though. If it doesn't, don't give up! Have a closer look through this guide notably Section \ref{prefligh} and be sure to check out the \Index{FAQ}.
|
||
|
|
|
||
|
|
|
||
|
|
%% Revision 0.00 1998/09/08 michael
|
||
|
|
%% Initial revision for version 0.41.
|
||
|
|
%% Revision 0.01 2002/01/01 michael
|
||
|
|
%% Included outline of the Guide, integrated former separate chapter ''Quickstart''
|
||
|
|
%% revision 0.5 2002/01/01 michael/martin
|
||
|
|
%% Hint on Linux distros
|
||
|
|
%% revision 0.6 2002/09/09 michael
|
||
|
|
%% minor corrections
|