General Configuration Notes
Previous  Top  Next


The CAVELib uses a series of configuration files to describe the display environment. Specific descriptions of how to define an environment are discussed below. The CAVELib assumes a standard CAVE display as a 10-foot cube. The origin of the coordinate system (0, 0, 0) for the CAVE is normally located at the center of the floor, that is, 5 feet away from any wall. This means that you have from +5 to -5 feet horizontally and 0 to 10 feet vertically to define objects inside the CAVE. The exact location of the CAVE origin may be defined in the configuration file by the "Origin" option. But this is only used with canonical (e.g. cubic) displays. For all other VR displays the screens' projection planes are defined in CAVE coordinates, a.k.a. relative to some origin. An origin can be defined to be anywhere. Some origin must be decided on, in order to define the projection planes in some coordinate system. If you wish to change the location of the origin, you must change all the configuration settings that rely on it, such as Origin, TransmitterPosition, and ProjectionData , to name a few.

All of the walls of the CAVE share the same reference coordinate system, as shown below. The coordinate system is a "right-handed" system (fingers on the right hand curl from +X toward +Y and the thumb points along +Z). All locations and orientations returned by the trackers to the CAVELib follow this convention.

origins

Here are three recommended origins for a CAVE, an ImmersaDesk, and a RealityCentre.