Simulator/README.Win32

   1 July 21, 1997
   2 =============
   3
   4 Here is a quick outline of one way you can build FG for Win32 using a
   5 completely free development environment.
   6
   7 1.  Setup your development environment.  The main Cygnus Gnu-Win32
   8     page is at:
   9
  10         http://www.cygnus.com/misc/gnu-win32/
  11
  12     Download and install the Cygnus Gnu-Win32 compiler:
  13
  14         ftp://ftp.cygnus.com/pub/gnu-win32/latest/cdk.exe
  15
  16     Be sure to read this package's README for post installation
  17     configuration instructions:
  18
  19         http://www.cygnus.com/misc/gnu-win32/readme_toc.html
  20
  21
  22 2.  Fetch the Flight Gear prototype code.  It can be found at:
  23
  24         http://www.menet.umn.edu/~curt/fgfs/prototype/source/
  25
  26     Grab the latest .zip file.
  27
  28
  29 3.  Unpack the FG prototype code.  Run:
  30
  31         pkunzip -d <file>.zip
  32
  33     Be sure to use the -d option.  This will create all the needed
  34     subdirectories.  Otherwise you will have one big mess!
  35
  36     You should now have directory called ``FlightGear'' with several
  37     subdirectories.
  38
  39
  40 3.  Install the OpenGL/GLUT headers.  Cd to ``FlightGear\Src\Win32''.
  41     There you will find a file called gl-hdrs.zip.  Assuming you
  42     installed the free Cygnus compiler in C:\gnuwin32\b18,, copy the
  43     file ``gl-hdrs.zip'' to ``c:\gnuwin32\b18\include\":
  44
  45         copy gl-hdrs.zip c:\gnuwin32\b18\include\
  46
  47     Then go to the c:\gnuwin32\b18\include\ directory and run:
  48
  49         pkunzip -d gl-hdrs.zip
  50
  51     You can remove the gl-hdrs.zip file if you wish.
  52
  53
  54 4.  Install the OpenGL dynamic link libraries.  If you are running
  55     an NT system you can skip this step.  NT comes with the OpenGL
  56     libraries.  If you are running windows 95, you should grab the
  57     OpenGL libraries from the Microsoft ftp server:
  58
  59         ftp://ftp.microsoft.com/Softlib/MSLFILES/Opengl95.exe
  60
  61     This is a self extracting compressed archive, so run this .exe to
  62     extract the files.  To install these permanently on your system,
  63     you can copy them to your ``c:\windows\system\" directory.
  64     Otherwise, you could just as easily copy them to the
  65     ``FlightGear\Src\OpenGL'' directory or someplace that is in your
  66     path.
  67
  68 4.  Edit the ``make.inc'' file.  Go back to the main FlightGear source
  69     directory.  From where ever you extracted the FG code, cd to
  70     ``FlightGear\Src''.  Edit the file called ``make.inc''.  Find the
  71     part of the file that says:  ``Uncomment one of the following
  72     sections depending on your system''
  73
  74     Uncomment all the makefile defines in the ``Cygnus Win32''
  75     section.  Also, you should comment out any of the defines in the
  76     other sections.
  77
  78
  79 5.  Build the executable.  From the same ``FlightGear\Src'' directory,
  80     run the following command:
  81
  82         make
  83
  84     make is a build utility that comes with the Cygnus development
  85     environment.
  86
  87     You will see a few warning messages from the compiler, but none of
  88     these are serious.
  89
  90
  91 6.  Try it out!  cd to the FlightGear\Src\OpenGL directory and run the
  92     simulator:
  93
  94         fg0
  95
  96
  97 7.  I wrote this document from the top of my head so it is certain to
  98     contain errors.   Please send me email (curt@me.umn.edu) and let
  99     me know what changes need to be made to this document and these
 100     procedures to make them easier to understand and follow.