Changeset 19469

Show
Ignore:
Timestamp:
11/11/06 11:13:34 (2 years ago)
Author:
patrick
Message:

Regen.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • juggler/trunk/INSTALL.html

    r19461 r19469  
    22      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> 
    33   <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 
     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="#d0e250">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="#d0e332">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e343">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 
    55         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 
    66      Project. This is the code that will become VR Juggler 2.2, and it is the 
    …… 
    104104            can be downloaded from <a href="http://java.sun.com/j2se/" target="_top">http://java.sun.com/j2se/</a>.</p></li><li><p>omniORB (<a href="http://www.jdom.org/" target="_top">http://omniorb.sourceforge.net/</a>): 
    105105            A C++ implementation of CORBA 2.3, required for the Tweek C++ 
    106             API.</p></li></ul></div><p>The following are fully optional packages that are primarily of 
     106            API.</p></li><li><p>Doozer (<a href="http://sourceforge.net/projects/doozer" target="_top">http://sourceforge.net/projects/doozer</a>): 
     107            A collection of makefile stubs written for use with GNU Make and 
     108            intended for simplifying the creation of cross-platform VR Juggler 
     109            application builds. Version 2.1.3 or newer is needed for building 
     110            VR Juggler sample applications.</p></li></ul></div><p>The following are fully optional packages that are primarily of 
    107111      interest only to people doing development on the Juggler Suite 
    108112      itself:</p><div class="itemizedlist"><ul type="disc"><li><p>JUnit (<a href="http://www.junit.org/" target="_top">http://www.junit.org/</a>): A unit 
    …… 
    123127         you can execute the following command from a shell to get the code 
    124128         from our Subversion repository:</p><pre class="screen">svn co https://realityforge.vrsource.org/svn/vrjuggler/juggler/trunk juggler 
    125 </pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e244"></a>Downloading Third-Party Dependencies</h3></div></div></div><p>In addition to source the dependencies acquired through 
     129</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e250"></a>Downloading Third-Party Dependencies</h3></div></div></div><p>In addition to source the dependencies acquired through 
    126130         Subversion, there are some third-party dependencies that must be 
    127131         installed separately. Remember that no Java code in VR Juggler can be 
    128          used without the JDK and a working Java version of CORBA.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e249"></a>Boost</h4></div></div></div><p>The minimum required version of Boost, as of this writing, 
     132         used without the JDK and a working Java version of CORBA.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e255"></a>Boost</h4></div></div></div><p>The minimum required version of Boost, as of this writing, 
    129133            is 1.31.0. The Boost source can be downloaded from <a href="http://www.sf.net/projects/boost/" target="_top">http://www.sf.net/projects/boost/</a>. 
    130134            To compile and install Boost, refer to its installation 
    …… 
    133137            to as &#8220;<span class="quote">boost-jam</span>&#8221; on the Boost download page) to 
    134138            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 
    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 
     139               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="d0e278"></a>CppDOM</h4></div></div></div><p>For XML processing, we use CppDOM 0.6.5 or newer. The source 
    136140            and binary distributions for some platforms can be downloaded from 
    137141            <a href="http://www.sf.net/projects/xml-cppdom/" target="_top">http://www.sf.net/projects/xml-cppdom/</a>. 
    …… 
    139143            must compile and install CppDOM yourself. Note that you need SCons 
    140144            (<a href="http://scons.sourceforge.net/" target="_top">http://scons.sourceforge.net/</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 
     145            to build and install CppDOM.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e289"></a>GMTL</h4></div></div></div><p>For high-level mathematical operations, we use GMTL 0.4.12 
    142146            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>. 
    143147            Note that you need SCons (<a href="http://scons.sourceforge.net/" target="_top">http://scons.sourceforge.net/</a>) 
    144             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 
     148            to build and install GMTL.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e300"></a>Netscape Portable Runtime (NSPR)</h4></div></div></div><p>Our operating system abstraction, VPR, can make use of NSPR 
    145149            for operating system primitives. On some platforms (IRIX, FreeBSD, 
    146150            Linux, Mac OS X), the use of NSPR is strictly optional. On others 
    …… 
    148152            system, you should decide whether you need NSPR. Binary versions 
    149153            of NSPR can be downloaded from <a href="ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases" target="_top">ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases</a>. 
    150             At this time, we recommend the use of version 4.2 or newer.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e302"></a>Java Developer Kit (also called the J2SE SDK)</h4></div></div></div><p>We make use of the Java programming language in addition to 
     154            At this time, we recommend the use of version 4.2 or newer.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e308"></a>Java Developer Kit (also called the J2SE SDK)</h4></div></div></div><p>We make use of the Java programming language in addition to 
    151155            C++. Java is used exclusively for GUIs such as Tweek and VRJConfig 
    152156            (which is a JavaBean that is loaded into Tweek). To compile the 
    153157            Java code, a JDK is necessary. We currently require version 1.4 or 
    154158            newer. The Java Standard Edition can be downloaded from <a href="http://java.sun.com/j2se/" target="_top">http://java.sun.com/j2se/</a>. 
    155             More information can be found at <a href="http://java.sun.com/" target="_top">http://java.sun.com/</a>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e313"></a>omniORB</h4></div></div></div><p>omniORB is a C++ implementation of CORBA 2.3. It is required 
     159            More information can be found at <a href="http://java.sun.com/" target="_top">http://java.sun.com/</a>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e319"></a>omniORB</h4></div></div></div><p>omniORB is a C++ implementation of CORBA 2.3. It is required 
    156160            in order to compile the Tweek C++ API. At this time, the Tweek C++ 
    157161            API is not required for VR Juggler, but this situation will change 
    …… 
    160164            <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. 
    161165      We focus on VR Juggler as a whole, but information about some of the 
    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 
     166      individual components is provided later.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e332"></a>Important Note Regarding Compiling</h3></div></div></div><p>You have downloaded <span class="emphasis"><em>developmental</em></span> code. It 
    163167         may not be stable, and it may not even compile. Compiling VR Juggler 
    164168         itself can be a little complicated for anyone who does not have some 
    165169         background in using Subversion, Autoconf, C++, and 
    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 
     170         <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="d0e343"></a>Compiling the Juggler Suite of Tools</h3></div></div></div><p>This section explains how to get, configure, and compile all of 
    167171         the tools that make up VR Juggler. Each tool compiles to its own 
    168172         library and can be installed individually. (Refer to the 
    …… 
    171175         solution. After getting the dependencies needed to compile VR Juggler 
    172176         (see the next section), refer to the <a href="README-WINDOWS.html" target="_top">README-WINDOWS.html</a> file located in 
    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 
     177         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="d0e356"></a>Per-Module Dependencies</h4></div></div></div><p>Here, we provide per-module dependency information. Given 
    174178            that the dependencies for any single module are met, the modules 
    175179            may be reused effectively outside the scope of immersive VR 
    …… 
    177181            <span class="emphasis"><em>minimum</em></span> required version for each dependency, 
    178182            and where appropriate, we note which dependencies are 
    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 
     183            optional.</p><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e364"></a>VPR</h5></div></div></div><p>VPR provides a cross-platform, object-oriented operating 
    180184               system abstraction. It is the foundation for all other Juggler 
    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 
     185               modules.</p><div class="itemizedlist"><ul type="disc"><li><p>CppDOM 0.6.6</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="d0e379"></a>Tweek C++ API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    182186               system on top of CORBA. The Tweek C++ API provides the C++ 
    183187               component of that system. Code written on top of the Tweek C++ 
    184188               API normally acts as the model piece of the distributed 
    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 
     189               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="d0e391"></a>Tweek Java API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    186190               system on top of CORBA. The Tweek Java API provides the Java 
    187191               component of that system. The main part of the Tweek Java API 
    …… 
    189193               Tweek Beans that normally function as the view and controller 
    190194               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 
    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 
     195                     source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e409"></a>Tweek Python API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    192196               system on top of CORBA. The Tweek Python API provides the 
    193197               Python component of that system. The main part of the Tweek 
    …… 
    195199               application that loads Python modules that normally function as 
    196200               the view and controller pieces of the distributed 
    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 
     201               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="d0e424"></a>JCCL C++ API</h5></div></div></div><p>The JCCL C++ API provides an interface for loading 
    198202               XML-based configurations. It includes the run-time 
    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 
     203               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="d0e433"></a>JCCL Java API</h5></div></div></div><p>The JCCL Java API provides a programming interface for 
    200204               editing Juggler configuration files and config definition files 
    201205               as well as JavaBeans for editing these files using a graphical 
    202206               interface.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek Java API</p></li><li><p>TableLayout package (included with Juggler 
    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 
     207                     source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e445"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
    204208               (C++)</h5></div></div></div><p>The C++ JCCL Remote Run-Time Reconfiguration Plug-in is 
    205209               an optional extension to the JCCL Config Manager for allowing 
    206210               remote manipulation of a Juggler configuration at run time 
    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 
     211               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="d0e454"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
    208212               (Java)</h5></div></div></div><p>The Java JCCL Remote Run-Time Reconfiguration Plug-in is 
    209213               an optional extension that provides the features needed for a 
    210214               Java-based editor to communicate with the C++ Remote Run-Time 
    211215               Reconfiguration Plug-in to edit Juggler configurations 
    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 
     216               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="d0e463"></a>Sonix</h5></div></div></div><p>Sonix is an abstraction layer for positional sound 
    213217               software. Sonix itself cannot play audio, but it includes 
    214218               plug-ins based on popular interfaces for playing audio. Each 
    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 
     219               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="d0e475"></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="d0e488"></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="d0e498"></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="d0e508"></a>Gadgeteer</h5></div></div></div><p>Gadgeteer handles all input devices that can be used by 
     220               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="d0e526"></a>Gadgeteer Device Driver Plug-ins</h5></div></div></div><p>The device driver plug-ins for Gadgeteer are independent 
    217221               components that are discovered and used at run time based on 
    218222               the application configuration. Drivers with dependencies are 
    219223               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 
    220224                     plug-in</p></li><li><p>Microsoft Speech API for the MS Speech API driver 
    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 
     225                     plug-in</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e544"></a>Gadgeteer Cluster Plug-ins</h5></div></div></div><p>The cluster plug-ins extend the functionality of the 
     226               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="d0e553"></a>VR Juggler</h5></div></div></div><p>The VR Juggler module is the unifying piece that pulls 
    223227               all the other Juggler modules together. It provides a virtual 
    224228               platform for VR application development. Real-time rendering is 
    …… 
    226230               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 
    227231                     <span class="emphasis"><em>optional</em></span> OpenGL Performer Draw 
    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 
     232                     Manager</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e574"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
    229233               (C++)</h5></div></div></div><p>The C++ VR Juggler Run-Time Performance Monitoring 
    230234               Plug-in provides an optional extension to VR Juggler for remote 
    231235               visualization of performance metrics that are captured while 
    232236               running a VR Juggler application. Communication is performed 
    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 
     237               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="d0e586"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
    234238               (Java)</h5></div></div></div><p>The Java VR Juggler Run-Time Performance Monitoring 
    235239               Plug-in is an optional extension that provides the features 
    …… 
    238242               another JavaBean handled by the Tweek JavaBean Loader, and it 
    239243               uses CORBA to communicate with the C++ VR Juggler Run-Time 
    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 
     244               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="d0e598"></a>VRJConfig</h5></div></div></div><p>VRJConfig is the graphical editor for Juggler 
    241245               configurations. It is a JavaBean loaded by the Tweek JavaBean 
    242246               Loader, and it makes use of the editor Beans provided by the 
    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 
     247               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="d0e610"></a>Preparing Flagpoll</h4></div></div></div><p>The Flagpoll software has a default search path where it 
    244248            looks for <code class="filename">.pc</code> and <code class="filename">.fpc</code> 
    245249            package metadata files. It searchs 
    …… 
    367371               has information on more advanced uses of 
    368372               <span><strong class="command">configure.pl</strong></span> that are beyond the scope of 
    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 
     373               this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e896"></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 
    370374               Juggler depends on several external software packages. As an 
    371375               example, consider the case where the Boost libraries are 

  • juggler/trunk/INSTALL.txt

    r19461 r19469  
    212212   2.3, required for the Tweek C++ API. 
    213213 
     214*  Doozer (http://sourceforge.net/projects/doozer): A collection of makefile 
     215   stubs written for use with GNU Make and intended for simplifying the 
     216   creation of cross-platform VR Juggler application builds. Version 2.1.3 
     217   or newer is needed for building VR Juggler sample applications. 
     218 
    214219 
    215220 The following are fully optional packages that are primarily of interest 
    …… 
    361366 
    362367 
    363 *  CppDOM 0.6.5 
     368*  CppDOM 0.6.6 
    364369 
    365370*  Boost headers and Boost.Filesystem 1.31.0 
    …… 
    648653 If Flagpoll is not installed in a place where the aclocal tool searches for 
    649654 .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 
     655 This is done by setting the environment variable ACLOCAL_FLAGS to 
     656 "- I .../share/alocal" where "..." is the path to the 
    652657 directory tree where Flagpoll is installed. 
    653658