The preferred Internet distribution format for Mac OS X is the
disk image (file extension .dmg). Double-clicking
on the .dmg file mounts the disk image which can
then be opened. Pre-compiled versions of VR Juggler for Mac OS X are
distributed in this manner. Within the mounted disk image, there is an
installer program for the VR Juggler release (file extension
.pkg)[1].
Before installing, read any HTML files included with the VR Juggler distribution. These will contain relevant information about updating an existing VR Juggler installation or how to use the VR Juggler installer that is not covered here.
Double-clicking on the VR Juggler installer will install VR
Juggler. The VR Juggler libraries will be installed to
/usr/local, and the dependencies will be installed
to /usr/local/vrjuggler-deps. The application
bundles for the Tweek Java GUI and VRJConfig
will be installed to /Applications. Finally, the
file ~/.MacOSX/environment.plist will be updated to
set the VR Juggler-related environment variables (see Chapter 2, Environment Variables).
The application bundles for the Tweek Java GUI and VRJConfig are still in the early stages of development. For convenience, the command line versions of these applications are also installed. Running tweek or vrjconfig from a terminal window will start those applications just as would be done on other operating systems. At some point, the command line verrsions of these applications will probably be removed on Mac OS X in favor of exclusive use of the application bundles.
[1] Unfortunately, the complexity of VR Juggler prevents it from being installed using the preferred drag-and-drop method.