6.00 HOW TO CREATE A BATCH FILE AND MANUALLY CONFIGURE THE HEARSAY GOLD Section 6.01 describes configuring the Hearsay Gold system manually as well as customizing the system. This means every time you boot up your system your own custom settings would have to be re-entered. Section 6.02 describes editing the batch files created in the SETUP program described in Section 1. Your vocabularies or customized settings may be added to these batch files. You can also add the Hearsay directory to your path. NOTE: All Hearsay arguments detailed below can be use in combination from the HSR or HSRE command line. 6.01 HOW TO MANUALLY CONFIGURE THE HEARSAY HOW TO ADD THE HEARSAY DIRECTORY TO YOUR PATH STEP ACTION 1. Type - cd\ [ENTER] to return to your Root directory. 2. Type - PATH [ENTER] The current PATH statement will be displayed. 3. Type PATH = (copy the PATH statement in step 2. End the statement with a semi-colon (;), then add C:\HEARSAY;) 4. Press [ENTER] NOTE 1: This statement assumes the C drive & Hearsay directory. If the Hearsay files are stored on another drive and directory specify that Drive & Directory (DRIVE:\DIRECTORY;). NOTE: 2: Hearsay is not added to the PATH statement. It is in the HEARSAY SETUP program. HOW TO SET THE DEFAULT DIRECTORY The first thing you need to do it set Hearsay's default directory. The default directory should be HEARSAY\XXX where HEARSAY is the directory that contains the Hearsay files and XXX is the sub-directory where the person with the initials XXX's vocabularies are stored. The DOS command is: SET HEARSAY=C:\HEARSAY\XXX [ENTER] This command is contained in all start up batch files created in SET UP. HOW TO SET THE INITIAL LEVEL In order to set the Level you must first load one of Hearsay drivers HSR or HSRE. HSR is a voice recognition driver that does not include the on line Hearsay Editor. This driver is automatically loaded when you enter your XXX batch file. HSRE is a voice recognition driver that includes the on line Hearsay Editor. It allows editing without exiting from your application. This driver program takes up about 40 K bytes of additional memory (Approximately 120 K bytes total). It is automatically loaded when you enter your XXXE batch file. STEP ACTION 1. Type HSR or HSRE [ENTER]. 2. Type LEVEL [ENTER]. 3. The system will prompt you to say the word "CALIBRATE". The program then determines an appropriate noise level parameter and stores the level in the default directory that is set. The system will print to the four (4) numbers representing a level. This new level takes effect the next time recognition is enabled and is set automatically the next time you run HSR or HSRE. HOW TO SET THE LEVEL MANUALLY The level setting can also be set manually by entering a four digit value after an "N" character when loading HSR or HSRE. HSR NXXXX HSRE NXXXX The level setting will be XXXX. It is not a good practice to set the level manually. Best results are achieved if the system level is set in the environment where it will be used by running the automatic LEVEL setting routine described above. NOTE: The level setting is automatically set in SET UP. 6.02 HOW TO CREATE A BATCH FILE The best way to use Setup Commands is to include them in a .BAT file that you can run whenever you want to use the Hearsay Gold. If you put the command in the AUTOEXEC.BAT it will be run every time you boot up your PC. As an alternative, you can edit your personalized batch files with EDLIN or any DOS editor. XXX batch file performs the following: SET HEARSAY=DRIVE:\HEARSAY\XXX HSR/X HSR XXXE batch file performs the following: SET HEARSAY=DRIVE:\HEARSAY\XXX HSRE/X HSRE These batch files may be edited using EDLIN or any DOS editor and any customized set up arguments can be added to the HSR or HSRE command line. In addition, you can add the loading commands REDT/L VOCABULARY or MKLIB XX and RE/L VOCABULARY. Save the edited file under the names: XXXVOCABULARY (If HSR is used) or XXXEVOCABULARY (If HSRE is used) Now you can load the Hearsay driver and your customized set up commands and vocabulary from one batch file command. HOW TO ADD THE PATH TO YOUR AUTOEXEC.BAT FILE USING THE DOS UTILITY EDLIN: STEP ACTION 1. Type "EDLIN AUTOEXEC.BAT [ENTER]" 2. At the * Type "1i [ENTER]" 3. At the 1:* (Copy the exact PATH setting, make the last character a semi-colon (;), then add C:\HEARSAY;). 4. Press [ENTER] NOTE: This statement assumes the C drive and Hearsay directory. If the Hearsay files are stored on another drive and directory specify that drive and directory (DRIVE:\DIRECTORY;). 5. Type [CONTROL-Z] 6. At the * Type -E [ENTER] Alternatively you can use any DOS Editor. HOW TO REDEFINE THE WINDOW KEY Hearsay includes a means to redefine the window key (Usually the numeric + key) to be one of a number of other keys and key combinations. To redefine the window key a numeric code is entered after the letter "K" when loading a Hearsay driver. A listing of the keys that may be used and the corresponding codes to be entered is included on this disk in a text file called KEYS.TXT. For example, the F10 key, has a code of 68 assigned to it. If you wished to reconfigure Hearsay Gold with the F10 function key as the HOT KEY type the following when loading a Hearsay driver: HSR K68 This feature is particularly useful on some IBM compatible machines that do not have a numeric plus key such as the TANDY 1000. If the K option is used without a numeric argument the HOT KEY is set to the default value (Num-plus). This change may also be made using the EDIT PARAMETERS option of the vocabulary editor described in Section 5.03. HOW TO UNHOOOK HEARSAY FROM DOS Unhooking Hearsay from DOS is accomplished using the argument /X from the HSR or HSRE command line: To unhook type: HSR/X or HSRE/X HOW TO ENABLE / DISABLE AUTOPAUSE The AutoPause mode is normally ENABLED when loading a Hearsay driver. To Disable you may do so from the driver command line by specifying the argument PD (Pause Disable). To Re-Able specify PE (Pause Enable). To Disable type: HSR PD HSRE PD To Re-Enable type: HSR PE HSRE PE HOW TO ENABLE / DISABLE VOICE RECOGNITION The Voice Recognition mode is normally DISABLED when loading a Hearsay driver. To Enable you may do so from the driver command line by specifying the argument RE (Recognition Enable). To Disable specify RD (Recognition Disable). HOW TO AUTOMATICALLY TRAIN A VOCABULARY FROM REDT To Automatically train a vocabulary from REDT a special argument /T is included. Simply insert /T after REDT to begin training a vocabulary. To train Vocabulary #1 and Vocabulary #2 type: REDT/T Vocabulary #1 Vocabulary #2 etc. The trained vocabularies are now automatically saved to file in your personalized directory or your specified directory. NOTE: The trained vocabulary is NOT automatically loaded. You must do so by running REDT agin with the /L argument (Example REDT/L vocabulary #1). APPENDIX A - HOW TO USE THE HEARSAY GOLD WITH A MOUSE Although the use of a mouse pointing device is not necessary for the operation of the Hearsay System, using mouse cursor movement coupled with voice commands produces a dramatically fast and natural editing environment. Hearsay includes special software that allows you to move the cursor under mouse control in programs that do not directly support a mouse. The system may also be used with programs that have direct mouse support, and even with other "transparent mouse" packages such as Microsoft Mouse Menus. EXECUTING COMMANDS WITH A MOUSE The Hearsay Gold provides transparent cursor control and command selection with a mouse. A mouse is a small hand size device, with one, two or three buttons on its top or front surface. If a mouse is installed, the [RIGHT] button is the equivalent to the "HOT KEY". The [LEFT] button is the equivalent to the [ENTER] key. Commands may be selected by moving the mouse until the desired command is highlighted, and pressing the [LEFT] button. If you are using a mouse, please refer to the manufacturer's instructions for information on installation of the hardware and Microsoft compatible software. STEP ACTION 1. Place your hand on the mouse. 2. Move the mouse on the table top, mouse pad or surface to the desired operation. NOTE: The mouse provides high speed inputting or selection. 3. Press the [LEFT] button. NOTE: Hearsay Gold supports any Microsoft standard mouse. To use Hearsay Gold with a mouse, follow the manufacturer's installation instructions & load the Microsoft compatible drivers before running the Hearsay drivers (HSR or HSRE). If you are using a Microsoft mouse, the appropriate driver is named MOUSE.COM. There are two modes of operation for the Hearsay Gold mouse software. Transparent mouse operation enables the Hearsay Gold to automatically enter cursor motion key press when the mouse is moved. In most software written for the IBM PC, this will result in smooth accurate cursor positioning on the screen. Newer software packages, such as the programs in the Microsoft Multi tool series, interface directly to the mouse. In this case it is not necessary for Hearsay Gold to control the cursor and transparent mode must be DISABLED. NOTE: Interference may result if transparent operation is not disabled. However control over transparent operation allows you to be able to create & use vocabularies that will not interefere with these programs. HOW TO SET THE MOUSE PARAMETERS There are three parameters related to the mouse interface stored in every Hearsay Gold vocabulary. They may be modified using EDIT PARAMETERS in the Hearsay Gold Editor program. The three mouse parameters are: TRANSPARENT OPERATION - Set to either YES or NO. Select "YES" if the vocabulary is to be used with a program that DOES NOT communicate directly with the Microsoft compatible driver. Select "NO" if the vocabulary is to be used with a program that DOES communicate directly with the Microsoft compatible mouse driver. If difficulties are encountered, restart DOS, install the Hearsay driver (REDT.EXE), then install a Microsoft compatible mouse driver (MOUSE.COM). NOTE 1: If mouse.com is installed after REDT.EXE, Hearsay will configure itself as if there is no mouse installed. If this is done, you must again restart DOS before you can use the Hearsay transparent mouse driver. In most cases no interference will occur and this procedure will be unnecessary. NOTE 2: If you are using Hearsay with WORDPERFECT, MICROSOFT WORD, AUTOCAD or other C.A.D. software, set the TRANSPARENT MOUSE parameter of the vocabularies to be used to NO and set the RECOGNIZER DELAY parameter to -1. These steps are essential for correct operation. HORIZONTAL SCALE FACTOR - Only exists for vocabularies with a transparent operation mode set to YES. It is the number of horizontal mouse increments (Mickeys) per cursor key depression. The smaller the number, the more sensitive the mouse (ie. more cursor movement for a given amount of mouse movement). VERTICAL SCALE FACTOR - Only exists for vocabularies with the transparent mode operation set to YES. It is the number of vertical mouse increments (Mickeys) per cursor key depression. The smaller the number, the more sensitive the mouse (ie. more cursor movement for a given amount of mouse movement). Hearsay Gold provides default values for the mouse scale factors that are appropriate for programs where pressing the cursor keys moves the cursor by one character in the horizontal direction, and one line in the vertical direction. These settings are adequate for most applications. CAUTION: These settings are inappropriate for any spreadsheet program. Larger scale factors should be used for these applications. Here are a few recommeded scale factors: Word Processing Programs Horizontal Scale Factor 14 Vertical Scale Factor 17 Spreadsheet Programs Horizontal Scale Factor 75 Vertical Scale Factor 35 SETTING THE MOUSE PARAMETERS To set the Hearsay Gold mouse parameters for a particular Vocabulary the Vocabulary must be loaded into the Hearsay Gold Editor. STEP ACTION 1. Type CD\HEARSAY 2. Type HSR or HSRE 3. Type REDT VOCABULARY or MKLIBXX RE VOCABULARY When the vocabulary has been loaded: STEP ACTION 1. Select EDIT from the Main Menu 2. Select PARAMETERS from the EDIT Menu 3. Select MOUSE CONTROL from the EDIT PARAMETERS Menu. 4. Set the transparent mouse mode for the vocabulary by typing "Y" for YES or "N" for NO. NOTE: To leave the current value (Shown after the >) unchanged, press [ENTER]. If NO is selected the system returns to the EDIT PARAMETERS Menu. If YES is selected proceed to step number 5. 5. Set the horizontal scale factor by typing the new value followed by [ENTER], or [ENTER] to leave the current value unchanged. 6. Set the vertical scale factor in the same manner as you set the horizontal scale factor in Step 5. We encourage you to experiment with different mouse scale factors to find what is most comfortable to you. NOTE: As in the case with all edits or updates to Hearsay Gold vocabularies, if you wish to save your changes in the vocabulary FILE or Library, you must do so explicity by selecting SAVE. RESTORING TRANSPARENT MOUSE CONTROL After you have loaded a Vocabulary with mouse control DISABLED, and have run a program which communicates directly with the mouse driver; the following steps must be taken to restore transparent mouse control: 1. Select a Vocabulary with mouse control ENABLED as the active Hearsay Gold Vocabulary by loading it from the Library (See Section 4) or by running the Hearsay Gold Editor program REDT or RE. NOTE: You can not use the mouse to bring up the Hearsay Gold Windows, or select from the Library, since it is not yet active. 2. Press the "HOT KEY" to step through the Vocabulary Window, Control Window, and once more to exit from the Hearsay Gold Control Window. The system resets and the transparent mouse will be active again. NOTE 1: The mouse parameters are always set to their new values upon exit from the Hearsay Gold Control Window. NOTE 2: Setting the mouse mode to NO will not disable mouse cursor control until another program resets or reconfigures a Microsoft mouse driver. If the transparent driver is still active after running an application program, and a Hearsay Gold vocabulary that has the mouse mode disabled is loaded at the time, the program in question is NOT using the mouse directly. In general, if the documentation does not explicity instruct you to load the Microsoft compatible driver before running the program, it is not using the mouse directly, and the transparent mouse mode should be set to YES. For those users who are not currently using a mouse with the Hearsay Gold, we suggest setting the mouse mode to NO. Hearsay Gold knows whether a mouse is installed, and acts accordingly. There is no gained value in turning on the transparency mode except in the cases mentioned above. HOW TO USE HEARSAY WITH MICROSOFT MOUSE MENUS The mouse menu package from Microsoft is a support tool provided to all purchasers of the Microsoft Mouse. It includes a selection of predefined transparent menus for popular application packages. If you wish to use this package with Hearsay Gold, run REDT.EXE to install the Hearsay Gold software before the mouse driver MOUSE.COM is installed. The transparent mouse functions are then supported by the MOUSE MENUS software. NOTE: Voice commands will not be accepted while a MOUSE MENUS pop-up selection is being made. The MOUSE MENUS package also includes a menu compiler that allows special application developers or programmers to write "menu programs". The mouse menus programming language is complicated enough to most non-programmers very uncomfortable. We suggest that you use the Hearsay Gold transparent menu system to create your own programs. The information that follows is provided for the sophisticated user. If you are writing your own "Mouse Menu Program" you can control Hearsay Gold directly from your programs. For example, if you wish to program the [RIGHT]mouse button to bring up the Hearsay Gold Windows (The equivalent of the "HOT KEY"), use an ASSIGN or BEGIN statement to set the RTBTN parameter to type in the extended decimal character code 0,78. In the following example we will also set the [LEFT] button to be the equivalent of the [ENTER] key: ASSIGN ent,HS HS:TYPE 0,78;window button ent:TYPE ENTER;enter key Any of the Hearsay Gold command or control functions can be executed in a similiar manner using a combination of the [ENTER] and window button codes shown above. For example, to expand the program above to toggle the voice mode when both mouse buttons are pressed simultaneously: ASSIGN ent,hs,rec hs: TYPE 0,78;window button ent: TYPE ENTER;enter key rec: EXECUTEhs,hs,ent;voice mode For more information on the use of Mouse Menus you are referred to the Microsoft supplied documentation.