VR camera UI -
VRModules				                   VR camera UI (6)


NAME
     VR camera UI - a module which implements a "user interface" between
	the input VR fields and the virtual camera.  This module is used
	to prepare a VR event field for the VR Transform Camera module.
	The general idea is that the VR event field which is prepared
	for the VR transform camera module is a function of the head
	and hand input fields.  

SUMMARY
     Name	   VR camera UI

     Type	   filter

     Inputs	   field float 1D 1-space uniform  (hand event stream)
		   (VR device event field)

     		   field float 1D 1-space uniform (head event stream)
		   (VR device event field)

     Output	   field float 1D 1-space uniform  (hand event stream)
		   (VR device event field)



     Parameters	   _N_a_m_e		   _T_y_p_e		  _D_e_f_a_u_l_t	 _M_i_n	   _M_a_x
		   trans scale	   float dial	  1.0		 0.0	   1.0
		   rotate scale	   float dial	  0.5		 0.0	   1.0

DESCRIPTION
	The context for which this module was written is when there
	are two trackers present, one attached to the head and one which
	is hand-held.  Furthermore, it is assumed that there are button
	events in the input field from the hand.  The events from both
	the head & hand fields are combined into a single stream of
	data which can be used to control the camera position in a 
	virtual world.

INPUTS
     	field float 1D 1-space uniform - VR device event field.  A set
	of C-language macros is used internal to the code for this 
	module to encode the device event information into an AVS
	field.  This field is not readily processible (unfortunately)
	by "normal" AVS modules.  This is the case because both
	floating point and boolean values are encoded into the field data.

PARAMETERS

	trans event scale, rotate event scale - floating point values
	used to attenuate the translational and rotational components
	
OUTPUT
	see INPUT -  a single VR event stream.

EXAMPLE
	division ipu
	    |    |
        VR camera UI
	      |
	VR Xform Camera
            |
	Geoemtry Viewer

RELATED	MODULES
	VR Transform Camera, VR Stereo Camera

BUGS
	Nobody seems to agree on a canonical UI for controlling a
	camera in a virtual world.  Here's some code that will let
	you quickly prototype up your own for experimentation.


VRModules					  Lawrence Berkeley Laboratory
