home *** CD-ROM | disk | FTP | other *** search
/ Virtual Reality Zone / VRZONE.ISO / mac / ZIP / MISC3D / AVRIL11.ZIP / READ.ME < prev    next >
Text File  |  1994-09-07  |  4KB  |  89 lines
  1.  
  2.                                   AVRIL
  3.  
  4. This is release 1.1 of AVRIL, a 3D polygon graphics library suitable for
  5. VR applications.
  6.  
  7. Changes since 1.0 include:
  8.     * support for the Polhemus Isotrak
  9.     * simplified CFG code
  10.     * new "LookAt" routines
  11.     * bug fix to the horizon code
  12. These changed are detailed in Appendix A of the documentation file
  13.  
  14. The latest version of this software can always be found on sunee.uwaterloo.ca,
  15. in the pub/avril directory.  It should also be available on major sites such
  16. as wuarchive.wustl.edu and oak.oakland.edu.
  17.  
  18. CONTENTS
  19.  
  20. The contents of this archive are as follows:
  21.  
  22.     read.me         this file
  23.     avrildoc.ps     the AVRIL programmer's guide (Postscript format)
  24.     avrildoc.txt    the AVRIL programmer's guide (ascii text)
  25.     av.exe          the AVRIL Viewer (reads PLG, FIG and WLD files)
  26.     avril.cfg       the configuration file for AVRIL
  27.     avril.h         header file to be #included in AVRIL programs
  28.     avrilkey.h      definitions of keys recognized by AVRIL
  29.     avrildrv.h      declarations for device driver functions
  30.     avril.lib       library to link with AVRIL programs (Borland C)
  31.     vd256.rvd       the RVD driver for mode Y (320x200x256)
  32.     system.c        source code for vrl_System routines
  33.     input.c         source code for routines shared by all the examples
  34.     cfg.c           source code for reading configuration files
  35.     av.c            source for the AVRIL Viewer
  36.     example1.c      first example (a cube)
  37.     example2.c      second example (asteroids)
  38.     example3.c      third example (multiple surfaces)
  39.     example4.c      fourth example (animated objects)
  40.     example5.c      fifth example (input devices)
  41.     example6.c      sixth example (configuration files)
  42.     example6.cfg    configuration file for sixth example
  43.     drvcyman.c      source code for Logitech Cyberman driver
  44.     packet.c        source code for serial packet routines (used by drvcyman)
  45.     asteroid.plg    a multi-rep PLG file for example2
  46.     colorful.plg    a multi-colored object for example3
  47.     sample.zip      zip file containing a sample world (unzip using -d)
  48.  
  49. USING AV
  50.  
  51. Unzip sample.zip (using the -d option to create a directory for the sample
  52. world).  Type "av sample.wld".  You can also view PLG files and FIG files
  53. using AV.
  54.  
  55. MOVING AROUND
  56.  
  57. Moving around the virtual environment is easy.  The following applies to AV
  58. or any of the example programs (once they've been compiled).
  59.  
  60.          Key                                  Function
  61.  
  62.     up/down arrows                      move forward/backward
  63.     left/right arrows                   turn left/right
  64.     leftshift plus up/down arrows       move up/down
  65.     leftshift plus left/right arrows    move left/right
  66.     rightshift plus up/down arrows      look up/down
  67.     rightshift plus left/right arrows   tilt head left/right
  68.  
  69. OTHER KEYS
  70.  
  71. The following keys perform various functions:
  72.  
  73.     ESC     quit
  74.      f      toggle frame rate display
  75.      c      toggle compass display
  76.      p      toggle position display
  77.      d      toggle display of debugging information
  78.      _      (underscore) toggle horizon off/on
  79.     +,-     zoom in, out
  80.      =      reset zoom
  81.     h,H     adjust hither clipping plane distance by current space step
  82.      w      toggle wireframe mode
  83.   (space)   toggle mouse mode between 6D input and on-screen selection
  84.  
  85. CONTACTING THE AUTHOR
  86.  
  87. My email address is broehl@uwaterloo.ca; mention AVRIL in the subject line
  88. so I'll know what it's about.
  89.