The following keywords are supported in the CAVELib 2.7 and later versions for backward compatibility purposes. Most of these calls refer to tracking and controller settings for versions of trackd prior to 4.0. These configuration variables or their synonyms are now set in a separate tracker configuration file. This allows continually expanding support for devices without having to update the CAVELib itself. More information about new configuration methods can be found in the trackd section of this manual.
Note: Applying any of the below configuration variables in addition to applying the same or similar variables in the trackd's configuration file will likely result in erroneous data.
BirdsHemisphere <hemisphere>
Specifies which hemisphere to have the Flock-of-Birds tracker use. <hemisphere> should be one of "lower", "upper", "front", "aft", "left", or "right". The default is "lower".
BirdsSensors <headsensor> <wandsensor> ...
Specifies which Flock of Birds sensors to read. The arguments are the numeric ID's of the sensors, as reported by the tracker. The sensors will be stored in the CAVESENSOR list in the order given here; i.e. the first sensor listed will be used for the head, the second for the wand, etc. The default values are "2 3".
BirdsTransmitter <id>
Gives the numeric ID of the Flock of Birds transmitter. The default is "1".
FilterBirds y|n
If this flag is "y", the Flock-of-Birds tracker's hardware filtering option will be enabled.
FilterBirdsParameter <param>
Specifies the argument for the Flock of Birds hardware filtering command. <param> is an integer that defines which filters are to be used; the possible values are described in the Ascension manual under CHANGE VALUE / FILTER STATUS.
HeadSensorOffset <X-offset> <Y-offset> <Z-offset> <units>
Offset values from the position of the head sensor to the point between the user's eyes. The offset is added to the position reported by the head tracker to yield the position that the CAVELib will use for calculating eye positions and their perspective renderings.
HeadSensorRotation <axis-X> <axis-Y> <axis-Z> <angle>
The rotation of the physical head sensor relative to the sensor as reported by the library. This rotation is defined by an axis and an angle of rotation about that vector. The angle is in degrees.
HeadSensorRotationMatrix <m00> <m01> <m02> <m10> <m11> <m12> <m20> <m21> <m22>
Defines the head sensor rotation using a 3x3 matrix, instead of an axis and angle.
SyncBirds type1|type2|n
If this flag is "type1" or "type2", the Flock-of-Birds tracker will be made to synchronize itself with the projectors, to prevent any interference. "type1" synchronization runs the transmitter at the same frequency as the projectors; "type2" runs the transmitter at twice the frequency of the projectors. This requires additional hardware connecting the Birds and the projector.
TrackerBaud 19200|9600|...
Baud rate for the tracker serial device. 19200 is the default value.
TrackerPort <portname> [<port2name>]
Name of the serial port(s) that the trackers are attached to. <portname> should be something like "/dev/ttyd2". The Logitech tracker uses a second serial port for the wand tracker; <port2name> identifies this port.
TransmitterOffset <X-offset> <Y-offset> <Z-offset> <units>
The position of the transmitter in CAVE coordinates. This is used to adjust the values returned by the trackers.
TransmitterRotation <axis-X> <axis-Y> <axis-Z> <angle>
The orientation of the transmitter in the CAVE space. This is defined by an axis vector and an angle of rotation around that vector. The angle is in degrees.
TransmitterRotationMatrix <m00> <m01> <m02> <m10> <m11> <m12> <m20> <m21> <m22>
Defines the transmitter rotation using a 3x3 matrix, instead of an axis and angle.
Wand <wand-type>
This has been changed to "ControllerType", for a description see "ControllerType" above.
WandSensorOffset <X-offset> <Y-offset> <Z-offset> <units>
The offset from the location of the physical sensor attached to the wand to the location which will be reported by the library for the wand.
WandSensorRotation <axis-X> <axis-Y> <axis-Z> <angle>
The rotation of the physical wand sensor relative to the sensor as reported by the library. This is defined by an axis vector and an angle of rotation around that vector. The angle is in degrees.
WandSensorRotationMatrix <m00> <m01> <m02> <m10> <m11> <m12> <m20> <m21> <m22>
Defines the wand sensor rotation using a 3x3 matrix, instead of an axis and angle.