SoWin_Build_Environment

SoWin Build Environment

The SoWin GUI library is built using Microsoft Visual Studio tools.

• SoWin Build Environment
  • Dependencies
  • Environment Variables
    • COINDIR Environment Variable
  • Download the Source
  • Details

Dependencies

This section identifies the dependencies for building SoWin.

1. Microsoft Visual Studio 2010 is installed with Service Pack 1 applied.

Environment Variables

The following environment variables need to be set in order to build and install the SoWin libraries.

COINDIR Environment Variable

Set the variable COINDIR to reference the directory where the Coin3D SDK has been installed.See the Coin3D project for more information.

Download the Source

The Wizzer Works Coin 3D SoWin source code resides on Sourceforge (https://sourceforge.net/projects/coin3d-sowin/). It is in a Git repository and the following instructions can be used to retrieve the source.

In the Git Bash Window, run:

cd <workarea>
git clone git://git.code.sf.net/p/coin3d-sowin/code coin3d-sowin-code

A coin3d-sowin-code project will be created in the <workarea> directory.

Note that the master branch contains the source from the original Coin3 SoWin v1.5.0 tar package. The master branch will not be modified unless it is necessary to be maintained (i.e. bug fixes) outside the scope of Magic Lantern.

Details

To build the SoWin libraries using Microsoft Visual Studio 2005, use the following instructions.

1. Open the SoWin Visual Studio solution, sowin1.sln. It can befound under the build/msvc10 directory. The following figure shows the open solution in the Visual Studio "Solution Explorer" window.

1. Right-click on the sowin1_install entry in the "Solution Explorer". Select "Build" from the pop-up menu. This will build and install the sowin1.dll in the $COINDIR/bin directory and the sowin1.lib file in the $COINDIR/lib directory.