FreeVR: Virtual Reality Integration Library
FreeVR
Tutorials
User Guide
Programming
Functions

FreeVR

TUTORIALS

DOWNLOADS

GUIDES
    Administrator
    User
    Programming
    Function List
    Library Dev
    Socket Interface

MAN PAGES


All materials
Copyright © 2013
William R. Sherman

Manpage of INPUTS

INPUTS

Section: FreeVR Commands (1FV)
Updated: 5 November 2013
Index Return to Main Contents

 

NAME

inputs - a simple application useful as a virtual reality input aggregator and server.  

SYNOPSIS

inputs [<FreeVR options>]  

DESCRIPTION

The primary utility of the inputs program to act as an input aggregator and repeater, serving input events back out to other virtual reality applications. Any of the FreeVR output protocols can be served through the inputs application, as per the configuration settings. Presently, FreeVR offers two output protocols:

* the Vrui VRDeviceDaemon protocol
* the Argonne National Lab TrackD protocol

As a simple virtual reality application, inputs can also be useful in testing whether FreeVR has been properly compiled as well as properly configured. However, the travel(1FV) application is perhaps more appropriate for that task, as it also has the ability for the user to move the virtual world via the user interface.

The inputs application has no user interface controls of its own as it is intended to pass through all input data to other systems. Of course, inputs does use the standard Escape key as the indicator to terminate the application.

The inputs application is itself a FreeVR application, and thus it renders a virtual world into all the windows of the configuration. Typically, when acting as an input server, inputs would be configured to display in a simulator-view rather than itself being rendered on the walls of a CAVE or screens of an HMD.

The rendered world of the inputs application contains representations of all the active inputs in the configuration. Input buttons are represented as small cubes when "off", and tall beams when "on". Valuator inputs are represented as narrow pyramids with the point extending from the floor plane (up or down) a distance relative to the valuator value. Position inputs (aka 6-sensors) are not directly represented as graphical objects since the FreeVR simulator view will already render these inputs with shapes representing a head or wand.

All inputs (buttons, valuators, 6-sensors) are also represented in a text string that is positioned to coincide with what would normally be the front screen of a CAVE system. 6-sensor inputs are also colored and flagged based on their status:

* active --- green,
* in-active --- grey,
* out-of-bounds --- blue,
* input-error --- red, and
* dummy input --- yellow.

The on-screen help display lists all the active self-controls that are part of the current configuration (or at least as many as will fit in the alloted string).  

OPTIONS

The inputs 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 inputs as specified by the current configuration:

% inputs

Run inputs with a configuration that reads from an ART DTrack server and outputs the Vrui VRDeviceDaemon protocol:

% inputs 'usesystem "dtrack2vrui";'

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

SEE ALSO

freevr(7FV), travel(1FV), freevrrc(5FV)  

LOCATION

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

COPYRIGHT

Copyright 2013, Bill Sherman, All rights reserved.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO
LOCATION
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 05:02:19 GMT, December 13, 2013