README.Win32

   1 April 8, 1998
   2 =============
   3
   4 Here is a quick outline of *one* way you can build FG for Win32 using
   5 a completely free development environment.
   6
   7 1.  Install and configure the Cygnus Gnu-Win32  development
   8     environment. The latest version is Beta 19. The main
   9     Cygnus Gnu-Win32 page is at:
  10
  11         http://www.cygnus.com/misc/gnu-win32/
  12
  13     You can download the Cygnus Gnu-Win32 compiler from:
  14
  15         ftp://ftp.cygnus.com/pub/gnu-win32/latest/cdk.exe
  16
  17     To install, just run the file: "cdk.exe" by double-clicking in
  18     windows explorer. Be sure to read this package's README :
  19
  20         http://www.cygnus.com/misc/gnu-win32/readme_toc.html
  21
  22     After installing the cygnus compiler and the usertools you should
  23     find a program group "Cygnus" in your start menu.
  24
  25 2.  Install the Silicon Graphics OpenGL dynamic link libraries. For
  26     this purpose, get the file sgi-opengl2.exe from the flight gear
  27     project site. This is a win95/winnt self extracting installation
  28     program. Install it by double-clicking in windows explorer.
  29
  30 3.  Fetch the Flight Gear code and special Win32 libraries.  These can
  31     be found at:
  32
  33         http://www.menet.umn.edu/~curt/fgfs/Downloads/Source/
  34
  35     Grab the latest "FlightGear-X.XX.zip" and "win32-libs-X.XX.zip"
  36     files.
  37
  38 4.  Unpack the FG source code.  Run:
  39
  40         pkunzip -d FlightGear-X.XX.zip
  41
  42     Be sure to use the -d option.  This will create all the needed
  43     subdirectories.  Otherwise you will have one big mess!  Trust me!
  44
  45 5.  Change to the newly created FlightGear-X.XX directory and unpack
  46     the Win32 libraries.  Run:
  47
  48         cd FlightGear-X.XX
  49         pkunzip -d win32-libs-X.XX.zip
  50
  51 Side Note: we need to make a distinction between the "build tree" and
  52     the "install tree."  The "build tree" is what we've been talking
  53     about up until this point.  This is where the source code lives
  54     and all the compiling takes place.  Once the executables are
  55     built, they need to be installed someplace.  We shall call this
  56     install location the "install tree".  This is where the
  57     executables, the scenery, the textures, and any other run-time
  58     files will be located.
  59
  60 6.  Configure the make system for your environment and your "install
  61     tree".  Tell the configure script where you would like to install
  62     the exectuables and all the scenery and textures by using the
  63     "--prefix" option.  In the following example the base of the
  64     "install tree" is "/FlightGear".  Run:
  65
  66         ./configure --prefix=/FlightGear
  67
  68 7.  Build the executable.  Run:
  69
  70         make
  71
  72 8.  Create and populate the install tree.  Run:
  73
  74         make install
  75
  76     currently this step fails, but I hope to find a solution soon.
  77     You can probably install everything by hand for now ... for example:
  78
  79         cp Simulator/Main/fg.exe /FlightGear/bin/fg.exe
  80         cp Simulator/Main/runfg.bat /FlightGear/bin/runfg.bat
  81
  82 Important Note: so far you've built and installed the simulator and
  83     related tools.  Before you can actually try it out, you need to
  84     make sure you have the appropriate scenery and texture downloaded
  85     and unzip'ed in your "install tree".
  86
  87 9.  Download and install the scenery and texture files.
  88
  89 10. Set the runtime environment variable to point to the base of your
  90     "install tree".  Run:
  91
  92         export FG_ROOT=/FlightGear
  93
  94 11. Try it out!  There are several ways to run flight gear once it has
  95     been installed. The simplest is as follows.  Run:
  96
  97         /FlightGear/bin/runfg.bat
  98
  99 12. I appreciate feedback.  Tell me if it works!  If it doesn't, tell me
 100     what went wrong.  My email is curt@me.umn.edu