VR Juggler

Getting Started Guide

Version 2.2

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with the Invariant Sections being Appendix A, GNU Free Documentation License, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in Appendix A, GNU Free Documentation License.

$Date: 2007-10-21 11:38:15 -0500 (Sun, 21 Oct 2007) $


Table of Contents

Preface
1. Installing VR Juggler
Installing from a Compressed TAR File
Installing from a ZIP File (Windows® only)
Installing from a Disk Image (Mac OS X only)
2. Environment Variables
How to Set Environment Variables
Common Conventions and Background
C-Style Shells (csh, tcsh)
sh-Derived Shells (sh, ksh, bash, zsh, etc.)
DOS Shell
Windows® GUI
Mac OS X
Syntax Used in this Document
Relevant Environment Variables
3. VR Juggler Sample Applications
Tutorial Applications
Advanced OpenGL Performer Applications
4. Compiling a VR Juggler Sample Program
Required Reading
Compiling an Application
Compiling from the Command Line
Compiling Using Microsoft Visual Studio
5. Running a VR Juggler Sample Program
Required Reading
Running an Application with a Simulator Configuration
Starting the Application
Basic Desktop Configuration Controls
Using a Simulated Glove
Using a Simulated Analog Device
Running an Application in a VR System
Single Machine Configuration
Cluster Configuration
A. GNU Free Documentation License
PREAMBLE
APPLICABILITY AND DEFINITIONS
VERBATIM COPYING
COPYING IN QUANTITY
MODIFICATIONS
COMBINING DOCUMENTS
COLLECTIONS OF DOCUMENTS
AGGREGATION WITH INDEPENDENT WORKS
TRANSLATION
TERMINATION
FUTURE REVISIONS OF THIS LICENSE
ADDENDUM: How to use this License for your documents

List of Figures

1.1. Windows Folder View of ZIP File
1.2. Open WinZip Window
1.3. WinZip Extract Dialog
2.1. Windows® 2000 System Properties Dialog
2.2. Windows® XP System Properties Dialog
2.3. Windows® Environment Variable Editor Dialog
4.1. Selecting the Visual C++ Project File
4.2. MPApp Project
4.3. Project Menu
4.4. Build MPApp.exe
5.1. MPApp Running on a Linux Desktop with Multiple Input Windows
5.2. MPApp Running on a Linux Desktop with One Window
5.3. Setting Command Arguments
5.4. Execute MPApp.exe
5.5. MPApp Running on Mac OS X Using Cocoa with One Window
5.6. MPApp Running on Mac OS X Using X11 with One Window

List of Tables

5.1. Moving the simulated head
5.2. Moving the simulated wand
5.3. Moving the camera (multi-window configuration only)
5.4. Analog Device Simulator Keys