Astra Blaster/Astra.cdr/voice/hearsay5.txt

Text File | 1992-04-08 | 19KB | 439 lines

     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.