Chapter 2. Building from Source

Table of Contents

Required Tools and Utilities for Building VR Juggler from Source
Officially Supported Platforms
Platforms Not Officially Supported

There are a few different ways to build the modules related to the VR Juggler project. This chapter explains all the ins and outs of getting the VR Juggler source code and compiling everything, including the documentation you are reading right now.

In general, readers should refer to the file INSTALL.html found in the top-level VR Juggler source directory and to the build-from-CVS public Wiki page. These have the most up-to-date information. In this part of the book, we cover more general topics that are not likely to change frequently. All developers of VR Juggler should nonetheless read this and the following chapters carefully to understand the build process as a whole.

Required Tools and Utilities for Building VR Juggler from Source

This section lists the comprehensive set of software tools that we require when compiling VR Juggler from its source. If you are reading a printed version of this file, please check the website to ensure that you have the latest information. There have been several instances where bugs in third party software caused problems with compiling VR Juggler and running VR Juggler applications. For the most current system setup instructions, visit the system setup Wiki page.

Table 2.1. All Platforms

CVS1.11 (or newer)
GNU make3.78 (or newer)
GNU Autoconf2.53 (or newer)
GNU Automake1.5 (or newer)
Perl5.6.0 (or newer)
Boost1.31.0
CppDOM0.3.1 (or newer)
Java 2 Platform (for Tweek and VRJConfig)1.3.1 or newer (1.4.2 is recommended)

Officially Supported Platforms

Table 2.2. IRIX

Operating System6.5
MIPSpro Compilers7.3.1.3m

Table 2.3. Red Hat Linux

Operating System8.0
GCC Compilers3.2
Mesa 3DComes with XFree86 4.x package

Table 2.4. Fedora Core

Operating System1
GCC Compilers3.3
Mesa 3DComes with XFree86 4.x package

Table 2.5. Win32

Operating SystemWindows 2000/XP[a]
Microsoft Visual Studio7.0 (.NET 2002) or 7.1 (.NET 2003)
Juggler ToolsLatest
Cygwin1.3 (including Perl 5.6.1 or newer)
NSPR4.1 (or newer)

[a] Windows 2000 (or XP) is needed only for compiling the VR Juggler libraries. Applications can be compiled against the libraries on Windows 95/98/ME.

Platforms Not Officially Supported

Table 2.6. HP-UX

Operating System11.00
aCCA.03.30
OpenGL1.1

Table 2.7. Solaris

Operating System7
Patch SetJune 7, 2001
GCC3.0.2 (or newer)
GNU Binutils2.12 (or newer)
Mesa 3D3.2 (or newer)
NSPR4.1 (or newer)

Note

Support for the Forte™ C++ (WorkShop™ C++) development package on Solaris™ has not been tested, so only freely available GNU utilities are listed.

Table 2.8. FreeBSD

Operating System5.0 (or newer)
GCC3.2
Mesa 3DComes with XFree86 4.x package

Table 2.9. Mac OS X

Operating System10.2
GCCComes with developer Tools
OpenGL FrameworkComes with the OS