Initial revision.
This commit is contained in:
curt
parent
c9f3077690
commit
725877b751
4 changed files with 195 additions and 0 deletions
32
README
Normal file
32
README
Normal file
|
|
@ -0,0 +1,32 @@
|
||||||
|
Welcome to the Flight Gear project.
|
||||||
|
===================================
|
||||||
|
|
||||||
|
The primary web page for this project is:
|
||||||
|
|
||||||
|
http://www.menet.umn.edu/~curt/fgfs
|
||||||
|
|
||||||
|
We are overhauling the make system and a lot of things are in a state of
|
||||||
|
change, so let me know if you see incorrect information in the README's,
|
||||||
|
extraneous files laying around, or any other anomylous things. The
|
||||||
|
coordinator of this project is Curt Olson <curt@me.umn.edu>.
|
||||||
|
|
||||||
|
===================================
|
||||||
|
|
||||||
|
Please see .... for more information on ....
|
||||||
|
|
||||||
|
- Authors & Thanks: List of the authors and contributors.
|
||||||
|
|
||||||
|
- COPYING: Copyright and usage terms and limits.
|
||||||
|
|
||||||
|
- INSTALL: Generic install instructions
|
||||||
|
|
||||||
|
- NEWS: The latest news
|
||||||
|
|
||||||
|
- README: This file
|
||||||
|
|
||||||
|
- README.Win32: Specific Win32 compiling information and instructions
|
||||||
|
|
||||||
|
- README.autoconf: Info on updating the make system (adding new source
|
||||||
|
files, etc.)
|
||||||
|
|
||||||
|
- README.running: Minimalist info for running the simulator
|
||||||
100
README.Win32
Normal file
100
README.Win32
Normal file
|
|
@ -0,0 +1,100 @@
|
||||||
|
April 8, 1998
|
||||||
|
=============
|
||||||
|
|
||||||
|
Here is a quick outline of *one* way you can build FG for Win32 using
|
||||||
|
a completely free development environment.
|
||||||
|
|
||||||
|
1. Install and configure the Cygnus Gnu-Win32 development
|
||||||
|
environment. The latest version is Beta 19. The main
|
||||||
|
Cygnus Gnu-Win32 page is at:
|
||||||
|
|
||||||
|
http://www.cygnus.com/misc/gnu-win32/
|
||||||
|
|
||||||
|
You can download the Cygnus Gnu-Win32 compiler from:
|
||||||
|
|
||||||
|
ftp://ftp.cygnus.com/pub/gnu-win32/latest/cdk.exe
|
||||||
|
|
||||||
|
To install, just run the file: "cdk.exe" by double-clicking in
|
||||||
|
windows explorer. Be sure to read this package's README :
|
||||||
|
|
||||||
|
http://www.cygnus.com/misc/gnu-win32/readme_toc.html
|
||||||
|
|
||||||
|
After installing the cygnus compiler and the usertools you should
|
||||||
|
find a program group "Cygnus" in your start menu.
|
||||||
|
|
||||||
|
2. Install the Silicon Graphics OpenGL dynamic link libraries. For
|
||||||
|
this purpose, get the file sgi-opengl2.exe from the flight gear
|
||||||
|
project site. This is a win95/winnt self extracting installation
|
||||||
|
program. Install it by double-clicking in windows explorer.
|
||||||
|
|
||||||
|
3. Fetch the Flight Gear code and special Win32 libraries. These can
|
||||||
|
be found at:
|
||||||
|
|
||||||
|
http://www.menet.umn.edu/~curt/fgfs/Downloads/Source/
|
||||||
|
|
||||||
|
Grab the latest "FlightGear-X.XX.zip" and "win32-libs-X.XX.zip"
|
||||||
|
files.
|
||||||
|
|
||||||
|
4. Unpack the FG source code. Run:
|
||||||
|
|
||||||
|
pkunzip -d FlightGear-X.XX.zip
|
||||||
|
|
||||||
|
Be sure to use the -d option. This will create all the needed
|
||||||
|
subdirectories. Otherwise you will have one big mess! Trust me!
|
||||||
|
|
||||||
|
5. Change to the newly created FlightGear-X.XX directory and unpack
|
||||||
|
the Win32 libraries. Run:
|
||||||
|
|
||||||
|
cd FlightGear-X.XX
|
||||||
|
pkunzip -d win32-libs-X.XX.zip
|
||||||
|
|
||||||
|
Side Note: we need to make a distinction between the "build tree" and
|
||||||
|
the "install tree." The "build tree" is what we've been talking
|
||||||
|
about up until this point. This is where the source code lives
|
||||||
|
and all the compiling takes place. Once the executables are
|
||||||
|
built, they need to be installed someplace. We shall call this
|
||||||
|
install location the "install tree". This is where the
|
||||||
|
executables, the scenery, the textures, and any other run-time
|
||||||
|
files will be located.
|
||||||
|
|
||||||
|
6. Configure the make system for your environment and your "install
|
||||||
|
tree". Tell the configure script where you would like to install
|
||||||
|
the exectuables and all the scenery and textures by using the
|
||||||
|
"--prefix" option. In the following example the base of the
|
||||||
|
"install tree" is "/FlightGear". Run:
|
||||||
|
|
||||||
|
./configure --prefix=/FlightGear
|
||||||
|
|
||||||
|
7. Build the executable. Run:
|
||||||
|
|
||||||
|
make
|
||||||
|
|
||||||
|
8. Create and populate the install tree. Run:
|
||||||
|
|
||||||
|
make install
|
||||||
|
|
||||||
|
currently this step fails, but I hope to find a solution soon.
|
||||||
|
You can probably install everything by hand for now ... for example:
|
||||||
|
|
||||||
|
cp Simulator/Main/fg.exe /FlightGear/bin/fg.exe
|
||||||
|
cp Simulator/Main/runfg.bat /FlightGear/bin/runfg.bat
|
||||||
|
|
||||||
|
Important Note: so far you've built and installed the simulator and
|
||||||
|
related tools. Before you can actually try it out, you need to
|
||||||
|
make sure you have the appropriate scenery and texture downloaded
|
||||||
|
and unzip'ed in your "install tree".
|
||||||
|
|
||||||
|
9. Download and install the scenery and texture files.
|
||||||
|
|
||||||
|
10. Set the runtime environment variable to point to the base of your
|
||||||
|
"install tree". Run:
|
||||||
|
|
||||||
|
export FG_ROOT=/FlightGear
|
||||||
|
|
||||||
|
11. Try it out! There are several ways to run flight gear once it has
|
||||||
|
been installed. The simplest is as follows. Run:
|
||||||
|
|
||||||
|
/FlightGear/bin/runfg.bat
|
||||||
|
|
||||||
|
12. I appreciate feedback. Tell me if it works! If it doesn't, tell me
|
||||||
|
what went wrong. My email is curt@me.umn.edu
|
||||||
22
README.autoconf
Normal file
22
README.autoconf
Normal file
|
|
@ -0,0 +1,22 @@
|
||||||
|
Flight Gear uses the Gnu autoconf and automake tools for managing
|
||||||
|
Makefiles. It also uses libtool to manage building shared and static
|
||||||
|
libraries. Key input files for this system are:
|
||||||
|
|
||||||
|
configure.in - Top level directory
|
||||||
|
Makefile.am - One in each subdirectory
|
||||||
|
Simulator/Include/config.in - input file for building config.h
|
||||||
|
|
||||||
|
If you need to modify any of these files, you will need to build and
|
||||||
|
install the following packages:
|
||||||
|
|
||||||
|
- GNU autoconf 2.12 (available from ftp://prep.ai.mit.edu/pub/gnu)
|
||||||
|
- GNU automake 1.2h (available from ftp://ftp.cygnus.com/pub/tromey)
|
||||||
|
- GNU libtool 1.0c (available from ftp://prep.ai.mit.edu/pub/gnu)
|
||||||
|
|
||||||
|
When making a change to any of these files you will need to run:
|
||||||
|
|
||||||
|
aclocal ; automake -a ; autoconf
|
||||||
|
|
||||||
|
Then follow the regular build procedure:
|
||||||
|
|
||||||
|
./configure; make; make install
|
||||||
41
README.running
Normal file
41
README.running
Normal file
|
|
@ -0,0 +1,41 @@
|
||||||
|
Starting the executable
|
||||||
|
=======================
|
||||||
|
|
||||||
|
Unix: runfg
|
||||||
|
Windows: runfg.bat
|
||||||
|
|
||||||
|
"runfg" is a script which sets the FG_ROOT and LD_LIBRARY_PATH
|
||||||
|
environment variables, then runs the Flight Gear executable.
|
||||||
|
|
||||||
|
|
||||||
|
Keyboard controls
|
||||||
|
=================
|
||||||
|
|
||||||
|
Flying is mainly done via the numeric keypad. There is some
|
||||||
|
unresolved wierdness with the GLUT libraries and keyboard input, so
|
||||||
|
for now, the state of the "Num Lock" key is important.
|
||||||
|
|
||||||
|
Num Lock Active
|
||||||
|
---------------
|
||||||
|
|
||||||
|
Pg Up/Pg Dn Throttle
|
||||||
|
Left Arrow/Right Arrow Aileron
|
||||||
|
Up Arrow/Down Arrow Elevator
|
||||||
|
Ins/Del Rudder
|
||||||
|
"5" Center aileron/elevator/rudder
|
||||||
|
Home/End Elevator Trim
|
||||||
|
|
||||||
|
Num Lock Inactive
|
||||||
|
-----------------
|
||||||
|
Shift + <Numeric Keypad Key> Change view
|
||||||
|
|
||||||
|
where key is one of:
|
||||||
|
|
||||||
|
8 = forward
|
||||||
|
7 = left/forward
|
||||||
|
4 = left
|
||||||
|
1 = left/back
|
||||||
|
2 = back
|
||||||
|
3 = right/back
|
||||||
|
6 = right
|
||||||
|
9 = right/forward
|
||||||
Loading…
Add table
Reference in a new issue