Information about the scons based build system that is used before r1622.

Building OpenSG 2.0 (SCons)

We are using  SCons to build the system.

If you get exceptions relating to ascii->unicode decode errors, using Python 2.6 might help (reported on the users mail list).

Linux Specifics

Do not install your own scons version, use the version from Tools/scons-local

To build it, execute the following command in the base project directory.

python Tools/scons-local/scons.py

It should find all existing dependencies automatically, as far as they are installed. Only boost is a must.

If you need to customize the build options or just want to see the options available, just execute:

python Tools/scons-local/scons.py --help

or check the option.cache.<os>.<compiler> file

Windows Specifics

Install python from  http://www.python.org/ Add the python install directory (e.g. C:\Python24) to the PATH environment
variable. If you use cygwin make sure the C:\ version is found before the cygwin version

Do not install your own scons version, use the version from Tools/scons-local

You will need boost. You can get it here:  download boost
Install the Multithread DLL variants

If you need to customize the build options or just want to see the options available, just execute:

python Tools/scons-local/scons.py --help

or check the option.cache.<os>.<compiler> file

To build it under windows, type:

python Tools/scons-local/scons.py BoostBaseDir=c:\programs\boost\boost_1_33_1 

If you have an older checkout and scons try to build unittests add enable_unittests=False to the command line

If you experience problems because scons detects a higher Visual Studio installation,
you can force scons to use the lower one (if installed and wanted) with the following:

python Tools/scons-local/scons.py BoostBaseDir=c:\programs\boost\boost_1_33_1  MSVS_VERSION=<VERSION>

e.g

python Tools/scons-local/scons.py BoostBaseDir=c:\programs\boost\boost_1_33_1 MSVS_VERSION=7.1
python Tools/scons-local/scons.py BoostBaseDir=c:\programs\boost\boost_1_33_1 MSVS_VERSION=8.0
python Tools/scons-local/scons.py BoostBaseDir=c:\programs\boost\boost_1_33_1 MSVS_VERSION=9.0

Building on MacOS X

• Building OpenSG 2.x

Variants

• var_type
  • the optimize and debug variants both use the optimized Microsoft runtime dlls (MSVCPRT and MSVCRT)
  • if you need the debug runtime dlls (MSVCPRTD and MSVCRTD) build debugrt