home *** CD-ROM | disk | FTP | other *** search
- 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.