VR dummy device -
VRModules						   VR dummy device (6)


NAME
     VR dummy device - create a dummy VR device event field from user parms.

SUMMARY
     Name	   VR dummy device

     Type	   input

     Inputs	   none

     Outputs	   field float 1D 1-space uniform
		   (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
		   Push Me	   boolean toggle off		 off	   on

		   X rotation	   float	  0.		 -1.0	   1.0
		   Y rotation	   float	  0.		 -1.0	   1.0
		   Z rotation	   float	  0.		 -1.0	   1.0

		   X translation   float	  0.		 -1.0	   1.0
		   Y translation   float	  0.		 -1.0	   1.0
		   Z translation   float	  0.		 -1.0	   1.0

		   Button Events   radio buttons  "No Event"	 Button1   Button8

DESCRIPTION

	The VR dummy device module will create a device event field
	from user parameters.  It is useful for creating an event field
	with known values, and for exercising the VRModules tools.

	This module is a subroutine module.  As such, it will generate
	a new field only when the "push me" button is pushed.

INPUTS
	None


PARAMETERS

	Push Me - a toggle when, when depressed, will cause this module
	to gather construct a VR device event field using the values of
	the parameters at the time the button is pushed.

	X,Y,Z Axis Rotation - sliders used to set the values for the
	rotational component of the VR device event field.

	X,Y,Z Axis Translation - sliders used to set the values for the
	translational component of the VR device event field.

	Button Event Array - a list of radio buttons which will cause
	either no button events (if "no event" is chosen), or a button
	event on any of buttons 1-8.  

OUTPUT
     	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.
	

EXAMPLE
	VR dummy device
	    |
	VR Xform Camera
            |
	Geoemtry Viewer

RELATED	MODULES
	VR Transform Camera, VR Transform Object, VR to acc floats,
	VR to floats, VR dummy device, VR print field.

BUGS
	1 March 1995
	I've had problems with mysterious hangs under OSF1 V2.
	The fix will be not to this module, but to the underlying
	spaceball i/o code.  When using AVS, the only recovery that I'm
	aware of to these hangs is to hammer the module, power-cycle the
	spaceball, then instantiate a fresh copy of the spaceball module.
	The module (ie, the underlying spaceball library) seems well 
	behaved under OSF1 V3.0B.
	

VRModules					  Lawrence Berkeley Laboratory
