After downloading, install/unpack Visual Studio, Qt, OpenSceneGraph and CMake. You should choose a simple path. In this tutorial, we use c:\OWLib.
The only library which needs to be build from source is Boost. Follow these instructions:
Unpack Boost Archive to c:\OWLibs\BoostBuild directory
Open a command prompt (cmd.exe) and type cd c:\OWLib\BoostBuild\boost_1_42_0 and then run bootstrap.bat, which creates bjam.exe and some other files which are Boost's build-system
type bjam install --prefix="c:\OWLibs" threading=multi link=static runtime-link=shared variant=debug,release which takes a while and compiles boost in debug and release mode and installs it to c:\OWLib\include and c:\OWLib\lib
Unfortunately a Problem is that the install script copies the headers to c:\OWLib\include\boost-1_42
copy the directory c:\OWLib\include\boost-1_42\boost to c:\OWLib\include
After building and installing Boost, some environment variables need to be set. They are needed to have CMake properly find OpenSceneGraph, Boost and Qt:
set or add the User Variable PATH=%PATH%;c:\OWLib\lib;c:\OWLib\bin
Log Off and On again
Now, start CMake Gui. On top it has to fields where you need to enter the path of OpenWalnut's source. Assuming you have OpenWalnut Checked out to c:\OW, enter c:\OW\src as source directory and c:\OW\build as build directory.
If you do this the first time, CMake will ask you which "Generator" it should use.
Select "Visual Studio 9 2008" here
Do NOT select "Visual Studio 9 2008 Win64"
If no error occurs, Cmake shows the Boost Libs, Qt Libs and OSG Libs and the right include paths.
I had to set Boost_INCLUDE_PATH to C:/OWLibs/include manually (Alex, 2011-04-11)
Press "Configure" again
These steps create a Visual Studio Solution file in c:\OW\build named OpenWalnut.sln. Open this file with Visual Studio.
Select Release as Build Type
If you choose Debug here, ensure you also downloaded the OpenSceneGraph Debug Libraries.
Set the working directory of ALL_BUILD to build/bin so shaders, fonts and the walnut.cfg will be found
TODO: write how! It needs to ensure that the walnut-bin.exe is copied to bin/ instead of bin/Release
Finally, build the target ALL_BUILD
The Visual Studio C++ compiler will print a lot of Warnings
in 2010!, the Visual Studio C++ compiler does not even support the C99 Standard (from 1999) completely
Now, OpenWalnut is compiled
The following targets will fail, but are not needed by now:
doc and fullDoc
you need doxygen for this
simply not working on Windows
not useful on Windows as Visual Studio provides its own tagging system
you'll need Python for this.
You can customize the GUI and some behavior settings of OpenWalnut by specifying your own walnut.cfg file.
copy c:\OW\doc\user\walnut.cfg.XYZ to the directory bin\ inside your build directory. Rename it to walnut.cfg.
customize the file
Biosig is deactivated at the moment
ZLib is deactivated but has been succesfully compiled with: