README_FIRST
Version 1.0
IAC, Manchester, England

This directory contains modules for interfacing AVS with Virtual
Reality input devices (Spaceball and Division_ipu/Fastrak) and
subsequent interpretation of the inputs to control various aspects
of the Geometry viewer, as well as some utility modules.

The modules have been divided into three archives due to the large
number of files that are required:

 vrmodules.tar.Z - the support modules as well as a
                    dummy input device
                    makefiles for DEC, HP, SGI, Solaris
 spaceball.tar.Z - the library and module source
                    for the spaceball input device
                    makefiles for DEC, HP, SGI, Solaris
 fastrak.tar.Z   - the library and module source
                    for the division_ipu input device
                    makefiles for HP, SGI

NOTE:	it has not been possible to test the spaceball and
	division ipu modules with the appropiate peripherals.
	The IAC would be most grateful to IAC users to report
	if the modules work correctly or and problems/changes
	concerning the code. Please send your responses to:
	email: avs@iavsc.org
		
You will need to download the vrmodules archive and then either
the spaceball or fastrak archives. The archives should then be
unpacked from the same directory using:

> uncompress vrmodules.tar.Z
> uncompress spaceball.tar.Z     // or fastrak.tar.Z
> tar xvf vrmodules.tar
> tar xvf spaceball.tar      // or fastrak.tar

This should result in the following directory structure:

                      $HOME/.../
                           |
               ____________|____________
               |                       |
           vrmodules/              spaceball/
               |                 (or fastrak/)
        _______|______           ______|______
        |            |           |           |
       src/      helpfiles/     src/        lib/

Use the following procedure to make the modules:

> cd $HOME/.../spaceball/src/     // or ...fastrak/src/
> make -f make.<platform>         // create the appropiate lib
                                  // where platform is one of 
                                  // DEC, HP, SGI, Solaris
> cd $HOME/.../vrmodules/src

edit the appropiate make.<platform> to define whether the
spaceball or division_ipu module should be built.

> make -f make.<platform>         // create the modules

The following is a list of all the modules:

input devices:
  dummy device
  spaceball	(see note above)
  division ipu	(see note above)
output devices:
  vr print field
filter:
  event scale
  event threshold
  button gate
  button gate acc
  VR to float*
  VR to acc float*
  VR camera UI
mapper:
  VR Transform Camera
  VR Transform Object
  VR Stero Camera

*WARNING The vr_2float and vr_2accfloat modules do not work
         on the DEC Alpha due to this architechure being 
         little endian and the vrmodules making assumptions
         about byte ordering in the event field file.
