home *** CD-ROM | disk | FTP | other *** search
/ Virtual Reality Zone / VRZONE.ISO / mac / PC / PCGLOVE / RACBALL / SOURCE / SEGASUPP.H < prev    next >
C/C++ Source or Header  |  1992-09-21  |  5KB  |  145 lines
  1. /* Prototypes for Sega and Powerglove (and timer) support */
  2.  
  3. /* Copyright 1992 by Dave Stampe and Bernie Roehl.
  4.    May be freely used to write software for release into the public domain;
  5.    all commercial endeavours MUST contact Bernie Roehl and Dave Stampe
  6.    for permission to incorporate any part of this software into their
  7.    products!
  8.  */
  9.  
  10. extern void init_SG_interrupt(void (*sega_switcher)(), /* NULL if no sega/video   */
  11.             void (*glove_handler)(), /* NULL if no glove driver */
  12.             int glove_tc);           /* 1.19*uS (test interval) */
  13.  
  14. /*
  15.  sega_switcher is called just before the vertical retrace
  16.  use NULL if no video synchronization desired
  17.  
  18.  glove_handler is called once or more per screen time
  19.  use NULL if not required
  20.  
  21.  glove_tc is period in timer clocks (1.19 * microseconds) desired between
  22.  glove_handler calls.  If sega_switcher is also used, this will be an
  23.  integer number per screen time.  Use 6500 for best results, as this
  24.  gives the least glitches (2xscreen for 72 Hz, 3xscreen for 60 Hz VGA cards
  25. */
  26.  
  27. /***** GLOVE DATA SPECIFICATIONS **************
  28.  
  29. x =   X position, 3mm per number
  30. y =   Y position, 3mm per number
  31. z =   distance,  14mm per number
  32. rot = wrist twist. 0 is up 1 is slightly CW, 5 is down,
  33.       11 is slightly CCW.
  34.       About 30 to 40 degrees per count.
  35.  
  36.  Note: exact scaling of all above change with distance! Closer is higher res.
  37.  
  38.  fingers = packed 2-bit values, 0 is open, 3 is (tight) fist:
  39.     Bit format: TtIiMmRr  for Thumb, Index, Middle, and Ring fingers.
  40.  
  41.  keys: $FF or $80 is no key. Responds with 0 to 9 for keys "0" thru "9"
  42.       $82 = START, $83 = SEL, $0A = "A", $0B = "B", 0 is "Center"
  43.             Up,down,left,right are $0D,$0E,$0C,$0F respectively.
  44.  
  45.  gstat1, gstat2 are dummies
  46.  rxflags is valid ONLY after glove_ready returns 2.
  47.  
  48.  nmissed is number of reads since last glove_read call
  49.  
  50.  **********************************************/
  51.  
  52. #define G_NOKEY 0xFF
  53. #define G_START 0x82
  54. #define G_SEL   0x83
  55. #define G_AKEY  0x0A
  56. #define G_BKEY  0x0B
  57. #define G_UP    0x0D
  58. #define G_DOWN  0x0E
  59. #define G_LEFT  0x0C
  60. #define G_RIGHT 0x0F
  61.  
  62. #define G_RECENTER 0
  63.  
  64. typedef struct glove_data {
  65.     signed char x,y,z,rot,fingers,keys,gstat1,gstat2,rxflags;
  66.     unsigned int nmissed;  /* number of samples missed */
  67.     } glove_data;
  68.  
  69. /* prototypes */
  70.  
  71. extern void getglove(glove_data *);    /* get data packet from glove */
  72. extern int  glove_ready(void);        /* returns 0 if not ready     */
  73.                                     /*         1 if data ready    */
  74.                                     /*         2 if rxflags also valid */
  75. #define DEGLITCH   1
  76. #define NODEGLITCH 0
  77.  
  78. extern void glove_init(int gdeg);   /* sets up glove, enters hires mode    */
  79.                                     /* gdeg switches deglitching on or off */
  80.  
  81. extern int glove_read(glove_data *g);  /* reads glove data, with de-glitching */
  82.  
  83. extern void glove_int_handler();       /* int handler: pass as argument to SGinit */
  84.  
  85. /* gesture recognition */
  86.  
  87. #define G_FLAT      0           /* std. gesture classification */
  88. #define G_THUMB_IN  1
  89. #define G_INDEX_IN  2
  90. #define G_MIDDLE_IN 3
  91. #define G_RING_IN   4
  92. #define G_PINCH     5
  93. #define G_FIST      6
  94. #define G_THUMB_OUT 7
  95. #define G_POINT     8
  96. #define G_BADFINGER 9
  97. #define G_RING_OUT  10
  98. #define G_UNKNOWN   11
  99.  
  100. extern long gesture_time;              /* # of glove-reads (1/20 sec) gesture seen */
  101. extern unsigned char gesture_type;     /* mapped gesture type */
  102. extern unsigned char gesture_map[];    /* use to map std. gestures to subset */
  103.                                                             /* so gesture_time is valid */
  104.  
  105. /**************** SEGA SUPPORT ****************/
  106.  
  107. extern int left_page;     /* video page with current left image */
  108. extern int right_page;    /* video page with current right image */
  109. extern int has_switched;  /* = 3 once both switched in */
  110.  
  111. extern void init_switch_driver(char *sdname);
  112.  
  113. extern void switch_sega(int to_go);     /* video, glasses switcher: pass to SGinit */
  114.  
  115. extern void sega_off();        /* turn off glasses at exit (longer life) */
  116.  
  117. extern void select_sega_port(int port);
  118.  
  119. /************** SEGA/GLOVE PARAMETERS *************/
  120.  
  121. extern int glove_in_port;
  122. extern int glove_out_port;
  123. extern int port_image;
  124.  
  125. extern int glove_data_mask;
  126. extern int glove_write_mask;
  127.  
  128. extern int glove_none_mask;
  129. extern int glove_latch_mask;
  130. extern int glove_clock_mask;
  131. extern int glove_clock_latch;
  132.  
  133. extern int glove_bit_delay;
  134. extern int glove_byte_delay;
  135.  
  136. extern int sega_address;
  137. extern int sega_port_image;
  138. extern int sega_mask;
  139.  
  140. extern int sega_left;
  141. extern int sega_right;
  142. extern int sega_doff;
  143.  
  144. /* End of segasupp.h */
  145.