Changeset 19461

Show
Ignore:
Timestamp:
11/10/06 15:52:47 (2 years ago)
Author:
patrick
Message:

Regen.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • juggler/trunk/INSTALL.html

    r19200 r19461  
    11<html><head> 
    22      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 
    3    <title>Building and Installing the Juggler Project (Version 
    4       2.1/2.2)</title><link rel="stylesheet" href="base_style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.70.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="d0e1"></a>Building and Installing the Juggler Project (Version 
    5       2.1/2.2)</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">The Juggler Team</span></h3></div></div></div><div><p class="pubdate">$Date$</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e15">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e32">Important Notes for IRIX Users</a></span></dt><dt><span class="section"><a href="#d0e116">Important Note for Windows Users</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e124">Build Tools</a></span></dt><dt><span class="section"><a href="#source.code.section">Getting the Source Code and the Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="#section.cvs.access">How to Get the Juggler Suite from Subversion</a></span></dt><dt><span class="section"><a href="#d0e244">Downloading Third-Party Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="#compile.section">Compiling</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e336">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e347">Compiling the Juggler Suite of Tools</a></span></dt><dt><span class="section"><a href="#compile.individual.section">Tips for Compiling Individual Tools in the Juggler 
     3   <title>Building and Installing the Juggler Project (Version 2.1/2.2)</title><link rel="stylesheet" href="base_style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.71.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="d0e1"></a>Building and Installing the Juggler Project (Version 
     4      2.1/2.2)</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">The Juggler Team</span></h3></div></div></div><div><p class="pubdate">$Date$</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e15">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e32">Important Notes for IRIX Users</a></span></dt><dt><span class="section"><a href="#d0e116">Important Note for Windows Users</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e124">Build Tools</a></span></dt><dt><span class="section"><a href="#source.code.section">Getting the Source Code and the Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="#section.cvs.access">How to Get the Juggler Suite from Subversion</a></span></dt><dt><span class="section"><a href="#d0e244">Downloading Third-Party Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="#compile.section">Compiling</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e326">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e337">Compiling the Juggler Suite of Tools</a></span></dt><dt><span class="section"><a href="#compile.individual.section">Tips for Compiling Individual Tools in the Juggler 
    65         Suite</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e15"></a>Introduction</h2></div></div></div><p>You have downloaded the source code for Version 2.1 of the Juggler 
    76      Project. This is the code that will become VR Juggler 2.2, and it is the 
    …… 
    7776      Juggler:</p><div class="itemizedlist"><ul type="disc"><li><p>GNU Make 3.79 or newer</p></li><li><p>GNU Autoconf 2.53 or newer</p></li><li><p>GNU Automake 1.8 or newer</p></li></ul></div><p>Additionally, VR Juggler 2.1 and beyond require the <a href="https://realityforge.vrsource.org/view/FlagPoll/" target="_top">Flagpoll</a> 
    7877      software tool. As of this writing, the minimum required version is 
    79       0.5.0. It is recommended that all of these tools be installed in either 
     78      0.8.1. It is recommended that all of these tools be installed in either 
    8079      the <code class="filename">/usr</code> or the <code class="filename">/usr/local</code> 
    8180      directory trees so that search paths do not have to be extended.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="source.code.section"></a>Getting the Source Code and the Dependencies</h2></div></div></div><p>In this section, we explain how to get the Juggler Project source 
    …… 
    134133            to as &#8220;<span class="quote">boost-jam</span>&#8221; on the Boost download page) to 
    135134            build Boost.</p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>Mac OS X users should compile the Boost libraries using 
    136                the &#8220;<span class="quote">darwin</span>&#8221; toolset.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e272"></a>CppDOM</h4></div></div></div><p>For XML processing, we use CppDOM 0.3.2 or newer. The source 
     135               the &#8220;<span class="quote">darwin</span>&#8221; toolset.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e272"></a>CppDOM</h4></div></div></div><p>For XML processing, we use CppDOM 0.6.5 or newer. The source 
    137136            and binary distributions for some platforms can be downloaded from 
    138137            <a href="http://www.sf.net/projects/xml-cppdom/" target="_top">http://www.sf.net/projects/xml-cppdom/</a>. 
    …… 
    140139            must compile and install CppDOM yourself. Note that you need SCons 
    141140            (<a href="http://scons.sourceforge.net/" target="_top">http://scons.sourceforge.net/</a>) 
    142             to build and install CppDOM.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e283"></a>GMTL</h4></div></div></div><p>For high-level mathematical operations, we use GMTL 0.3.2 or 
    143             newer. The source distribution can be downloaded from <a href="http://www.sf.net/projects/ggt/" target="_top">http://www.sf.net/projects/ggt/</a>. 
     141            to build and install CppDOM.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e283"></a>GMTL</h4></div></div></div><p>For high-level mathematical operations, we use GMTL 0.4.12 
     142            or newer. The source distribution can be downloaded from <a href="http://www.sf.net/projects/ggt/" target="_top">http://www.sf.net/projects/ggt/</a>. 
    144143            Note that you need SCons (<a href="http://scons.sourceforge.net/" target="_top">http://scons.sourceforge.net/</a>) 
    145144            to build and install GMTL.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e294"></a>Netscape Portable Runtime (NSPR)</h4></div></div></div><p>Our operating system abstraction, VPR, can make use of NSPR 
    …… 
    157156            in order to compile the Tweek C++ API. At this time, the Tweek C++ 
    158157            API is not required for VR Juggler, but this situation will change 
    159             in the near future. At this time, we primarily use omniORB 4.0.x. 
    160             omniORB can be downloaded from <a href="http://omniorb.sourceforge.net/" target="_top">http://omniorb.sourceforge.net/</a>.</p><p>omniORB 3.0 has strange conventions for how installations 
    161             are made. Within the <code class="filename">bin</code> and 
    162             <code class="filename">lib</code> directories, there are platform-specific 
    163             subdirectories that contain the actual binaries (except when 
    164             installed on FreeBSD via the Ports Collection). Because of this, 
    165             several extra options must be specified in order to tell the Tweek 
    166             configure script where to find everything. Please refer to <a href="#tweek.build.section" title="Tweek">the section called &#8220;Tweek&#8221;</a> for more details on this.</p></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="compile.section"></a>Compiling</h2></div></div></div><p>In this section, we describe how to compile the Juggler Project. 
     158            in the near future. At this time, we primarily use omniORB 4.0.x; 
     159            omniORB 3.0 is not supported. omniORB can be downloaded from 
     160            <a href="http://omniorb.sourceforge.net/" target="_top">http://omniorb.sourceforge.net/</a>.</p></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="compile.section"></a>Compiling</h2></div></div></div><p>In this section, we describe how to compile the Juggler Project. 
    167161      We focus on VR Juggler as a whole, but information about some of the 
    168       individual components is provided later.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e336"></a>Important Note Regarding Compiling</h3></div></div></div><p>You have downloaded <span class="emphasis"><em>developmental</em></span> code. It 
     162      individual components is provided later.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e326"></a>Important Note Regarding Compiling</h3></div></div></div><p>You have downloaded <span class="emphasis"><em>developmental</em></span> code. It 
    169163         may not be stable, and it may not even compile. Compiling VR Juggler 
    170164         itself can be a little complicated for anyone who does not have some 
    171165         background in using Subversion, Autoconf, C++, and 
    172          <span><strong class="command">make</strong></span> or Visual Studio.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e347"></a>Compiling the Juggler Suite of Tools</h3></div></div></div><p>This section explains how to get, configure, and compile all of 
     166         <span><strong class="command">make</strong></span> or Visual Studio.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e337"></a>Compiling the Juggler Suite of Tools</h3></div></div></div><p>This section explains how to get, configure, and compile all of 
    173167         the tools that make up VR Juggler. Each tool compiles to its own 
    174168         library and can be installed individually. (Refer to the 
    …… 
    177171         solution. After getting the dependencies needed to compile VR Juggler 
    178172         (see the next section), refer to the <a href="README-WINDOWS.html" target="_top">README-WINDOWS.html</a> file located in 
    179          this directory. Do not bother to the rest of this document.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e360"></a>Per-Module Dependencies</h4></div></div></div><p>Here, we provide per-module dependency information. Given 
     173         this directory. Do not bother to the rest of this document.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e350"></a>Per-Module Dependencies</h4></div></div></div><p>Here, we provide per-module dependency information. Given 
    180174            that the dependencies for any single module are met, the modules 
    181175            may be reused effectively outside the scope of immersive VR 
    …… 
    183177            <span class="emphasis"><em>minimum</em></span> required version for each dependency, 
    184178            and where appropriate, we note which dependencies are 
    185             optional.</p><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e368"></a>VPR</h5></div></div></div><p>VPR provides a cross-platform, object-oriented operating 
     179            optional.</p><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e358"></a>VPR</h5></div></div></div><p>VPR provides a cross-platform, object-oriented operating 
    186180               system abstraction. It is the foundation for all other Juggler 
    187                modules.</p><div class="itemizedlist"><ul type="disc"><li><p>CppDOM 0.3.2</p></li><li><p>Boost headers and Boost.Filesystem 1.31.0</p></li><li><p>NSPR (Windows, Solaris, and HP-UX only) 4.4</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e383"></a>Tweek C++ API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
     181               modules.</p><div class="itemizedlist"><ul type="disc"><li><p>CppDOM 0.6.5</p></li><li><p>Boost headers and Boost.Filesystem 1.31.0</p></li><li><p>NSPR (Windows, Solaris, and HP-UX only) 4.4</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e373"></a>Tweek C++ API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    188182               system on top of CORBA. The Tweek C++ API provides the C++ 
    189183               component of that system. Code written on top of the Tweek C++ 
    190184               API normally acts as the model piece of the distributed 
    191                model/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>omniORB 4.0</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e395"></a>Tweek Java API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
     185               model/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>omniORB 4.0</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e385"></a>Tweek Java API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    192186               system on top of CORBA. The Tweek Java API provides the Java 
    193187               component of that system. The main part of the Tweek Java API 
    …… 
    195189               Tweek Beans that normally function as the view and controller 
    196190               pieces of the distributed module/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>J2SE SDK 1.4</p></li><li><p>JDOM (included with Juggler source)</p></li><li><p>Ant (included with Juggler source)</p></li><li><p>JacORB IDL-to-Java compiler (included with Juggler 
    197                      source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e413"></a>Tweek Python API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
     191                     source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e403"></a>Tweek Python API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    198192               system on top of CORBA. The Tweek Python API provides the 
    199193               Python component of that system. The main part of the Tweek 
    …… 
    201195               application that loads Python modules that normally function as 
    202196               the view and controller pieces of the distributed 
    203                module/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>Python 2.3</p></li><li><p>omniORBpy 2.0</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e428"></a>JCCL C++ API</h5></div></div></div><p>The JCCL C++ API provides an interface for loading 
     197               module/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>Python 2.3</p></li><li><p>omniORBpy 2.0</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e418"></a>JCCL C++ API</h5></div></div></div><p>The JCCL C++ API provides an interface for loading 
    204198               XML-based configurations. It includes the run-time 
    205                reconfiguration feature of Juggler.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e437"></a>JCCL Java API</h5></div></div></div><p>The JCCL Java API provides a programming interface for 
     199               reconfiguration feature of Juggler.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e427"></a>JCCL Java API</h5></div></div></div><p>The JCCL Java API provides a programming interface for 
    206200               editing Juggler configuration files and config definition files 
    207201               as well as JavaBeans for editing these files using a graphical 
    208202               interface.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek Java API</p></li><li><p>TableLayout package (included with Juggler 
    209                      source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e449"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
     203                     source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e439"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
    210204               (C++)</h5></div></div></div><p>The C++ JCCL Remote Run-Time Reconfiguration Plug-in is 
    211205               an optional extension to the JCCL Config Manager for allowing 
    212206               remote manipulation of a Juggler configuration at run time 
    213                based on Tweek.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e458"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
     207               based on Tweek.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e448"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
    214208               (Java)</h5></div></div></div><p>The Java JCCL Remote Run-Time Reconfiguration Plug-in is 
    215209               an optional extension that provides the features needed for a 
    216210               Java-based editor to communicate with the C++ Remote Run-Time 
    217211               Reconfiguration Plug-in to edit Juggler configurations 
    218                live.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek Java API</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e467"></a>Sonix</h5></div></div></div><p>Sonix is an abstraction layer for positional sound 
     212               live.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek Java API</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e457"></a>Sonix</h5></div></div></div><p>Sonix is an abstraction layer for positional sound 
    219213               software. Sonix itself cannot play audio, but it includes 
    220214               plug-ins based on popular interfaces for playing audio. Each 
    221                plug-in depends on a specific audio software library.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>GMTL 0.1.9</p></li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e479"></a>Sonix OpenAL Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>OpenAL</p></li><li><p>Free ALUT</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e492"></a>Sonix Audiere Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>Audiere</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e502"></a>Sonix AudioWorks Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>AudioWorks</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e512"></a>Gadgeteer</h5></div></div></div><p>Gadgeteer handles all input devices that can be used by 
    222                VR Juggler applications.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>JCCL</p></li><li><p>GMTL 0.1.9</p></li><li><p>X Window System (non-Windows platforms)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e530"></a>Gadgeteer Device Driver Plug-ins</h5></div></div></div><p>The device driver plug-ins for Gadgeteer are independent 
     215               plug-in depends on a specific audio software library.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>GMTL 0.4.12</p></li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e469"></a>Sonix OpenAL Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>OpenAL</p></li><li><p>Free ALUT</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e482"></a>Sonix Audiere Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>Audiere</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e492"></a>Sonix AudioWorks Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>AudioWorks</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e502"></a>Gadgeteer</h5></div></div></div><p>Gadgeteer handles all input devices that can be used by 
     216               VR Juggler applications.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>JCCL</p></li><li><p>GMTL 0.4.12</p></li><li><p>X Window System (non-Windows platforms)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e520"></a>Gadgeteer Device Driver Plug-ins</h5></div></div></div><p>The device driver plug-ins for Gadgeteer are independent 
    223217               components that are discovered and used at run time based on 
    224218               the application configuration. Drivers with dependencies are 
    225                optional.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li><li><p>VRPN 06.06 for the VRPN driver plug-in</p></li><li><p>TrackD API 4 for the TrackD API driver 
     219               optional.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li><li><p>VRPN 07.03 for the VRPN driver plug-in</p></li><li><p>TrackD API 4 for the TrackD API driver 
    226220                     plug-in</p></li><li><p>Microsoft Speech API for the MS Speech API driver 
    227                      plug-in</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e548"></a>Gadgeteer Cluster Plug-ins</h5></div></div></div><p>The cluster plug-ins extend the functionality of the 
    228                clustering infrastructure built into Gadgeteer.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e557"></a>VR Juggler</h5></div></div></div><p>The VR Juggler module is the unifying piece that pulls 
     221                     plug-in</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e538"></a>Gadgeteer Cluster Plug-ins</h5></div></div></div><p>The cluster plug-ins extend the functionality of the 
     222               clustering infrastructure built into Gadgeteer.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e547"></a>VR Juggler</h5></div></div></div><p>The VR Juggler module is the unifying piece that pulls 
    229223               all the other Juggler modules together. It provides a virtual 
    230224               platform for VR application development. Real-time rendering is 
    …… 
    232226               is optional.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li><li><p>Sonix</p></li><li><p>OpenGL</p></li><li><p>OpenGL Performer for the 
    233227                     <span class="emphasis"><em>optional</em></span> OpenGL Performer Draw 
    234                      Manager</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e578"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
     228                     Manager</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e568"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
    235229               (C++)</h5></div></div></div><p>The C++ VR Juggler Run-Time Performance Monitoring 
    236230               Plug-in provides an optional extension to VR Juggler for remote 
    237231               visualization of performance metrics that are captured while 
    238232               running a VR Juggler application. Communication is performed 
    239                using the Tweek C++ API on top of CORBA.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li><li><p>VR Juggler</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e590"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
     233               using the Tweek C++ API on top of CORBA.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li><li><p>VR Juggler</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e580"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
    240234               (Java)</h5></div></div></div><p>The Java VR Juggler Run-Time Performance Monitoring 
    241235               Plug-in is an optional extension that provides the features 
    …… 
    244238               another JavaBean handled by the Tweek JavaBean Loader, and it 
    245239               uses CORBA to communicate with the C++ VR Juggler Run-Time 
    246                Performance Monitoring Plug-in.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JFreeChart (included with Juggler source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e602"></a>VRJConfig</h5></div></div></div><p>VRJConfig is the graphical editor for Juggler 
     240               Performance Monitoring Plug-in.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JFreeChart (included with Juggler source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e592"></a>VRJConfig</h5></div></div></div><p>VRJConfig is the graphical editor for Juggler 
    247241               configurations. It is a JavaBean loaded by the Tweek JavaBean 
    248242               Loader, and it makes use of the editor Beans provided by the 
    249                JCCL Java API.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JGraph (included with Juggler source)</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="config.vrjuggler.section"></a>Configuring the Juggler Build</h4></div></div></div><p>We now explain the process by which the Juggler build is 
     243               JCCL Java API.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JGraph (included with Juggler source)</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e604"></a>Preparing Flagpoll</h4></div></div></div><p>The Flagpoll software has a default search path where it 
     244            looks for <code class="filename">.pc</code> and <code class="filename">.fpc</code> 
     245            package metadata files. It searchs 
     246            <code class="filename">/usr/lib/pkgconfig</code>, 
     247            <code class="filename">/usr/lib/flagpoll</code>, 
     248            <code class="filename">/usr/lib64/pkgconfig</code>, 
     249            <code class="filename">/usr/lib64/flagpoll</code>, 
     250            <code class="filename">/usr/share/pkgconfig</code>, and 
     251            <code class="filename">/usr/share/flagpoll</code>. If 
     252            <code class="envar">LD_LIBRARY_PATH</code> (or 
     253            <code class="envar">DYLD_LIBRARY_PATH</code> on Mac OS X) is set, Flagpoll 
     254            will search each of the directories in that environment variable 
     255            for subdirectories named <code class="filename">pkgconfig</code> and 
     256            <code class="filename">flagpoll</code>. Users can extend this search path 
     257            further by setting the environment variables 
     258            <code class="envar">PKG_CONFIG_PATH</code> and/or <code class="envar">FLAGPOLL_PATH</code> 
     259            to list more directories for Flagpoll to search. (All of the 
     260            environment variables mentioned here have as their value a 
     261            colon-separated list of directories.)</p><p>The Juggler build relies upon Flagpoll for getting compiler 
     262            and linker flags for the following packages:</p><div class="itemizedlist"><ul type="disc"><li><p>CppDOM</p></li><li><p>GMTL</p></li><li><p>omniORB</p></li></ul></div><p>Therefore, it is critical that Flagpoll be able to find the 
     263            package metadata file for each. For CppDOM, the 
     264            <code class="filename">.fpc</code> file is under the CppDOM 
     265            <code class="filename">lib</code> (or <code class="filename">lib64</code>) directory 
     266            in the <code class="filename">flagpoll</code> subdirectory. For omniORB, 
     267            the <code class="filename">.pc</code> files (there are several) are under 
     268            the omniORB <code class="filename">lib</code> (or 
     269            <code class="filename">lib64</code>) directory in the 
     270            <code class="filename">pkgconfig</code> subdirectory. Finally, for GMTL, 
     271            the <code class="filename">.pc</code> file is under the GMTL 
     272            <code class="filename">share</code> directory in the 
     273            <code class="filename">pkgconfig</code> subdirectory. If these packages are 
     274            installed in <code class="filename">/usr</code>, then Flagpoll will be able 
     275            to find the information it needs with no extra work on the part of 
     276            the user.</p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>If Flagpoll is not installed in a place where the 
     277               <span><strong class="command">aclocal</strong></span> tool searches for 
     278               <code class="filename">.m4</code> files by default, then it is necessary 
     279               to extend <span><strong class="command">aclocal</strong></span>'s search path. This is 
     280               done by setting the environment variable 
     281               <code class="envar">ACLOCAL_FLAGS</code> to &#8220;<span class="quote"><code class="literal">-I 
     282               .../share/alocal</code></span>&#8221; where 
     283               &#8220;<span class="quote"><code class="literal">...</code></span>&#8221; is the path to the 
     284               directory tree where Flagpoll is installed.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="config.vrjuggler.section"></a>Configuring the Juggler Build</h4></div></div></div><p>We now explain the process by which the Juggler build is 
    250285            configured. The Juggler Suite makes use of the well-known, widely 
    251286            used GNU tools Autoconf and GNU Make. We provide a wrapper script 
    …… 
    260295            be a fundamental part of the operating system installation (such 
    261296            as OpenGL) or if it is an &#8220;<span class="quote">add-on</span>&#8221; package (such as 
    262             Boost, GMTL, CppDOM, or omniORB).</p><div class="sidebar"><p>The distinction between <code class="filename">/usr/local</code> 
     297            Boost, GMTL, CppDOM, or omniORB).</p><div class="sidebar"><p class="title"><b></b></p><p>The distinction between <code class="filename">/usr/local</code> 
    263298               and <code class="filename">/usr</code> is complicated by the fact that 
    264299               most Linux distributions have <span class="emphasis"><em>everything</em></span> 
    …… 
    300335                     <code class="filename">build.solaris.nspr</code>, etc.</p></li><li><p>Enter the new build directory.</p><pre class="screen">cd build.linux.posix</pre></li><li><p>Configure all the modules making up VR Juggler. 
    301336                     This is when you must tell the module configure scripts 
    302                      where all the package dependencies are found.</p><pre class="screen">../configure.pl --prefix=$HOME/vrjuggler-2.2 --with-java-orb=JDK</pre><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>You will probably have to specify the paths to 
    303                         your local CppDOM, GMTL, and Boost installations using 
    304                         the options <code class="option">--with-cppdom</code>, 
    305                         <code class="option">--with-gmtl</code>, and 
    306                         <code class="option">--with-boost</code> unless they are 
    307                         installed in the default location 
     337                     where all the package dependencies are found.</p><pre class="screen">../configure.pl --prefix=$HOME/vrjuggler-2.2 --with-java-orb=JDK</pre><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>You will probably have to specify the path to 
     338                        your local Boost installation using the option 
     339                        <code class="option">--with-boost</code> unless it is installed 
     340                        in the default location 
    308341                        (<code class="filename">/usr/local</code>). By default, Boost 
    309                         1.31 installs its header files in a subdirectory of 
    310                         <code class="filename">include</code> called 
    311                         <code class="filename">boost-1_31</code>. That is, if Boost is 
    312                         installed in 
     342                        1.31 and newer install the Boost header files in a 
     343                        subdirectory of <code class="filename">include</code> called 
     344                        <code class="filename">boost-VERSION</code> (where 
     345                        <code class="filename">VERSION</code> is the Boost version 
     346                        number with underscores instead of periods). That is, 
     347                        if Boost 1.34 is installed in 
    313348                        <code class="filename">/home/user1/pkgs/boost</code>, the 
    314349                        header files will be in 
    315                         <code class="filename">/home/user1/pkgs/boost/include/boost-1_31</code>. 
     350                        <code class="filename">/home/user1/pkgs/boost/include/boost-1_34</code>. 
    316351                        In this case, you must also specify the option 
    317                         <code class="option">--with-boost-includes=/home/user1/pkgs/boost/include/boost-1_31</code> 
    318                         when running <span><strong class="command">configure.pl</strong></span>.</p></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>If Flagpoll is not installed in a place where 
    319                         the <span><strong class="command">aclocal</strong></span> tool searches for 
    320                         <code class="filename">.m4</code> files by default, then it is 
    321                         necessary to extend <span><strong class="command">aclocal</strong></span>'s 
    322                         search path. This is done by setting the environment 
    323                         variable <code class="envar">ACLOCAL_FLAGS</code> to 
    324                         &#8220;<span class="quote"><code class="literal">-I .../share/alocal</code></span>&#8221; 
    325                         where &#8220;<span class="quote"><code class="literal">...</code></span>&#8221; is the 
    326                         path to the directory tree where Flagpoll is 
    327                         installed.</p></div></li></ol></div><p>By default, the configuration process will configure VR 
     352                        <code class="option">--with-boost-includes=/home/user1/pkgs/boost/include/boost-1_34</code> 
     353                        when running <span><strong class="command">configure.pl</strong></span>.</p></div></li></ol></div><p>By default, the configuration process will configure VR 
    328354               Juggler and all of its dependencies. This includes Sonix, which 
    329                is an interesting special case. Sonix can make use of Aaudiere, 
     355               is an interesting special case. Sonix can make use of Audiere, 
    330356               OpenAL, or AudioWorks to add sound to VR Juggler applications. 
    331357               If none of those packages is found, Sonix will &#8220;<span class="quote">stub 
    …… 
    341367               has information on more advanced uses of 
    342368               <span><strong class="command">configure.pl</strong></span> that are beyond the scope of 
    343                this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e806"></a>Using Locally Installed Software</h5></div></div></div><p>As noted in <a href="#source.code.section" title="Getting the Source Code and the Dependencies">the section called &#8220;Getting the Source Code and the Dependencies&#8221;</a>, VR 
     369               this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e890"></a>Using Locally Installed Software</h5></div></div></div><p>As noted in <a href="#source.code.section" title="Getting the Source Code and the Dependencies">the section called &#8220;Getting the Source Code and the Dependencies&#8221;</a>, VR 
    344370               Juggler depends on several external software packages. As an 
    345                example, consider the case where the GMTL library is installed 
    346                in <code class="filename">/home/user1/pkgs/GMTL</code> with the headers 
    347                in <code class="filename">/home/user1/pkgs/GMTL/include</code>. To use 
     371               example, consider the case where the Boost libraries are 
     372               installed in <code class="filename">/home/user1/pkgs/boost</code> with 
     373               the headers in 
     374               <code class="filename">/home/user1/pkgs/boost/include</code>. To use 
    348375               this installation, run <span><strong class="command">configure.pl</strong></span> as 
    349                follows:</p><pre class="screen">../configure.pl --with-gmtl=/home/user1/pkgs/GMTL</pre><p>The <code class="option">--with-gmtl</code> option could of course 
    350                be mixed in with those shown in the previous section.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="compile.vrjuggler.section"></a>Compiling VR Juggler</h4></div></div></div><p>Once the configuration process is complete, the code can be 
     376               follows:</p><pre class="screen">../configure.pl --with-boost=/home/user1/pkgs/boost</pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="compile.vrjuggler.section"></a>Compiling VR Juggler</h4></div></div></div><p>Once the configuration process is complete, the code can be 
    351377            compiled. Remember that we require the use of GNU make 3.78 or 
    352378            newer.</p><div class="orderedlist"><ol type="1"><li><p>Compile the source tree using GNU make.</p><pre class="screen">gmake build</pre></li><li><p>Once this completes, you will have a full build of VR 
    …… 
    383409               fact. OpenAL and Audiere can be compiled together, 
    384410               however.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="tweek.build.section"></a>Tweek</h4></div></div></div><p>Tweek needs JDK 1.4 or newer and a C++ CORBA implementation. 
    385             Currently, we primarily use omniORB 4.0, but omniORB 3.0 can be 
    386             used. Visit the <a href="http://omniorb.sourceforge.net/" target="_top">omniORB website</a> to 
     411            Currently, we primarily use omniORB 4.0. Visit the <a href="http://omniorb.sourceforge.net/" target="_top">omniORB website</a> to 
    387412            download omniORB.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>IRIX users must configure Tweek (and its VPR dependency) 
    388413               to use the POSIX subsystem or the NSPR subsystem. omniORB 
    …… 
    397422cd build 
    398423../configure.pl --with-cxx-orb=omniORB4 --with-cxx-orb-root=&lt;OMNIORB_PATH&gt; --with-java-orb=JDK --module=Tweek 
    399 gmake build install</pre><p>If you are using omniORB 3.x, pass 
    400             <code class="option">--with-cxx-orb=omniORB3</code> instead.</p><p>Depending on your omniORB installation, you may have to pass 
    401             extra arguments to <span><strong class="command">configure.pl</strong></span> so that the 
    402             configuration process can find the <span><strong class="command">omniidl</strong></span> 
    403             binary and the omniORB libraries. For example, on Red Hat Linux 
    404             7.2 with omniORB 3.0.x, the following arguments must be specified 
    405             in addition to the above:</p><pre class="screen">--with-cxx-orb-bin=&lt;OMNIORB_PATH&gt;/bin/i586_linux_2.0_glibc --with-cxx-orb-lib=&lt;OMNIORB_PATH&gt;/lib/i586_linux_2.0_glibc</pre></div></div></div></div></body></html> 
     424gmake build install</pre></div></div></div></div></body></html> 

  • juggler/trunk/INSTALL.txt

    r19200 r19461  
    5555 operating systems. We then explain how to get the source code from our 
    5656 Subversion repository. (Those users who downloaded a pre-packaged source 
    57  release can skip ahead to the section called "Using configure.pl"). We 
    58  conclude with instructions on how to build VR Juggler and its individual 
    59  components. 
     57 release can skip ahead to the section called "Using 
     58 configure.pl"). We conclude with instructions on how to build VR 
     59 Juggler and its individual components. 
    6060 
    6161 Before reading further, we recommend that readers take a look at the Wiki 
    …… 
    163163 
    164164 Additionally, VR Juggler 2.1 and beyond require the Flagpoll software tool. 
    165  As of this writing, the minimum required version is 0.5.0. It is 
     165 As of this writing, the minimum required version is 0.8.1. It is 
    166166 recommended that all of these tools be installed in either the /usr or the 
    167167 /usr/local directory trees so that search paths do not have to be extended. 
    …… 
    174174 source code: from a pre-packaged source release archive or from the 
    175175 Subversion repository on RealityForge. If you got the code from a pre- 
    176  packaged source archive, that code is a complete "snapshot" of the 
    177  Subversion repository at the time of release. It contains all dependencies 
    178  that would otherwise have been acquired using Subversion. It does not 
    179  contain binary dependencies that must be downloaded separately (such as 
    180  NSPR, the Java Developer Kit, a C++ compiler, etc.). 
     176 packaged source archive, that code is a complete "snapshot" of 
     177 the Subversion repository at the time of release. It contains all 
     178 dependencies that would otherwise have been acquired using Subversion. It 
     179 does not contain binary dependencies that must be downloaded separately 
     180 (such as NSPR, the Java Developer Kit, a C++ compiler, etc.). 
    181181 
    182182 The current list of required software packages is as follows: 
    …… 
    261261 compile and install Boost, refer to its installation documentation (http:// 
    262262 www.boost.org/more/getting_started.html#Build_Install). Note that you need 
    263  the command bjam (referred to as "boost-jam" on the Boost download page) to 
    264  build Boost. 
     263 the command bjam (referred to as "boost-jam" on the Boost 
     264 download page) to build Boost. 
    265265 
    266266 
    267267Important 
    268268 
    269  Mac OS X users should compile the Boost libraries using the "darwin" 
    270  toolset. 
     269 Mac OS X users should compile the Boost libraries using the 
     270 "darwin" toolset. 
    271271 
    272272 
    273273CppDOM 
    274274 
    275  For XML processing, we use CppDOM 0.3.2 or newer. The source and binary 
     275 For XML processing, we use CppDOM 0.6.5 or newer. The source and binary 
    276276 distributions for some platforms can be downloaded from http://www.sf.net/ 
    277277 projects/xml-cppdom/. If a binary version is not available for your 
    …… 
    282282GMTL 
    283283 
    284  For high-level mathematical operations, we use GMTL 0.3.2 or newer. The 
     284 For high-level mathematical operations, we use GMTL 0.4.12 or newer. The 
    285285 source distribution can be downloaded from http://www.sf.net/projects/ggt/. 
    286286 Note that you need SCons (http://scons.sourceforge.net/) to build and 
    …… 
    314314 compile the Tweek C++ API. At this time, the Tweek C++ API is not required 
    315315 for VR Juggler, but this situation will change in the near future. At this 
    316  time, we primarily use omniORB 4.0.x. omniORB can be downloaded from http:/ 
    317  /omniorb.sourceforge.net/. 
    318  
    319  omniORB 3.0 has strange conventions for how installations are made. Within 
    320  the bin and lib directories, there are platform-specific subdirectories 
    321  that contain the actual binaries (except when installed on FreeBSD via the 
    322  Ports Collection). Because of this, several extra options must be specified 
    323  in order to tell the Tweek configure script where to find everything. 
    324  Please refer to the section called "Tweek" for more details on this. 
     316 time, we primarily use omniORB 4.0.x; omniORB 3.0 is not supported. omniORB 
     317 can be downloaded from http://omniorb.sourceforge.net/. 
    325318 
    326319 
    …… 
    368361 
    369362 
    370 *  CppDOM 0.3.2 
     363*  CppDOM 0.6.5 
    371364 
    372365*  Boost headers and Boost.Filesystem 1.31.0 
    …… 
    480473*  VPR 
    481474 
    482 *  GMTL 0.1.9 
     475*  GMTL 0.4.12 
    483476 
    484477 
    …… 
    523516*  JCCL 
    524517 
    525 *  GMTL 0.1.9 
     518*  GMTL 0.4.12 
    526519 
    527520*  X Window System (non-Windows platforms) 
    …… 
    538531*  Gadgeteer 
    539532 
    540 *  VRPN 06.06 for the VRPN driver plug-in 
     533*  VRPN 07.03 for the VRPN driver plug-in 
    541534 
    542535*  TrackD API 4 for the TrackD API driver plug-in 
    …… 
    615608*  JGraph (included with Juggler source) 
    616609 
     610 
     611 
     612Preparing Flagpoll 
     613 
     614 The Flagpoll software has a default search path where it looks for .pc and 
     615 .fpc package metadata files. It searchs /usr/lib/pkgconfig, /usr/lib/ 
     616 flagpoll, /usr/lib64/pkgconfig, /usr/lib64/flagpoll, /usr/share/pkgconfig, 
     617 and /usr/share/flagpoll. If LD_LIBRARY_PATH (or DYLD_LIBRARY_PATH on Mac OS 
     618 X) is set, Flagpoll will search each of the directories in that environment 
     619 variable for subdirectories named pkgconfig and flagpoll. Users can extend 
     620 this search path further by setting the environment variables 
     621 PKG_CONFIG_PATH and/or FLAGPOLL_PATH to list more directories for Flagpoll 
     622 to search. (All of the environment variables mentioned here have as their 
     623 value a colon-separated list of directories.) 
     624 
     625 The Juggler build relies upon Flagpoll for getting compiler and linker 
     626 flags for the following packages: 
     627 
     628 
     629*  CppDOM 
     630 
     631*  GMTL 
     632 
     633*  omniORB 
     634 
     635 
     636 Therefore, it is critical that Flagpoll be able to find the package 
     637 metadata file for each. For CppDOM, the .fpc file is under the CppDOM lib 
     638 (or lib64) directory in the flagpoll subdirectory. For omniORB, the .pc 
     639 files (there are several) are under the omniORB lib (or lib64) directory in 
     640 the pkgconfig subdirectory. Finally, for GMTL, the .pc file is under the 
     641 GMTL share directory in the pkgconfig subdirectory. If these packages are 
     642 installed in /usr, then Flagpoll will be able to find the information it 
     643 needs with no extra work on the part of the user. 
     644 
     645 
     646Important 
     647 
     648 If Flagpoll is not installed in a place where the aclocal tool searches for 
     649 .m4 files by default, then it is necessary to extend aclocal's search path. 
     650 This is done by setting the environment variable ACLOCAL_FLAGS to "- 
     651 I .../share/alocal" where "..." is the path to the 
     652 directory tree where Flagpoll is installed. 
    617653 
    618654 
    …… 
    646682Using configure.pl 
    647683 
    648  In the base juggler source directory, we have a "global" configure script 
    649  written in Perl called configure.pl. To get the command-line options for 
    650  this script, use one of the following (the second being much more 
    651  detailed): 
     684 In the base juggler source directory, we have a "global" 
     685 configure script written in Perl called configure.pl. To get the command- 
     686 line options for this script, use one of the following (the second being 
     687 much more detailed): 
    652688 
    653689 
    …… 
    677713 various modules, should you need to run one individually. 
    678714 
    679  configure.pl can run in a unique "build" directory or in the directory 
    680  where it resides. Here is how we (the Juggler Team) have been using it: 
     715 configure.pl can run in a unique "build" directory or in the 
     716 directory where it resides. Here is how we (the Juggler Team) have been 
     717 using it: 
    681718 
    682719 
    …… 
    706743     Important 
    707744 
    708       You will probably have to specify the paths to your local CppDOM, 
    709       GMTL, and Boost installations using the options --with-cppdom, --with- 
    710       gmtl, and --with-boost unless they are installed in the default 
    711       location (/usr/local). By default, Boost 1.31 installs its header 
    712       files in a subdirectory of include called boost-1_31. That is, if 
    713       Boost is installed in /home/user1/pkgs/boost, the header files will be 
    714       in /home/user1/pkgs/boost/include/boost-1_31. In this case, you must 
    715       also specify the option --with-boost-includes=/home/user1/pkgs/boost/ 
    716       include/boost-1_31 when running configure.pl. 
    717  
    718  
    719      Important 
    720  
    721       If Flagpoll is not installed in a place where the aclocal tool 
    722       searches for .m4 files by default, then it is necessary to extend 
    723       aclocal's search path. This is done by setting the environment 
    724       variable ACLOCAL_FLAGS to "-I .../share/alocal" where "..." is the 
    725       path to the directory tree where Flagpoll is installed. 
     745      You will probably have to specify the path to your local Boost 
     746      installation using the option --with-boost unless it is installed in 
     747      the default location (/usr/local). By default, Boost 1.31 and newer 
     748      install the Boost header files in a subdirectory of include called 
     749      boost-VERSION (where VERSION is the Boost version number with 
     750      underscores instead of periods). That is, if Boost 1.34 is installed 
     751      in /home/user1/pkgs/boost, the header files will be in /home/user1/ 
     752      pkgs/boost/include/boost-1_34. In this case, you must also specify the 
     753      option --with-boost-includes=/home/user1/pkgs/boost/include/boost-1_34 
     754      when running configure.pl. 
    726755 
    727756 
    728757 By default, the configuration process will configure VR Juggler and all of 
    729758 its dependencies. This includes Sonix, which is an interesting special 
    730  case. Sonix can make use of Aaudiere, OpenAL, or AudioWorks to add sound to 
     759 case. Sonix can make use of Audiere, OpenAL, or AudioWorks to add sound to 
    731760 VR Juggler applications. If none of those packages is found, Sonix will 
    732  "stub out" its sound APIs. This means that Sonix and the VR Juggler Sound 
    733  Manager can still be used in applications, but no audio will be heard at 
    734  run time. See the section called "Sonix" for more information about how to 
    735  configure Sonix to use Audiere, OpenAL, or AudioWorks. 
     761 "stub out" its sound APIs. This means that Sonix and the VR 
     762 Juggler Sound Manager can still be used in applications, but no audio will 
     763 be heard at run time. See the section called "Sonix" for more 
     764 information about how to configure Sonix to use Audiere, OpenAL, or 
     765 AudioWorks. 
    736766 
    737767 For example uses of configure.pl, take a look at the Wiki page relating to 
    …… 
    746776 
    747777 As noted in the section called "Getting the Source Code and the 
    748  Dependencies", VR Juggler depends on several external software packages. As 
    749  an example, consider the case where the GMTL library is installed in 
    750  /home/user1/pkgs/GMTL with the headers in /home/user1/pkgs/ GMTL/include. 
    751  To use this installation, run configure.pl as follows: 
    752  
    753  
    754   ../configure.pl --with-gmtl=/home/user1/pkgs/GMTL 
    755  
    756  The --with-gmtl option could of course be mixed in with those shown in the 
    757  previous section. 
     778 Dependencies", VR Juggler depends on several external software 
     779 packages. As an example, consider the case where the Boost libraries are 
     780 installed in /home/user1/pkgs/boost with the headers in /home/user1/pkgs/ 
     781 boost/include. To use this installation, run configure.pl as follows: 
     782 
     783 
     784  ../configure.pl --with-boost=/home/user1/pkgs/boost 
    758785 
    759786 
    …… 
    824851 
    825852 Tweek needs JDK 1.4 or newer and a C++ CORBA implementation. Currently, we 
    826  primarily use omniORB 4.0, but omniORB 3.0 can be used. Visit the omniORB 
    827  website to download omniORB. 
     853 primarily use omniORB 4.0. Visit the omniORB website to download omniORB. 
    828854 
    829855 
    …… 
    847873  gmake build install 
    848874