VR Transform Object -
VRModules				               vr transform object (6)


NAME
     vr transform object - generate object transformation events given
	a "vr device event" field.

SUMMARY
     Name	   VR Transform Object

     Type	   mapper

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

     Outputs	   AVS Geometry


     Parameters	   _N_a_m_e		   _T_y_p_e		  _D_e_f_a_u_l_t	 _M_i_n	   _M_a_x
		   Translate Scale float slider	  2.5		 .1	   10
		   Rotate Scale	   float slider	  2.5		 .1	   10
		   Current Object  string	  <read only>

DESCRIPTION

	The VR Transform Object module will take as input events from a
	VR input device, encoded into a "VR device event field" and generate
	object transformation events.  These events are passed to the
	Geometry Viewer via the AVS Geometry data type.

	This module is used to move objects around using a VR input 
	device.

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

	Translate Scale, Rotate Scale - floating point values that can
	be used to attenuate the magnitude of the translation and
	rotation components of the VR Input Device event.  They have been
	set, by default, to 2.5 to reflect what the developer feels is
	a suitable level of sensitivity.

	Object Name - this reports the name of the object that will be
	moved around.  Note that since this module is a subroutine module,
	the name of the currently selected object is NOT accurate until
	the module actually fires.

OUTPUT

	AVS Geometry - containing object transformation commands.  Feed
	this to the geometry viewer.
	

EXAMPLE
	spaceball
	    |
	VR Transform Object
            |
	Geoemtry Viewer

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

BUGS

	This module will compute the correct transformations only for
	the view of "camera1".  This is a limitation of the AVS CLI.

	This module will compute the correct transformations ONLY in
	object heirarchies which are 2 or fewer levels deep.  In those
	cases in which a deeper tree is present, the correct transformation
	will be applied to the "top" level object, and to the first level
	of children in the tree.  Transformations applied to lower levels
	in the tree are not necessarily correct.  This is a limitation of
	AVS CLI.

VRModules					  Lawrence Berkeley Laboratory
