File: README.tss.txt - 2009-03-13

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

PRE Update ALL in the SOURCE folder, CVS/SVN/git/tar.gz/zip, as appropriate.
1.  Download vc?sln??.zip, and extract SETUPFG.BAT, into root WORK folder, in my case C:\FG
2.  Adjust SETUPFG.BAT to the ROOT of the SOURCE folder. The default is C:\FGCVS.
3.  Run SETUPFG.BAT, giving the name of the new WORK folder. In my case C:\FG>setupfg 30
4.  Unzip, overwriting, with folder names, vc?sln??.zip, into the new WORK folder, in this case WORK\30
5.  Optionally unzip vc?cfg??.zip, with folders, OR do your own configurations.
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.
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, 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 ubuntu at geoffair dot info
