Compiling OpenSceneGraph with Cygwin

Follows are details on usage of OpenSceneGraph such as how to get things compiling using Cygwin.

The following assumes that the OpenSceneGraph and its dependencies (OpenThreads, Producer, and optionally gdal) have been downloaded, either from CVS or tarballs, and installed under a common parent directory. I will call this "/development".

Load the proper version of the GCC Compiler

The current default gcc compiler version distributed with Cygwin is 3.4.1. Unfortunately, this version has problems dealing with the complexity of the OpenSceneGraph and Producer template usage. The libraries will compile, but they will not run. To build OSG you need to manually direct the cygwin installer to load version 3.3.3 of the gcc compiler family.

Set up the Cygwin environment

You must create some initial environment variables so that the OpenSceneGraph build process knows where OpenThreads and Producer are installed. The best place to locate these variables is in your shell resources file. Assuming you are using the default bash shell, your bash resources file will be

~/.bashrc

Using your favorite text editor, add these variables to the file:

export OPENTHREADS_INC_DIR=/usr/local/OpenThreads/include
export OPENTHREADS_LIB_DIR=/usr/local/OpenThreads/bin
export PRODUCER_INC_DIR=/usr/local/Producer/include
export PRODUCER_LIB_DIR=/usr/local/Producer/bin

OSG also uses environment variables to control which parts of the distribution is compiled. To compile the example programs, add the following line to the .bashrc file

export COMPILE_EXAMPLES=yes

Introspection does not seem to work within Cygwin, so also add this line to the .bashrc:

export COMPILE_INTROSPECTION=no

If you have installed GDAL (required for the osgTerrain component) also add:

export GDAL_INSTALLED=yes

Next you must add these paths and the path to the OpenSceneGraph installed bin directory to the systems PATH environment variable:

export PATH="$OPENTHREADS_LIB_DIR:$PATH"
export PATH="$PRODUCER_LIB_DIR:$PATH"
export PATH="/usr/local/OpenSceneGraph/bin:$PATH"

The $PATH variable on the end makes sure that any previously assigned paths are also included.

That's all that needs to be done for the .bashrc file, though you could also add the variable that specifies the directory of the OpenSceneGraph data, or any other variables that are particular to your setup.

export OSG_FILE_PATH=/usr/local/OpenSceneGraph/data

Compiling OpenThreads

Go to the OpenThreads directory

$ cd /development/OpenThreads

run:

$ make
$ make install

Compiling Producer

A bug in the make system requires that we manually create the target directory for the !Producer library. Go to the library directory:

cd /development/Producer/lib

and create a new directory

$ mkdir CYGWIN32

Having done that you can build the Producer library.

$ cd /development/Producer
$ make
$ make install

Compiling OpenSceneGraph

First, we must work around the same bug as in !Producer:

$ cd /development/OpenSceneGraph/lib
$ mkdir CYGWIN32

Go to the OpenSceneGraph home directory and make, then install, OpenSceneGraph.

$ cd /development/OpenSceneGraph
$ make
$ make install