File: README.tss.txt - 2009-07-11 - 2009-04-19 - 2009-03-13

The 15 easy steps to using my TSS (Two Solution System) (c) ;=))

PRE Update ALL in the SOURCE folder, using CVS/SVN/git/tar.gz/zip, as appropriate.

1.  Download vc?sln??.zip, and extract SETUPFG.BAT, into a root WORK folder, 
    in my case C:\FG, or G:\FG

2.  Adjust SETUPFG.BAT to the ROOT of the SOURCE folder. The default is C:\FGCVS,
    (or  sometimes G:\FGCVS).

3.  Run SETUPFG.BAT, giving the name of the new WORK folder. In this 
    case G:\FG> setupfg 31

4.  Unzip, overwriting, with folder names, vc?sln??.zip, into the new WORK folder,
    in this case WORK\31 - BUT these are NOT used, and this step can be skipped!
    See step 7 - now exclusively use the MSVC6 dsw/dsp build files only.

5.  Optionally unzip vc?cfg??.zip, with folders, OR do your own configurations. This
    is only for SimGear and FlightGear

6.  Optionally unzip vc?chg??.zip, with folders, OR apply chgdiff??.[txt|patch], 
    fully or partially. Sometimes I do this entirely manually, due to other changes 
    in the sources. 
    If you include the changes to PLIB\src\js\jsWidows,cxx, then you must at least 
    extract jsName.cxx. This is also available in vc?PLIB-??.zip.

7.  Unzip vc?dsw??.zip, preserving paths, and optionally run delslnlist.bat, to avoid 
    MSVC dialog asking if it should use existing file. Answer NO to this...

8.  Load fgfs\fgfs.dsw into MSVC, allowing conversion, and build just libpng, zlib... 
    I use the Batch... build and select just these projects. 
    Make sure there is a zlib.lib and zlibd.lib in the root
    zlib-1.2.3 folder, and a libpng.lib, and libpngd.lib in the 
    lpng folder before proceeding.

9.  Run CMake (2.6+) on the OpenSceneGraph folder. Check [x] Show Advanced Values; 
    click [ Configure ], selecting the appropriate MSVC; 
    set ZLIB include to WORK\zlib-1.2.3, and ZLIB library to 
    WORK\zlib-1.2.3\zlib.lib; [Configure] again; 
    set PNG include to WORK\lpng, and PNG library 
    to WORK\lpng\libpng.lib; [Configure] again; then [OK] to build solution set.

10. Load another MSVC, and open OpenSceneGraph\OpenSceneGraph.sln. It may show in the order of 80
    projects. Build at least the Release configuration, and maybe Debug if you intend 
    'debugging'

11. Optionally (a) run copyboost.bat, to copy new, updated sources from SOURCE\boost-trunk 
    folder, preferred, 
    OR (b) unzip, preserving folders, the boost-??.zip, to use the older headers. As
    SG/FG progress other boost headers may be used, thus more have to be copied from the
    SOURCE\boost-trunk, or if you do not want to pick and choose, copy ALL SOURCE to WORK.

12. Reload, or switch back to the MSVC fgfs solution, and build ALL Release, and Debug 
    if desired.
    Depending on SG/FG sources changes, it may be necessary to add or delete particular
    sources.
    Optionally, unzip rfgbats05.zip, with folders - these will be put in WORK\bin\bats.

13. In the MSVC command prompt, since it uses nmake - see Tools -> VS Command Prompt, 
    run UPD.BAT.
    This may requires adjusting the variables TEMPOSGV, TEMPPIV, and sometimes TEMPOTV,
    but UPD.BAT will give advice on what it finds, very good advice if you have Perl 
    installed and runable...

14. If not done previously, copy alub.dll to $(SYSTEMROOT)\System32 folder, to join 
    where the OpenAL32.dll, and wrap_oal.dll reside.

15. cd bin\bats, and try the rfgufo, first or any of the other batch files available ...
    The load of FG takes a few minutes... note any output to the console...
    
=== YOU SHOULD BE FLYING === ;=)) Enjoy!!!

Geoff.

PS: Please give any feedback to 'report at geoffair dot info'
