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