Q: What do I need to do to compile VR Juggler from CVS?

I want to get the latest VR Juggler 1.1 code from CVS, but I do not know where to start. How do I get the code? Are there external dependencies? What compiler do I use? What platforms are supported?

A: We have written a lot about how to compile from CVS, and ideally, it's as simple as following the instructions.

The following strives to provide a jumping off point for compiling VR Juggler and its component modules from our CVS repository, hosted on SourceForge. The keys sources of information are as follows:

• juggler/INSTALL.html or juggler/INSTALL.txt: The definitive instuction set for compiling from CVS. Once you have the source code, this should be the first document you read.
• BuildingFromSvn: A page on this Wiki that gives lots of helpful tips for compiling our code.
• CompilerStatus: A list of all the compilers and platforms where we know VR Juggler compiles and runs.
• Juggler Team Guide build instructions
• Build System Guide

Getting the Source

Getting External Dependencies

The following is a list of external dependencies, listed in order of importance (more or less).

• Doozer++ (acquired by cvs-gather.pl)
• Boost: http://www.boost.org/ (acquired by cvs-gather.pl)
• !CppDOM: http://xml-cppdom.sourceforge.net/ (acquired by cvs-gather.pl)
• GMTL: http://ggt.sourceforge.net/ (acquired by cvs-gather.pl)
• JDK 1.3 or newer: http://java.sun.com/
• JDOM: http://www.jdom.org/
  • We recommend using Beta8 (this is currently the latest version)
• A Java ORB
  • We use OpenORB, an open source CORBA 2.3 implementation written in pure Java. Versions 1.2.0, 1.2.1, and 1.3.0 (still in beta) have all been used successfully. Java IDL 1.4 (the ORB that ships with the Java Developer's Kit version 1.4.x) works as well. Java IDL 1.3 and older will not work.
  • http://openorb.exolab.com/
  • http://openorb.sourceforge.net/
• NSPR: http://www.mozilla.org/projects/nspr/
• !OpenGL implementation (hardware acceleration is recommended)
• !OpenGL Performer: http://www.sgi.com/
  • Use of Performer is optional, and it is only supported on IRIX and Linux
• !OpenAL
  • A CVS version can be downloaded from: http://www.openal.org/downloads/
  • Use of !OpenAL in Sonix is optional
• AudioWorks
  • Use of AudioWorks in Sonix is optional
  • Commercial audio software
  • Only known to work on IRIX with SPROC threads
• Doozer (acquired by cvs-gather.pl)
• A C++ ORB
  • We use omniORB, an open source CORBA 2.3 implementation written in C++. We have tested versions 3.0.4, 3.0.5, and 4.0.0 extensively.
  • Any C++ CORBA 2.3 implementation can be used, but the Tweek build system has only been tested with omniORB.
  • http://omniorb.sourceforge.net/

===== Win32 specific dependencies ===== * Cygwin:

• http://www.cygwin.com/
• You need cygwin for a shell environment for compiling and developing

• Juggler Tools
  • http://www.vrjuggler.org/vrjuggler/download.php
  • The Juggler Tools module includes a version of makedepend that os meeded by the Juggler build system.

Choosing a Compiler

There are many things to consider when choosing a compiler, and there are many compilers from which to choose. The best place to start when choosing a compiler is the CompilerStatus Wiki page. It contains a comprehensive list of compilers and platforms where we have done testing of VR Juggler 1.0 and 1.1.

Back to: LiveFaq