home *** CD-ROM | disk | FTP | other *** search
/ Virtual Reality Zone / VRZONE.ISO / mac / PC / PCGLOVE / GLOVE / ROUTINES.DOC < prev    next >
Text File  |  1991-11-07  |  2KB  |  45 lines
  1. glove_init(mode, function)
  2.     puts the glove into a given mode; the following are defined so far:
  3.         HIRES -- high-resolution
  4.         LORES -- low-resolution
  5.         IHIRES -- interrupt-driven high-resolution
  6.         ILORES -- interrupt-driven low-resolution
  7.     Note that the code as supplied always uses high resolution, but
  8.     will still accept LORES and ILORES as valid modes; glove_init()
  9.     will return the mode *actually* selected (for forwards and
  10.     backwards compatability).
  11.  
  12.     The function, if not NULL, is a pointer to a function to be called
  13.     from the interrupt handler every time the glove position changes.
  14.  
  15. glove_quit()
  16.     Basically just restores the interrupt vectors that were taken over
  17.     by glove_init() if an interrupt mode (IHIRES or ILORES) was used;
  18.     must be called before exiting, so glove_init() uses atexit() to
  19.     set this.
  20.  
  21. glove_read(&glov)
  22.     Reads the current glove data; this may be called at any time (no
  23.     need to poll) if in interrupt mode.  Returns non-zero if the data
  24.     has changed since the last time you called glove_read().
  25.  
  26. glove_ready()
  27.     Always returns 1 in interrupt modes; otherwise, polls the glove and
  28.     returns 1 if it's ready.  Not needed in interrupt mode.
  29.  
  30. glove_delay()
  31.     Used only in polled mode, this routine should be called between
  32.     calls to glove_ready() to make sure we aren't confusing the glove's
  33.     processor by bugging it too often.
  34.  
  35. The glove data structure (glove_data) now contains an "nmissed" field,
  36. which is the number of samples we've missed between calls to glove_read().
  37. Note that deglitching and dehysterisis are done in the interrupt handler,
  38. so the caller never needs to worry about it.
  39.  
  40. -- 
  41.     Bernie Roehl, University of Waterloo Electrical Engineering Dept
  42.     Mail: broehl@sunee.waterloo.edu OR broehl@sunee.UWaterloo.ca
  43.     BangPath: watmath!sunee!broehl
  44.     Voice:  (519) 885-1211 x 2607 [work]
  45.