TRAVEL

NAME

travel — a simple VR application with colored objects and use of inputs to test FreeVR operations.  

SYNOPSIS

travel [<FreeVR options>]  

DESCRIPTION

The travel program is a simple virtual reality application that can be useful in testing whether FreeVR has been properly compiled as well as properly configured. The virtual world in travel consists of several colorful basic shapes placed in strategic locations. With the exception of a white pyramid floating in the center of the space, all objects are fixed in real-world space. The white pyramid on the other hand is in virtual space, which means that when travel operations are performed, it will move as the user moves relative to the virtual world.

The joystick and first three buttons are used to control travel through the virtual world. Travel uses a common interface regime whereby the Y-axis of the joystick move the user along the vector indicated by the orientation of the wand, and the X-axis rotates the user about the vertical axis.

Button inputs also can affect user-travel. Button #1 resets user-travel back to the initial position, button #2 moves the user 0.1 unit (foot) to the right, and button #3 moves the user 0.1 unit to the left.

Of course, travel uses the standard Escape key as the indicator to terminate the application.

The travel application can also be used as a means to read inputs and then output them again through an alternate protocol — this is how FreeVR operates as an input server. However, the inputs(1fv) program is more appropriate for this purpose, as it has a more minimalistic world, with objects that represent various inputs.  

OPTIONS

The travel application itself does not have any of it's own command-line options. However it can take any FreeVR configuration options as command-line options to deviate from the default configuration. The most common option is to specify an alternate system specified within the existing FreeVR configuration schema. See the EXAMPLES section below for a basic example.

usesystem <system name>;

The usesystem option selects one of the specified FreeVR "systems" as defined within one of the .freevrrc configuration files.

EXAMPLES

Run travel as specified by the current configuration:

% travel

Run travel with the built-in (default) simulator configuration:

% travel 'usesystem "simulator";'

Other examples can be found in the FreeVR configuration documentation — freevrrc(5FV).  

SEE ALSO

freevr(7fv), inputs(1fv), freevrrc(5FV)  

LOCATION

The source code for travel is in the "travel.c" and "drawing.c" files.  

COPYRIGHT

Copyright 2024, Bill Sherman, All rights reserved.

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO

LOCATION

COPYRIGHT