home *** CD-ROM | disk | FTP | other *** search
- APPENDIX E
- COMMAND LINE PARAMETERS
-
- Vocal-Eyes offers several command line parameters. These are commands you
- can issue at the DOS prompt. Each of these commands will be described below.
- These commands will only relate to the Vocal-Eyes command line. For a
- description of the Speech Driver commands, refer to Appendix F.
-
- First we will describe the one time startup parameters. These are the
- commands that can ONLY be issued the very first time Vocal-Eyes is started up
- each session. If you attempt to issue them while Vocal-Eyes is already
- loaded, they will simply be ignored. After these commands, the commands
- which can be issued anytime or will be listed.
-
- VE.COM ONE TIME STARTUP PARAMETERS
-
- /!Fn n = 1-9 Allocate maximum number of RAM .SET files. Default = 1.
- Before you can load several .SET files in RAM, you must first allocate the
- maximum number of locations with this command.
-
- /!Kn n = 0-9 Key label dictionary buffer size. Default = 2. This is used
- to allocate the maximum size of the key label dictionary buffer. Each number
- is multiplied by 512 bytes. For example, a setting of 9 would actually
- allocate 9 * 512 or 4608 bytes of storage. A setting of 0 will not allocate
- any space for the key labels. You will not be able to load any key labels if
- this is the case. However, you will have freed up 1024 bytes of RAM space.
-
- /!Cn n = 0-9 Character dictionary buffer size. Default = 1. This is used
- to allocate the maximum size of the character dictionary buffer. Each number
- is multiplied by 256 bytes. For example, a setting of 5 would actually
- allocate 5 * 256 or 1280 bytes of storage. A setting of 0 will not allocate
- any space for the character dictionary. You will not be able to load any
- characters if this is the case. However, you will have freed up 256 bytes of
- RAM space.
-
- /!Vn n = 0-9 Video clipboard buffer size. Default = 4 (1,024 bytes). This
- is used to allocate the maximum size for the clipboard buffer. Each number
- is multiplied by 256 bytes. For example, a setting of 5 would be 5*256=1,280
- bytes of storage. A setting of 0 will not allocate any space for the buffer.
- If you try and copy information to the clipboard and the buffer is not large
- enough, Vocal-Eyes will give you an error message and abort the copy.
-
- /!Lx x = 0 or 1 Auto Lightbar buffer. Default = 1 (on). Because the auto
- lightbar requires a relatively large amount of memory, you have the option of
- disabling this feature and freeing up this memory. By disabling the Auto
- Lightbar, you will free up about 2K of memory. Vocal-Eyes by default will
- enable the auto lightbar. If you disable this and set the lightbar setting
- to auto, Vocal-Eyes will treat it as if you had set lightbar off. Turning
- lightbar on however will always work correctly regardless of this setting.
- Only the auto setting will be effected.
-
- /!ME - This will cause Vocal-Eyes to load into Expanded memory. If your
- machine supports Expanded memory, you may wish to give this a try. If
- Vocal-Eyes has successfully loaded into your expanded memory, you will get
- the message "Loaded into expanded memory." Unfortunately, all Expanded
- memory drivers are not created equal. Therefore, you should try several
- application programs while Vocal-Eyes is in expanded memory. If nothing
- unusual happens, you can assume Vocal-Eyes is compatible with your memory
- driver. If you have a choice between expanded and extended, you should use
- extended. Extended memory is faster and more reliable.
-
- /!MX - This will cause Vocal-Eyes to load into Extended memory. If your
- machine supports Extended memory, you may wish to give this a try. If
- Vocal-Eyes successfully loaded into your extended memory, you will get the
- message "Loaded into extended memory." Before you can use your extended
- memory, you must load the HIMEM.SYS device driver supplied on the Vocal-Eyes
- disk. You need to add a line in your CONFIG.SYS file 'DEVICE=HIMEM.SYS'.
- This is assuming you have the HIMEM.SYS driver in the root directory. Only
- if this device driver is loaded will Vocal-Eyes load into extended memory.
- If your machine has both extended and expanded memory, you may want to try
- this option first. Vocal-Eyes has a tendency to execute faster in extended
- then expanded. It all depends on how good your expanded memory driver is.
- As with expanded memory, you should first try Vocal-Eyes with several of your
- application programs. If nothing unusual happens, you can assume Vocal-Eyes
- is compatible with your extended memory. Better safe than sorry!
-
- /!OE - This will cause Vocal-Eyes to load the overlay file (VE.OVL) into
- expanded memory. If Vocal-Eyes was able to load the overlay file into
- expanded memory, you will get a message indicating this. If you do not get
- the message, you can assume Vocal-Eyes was unable to allocate enough expanded
- memory.
-
- /!OX - This will cause Vocal-Eyes to load the overlay file (VE.OVL) into
- extended memory. If Vocal-Eyes was able to load the overlay file into
- extended memory, you will get a message indicating this. If however, you do
- not get the message, you can assume Vocal-Eyes was unable to load the overlay
- file into extended.
-
- Loading Vocal-Eyes into expanded or extended memory is completely independent
- of loading the overlays into expanded or extended memory. You could for
- example load Vocal-Eyes into extended and the overlays in expanded. Or
- Vocal-Eyes in extended and the overlays in extended. It really does not
- matter. The advantage of loading the overlays in expanded or extended memory
- means they can be loaded faster and you do not have to worry about DOS being
- unable to always load the required information from the VE.OVL file.
-
- VE.COM ANYTIME PARAMETERS
-
- /Fnp n = 1-9 (RAM location), p = .SET file name. This will load the
- specified file (p) into the RAM location specified (n). Remember, if you
- wish to have more than 1 RAM location, you must issue the /!Fn parameter to
- allocate the desired locations. Once allocated, you can load as often as you
- like. For example, the command /F7C:\WP\WP would load the file WP.SET which
- is on the C: drive in the WP directory into RAM7. You can repeat this
- command on the same command line as many times as DOS will allow. If you
- load into RAM1, the specified information will become active.
-
- /Rn n = 1-9 (RAM location) This will make the .SET file in the RAM location
- n active. It would be like pressing the load RAM SET hotkey and pressing the
- number you specified for n. Be aware of the autoloading feature. If you
- load a .SET file with this command and execute a program, Vocal-Eyes will
- reload the new .SET file if it exists.
-
- /Cp p = Character dictionary path and name. This will load the specified
- character dictionary (p) into the character dictionary buffer. For example,
- the command /CB:\LOTUS\LOTUS would load the file LOTUS.CHR which is on the B:
- drive in the LOTUS directory. Remember, Vocal-Eyes will default to a 256
- character buffer. If you wish more, you must use the /!Cn command.
-
- /CC - This will clear the entire Character dictionary buffer. This can be
- used if you don't wish to load a new character dictionary but you don't want
- to use the existing one either.
-
- /Kp p = Key Label dictionary path and name. This will load the specified
- key label dictionary (p) into the key label dictionary buffer. For example,
- the command /KDBXL would load the file DBXL.KEY into the key label buffer.
- Vocal-Eyes would first look in the default Vocal-Eyes directory. If found it
- would be loaded. If not, Vocal-Eyes will look in the current drive and
- directory. If there, it will be used. This same search is done with the /Cp
- command as well.
-
- /KC - This will clear the entire key label dictionary buffer. This can be
- used if you don't wish to load a new key label dictionary but you don't want
- to use the existing one either.
-
- /Ax x = 0-2. This command with either disable the autoloading feature,
- enable it without messages or enable it with message. By default, Vocal-Eyes
- has the autoloading enabled without message. The valid options are:
-
- /A0 - Disable the autoloading altogether
- /A1 - Enable autoloading without verbal message (default)
- /A2 - Enable autoloading with verbal message during loading and reloading
-
- With autoloading enabled, Vocal-Eyes will automatically load a .SET, .KEY and
- .CHR file from the default Vocal-Eyes directory with the same name as the
- application program being executed. Vocal-Eyes will also automatically load
- DOS.SET, DOS.KEY and DOS.CHR when you shell to DOS. When you exit the shell,
- the original information will be reloaded. Vocal-Eyes can actually go 15
- levels deep and be able to reload all 15 levels. If Vocal-Eyes tries to
- autoload a new .SET file which does not exist, the original .SET file remains
- active. If a key label or character dictionary does not exist, you have a
- choice of what should be done using the following command line parameters:
-
- /AKC - This tells Vocal-Eyes to 'C'lear the current key label dictionary if
- the requested file does not exist.
- /AKL - This tells Vocal-Eyes to 'L'eave the current key label dictionary if
- the requested file does not exist.
-
- /ACC - This tells Vocal-Eyes to 'C'lear the current character dictionary if
- the requested file does not exist.
- /ACL - This tells Vocal-Eyes to 'L'eave the current character dictionary if
- the requested file does not exist.
-
- /H - There are several programs available today such as QEMM which allow you
- to load Vocal-Eyes in high memory. This is not expanded or extended memory
- although it is memory between the 640K and 1 MEG space. If you plan on
- loading Vocal-Eyes in high memory with these types of programs, you must
- include the command /H on the Vocal-Eyes command line parameter for all
- reloads of Vocal-Eyes. You should not include it the very first time
- Vocal-Eyes is loaded for each session but for all others. The /H simply
- tells Vocal-Eyes to look in high memory for itself for each reload. If you
- load Vocal-Eyes in high memory and reissue Vocal-Eyes with new command line
- parameters and don't specify the /H, Vocal-Eyes will not notice it has been
- loaded high and reloaded a second time. This would mean two copies of
- Vocal-Eyes are running at the same time. If this every happens, reboot your
- machine and only load Vocal-Eyes once.
-
- ; - If you end the entire command line with a ; (semicolon), Vocal-Eyes will
- not speak its usual message. This is good for batch files where you want to
- keep unnecessary chatter to a minimum.
-