Windows Build Instructions

VE-Suite, as well as its dependencies, is currently built and tested using Visual Studio 7.1(2003).

Building VE-Suite

Set the environment variables (see Chapter 15, Setting the Environment) and launch a session of Visual Studio with the VE-Suite project loaded, then run the batch file:

$(VE_SUITE_HOME)VE_Installerbuild.bat

Supported base configurations available:

  1. tao_osg_dbg - OpenSceneGraph based application supporting released features

  2. tao_osg_vep_dbg - OpenSceneGraph based application supporting released and new features from current research

There are also cluster variants of each of the above configurations:

  1. # tao_osg_cluster_dbg

  2. # tao_osg_vep_cluster_dbg

Debugging VE-Xplorer

To run VE-Xplorer from within the Visual Studio debugger, change the working directory in the Configuration Properties tab to point to the directory where your VE-Suite parameter file is located (for example, change the working directory to $VE_SUITE_HOME)VE_TestSuite).

You will also need to pass in your VR Juggler config files as command arguments on the configuration properties tab. With the two projects still open, right-click on the VE_Xplorer project file and select Properties. For simulation mode, add the following to your command arguments section:

$(VJ_BASE_DIR)sharevrjugglerdataconfigFiles sim.base.jconf

$(VJ_BASE_DIR)sharevrjugglerdataconfigFiles sim.wand.mixin.jconf

After you enter a parameter file name and the scene loads, double click on $(VE_SUITE_HOME)bin runWinClient.bat to bring up the gui.

Running VE-Suite from a CD

You can build a working version of VE-Suite you can run from a CD by following these instructions:

  1. Create a folder to hold the CD's contents. We will call this the CD folder.

  2. Build VE-Suite and its dependencies. Make sure you build them without library or header files; these optional files will make VE-Suite too large to fit on a CD. Once they are built, copy them to the CD folder.

  3. Add the autorun.inf and VE_icon.ico files (found in the VE_Installer/installer/StandAloneCDreate directory) to the CD folder. (NOTE: Make sure the path to VE-Launcher listed in autorun.inf matches the path in your version of VE-Suite.)

  4. Add the models you want to include on the CD to the CD folder. We recommend putting them in VE_Suite.1.0.3/share/exampleDatasets with the sample datasets.

  5. Write the contents of the CD folder to the CD.

Reminders:

  • Make sure the contents of the CD folder will fit on the CD before you write it

  • While running VE-Suite from a CD, make sure the dependencies directories and working directory are located on the CD. Otherwise, the program will not run properly. Also, you can only use the .ves (model) files located on the CD itself.