event scale
VRModules				                      event scale (6)


NAME
	event scale provides a means to attenuate the rotation and
	translational components of a VR event field.

SUMMARY
     Name	   event scale

     Type	   filter

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

     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
		   tscale	   real		  1.0		 UNBOUNDED
		   rscale	   real		  1.0		 UNBOUNDED

DESCRIPTION
	
	event scale produces an output vr field computed thus:
		output button events = input button events
		output rotation values =
				input rotation values * rscale
		output translation values =
				input translation values * tscale
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
	tscale - a floating point value which is multiplied with the
	input translational component of the VR event field.  this
	scaled vector is the translational component of the output field.

	rscale - a floating point value which is multiplied with the
	input rotational component of the VR event field.  this
	scaled vector is the rotational component of the output field.

OUTPUT
	see INPUT.

EXAMPLE
	spaceball
	    |
	event scale
	    |
	vr xform obj
	    |
	geometry viewer

RELATED	MODULES
	event thresh


VRModules					  Lawrence Berkeley Laboratory
April 1996