VR print field -
VRModules						   VR print field (6)


NAME
     VR print field - "print" the contents of a VR device event field.

SUMMARY
     Name	   VR print field

     Type	   output/render

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

     Outputs	   none

     Parameters	   _N_a_m_e		   _T_y_p_e		  _D_e_f_a_u_l_t	 _M_i_n	   _M_a_x

		   X,Y,Z rotation  string (read only)
		   X,Y,Z translation  string (read only)
		   Button Events   string (read only)

DESCRIPTION

	VR print field will display the contents of a VR device event
	field in readable form.  This module must be used, rather than
	"print field", because the VR device event field contains a
	mixture of floating point and boolean data encoded into an
	AVS field.  

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

	X,Y,Z Axis Rotation - a read-only string parameter used to display
	the rotational components of the VR device event field.

	X,Y,Z Axis Translation - a read-only string parameter used to display
	the translational components of the VR device event field.

	Button Events - a read-only string parameter to display which
	button of the input device, if any, is being pressed.

OUTPUT
	none
	

EXAMPLE
	spaceball
	    |
	VR print field

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


VRModules					  Lawrence Berkeley Laboratory
