home *** CD-ROM | disk | FTP | other *** search
/ Mega CD-ROM 1 / megacd_rom_1.zip / megacd_rom_1 / HANDICAP / VEDOCS20.ZIP / SECT13.DOC < prev    next >
Text File  |  1991-06-11  |  37KB  |  723 lines

  1. SECTION THIRTEEN
  2. HYPERACTIVE WINDOWS
  3.  
  4. 13.1:  INTRODUCTION
  5.  
  6. In section 7, we talked about the standard windows 0-9.  These windows could
  7. be setup as Neutral, Silent, Speak or Float.  These windows offer much
  8. flexibility but for certain programs, you need the power of hyperactive
  9. windows.
  10.  
  11. As we've mentioned, not all software programs use DOS screen service to
  12. display their information on your PC's screen.  This is not necessarily a bad
  13. thing, however.  After all, you wouldn't want your word processor to reread
  14. your entire business letter every time you type in a character, or use a
  15. cursor key to change lines.  Certainly you wouldn't want your spreadsheet
  16. repeating every cell when all you've done is add or modify the data in a
  17. single cell.
  18.  
  19. As you can see, when it comes to certain kinds of software, often silence is
  20. golden.  Well, almost golden.  After all, even though you wouldn't want to
  21. hear everything on your screen repeated ad infinitum, occasionally there is
  22. going to be some critical information that you'd like to hear read to you as
  23. soon as it pops up.  This is where Vocal-Eyes' "Hyperactive" windows come
  24. into play.
  25.  
  26. 13.2:  WINDOWS A-E
  27.  
  28. In addition to the standard ten windows 0-9, Vocal-Eyes offers an additional
  29. five windows A-E.  These five windows are dedicated as hyperactive although
  30. they can each be enabled or disabled independent of all other windows. 
  31. Whenever prompted for a hyperactive window, simply supply a letter from 'A'
  32. - 'E'.
  33.  
  34. When a window is set to "Hyperactive," Vocal-Eyes checks and rechecks that
  35. window for changes.  If it detects your specified change, the hyperactive
  36. window will trigger.  Once the window triggers, you can specify up to three
  37. things Vocal-Eyes should do.
  38.  
  39. This feature can best be demonstrated with a few examples.
  40.  
  41. Let's say your working in a spreadsheet.  Your particular spreadsheet has a
  42. small area in the upper right-hand corner where your program's present work
  43. status is displayed.  It says either "READY," "RECALCULATING" or "ERROR,"
  44. depending on what's happening at any one moment.  Lets say you'd like to know
  45. when your spreadsheet is busy with a recalculation so you won't attempt to
  46. enter new data while it's in progress.  And of course you'd want to know
  47. about any error messages.  You could setup a hyperactive window to this area
  48. and monitor for any change.  Once a change is detected, you can instruct
  49. Vocal-Eyes what should be done.
  50.  
  51. Here's another example.  Lets say you are using a program which at certain
  52. times displays the word 'EDIT' in a certain area of the screen.  When this is
  53. displayed, you may want Vocal-Eyes to do several tasks automatically.  With
  54. a hyperactive window, you can instruct Vocal-Eyes to monitor for the word
  55. 'EDIT' either in a specific location or anywhere within a certain window. 
  56. Once Vocal-Eyes notices the appearance of the word, it could then be
  57. instructed to handle your bidding.  This could be to read something or even
  58. load a completely new .SET file into memory.
  59.  
  60. 13.3:  WHAT HYPERACTIVE WINDOWS CAN LOOK FOR
  61.  
  62. There are actually 13 different ways to configure a hyperactive window to
  63. trigger.  By trigger, we mean a certain condition as been met.  Once the
  64. condition has been met, in other words, the hyperactive window has triggered,
  65. you can tell Vocal-Eyes what to do.  Should it read something or switch to
  66. another window or load a new .SET file or all three.  A hyperactive window
  67. like the standard windows can be from a single character to the full screen. 
  68. Your first step is to setup the coordinates of the hyperactive window.  Once
  69. you have the area confined, you must tell Vocal-Eyes what to look for.  Lets
  70. discuss each of the 13 ways in detail.
  71.  
  72. Any change:
  73.  
  74. If any change in the specified hyperactive window's coordinates occurs, the
  75. window will be triggered.  It does not matter if there was a text change or
  76. a color change.  Anything can be taken literally.
  77.  
  78. Any text change:
  79.  
  80. This gets a little more specific than any change described above.  This
  81. option will only trigger if a text change occurs in the hyperactive window. 
  82. Color changes will not be noticed.  If you don't care about color changes but
  83. you do care if characters are changed within the hyperactive window, this
  84. would be a good choice.
  85.  
  86. Any Attribute change:
  87.  
  88. You probably already guessed what this option does.  This one does not care
  89. if there is a text change in the hyperactive window but it does care if there
  90. is a color change.  This is the exact opposite of the any text change
  91. described above.
  92.  
  93. Exact match:
  94.  
  95. This option will take a snap-shot of everything in the current hyperactive
  96. window's coordinates.  It will remember every single detail.  Where each
  97. character is placed, the case of each character and even the color of each
  98. character.  Vocal-Eyes than takes this information and stores it for later
  99. comparison.  Now, instead of any type of change in the hyperactive window,
  100. Vocal-Eyes is looking for a very specific occurrence.  This window will not
  101. trigger until it is restored to the original state it was when Vocal-Eyes
  102. took a snap-shot of what was already there.  Every character must be in the
  103. exact same position, the case of each character must match and the color of
  104. each position must be the same as before.  Then and only then, will
  105. Vocal-Eyes trigger the hyperactive window.
  106.  
  107. For example, if you wanted the window to trigger when line 5 columns 10
  108. through 20 contained the characters 'Spreadsheet' and each character is blue
  109. on red, you could setup a hyperactive window with coordinates, top=5,
  110. bottom=5, left=10 and right=20.  Vocal-Eyes will take a snap-shot of the
  111. current contents which would be the word 'spreadsheet' being displayed blue
  112. on red.  Once Vocal-Eyes saw this occurrence again, the window will trigger. 
  113. Remember, you can match a single character or the entire screen.
  114.  
  115. Exact text match:
  116.  
  117. This works like the exact match above except Vocal-Eyes is only concerned
  118. with the text on the screen.  It does not care about the color.  Like before,
  119. Vocal-Eyes will take a snap-shot of the hyperactive window but only of the
  120. text, not the color.
  121.  
  122. Vocal-Eyes will not trigger until the screen matches character for character
  123. as it was when the original snap-shot was taken.  The color of each character
  124. is not even considered.
  125.  
  126. Exact Attribute match:
  127.  
  128. This is just the opposite of the Exact text match above.  Again, Vocal-Eyes
  129. takes a snap-shot of the hyperactive window but only of the color.  It does
  130. not care about the text on the screen.  Vocal-Eyes will not trigger until the
  131. screen colors within the hyperactive window are exactly as they were then the
  132. original snap-shot was taken.  The current text on the screen is not even
  133. considered.
  134.  
  135. Different match:
  136.  
  137. This option will preform the opposite of the exact match option, described
  138. earlier.  That is, while exact match will trigger any time the contents of
  139. the hyperactive window exactly match the snap-shot, different match will
  140. trigger any time the contents of the hyperactive window are different in any
  141. way from the snap-shot.  Any change - text, color, what have you - within the
  142. coordinates of the hyperactive window is enough to trigger the Vocal-Eyes
  143. command you have specified.
  144.  
  145. For example, if you wanted the window to trigger if a particular text and
  146. color was not currently displayed on the screen, this would be a good choice
  147. for different match.
  148.  
  149. Different text match:
  150.  
  151. Just as different match works opposite exact match, different text match
  152. works precisely opposite exact text match.  At any time the text in the
  153. hyperactive window is different in any way from the text of the snap-shot,
  154. the Vocal-Eyes command(s) you have specified will be triggered.
  155.  
  156. Different attribute match:
  157.  
  158. Following suit, different attribute match works opposite exact attribute
  159. match.  Instead of triggering on a specified set of colors in the snapshot,
  160. the specified Vocal-Eyes command will be triggered any time there is a color
  161. change in the hyperactive window from that of the snap-shot.
  162.  
  163. Contains attribute:
  164.  
  165. This option allows you to specify a particular color.  Vocal-Eyes remembers
  166. this color and will trigger if the specified color is present anywhere in the
  167. hyperactive window.  It does not matter where in the window the color is
  168. located or how much of the color is there.  The simple fact of its presence
  169. there will cause this to trigger.
  170.  
  171. Does not contain attribute:
  172.  
  173. This works exactly opposite of the contains attribute option above.  Once
  174. again, you specify a particular color and instruct Vocal-Eyes to trigger if
  175. the color is not in the current hyperactive window's coordinates.
  176.  
  177. Contains string:
  178.  
  179. This option allows you to specify a string of up to 5 characters in length. 
  180. If the specified string is contained anywhere in the hyperactive window's
  181. coordinates, the window will trigger.  The string can be in upper or lower
  182. case letters.  When Vocal-Eyes looks for the specified string, it ignores the
  183. case of all letters.  The string can be located anywhere within the
  184. hyperactive window.  It could be in the middle of another word.  It really
  185. does not matter.  If Vocal-Eyes sees the same pattern, the window will
  186. trigger.
  187.  
  188. This would be a good choice if you want something to happen if a certain word
  189. appears in a certain area but it is not always in the exact same location. 
  190. Let Vocal-Eyes scan an area for the string.
  191.  
  192. Does not contain string:
  193.  
  194. This works exactly opposite of the contains-string option above.  Again, you
  195. setup a string of up to 5 characters in length.  This time however,
  196. Vocal-Eyes will only trigger if the specified string is not located in the
  197. current hyperactive window's coordinates.
  198.  
  199. 13.4:  HYPERACTIVE WINDOW COMMANDS
  200.  
  201. Now that you know of the ways a hyperactive window can be triggered, it is
  202. time to see what it can be triggered to do.  Once a window has been
  203. triggered, Vocal-Eyes will act upon your requests.  You can specify any three
  204. of eight optional Vocal-Eyes commands to execute when a hyperactive window
  205. triggers.  Lets discuss each of the 8 options in detail.
  206.  
  207. Speak window:
  208.  
  209. This tells Vocal-Eyes to speak the specified window.  You can specify any of
  210. the standard windows 0-9 or any of the 5 hyperactive window A-E.
  211.  
  212. Speak string:
  213.  
  214. You can specify a string of up to 20 characters in length to be spoken.  For
  215. example, maybe you want to say, 'data base active' when a hyperactive window
  216. determines your specified criteria for determining if the data base is
  217. loaded.
  218.  
  219. Speak box:
  220.  
  221. This informs Vocal-Eyes to look for the current box and speak it.  This would
  222. be as if you pressed the read box hotkey only of course, Vocal-Eyes would do
  223. this automatically based on the hyperactive window triggering.
  224.  
  225. Speak light bar:
  226.  
  227. Upon seeing this command, Vocal-Eyes will automatically speak the current
  228. light bar on the screen.  This would be as if you pressed the read light bar
  229. hotkey.
  230.  
  231. Activate window:
  232.  
  233. This will make the specified window the currently selected window.  This
  234. would be just like hitting F3 in review mode or hitting the select window
  235. hotkey.  Remember by switching to a different window, you not only constrain
  236. the reading to the new window's coordinates but you can also turn the
  237. lightbar mode to on, off or auto along with setting the new lightbar color.
  238.  
  239. Load disk SET:
  240.  
  241. This feature gives Vocal-Eyes a tremendous amount of power.  Now, based on a
  242. particular criteria, you can instruct Vocal-Eyes to load a completely
  243. different .SET file.  You specify the name of the .SET file and Vocal-Eyes
  244. will look in the directory it was started from for it.  If found, it will be
  245. loaded automatically.  At this point, you can have a completely new voice
  246. environment.  You could, for example, have 5 more hyperactive windows doing
  247. completely different functions.  The possibilities are endless.
  248.  
  249. The load process used here is exactly as if you loaded the file manually from
  250. the files menu and specified the file name only.  If the specified .SET file
  251. is loaded in one of the RAM locations, Vocal-Eye will load it from there.
  252.  
  253. Load RAM SET:
  254.  
  255. This works just like the load disk SET only instead of specifying a file
  256. name, you specify the RAM number which contains the desired .SET file.  There
  257. are a couple advantages of using a RAM location instead of the disk while
  258. loading a new .SET file.
  259.  
  260. 1) The load process is much faster.  Loading from RAM is much faster than
  261. loading from disk.
  262.  
  263. 2) If DOS is busy doing other things, Vocal-Eyes can not instruct it to load
  264. the desired .SET file from disk.  The RAM locations are always available.
  265.  
  266. There are also a couple disadvantages of using the RAM locations instead of
  267. the disk.
  268.  
  269. 1) It requires more computer memory to allocate the RAM .SET files.
  270.  
  271. 2) You have to preload the .SET files into the specified RAM locations ahead
  272. of time.
  273.  
  274. Beep:
  275.  
  276. This instructs Vocal-Eyes to issue a simple beep tone.
  277.  
  278. 13.5:  SETTING UP THE HYPERACTIVE WINDOWS
  279.  
  280. You know what a hyperactive window can trigger on and what it can do once it
  281. has triggered.  Lets now go through the details of how you actually setup a
  282. hyperactive window.  In order to setup the hyperactive windows, you must be
  283. in review mode.  The following discussion will assume you are already in
  284. review mode.
  285.  
  286. SHIFT-F3:
  287.  
  288. In order to change a particular hyperactive window settings, you must first
  289. select that window.  Remember to select a standard window you press F3 in
  290. review mode and type a number from 0-9.  To select a hyperactive window,
  291. press SHIFT-F3 instead.  You will now be asked to select the hyperactive
  292. window.  Simply type the desired window A-E.  Once you press the letter,
  293. Vocal-Eyes will verify by saying 'Window x' where 'x' is the window of your
  294. choice.  Unlike the currently selected standard window, the only reason to
  295. have a hyperactive window selected is so the following commands know which
  296. hyperactive window to work with.  Other than for this reason, it makes no
  297. difference which hyperactive window you currently have selected.  Whenever
  298. you load a new .SET file from disk, hyperactive window A will always be the
  299. default window.  As for the standard windows, which ever window you had
  300. active when the .SET file was saved will become active when the .SET file is
  301. loaded.
  302.  
  303. Notice how the shift key was used to enhance the standard F3 command.  F3 by
  304. itself relates to the standard windows 0-9 but a SHIFT-F3 relates to the
  305. hyperactive windows A-E.  You will notice the shift key has been used to
  306. enhance several of the other standard window commands as well.
  307.  
  308. SHIFT-F4:
  309.  
  310. Pressing F4 alone will prompt you for the coordinates of the currently
  311. selected standard window 0-9.  However, pressing SHIFT-F4 will prompt you for
  312. the four coordinates of the currently selected hyperactive window A-E.  You
  313. fill in the data exactly as you would using the F4 command.
  314.  
  315. SHIFT-F5:
  316.  
  317. Pressing F5 alone, will set the top left of the currently selected window 0-9
  318. to the review cursor position.  However, if you press SHIFT-F5, Vocal-Eyes
  319. will set the top left of the currently selected hyperactive window to the
  320. review cursor position.  Vocal-Eyes will respond 'top left'.
  321.  
  322. SHIFT-F6:
  323.  
  324. Pressing F6 alone will set the bottom right of the currently selected window
  325. 0-9 to the review cursor position.  However, if you press SHIFT-F6,
  326. Vocal-Eyes will set the bottom right of the currently selected hyperactive
  327. widow to the review cursor position.  Vocal-Eyes will respond 'bottom right'.
  328.  
  329. SHIFT-F7:
  330.  
  331. Remember, pressing F7 alone pops up a box allowing you to customize the
  332. standard windows?  We did not talk much about the F7 key but it will be
  333. discussed in section 14.  SHIFT-F7 also pops up a box but deals with the
  334. currently selected hyperactive window.  This is where you setup the details
  335. of a hyperactive window.  There are six different settings which can be made
  336. with this option.  You can use the up and down arrows to move to the next or
  337. previous option.  Pressing the space bar will toggle to the next selection
  338. and the backspace will toggle to the previous selection for the current
  339. option.  At any point, you can press the ESCAPE key to exit the options.  All
  340. the new settings will be saved.  Also pressing ENTER from the last option
  341. will save and exit the options.  Lets discuss each option in detail.
  342.  
  343. Status: Off/Hyperactive
  344.  
  345. Although Vocal-Eyes offers 5 hyperactive windows, you probably will not need
  346. all 5.  Therefore, use this setting to active or deactivate the hyperactive
  347. windows you want or don't want to use.  A setting of hyperactive will enable
  348. the window.  By default, all 5 windows are turned off.  Unlike the standard
  349. windows, the order in which you use hyperactive windows will probably not be
  350. important.  However, you may want to keep in mind that Vocal-Eyes monitors
  351. the hyperactive windows from A to E.  Therefore, if both hyperactive windows
  352. A and D trigger at the same time, window A's commands will be issued first.
  353.  
  354. Interrupt: Yes/No
  355.  
  356. When a hyperactive window triggers, you have the option of telling Vocal-Eyes
  357. to silence the speech and then do the specified commands.  If you don't
  358. silence the speech, anything spoken by the hyperactive window will be
  359. buffered to the end of the text currently being spoken.  It normally is a
  360. good idea to interrupt the speech so you know instantly your hyperactive
  361. window triggered.  The default is to interrupt the speech.
  362.  
  363. If you have set the window to interrupt the speech and you have
  364. interruptability enabled, Vocal-Eyes will temporarily disable
  365. interruptability for about 2 seconds.  Lets say you are typing at the
  366. keyboard when a hyperactive window triggers.  If the window was requested to
  367. read something, you don't want your keystrokes to instantly silence the
  368. speech before it had a chance to speak.  If you really want to silence the
  369. speech, simply press the SHIFT, CONTROL or ALT key.  These keys with
  370. interruptability enabled will always silence the speech.
  371.  
  372. Also, notice if two hyperactive windows trigger at the same time or if one
  373. triggers before the first has finished speaking, the second will not
  374. interrupt the speech even if you have it setup to do so unless something has
  375. been spoken between the first hyperactive window triggering and the second
  376. window triggering.  If something has been sent to be spoken between both
  377. hyperactive windows other than the text from the first hyperactive window,
  378. the second hyperactive window will indeed interrupt the speech.
  379.  
  380. Again, this technique is used so hyperactive windows do not interrupt other
  381. hyperactive windows.
  382.  
  383. Trigger On:
  384.  
  385. This option allows you to toggle through all 13 ways to trigger the
  386. hyperactive window.  We discussed each option above.  Simply toggle to the
  387. desired option and move on.
  388.  
  389. First Command:
  390. Second Command:
  391. Third Command:
  392.  
  393. The final three choices allow you to set up to three commands Vocal-Eyes
  394. should do based on a hyperactive window triggering.  We already talked about
  395. the 8 choices available.  All three commands by default are undefined.  Just
  396. because Vocal-Eyes supports three commands, you can use however many you seem
  397. fit.  For example, the first command may be speak string, the second command
  398. could be speak lightbar and the final option could be to load the disk set
  399. FILES.SET.  Let your imagination soar with the possibilities.
  400.  
  401. If you select Speak Window, Speak String, Activate Window, Load Disk SET or
  402. Load RAM SET, you must then press ENTER.  Once you press ENTER, Vocal-Eyes
  403. will prompt for the needed information.  For example, if you select speak
  404. string, you will be prompted for the string itself.  If you selected load
  405. disk SET, you will be prompted for the name of the .SET file to load.  If the
  406. selection only requires a single character input such as the speak window,
  407. activate window or load RAM SET, simply type the single digit.  Do not press
  408. ENTER.
  409.  
  410. If you are supplying the .SET file to load, you are limited to 8 characters. 
  411. Therefore, do not include a path or .SET as part of the file name. 
  412. Vocal-Eyes will use the standard loading procedure.
  413.  
  414. If you selected the speak window option, the valid windows are 0-9 and A-E. 
  415. This means you can speak any of the standard windows 0-9 as well as any of
  416. the hyperactive windows A-E.
  417.  
  418. In order for Vocal-Eyes to conserve memory, it has allocated 80 characters of
  419. storage for text strings to be spoken and the disk SET file names.  Although
  420. there are 5 hyperactive windows and each supports 3 commands, you could not
  421. setup all 15 commands as speak string if the total number of characters
  422. exceeded 80 characters.  It if very unlikely you will ever encounter this
  423. type of problem but if you do, Vocal-Eyes will give the following error
  424. message:
  425.  
  426. Allocation table full.  Unable to save entry.
  427.  
  428. If you receive this error message, Vocal-eyes is telling you there is no room
  429. to store the new string or set file name.  What you typed has not been saved. 
  430. If this happens, you may want to shorten your string lengths to conserve
  431. memory.
  432.  
  433. Once you have all options set the way you want, either press ENTER, right
  434. arrow or down arrow from the last option or press the ESCAPE key from any
  435. option.  The entries will be saved as you exit.
  436.  
  437. There are certain considerations you need to be aware of for some of the
  438. triggering options available.  For example, the exact matches and different
  439. matches somehow have to know what the original data it is suppose to use as
  440. a model for later comparisons.  Also, the contains and does not contain
  441. attribute settings must know what the particular attribute color is.  Lets
  442. discuss where, how and when Vocal-Eyes gets this information.
  443.  
  444. 1) If your trigger string is set for any of the 3 exact matches or any of the
  445. 3 different matches, the data must be on the screen and the hyperactive
  446. window coordinates must be setup for the area before you press SHIFT-F7.
  447.  
  448. 2) If your trigger string is either contains attribute or does not contain
  449. attribute, the review cursor position must be sitting on the character which
  450. contains the color you wish to use when you press SHIFT-F7.
  451.  
  452. Vocal-Eyes does not actually update what it is looking for every time you
  453. enter the SHIFT-F7 menu.  For example, if you already have the window
  454. triggering correctly but you wish to set the interrupt setting or any of the
  455. commands, you should not have to worry about fulfilling the two requirements
  456. above.  And you don't.
  457.  
  458. When you first enter the SHIFT-F7 menu, Vocal-Eyes makes a note of the
  459. current status setting and the current trigger on setting.  When you exit the
  460. menu, Vocal-Eyes compares the settings it saved when you first entered the
  461. menu with the current settings when you exit the menu.  If either of the two
  462. settings have changed, Vocal-Eyes will update what it is looking for using
  463. either of the two methods above depending on what the trigger condition is
  464. set for.  However, even if one or both of the values have changed, the status
  465. must be set for hyperactive.  After all, why update the values if the
  466. hyperactive window is not even activated?
  467.  
  468. It is very important that you understand when Vocal-Eyes updates what it is
  469. looking for in the exact matches and the different matches as well as what
  470. attribute it is looking for in the contains attribute and does not contain
  471. attribute settings.  If your trigger string is any of the other 5 settings,
  472. there is no problem since nothing is needed by Vocal-Eyes which is not
  473. already supplied.
  474.  
  475. Lets say you have a hyperactive window all setup.  It is enabled, triggering
  476. if the window contains the color yellow on black.  But now, you decide to
  477. trigger the window with blue on black instead.  How can this be done?  If you
  478. press SHIFT-F7, there is nothing on the menu to change so when you exit the
  479. menu Vocal-Eyes will not update the color under the review cursor position.
  480.  
  481. Although this may be a rare case, you need to know how to handle this
  482. situation should it arise.  Since Vocal-Eyes only updates if the status is
  483. set to hyperactive and either the status setting or the trigger setting has
  484. changed from when you entered the menu to when you exited the menu, you need
  485. do it in two steps.
  486.  
  487. First, enter the menu with SHIFT-F7 and set the hyperactive window to off. 
  488. Then press the ESCAPE key to exit the menu.  Now make sure your review cursor
  489. is sitting on the new color (blue on black) and press SHIFT-F7 again.  Now
  490. you can change the setting from off to hyperactive and exit again with the
  491. ESCAPE key.  This time, Vocal-Eyes will notice that the status setting has
  492. changed and it is set for hyperactive.  Vocal-Eyes will than take note of the
  493. color under the review cursor and use that for its future comparisons.
  494.  
  495. Although this is not a difficult procedure, it can be a bit confusing at
  496. first.  If you remember when Vocal-Eyes updates what it uses for comparison,
  497. you should be able to master the hyperactive windows.
  498.  
  499. F8:
  500.  
  501. We already talked about this command.  Remember, it will read the coordinates
  502. and status of the currently selected window as well as the coordinates and
  503. status of the currently selected hyperactive window.
  504.  
  505. SHIFT-F8:
  506.  
  507. Remember, ALT-F8 will read through all 10 standard windows giving you the
  508. status and coordinates of each.  SHIFT-F8 on the other hand will read through
  509. all 5 hyperactive windows and give you the status and coordinates of each.
  510.  
  511. 13.6:  TYPING IN HYPERACTIVE WINDOWS
  512.  
  513. If you have a hyperactive window setup for any change, any text change or any
  514. attribute change and you type within the window, Vocal-Eyes will not consider
  515. your keystroke as a change and will not trigger the window.  This is because,
  516. normally you do not want your actual keystrokes to be considered a change. 
  517. If the keystroke causes a change to the screen other than just printing the
  518. character typed at the cursor position, the window will trigger as expected.
  519.  
  520. 13.7:  GLOBAL ENABLING AND DISABLING OF ALL HYPERACTIVE WINDOWS
  521.  
  522. At some point, you may wish to disable all hyperactive windows.  Of course
  523. you could enter review mode and manually disabled each window by selecting
  524. the window and toggling it off.  But if you later wanted them to be active
  525. again, you would have to reverse the process.  This can be very time
  526. consuming.
  527.  
  528. There are actually two ways you can very quickly disable and enable all
  529. hyperactive windows at once.  Even though they are disabled, each individual
  530. window will show a setting of hyperactive.  However, until you re-enable the
  531. windows, Vocal-Eyes will not monitor any of them.
  532.  
  533. The first approach uses one of the Vocal-Eyes hotkeys.  Option 56 (Hyper
  534. On/Off).  This hotkey will toggle the hyperactive windows on and off.  Simple
  535. press this hotkey and Vocal-Eyes will either say "Hyperactive windows off" or
  536. "Hyperactive windows on" depending on the current state of the hyperactive
  537. windows.
  538.  
  539. The second approach can be done through option 10 (Hyperactive Status On/Off)
  540. located in the General submenu.  Simply move to this option and press ENTER. 
  541. Each press will toggle the windows off and on.
  542.  
  543. Feel free to use either approach.  If you are going to use the hotkey, you
  544. first must assign the function a keystroke.  Using either of the above two
  545. techniques will directly effect the other.  In other words, you can turn off
  546. hyperactive windows with the hotkey and later turn them back on using the
  547. general submenu if you wish.
  548.  
  549. 13.8:  HYPERACTIVE CHECK DELAY
  550.  
  551. Option 18 (Hyperactive Check Delay) located in the General submenu gives you
  552. control over how often Vocal-Eyes should check it's hyperactive windows for
  553. changes.  This also effects how often Vocal-Eyes checks for boxes if the auto
  554. box read feature is enabled.
  555.  
  556. You can supply a number from 1 to 99.  Each number represents 1/18th of a
  557. second.  For example, 36 would tell Vocal-Eyes to check every two seconds. 
  558. A setting of 1 would tell Vocal-Eyes to check every 1/18 of a second.  By
  559. default, Vocal-Eyes waits 6/18th of a second or 1/3rd of a second.  This
  560. means each of the active hyperactive windows will be checked 3 times per
  561. second for changes.
  562.  
  563. Why would you want to slow Vocal-Eyes up?  There are two good reasons.
  564.  
  565. 1) If you have the value too low causing Vocal-Eyes to check too quickly,
  566. Vocal-Eyes may trigger on a hyperactive window or a box before the screen has
  567. finished changing.  If this happens, you may not get the results you
  568. intended.  In other words, you may get only a portion of the new information.
  569.  
  570. 2) The more often Vocal-Eyes checks the hyperactive windows and popup boxes,
  571. the more time Vocal-Eyes steals from your machine.  If you have several large
  572. hyperactive windows and you are running on a very slow machine, you may wish
  573. to increase this value to give you a better over-all response.
  574.  
  575. However, If you are using a relatively fast machine and are using an
  576. applications program which updates the screen fast, you may wish to decrease
  577. this value.  The smaller the number, the faster Vocal-Eyes will notice a
  578. change.
  579.  
  580. Lets say you have a hyperactive window monitoring line 25 for any change. 
  581. Once a change has occurred, you have instructed Vocal-Eyes to read the entire
  582. line 25.  Lets also say if you press F1, your applications program
  583. immediately modifies line 25.  If you have the hyperactive check delay set at
  584. 99, Vocal-Eyes will wait 99/18th of a second or 5 1/2 seconds before reading
  585. line 25.  Setting this value to 1 would cause Vocal-Eyes to read line 25
  586. immediately.  The default setting of 6 should work with most applications. 
  587. If you feel a need to change this value, option 18 in the General submenu is
  588. the place to do it.
  589.  
  590. 13.9: HYPERACTIVE WINDOW EXAMPLE
  591.  
  592. Now that you know everything about hyperactive windows, lets go through an
  593. example of actually using them.
  594.  
  595. Lets say you are using an integrated program which offers a word processor,
  596. spreadsheet and database.  When you first start it up, you get a menu
  597. offering the three options.  By picking any of the three choices, you active
  598. the desired function.  Lets say at the top left of the screen, the
  599. application either prints 'Word Processor', 'Spreadsheet' or 'Data Base'
  600. depending on which option you are currently using.
  601.  
  602. You will probably want a custom .SET file for each of the three environments. 
  603. You could manually load the desired .SET file but how about using hyperactive
  604. windows?  Note that the autoloading feature may not function since depending
  605. on the applications program, a program is not necessarily being executed from
  606. disk when you go from one environment to another.
  607.  
  608. For our example, lets start with the VE.SET file supplied and modify it. 
  609. Startup the application program and select the word processor.  Since 'Word
  610. Processor' is now displayed at the upper left of the screen, setup
  611. hyperactive window A for an exact text match.  You could set the coordinates
  612. at: left=1, top=1, right=14, bottom=1.  Now do SHIFT-F7 and set the status to
  613. hyperactive, and the trigger command to 'exact match' or 'exact text match'. 
  614. The exact match will consider both the characters and the color but exact
  615. text match will only consider the text.  Both would probably work in our
  616. example.
  617.  
  618. Now setup the first command to speak the string 'word processor'.  Since we
  619. know hyperactive window A already contains this message, we could have said
  620. read window A.  Either approach would get the same results.  Now lets setup
  621. the second command to load a disk SET.  Give it the name 'WP'.  We will
  622. create WP.SET shortly.  Now ESCAPE from this menu and save the .SET file to
  623. disk.  Lets call this 'MENU'.  Whenever you have a hyperactive window loading
  624. another .SET file, it is always a good idea to save the current .SET file to
  625. disk before you exit review mode.  This is because if the new .SET file gets
  626. loaded by the hyperactive window before you had a change to save the old one,
  627. your changes will be lost and you will have to make them again.
  628.  
  629. Now lets load the 'VE.SET' from the control panel.  We want to start with a
  630. fresh SET file for our word processor.  You will want to adjust all the
  631. features of Vocal-Eyes to work best with the word processor as before. 
  632. However, in this example, we are only concerned with the hyperactive windows.
  633.  
  634. When you exit the word processor, you will want to load the original MENU.SET
  635. file automatically.  We have the MENU.SET loading WP.SET but how can we get
  636. WP.SET to reload MENU.SET when the word processor is exited?
  637.  
  638. We loaded WP.SET by using an exact match in the upper left corner for the
  639. words 'Word Processor'.  How about reloading MENU.SET by triggering on
  640. different match.  In other words, if 'Word Processor' is not in the upper
  641. left, load 'MENU.SET'.
  642.  
  643. Therefore, now that you have VE.SET loaded, lets setup hyperactive window B
  644. to, left=1, top=1, right=14 and bottom=1.  Now press SHIFT-F7 to set the
  645. status to hyperactive, trigger to different match or different text match. 
  646. You can set the first command if you wish to speak 'main menu' and the second
  647. command to load the disk SET 'MENU'.  Now save this SET file to disk with the
  648. name 'WP'.
  649.  
  650. To give them a try, exit to the menu.  You should have heard Vocal-Eyes say
  651. 'main menu' and the 'MENU.SET' file should have been loaded.  Now pick the
  652. word processor option again.  Vocal-Eyes should say 'word processor' and load
  653. 'WP.SET' automatically.
  654.  
  655. Congratulations, you now have Vocal-Eyes working automatically for you.  To
  656. continue our example, you will want to setup hyperactive window B of the
  657. MENU.SET to look for 'Spreadsheet' in the upper left'.  If there, you may
  658. want to load SP.SET.  Then SP.SET will wait until 'Spreadsheet' disappears
  659. from the upper left and load MENU.SET.
  660.  
  661. You can use hyperactive window C of MENU.SET to load the appropriate set file
  662. for the data base as well.
  663.  
  664. Feel free to experiment with hyperactive windows.  Once setup, they can make
  665. an application program speak and act as if it were written for speech.
  666.  
  667. 13.10:  POTENTIAL PROBLEMS WITH HYPERACTIVE WINDOWS
  668.  
  669. Below are a few potential problems you may encounter while setting up
  670. hyperactive windows.
  671.  
  672. 1) Infinite loop
  673.  
  674. It is possible for you to setup a hyperactive window which when triggered
  675. loads a new .SET file.  That .SET file could have a hyperactive window which
  676. loads the original .SET file.  If not setup properly, they may continuously
  677. load each other.
  678.  
  679. For example, if you have the first .SET file triggering if blue on black is
  680. contained anywhere on the screen to load the second .SET file.  The second
  681. .SET file may have a hyperactive window which says load the first .SET file
  682. if the color blue on black is anywhere on the screen.  This would cause
  683. Vocal-Eyes to constantly switch between both .SET files.  An infinite loop.
  684.  
  685. If this happens to you, don't worry.  Simply enter review mode and fix the
  686. problem.  Whenever you enter the voice control panel or enter review, the
  687. hyperactive windows shut down until you return to the applications program. 
  688. You could also use the Hyper On/Off hotkey to turn off all hyperactive
  689. windows and then fix the problem.
  690.  
  691. You should also keep in mind when a new .SET file is loaded with a
  692. hyperactive window setup for any change, any text change or any attribute
  693. change that it will trigger immediately and then only if the area changes.
  694.  
  695. 2) Not saving your new .SET file before a new one is loaded.
  696.  
  697. If you have setup a hyperactive window to load another .SET file based on a
  698. particular occurrence, you should always save the .SET file as soon as
  699. possible.  This is because if the hyperactive window triggers before you have
  700. a chance to save it to disk, all your changes to the current .SET file will
  701. be lost as the new one is loaded.
  702.  
  703. 3) Your hyperactive window is not triggering on the correct data.
  704.  
  705. If you setup your hyperactive window for any of the three exact matches, any
  706. of the three different matches or contains or does not contain a particular
  707. attribute, you must remember how and when Vocal-Eyes gets this information. 
  708. If a window is not triggering as you expect it should, please refer to
  709. section 13.5.
  710.  
  711. 13.11:  SUMMARY
  712.  
  713. This section described the powerful features of hyperactive windows.  You
  714. learned there are 13 different ways a hyperactive window can be setup to
  715. trigger.  Once a window triggers, you can do up to three different things.
  716.  
  717. Hyperactive windows can be setup to make a program much more interactive and
  718. automatic.  With the ability of loading new .SET files based on a particular
  719. change, the sky is the limit.
  720.  
  721. Once you master the great power of Vocal-Eyes' hyperactive windows you will
  722. wonder how you ever got along without them.
  723.